gnutls_privkey_import_pkcs11(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_privkey_import_pkcs11 ✨

okay bestie, so this is a page from the gnutls manual, section 3 (the library-functions girlies 💅), and it's literally about yeeting a PKCS#11 private key into the abstract key world. stay with me, it's cute, I promise 🫶

🌸 NAME 🌸

gnutls_privkey_import_pkcs11 — the API function that does exactly what it says on the tin 💖

🎀 SYNOPSIS 🎀

#include <gnutls/abstract.h>

int gnutls_privkey_import_pkcs11(gnutls_privkey_t pkey,
gnutls_pkcs11_privkey_t key, unsigned int flags);

🦋 ARGUMENTS 🦋

  • gnutls_privkey_t pkey — the private key. the destination, the main character, the one getting the glow-up ✨
  • gnutls_pkcs11_privkey_t key — the private key that's getting imported. it's the one being moved in 🏠
  • unsigned int flags — flags for the import, bestie. they control the vibe of the whole operation 🎀

💖 DESCRIPTION 💖

so basically this function imports the private key you hand it into the abstract gnutls_privkey_t type. glow-up complete, she's abstract now 👑

⚠️ lowkey important: the gnutls_pkcs11_privkey_t object must not be deallocated during the lifetime of this structure. like, do not free her while she's still being used, that's not the vibe. fr fr. 🫣

and flags? it might be zero, or it might be one of GNUTLS_PRIVKEY_IMPORT_AUTO_RELEASE and GNUTLS_PRIVKEY_IMPORT_COPY. pick your fighter 💅

🌈 RETURNS 🌈

slay on success: GNUTLS_E_SUCCESS (0) comes back at you. otherwise? a negative error value, which is giving "something went wrong" energy 😭

⭐ SINCE ⭐

2.12.0 — she's been iconic for a while now, no cap 🧚

💀 REPORTING BUGS 💀

found a bug? not me gatekeeping the address:

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. (yes, that's the whole thing, and yes, it's giving generous queen 👑)

🔥 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, bestie, just go visit:

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

okay that's the whole page, you ate that 🍓 thanks for reading, ily, go import some keys responsibly 💜

— brought to you by the gnutls manual, version 3.8.13 💅✨ mwah, bye!!

📦 where this page comes from