gnutls_pkcs11_obj_get_exts(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

✨ NAME ✨

gnutls_pkcs11_obj_get_exts — it's an API function, bestie, and it's from the gnutls manual 💖

🌸 SYNOPSIS 🌸

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_obj_get_exts(gnutls_pkcs11_obj_t obj,
gnutls_x509_ext_st ** exts, unsigned int * exts_size, unsigned int
flags);

🎀 ARGUMENTS 🎀

  • gnutls_pkcs11_obj_t obj — okay so this one should contain a gnutls_pkcs11_obj_t type. That's the vibe. 👑
  • gnutls_x509_ext_st ** exts — a pointer to a gnutls_x509_ext_st pointer. yes, a pointer to a pointer, we love a little inception moment 🌀
  • unsigned int * exts_size — will be updated with the number of exts. she's getting updated, not just read, iykyk 💅
  • unsigned int flags — an Or sequence of GNUTLS_PKCS11_OBJ_* flags. mix and match, it's giving build your own adventure ✨

🦋 DESCRIPTION 🦋

So this function will return information about attached extensions that associate to the provided object — and like, that object should be a certificate, okay? no cap. 📜

The extensions in question are the attached p11-kit trust module extensions. that's the whole thing. that's the tea. 🍵

⚠️ cleanup era, do NOT skip this: each element of exts must be deinitialized using gnutls_x509_ext_deinit(), while exts itself should be deallocated using gnutls_free(). two different cleanup calls, bestie. don't mix them up. 😭

🌈 RETURNS 🌈

GNUTLS_E_SUCCESS (0) on success — slay 💖 — or a negative error code on error. sad girl hours but make it a return value. 💀

⭐ SINCE ⭐

3.3.8 — she's been iconic since way back 🫶

💜 REPORTING BUGS 💜

Found a bug? not me being the bearer of bad news but you gotta tell them:

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, this is the permissive queen behaviour we stan.) 🎀

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

and that's the whole page, bestie 💅 this was written for gnutls 3.8.13, and it's literally the gnutls_pkcs11_obj_get_exts(3) page in the gnutls manual — periodt. 🦋✨

📦 where this page comes from