gnutls_pkcs11_copy_secret_key(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_copy_secret_key — bestie edition 💖

okay so this page lives in the gnutls manual, and it's all about gnutls_pkcs11_copy_secret_key. let's get into it 🫶

✨ NAME ✨

gnutls_pkcs11_copy_secret_key — it's an API function, bestie. that's the whole vibe 💅

🌸 SYNOPSIS 🌸

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_copy_secret_key(const char * token_url, gnutls_datum_t
* key, const char * label, unsigned int key_usage, unsigned int flags);

like. look at that signature. iconic. no cap ✨

🎀 ARGUMENTS 🎀

  • const char * token_url — a PKCS 11 URL specifying a token. it's the little address that tells you which token we're talking about 🗺️
  • gnutls_datum_t * key — the raw key. just. the key. the actual key itself, sitting right there 🌸
  • const char * label — a name to be used for the stored data. so future-you can find it, periodt 🏷️
  • unsigned int key_usage — one of GNUTLS_KEY_*. pick your fighter 💅
  • unsigned int flags — one of GNUTLS_PKCS11_OBJ_FLAG_*. more knobs, more options, we love that for you 🎛️

🦋 DESCRIPTION 🦋

okay so the way this works: this function will copy a raw secret (symmetric) key into a PKCS 11 token specified by a URL. that's it. that's the job. 🧚

and the key can be marked as sensitive or not — so you get to decide whether it's giving secretive main character energy or open-book energy 🙈✨

💜 RETURNS 💜

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. so like, 0 = slay, negative = not slay 😭

⭐ SINCE ⭐

2.12.0 — this one's been around a minute, a true elder icon 👑

🌈 REPORTING BUGS 🌈

found a bug? don't just suffer in silence, tell the people:

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.

🔥 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!! go forth and copy those secret keys, but like, responsibly 💅 this was gnutls version 3.8.13 doing its thing. mwah. 🫶💖✨

📦 where this page comes from