gnutls_pkcs11_init(3)

💖 gnutls_pkcs11_init(3) — the gnutls manual, but make it cute ✨

okay bestie, welcome to the gnutls man pages, section 3, and today's main character is gnutls_pkcs11_init. it's giving "setup era" energy. let's get into it 🫶

---

🌸 NAME 🌸

gnutls_pkcs11_init — literally just an API function, that's the whole job description 💅

---

✨ SYNOPSIS ✨

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_init(unsigned int flags, const char *
deprecated_config_file);

yes the line break in the middle of the params is canon, we don't question the formatting gods 🙈

---

🎀 ARGUMENTS 🎀

• unsigned int flags — an ORed sequence of GNUTLS_PKCS11_FLAG_*. like, you stack them up with bitwise OR and the vibes compound 💫
• const char * deprecated_config_file — either NULL, or the location of a deprecated configuration file. it said what it said. deprecated. i don't make the rules 😭

---

💜 DESCRIPTION 💜

so this function initializes the PKCS 11 subsystem in gnutls. that's the whole glow-up arc. ✨

it'll read configuration files if GNUTLS_PKCS11_FLAG_AUTO is used, or it'll let you independently load PKCS 11 modules using gnutls_pkcs11_add_provider() if GNUTLS_PKCS11_FLAG_MANUAL is specified. two paths, both valid, choose your own adventure 🌈

not me telling you that you DON'T need to call this function since GnuTLS 3.3.0 😭 because it's being called during the first request PKCS 11 operation anyway. that automatic call will assume the GNUTLS_PKCS11_FLAG_AUTO flag, no cap. but if another flags are required, then it must be called independently prior to any PKCS 11 operation. so like, manual mode girlies, this one's for you 💅

---

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned. otherwise, a negative error value. that's it, that's the return. slay or fail, no in-between 🎀

---

🦋 SINCE 🦋

2.12.0 — an elder, an icon, a legend 👑

---

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, report it to <bugs@gnutls.org>. they wanna hear from you fr fr 🫶

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. so yes, you can 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, go read the Texinfo manual, it's the source of truth bestie 📚💜

---

and that's the whole page!! this was gnutls_pkcs11_init(3) from gnutls 3.8.13, brought to you by the gnutls gang, dated however the build stamped it — mwah, take care of your PKCS 11 subsystem, drink water, and don't forget the flags 🎀💅✨🫶