gnutls_x509_crt_set_pin_function(3)

💖 gnutls_x509_crt_set_pin_function — the gnutls manual, bestie edition 💖

okay so picture this: you're deep in the gnutls manual, page gnutls_x509_crt_set_pin_function(3), and you need to know who's gonna handle the PIN when something protected gets poked. That's this page. It's short, it's sweet, it's giving "one job, done correctly." ✨

---

✨ NAME ✨

gnutls_x509_crt_set_pin_function — API function 👑

---

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

void gnutls_x509_crt_set_pin_function(gnutls_x509_crt_t crt,
gnutls_pin_callback_t fn, void * userdata);

---

🎀 ARGUMENTS 🎀

• gnutls_x509_crt_t crt — the certificate structure. this is your girl, the cert we're attaching stuff to 🦋
• gnutls_pin_callback_t fn — the callback. the lil function that gets called, no cap 💅
• void * userdata — data associated with the callback. your emotional support pointer 🫶

---

💜 DESCRIPTION 💜

So here's the tea: this function sets a callback function that gets used whenever it's required to access a protected object. That's it, that's the whole vibe. 🔐

And important — this one overrides the global function that was set using gnutls_pkcs11_set_pin_function(). So if you set a global PIN handler and then call this, this one wins. main character energy, honestly. 👑

Heads up bestie, plot twist: this callback is currently used only during the import of a PKCS 11 certificate with gnutls_x509_crt_import_url(). That's the one and only place it shows up right now. Not me warning you so you don't sit there wondering why it's not firing elsewhere 😭

---

⭐ SINCE ⭐

3.1.0 — she's been around a minute, fr fr 🌈

---

🙈 REPORTING BUGS 🙈

Found something cursed? Report bugs to <bugs@gnutls.org>. They wanna hear it, iykyk.

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.

---

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

---

that's the whole page, bestie, you ate it 💅✨ this was the gnutls manual, version 3.8.13 — no date on this footer so I'm not making one up, don't come for me 🙈 — and the page name is gnutls_x509_crt_set_pin_function(3). go set that callback, you icon 🎀💖