gnutls_pkcs11_privkey_import_url(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_pkcs11_privkey_import_url(3) ✨

okay bestie, welcome to the gnutls manual, this page is gnutls_pkcs11_privkey_import_url, an API function, and it's giving "let me introduce your token's private key to GnuTLS" 🎀

🌸 NAME 🌸

gnutls_pkcs11_privkey_import_url — API function 💅

🦋 SYNOPSIS 🦋

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_privkey_import_url(gnutls_pkcs11_privkey_t pkey, const
char * url, unsigned int flags);

💖 ARGUMENTS 💖

  • gnutls_pkcs11_privkey_t pkey — the private key, that's the one we're hooking up 🫶
  • const char * url — a PKCS 11 url that identifies the key, like a little address for your key fr fr
  • unsigned int flags — an or sequence of GNUTLS_PKCS11_OBJ_* flags, mix and match as needed ✨

👑 DESCRIPTION 👑

So here's the tea: this function will "import" a PKCS 11 URL that identifies a private key into the gnutls_pkcs11_privkey_t type. But ngl, "import" is in quotes for a reason — in reality, since in most cases keys cannot be exported, the private key structure is just being associated with the available operations on the token. no cap, the key stays home, you're just vibing with it 💅

⭐ RETURNS ⭐

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value 😭 (negative = not the vibe, go read the error).

🐛 REPORTING BUGS 🐛

Report bugs to <bugs@gnutls.org>. 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. iconic behaviour tbh 💜

🔥 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/

lowkey if you're still here, go read the actual docs too, they ate 💅

that's the whole page bestie, written for gnutls version 3.8.13, manual name gnutls — stay hydrated, keep your keys on the token, periodt 🦋💖✨

📦 where this page comes from