GNUTLS_PKCS11_PRIVKEY_SET_PIN_FUNCTION(3)

✨ NAME ✨

okay bestie, gather round 💖 this is gnutls_pkcs11_privkey_set_pin_function — an API function from the gnutls manual, and she's here to let you hand a private key its very own PIN callback. no cap. 🎀

---

🌸 SYNOPSIS 🌸

#include <gnutls/pkcs11.h>

void gnutls_pkcs11_privkey_set_pin_function(gnutls_pkcs11_privkey_t key,
       gnutls_pin_callback_t fn, void * userdata);

---

🦋 ARGUMENTS 🦋

• gnutls_pkcs11_privkey_t key — the private key in question, your main character 🔑
• gnutls_pin_callback_t fn — the callback. the moment. the icon ✨
• void * userdata — data associated with the callback, aka the little bestie that rides along with fn 🫶

---

💅 DESCRIPTION 💅

so basically, this function will set a callback function to be used when required to access the object. lowkey essential.

and here's the tea: this function overrides the global one you set with gnutls_pkcs11_set_pin_function(). so if you set a global PIN function and then call this per-key one, this one wins. the global one is giving background character energy now. 👑

---

⭐ SINCE ⭐

3.1.0 — she's been iconic since way back. periodt.

---

🙈 REPORTING BUGS 🙈

found a bug? not me gatekeeping — report bugs to <bugs@gnutls.org>.

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

---

👑 COPYRIGHT 👑

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. (slay, fr fr, that's the whole license vibe 💜)

---

🌈 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 🧚 this was gnutls_pkcs11_privkey_set_pin_function(3) from the gnutls manual, version 3.8.13 — drink your water, close your file descriptors, and go be the callback you want to see in the world 💖✨