gnutls_certifi...et_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_certificate_set_pin_function ✨

okay bestie, welcome to the gnutls manual, page gnutls_certificate_set_pin_function(3) 💖 this one's short, sweet, and honestly kinda iconic. let's get into it 🫶

🌸 NAME 🌸

gnutls_certificate_set_pin_function — it's an API function, no cap 💅

🎀 SYNOPSIS 🎀

#include <gnutls/gnutls.h>

void
gnutls_certificate_set_pin_function(gnutls_certificate_credentials_t
cred, gnutls_pin_callback_t fn, void * userdata);

literally just three args and no return value. void-coded. it's giving "I do my job and I leave" 💀✨

🦋 ARGUMENTS 🦋

  • gnutls_certificate_credentials_t cred — bestie this is a gnutls_certificate_credentials_t type. that's it, that's the whole description 😭 it's the creds you're attaching stuff to.
  • gnutls_pin_callback_t fn — a PIN callback 👑 the function that's gonna handle PIN duty.
  • void * userdata — data to be passed in the callback. your lil care package that rides along 🎁

💖 DESCRIPTION 💖

so the way this works: this function sets a callback function that gets used when gnutls needs to access a protected object. think locked-up keys, PIN-protected vibes 🔐

and hear me out — this one overrides any other global PIN functions. it's the main character. periodt. 👑

⚠️ okay but listen: this function must be called right after initialization to have effect. not later. not whenever. right after. if you're late, it simply does not care and does nothing for you 🙈

⭐ SINCE ⭐

3.1.0 — old money, been serving since forever 💜

🌈 REPORTING BUGS 🌈

found a bug? spill it, fr fr 🐛

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. 💖 (yes queen, go ahead and share it, just keep the receipts 🧾)

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

iykyk, the whole lore is in there 📚✨

and that's the whole page bestie!! this lil cutie comes from gnutls 3.8.13 🫶💅 go set that PIN callback right after init, okay? love u, bye!! 🌸🦋💖

📦 where this page comes from