gnutls_pubkey_import_tpm_raw(3)

📦
version 3.8.13 · 7 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu stonking

💖 gnutls_pubkey_import_tpm_raw(3) 💖

okay bestie, welcome to the gnutls manual, page gnutls_pubkey_import_tpm_raw. this is the part where we pull a public key out of a TPM key blob and honestly? it's giving ✨ key extraction ✨. let's get into it 🫶

✨ NAME ✨

gnutls_pubkey_import_tpm_raw — it's an API function, and its whole job is exactly what the name says. no cap. 💅

🌸 SYNOPSIS 🌸

#include <gnutls/abstract.h>

int gnutls_pubkey_import_tpm_raw(gnutls_pubkey_t pkey, const
       gnutls_datum_t * fdata, gnutls_tpmkey_fmt_t format, const char *
       srk_password, unsigned int flags);

like, five arguments, one int returned, classic. don't forget that #include or it's gonna be a whole thing 😭

🎀 ARGUMENTS 🎀

  • gnutls_pubkey_t pkey — the public key. this is your main character right here, the one getting filled in 👑
  • const gnutls_datum_t * fdata — the TPM key that we're importing. the raw material, literally 🧚
  • gnutls_tpmkey_fmt_t format — the format of the private key. yes bestie, the private key — that's what the original says, we don't question it, we just pass it 💜
  • const char * srk_password — the password for the SRK key. it's optional, so if you don't need it, NULL it and move on 🦋
  • unsigned int flags — one of the GNUTLS_PUBKEY_* flags. one. not a whole little collection, one 🌈

💫 DESCRIPTION 💫

so the way that this works: this function will import the public key from the provided TPM key structure. that's the vibe. that's the whole assignment. 💅

and about passwords — with respect to passwords, the same as in gnutls_pubkey_import_tpm_url() apply. so if you've already read that page, you already know, iykyk. if not, go read it, bestie, i'm not about to guess at it for you 🙈

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise you get a negative error value. so like, check your return value, okay? zero is the slay outcome, negative means we're crying 😭

🦋 SINCE 🦋

3.1.0 — this one's been around since way before you discovered it, it's an elder icon 👑

📢 REPORTING BUGS 📢

found a bug? report it to <bugs@gnutls.org>. do not suffer in silence, that's not the energy 🌸

home page: https://www.gnutls.org

Copyright © 2001-2023 Free Software Foundation, Inc., and others.

copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. so like, go off, just keep the receipt 🧾💖

👀 SEE ALSO 👀

the full documentation for gnutls is maintained as a Texinfo manual. if the /usr/share/doc/gnutls/ directory does not contain the HTML form, visit:

https://www.gnutls.org/manual/

and that's the whole page, bestie!! you now know how to gnutls_pubkey_import_tpm_raw and honestly that's a flex 🫶

this was brought to you by the gnutls manual, version 3.8.13 — signed, sealed, delivered, slayed. periodt. 💅✨

📦 where this page comes from