GNUTLS_CERTIFICATE_GET_TRUST_LIST(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_certificate_get_trust_list — the get me the trust list girly 💖

okay bestie, welcome to the gnutls manual, you're gonna eat this up fr fr. this one's about gnutls_certificate_get_trust_list, an API function, and it's giving "quiet little helper that does exactly one thing and does it flawlessly." no cap. 🎀

✨ SYNOPSIS ✨

#include <gnutls/x509.h>

void gnutls_certificate_get_trust_list(gnutls_certificate_credentials_t
res, gnutls_x509_trust_list_t * tlist);

like, that's the whole entrance. two args, one void, zero drama. she's lowkey iconic for that. 💅

🌸 ARGUMENTS 🌸

  • gnutls_certificate_credentials_t res — this is your gnutls_certificate_credentials_t type, aka the credentials baddie that's holding all the trust energy. she's the main character here.
  • gnutls_x509_trust_list_t * tlist — the spot where you're gonna store the trust list. that's the location, bestie. she's just a pointer, ready to receive. 🫶

💫 DESCRIPTION 💫

so what does she actually do? she obtains the list of trusted certificates that's stored inside res, and then writes a pointer to it over at the location tlist. simple. clean. slay. ✨

but here's the part you gotta remember, and I mean it: that pointer points to memory that is internal to res. so you must not deinitialize it. do not touch. do not free. do not pass go. 🙈 it's not yours, it's hers.

and the good news? she handles cleanup herself. that memory gets automatically deallocated when the res structure is deinitialized. so you literally do not have to worry about it — just don't get handsy with it. periodt. 💀

fr fr: internal memory = look but don't deinit. that's the whole vibe check. 🦋

⭐ SINCE ⭐

3.4.0 — she's been here since 3.4.0, an absolute veteran, a legend, the blueprint. 👑

🐛 REPORTING BUGS 🐛

found a bug? spill the tea to <bugs@gnutls.org>.

home page is right here: https://www.gnutls.org — go visit her, she's lovely. 🌈

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 bestie, share the love, 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 go visit:

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

that's your backup plan, she's got you. 💖

and that's a wrap on this page, gorgeous. this manual came to you courtesy of gnutls 3.8.13 — go forth and never deinitialize that pointer, okay? mwah. 💅🎀✨

📦 where this page comes from