GNUTLS_X509_CRT_LIST_IMPORT_PKCS11(3)

πŸ’– gnutls_x509_crt_list_import_pkcs11 πŸ’–

okay bestie, listen up β€” this one lives in the gnutls manual (yes, the actual gnutls manual, the big one), and it's a whole API function, so buckle up πŸŽ€


✨ NAME ✨

gnutls_x509_crt_list_import_pkcs11 β€” it's an API function, periodt πŸ’…


🌸 SYNOPSIS 🌸

#include <gnutls/pkcs11.h>

int gnutls_x509_crt_list_import_pkcs11(gnutls_x509_crt_t * certs,
unsigned int cert_max, gnutls_pkcs11_obj_t *const objs, unsigned int
flags);

πŸ¦‹ ARGUMENTS πŸ¦‹

  • gnutls_x509_crt_t * certs β€” literally just a list of certificates, and every single one of them is of type gnutls_x509_crt_t πŸ’œ
  • unsigned int cert_max β€” the maximum size of the list, bestie. that's the ceiling, don't go over it πŸ™ˆ
  • gnutls_pkcs11_obj_t *const objs β€” a list of PKCS 11 objects ✨
  • unsigned int flags β€” it's 0 for now. that's it. that's the whole vibe 🌈

πŸ‘‘ DESCRIPTION πŸ‘‘

so what does this icon actually do? she will import a PKCS 11 certificate list into a list of gnutls_x509_crt_t type πŸ”₯

⚠️ and this is the important part, no cap: these must not be initialized. like, don't touch them first, don't prep them, don't do a lil warm-up. leave them alone and let the function do her thing πŸ’€

⭐ RETURNS ⭐

on success, you get GNUTLS_E_SUCCESS (0) back β€” slay πŸŽ‰

otherwise? a negative error value. so if the number's negative, that's your sign something went sideways, iykyk 😭


🧚 SINCE 🧚

2.12.0 β€” she's been around for a minute, a real veteran πŸ’…


πŸ“ REPORTING BUGS πŸ“

found a bug? don't just scream into the group chat, actually 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. so like, go off, 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, then bestie, go visit:

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

and that's the whole page, mwah πŸ’‹ this was the gnutls man page, version 3.8.13, for gnutls_x509_crt_list_import_pkcs11 β€” stay hydrated, read your docs, and go import some certs responsibly πŸ’…πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from