gnutls_pkcs11_set_pin_function(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_set_pin_function(3) 💖

okay bestie, welcome to the gnutls manual page for gnutls_pkcs11_set_pin_function — yes that's a whole mouthful, but it's lowkey the key to making your PKCS #11 stuff ask you for a PIN instead of just suffering in silence. let's get into it 🎀

✨ SYNOPSIS ✨

#include <gnutls/pkcs11.h>

void gnutls_pkcs11_set_pin_function(gnutls_pin_callback_t fn, void *
userdata);

like, that's it. two args. we love a short signature, no cap 💅

🌸 ARGUMENTS 🌸

  • gnutls_pin_callback_t fn — the PIN callback, aka a gnutls_pin_callback_t() function. this is the little guy that gets called when a PIN is needed. it's giving "main character" energy honestly 👑
  • void * userdata — data to be supplied to callback. you know, the lil extra bag of stuff you want passed along to your callback when it fires. it's your data, do whatever 🫶

🦋 DESCRIPTION 🦋

so here's the vibe: this function will set a callback function to be used when a PIN is required for PKCS #11 operations. that's the whole job. you hand it a function, it remembers it, and whenever something PKCS #11 needs a PIN, your callback gets the call instead of everything just... not working.

want to know how your callback is supposed to behave? go read gnutls_pin_callback_t() — it explains the whole etiquette. periodt ✨

⭐ SINCE ⭐

2.12.0 — this has been around for a minute, it's an icon, it's a legend, and it is the moment 💜

🐛 REPORTING BUGS 🐛

found something cursed? don't just scream into the group chat — 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. so yes, you may share the good word, royalty-free, just keep the receipts bestie 💖

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

go forth and read, it's worth it, i promise 🧚

and that's the whole page, bestie!! this was gnutls 3.8.13, documented as gnutls_pkcs11_set_pin_function(3). stay safe out there, keep your PINs close and your callbacks closer 💅✨🎀

📦 where this page comes from