GNUTLS_X509_TRUST_LIST_ADD_TRUST_MEM(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_x509_trust_list_add_trust_mem — bestie edition 💖

okay so this is one of those gnutls pages, from the gnutls manual set — yes the whole gnutls_x509_tru...t_add_trust_mem(3) situation. anyway. sit down, hydrate, let's get into it 🫶

✨ NAME ✨

gnutls_x509_trust_list_add_trust_mem — literally an API function, that's the whole name, no notes 💅

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_trust_list_add_trust_list_add_trust_mem(gnutls_x509_trust_list_t list,
       const gnutls_datum_t * cas, const gnutls_datum_t * crls,
       gnutls_x509_crt_fmt_t type, unsigned int tl_flags, unsigned int
       tl_vflags);

wait no hold on — not that, my bad, it's this one, copy it exactly bestie:

#include <gnutls/x509.h>

int gnutls_x509_trust_list_add_trust_mem(gnutls_x509_trust_list_t list,
       const gnutls_datum_t * cas, const gnutls_datum_t * crls,
       gnutls_x509_crt_fmt_t type, unsigned int tl_flags, unsigned int
       tl_vflags);

🎀 ARGUMENTS 🎀

  • gnutls_x509_trust_list_t list — the list. the main character of this whole operation fr.
  • const gnutls_datum_t * cas — a buffer holding a list of CAs. it's optional btw, so you can pass nothing if you're feeling mysterious.
  • const gnutls_datum_t * crls — a buffer holding a list of CRLs. also optional. no pressure.
  • gnutls_x509_crt_fmt_t type — the format of the certificates. tell it what it's looking at, it's not psychic 😭
  • unsigned int tl_flags — flags, and they come from gnutls_trust_list_flags_t.
  • unsigned int tl_vflags — this is gnutls_certificate_verify_flags, and you only care about it if flags specifies GNUTLS_TL_VERIFY_CRL. iykyk.

🦋 DESCRIPTION 🦋

so this function will add the given certificate authorities to the trusted list. that's it, that's the vibe. you hand it CAs, it trusts them. slay ✨

⚠️ important, do not skip this: if this function is used, gnutls_x509_trust_list_deinit() must be called with parameter all being 1. not 0. 1. periodt. 💅

⭐ RETURNS ⭐

the number of added elements is returned. so like, it tells you how many friends it made. iconic.

🌈 SINCE 🌈

3.1 — ancient. vintage. a classic. 🎀

💜 REPORTING BUGS 💜

found a bug? not me manifesting that but okay. report bugs to <bugs@gnutls.org>.

home page: https://www.gnutls.org

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 bestie 🫶

🔥 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!! this was gnutls version 3.8.13, brought to you with love from your favorite terminal girlie. go forth and trust those CAs 💖🦋✨

📦 where this page comes from