GNUTLS_PKCS11_OBJ_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_obj_set_pin_function — the manual page, bestie edition 💖

okay so this is one of the gnutls man pages (yes, that gnutls, the TLS library, she's iconic) and today we're doing gnutls_pkcs11_obj_set_pin_function. it's an API function. it's tiny. it's powerful. let's go 🎀

✨ NAME ✨

gnutls_pkcs11_obj_set_pin_function — it's an API function, bestie 💅

🌸 SYNOPSIS 🌸

#include <gnutls/pkcs11.h>

void gnutls_pkcs11_obj_set_pin_function(gnutls_pkcs11_obj_t obj,
gnutls_pin_callback_t fn, void * userdata);

like look at her. three args, returns nothing, does exactly one thing. main character energy fr fr 👑

🦋 ARGUMENTS 🦋

  • gnutls_pkcs11_obj_t obj — the object structure. this is the little guy you're attaching the callback to 🫶
  • gnutls_pin_callback_t fn — the callback. the function. the moment. ✨
  • void * userdata — data associated with the callback. your lil backpack of stuff you wanna hand to fn when it gets called 🎒

💜 DESCRIPTION 💜

so what does she actually do? this function will set a callback function to be used when required to access the object. that's it. that's the whole job. no cap 🧚

and here's the slay part: this function overrides the global set using gnutls_pkcs11_set_pin_function(). so if you already set a global pin function and now you want this one specific object to do its own thing? yeah. this is how. per-object callback, global callback found crying in the club 😭💀

⭐ SINCE ⭐

3.1.0 — she's been around. vintage. classic. still eating 🔥

🌈 REPORTING BUGS 🌈

found a bug? don't gatekeep, report it:

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.

(translation: use it, 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/

like, go read the whole thing. it's giving ✨comprehensive✨ iykyk

and that's the page, bestie!! 🎀 this little legend comes to you from gnutls 3.8.13, dated with all the love of a Free Software Foundation copyright spanning 2001–2023. go forth and set those pin functions, one object at a time. periodt. 💅✨🦋

📦 where this page comes from