gnutls_pkcs11_add_provider(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_add_provider(3) ✨

okay bestie, welcome to the gnutls manual — yes that's the manual name, we're literally in it 🎀 this one's all about gnutls_pkcs11_add_provider, and it's genuinely so useful, let's get into it 💅

🌸 NAME 🌸

gnutls_pkcs11_add_provider — it's an API function, no cap 🫶

🦋 SYNOPSIS 🦋

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_add_provider(const char * name, const char * params);

look at that signature, it's giving clean ✨

💖 ARGUMENTS 💖

  • const char * name — the filename of the module 🗂️ like, where the actual module lives on disk.
  • const char * params — should be NULL, or a known string 👀 (which known string? scroll down to the description, i got you).

🌈 DESCRIPTION 🌈

so basically? this function loads a PKCS 11 module and adds it to the module list that gnutls uses. the moment you call it, that module is officially in the rotation and will be used for PKCS 11 operations 🔥 main character energy fr fr.

if you're loading a module because you want it to be used for certificate verification, then pass the string 'trusted' as your params argument. that's the whole trick, iykyk 👑

⚠️ heads up bestie: this function is not thread safe. so like, don't be calling it from multiple threads at the same time and then act surprised, okay? 😭

⭐ RETURNS ⭐

  • on success: GNUTLS_E_SUCCESS (0) is returned 🎉 slay
  • otherwise: a negative error value 💀 so like, always check it

🎀 SINCE 🎀

2.12.0 — it's been iconic for a minute 💜

🙈 REPORTING BUGS 🙈

found a bug? don't suffer in silence, tell the girlies:

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, that's the real license text, keep it, it's important)

🌟 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, go visit:

https://www.gnutls.org/manual/

and that's the whole page, bestie!! this was gnutls_pkcs11_add_provider(3) from the gnutls 3.8.13 source 💖 now go forth and load your modules responsibly, mwah 💅✨🌸

📦 where this page comes from