GNUTLS_CERTIFICATE_SET_X509_TRUST(3)

💖 gnutls_certificate_set_x509_trust — like, the whole vibe ✨

okay bestie, so this is a page from the gnutls manual (that's the manual name, she's iconic, she's the whole TLS library) and we're about to get SO cozy with one specific function. buckle up 🎀

---

🌸 NAME 🌸

gnutls_certificate_set_x509_trust — it's an API function, no cap 💅

---

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

int gnutls_certificate_set_x509_trust(gnutls_certificate_credentials_t
res, gnutls_x509_crt_t * ca_list, int ca_list_size);

---

🦋 ARGUMENTS 🦋

• gnutls_certificate_credentials_t res — bestie this is a gnutls_certificate_credentials_t type, that's literally what it is 💜
• gnutls_x509_crt_t * ca_list — a list of trusted CAs, the little squad of certificate authorities you're trusting 👑
• int ca_list_size — holds the size of the CA list, i.e. how many besties are in that squad 🫶

---

💅 DESCRIPTION 💅

so here's the tea: this function adds the trusted CAs in order to verify client or server certificates. like, that's the whole job. 🌈

in case of a client, this is not required to be called if the certificates are not verified using gnutls_certificate_verify_peers2(). so if you're not doing the peer-verifying thing, you can just... not. we love a low-effort moment 💀

and this function may be called multiple times. she's not a one-and-done situation, she's a "come back whenever, babe" situation ✨

in case of a server, the CAs set here will be sent to the client if a certificate request is sent. if you don't want that — like, you're feeling shy — this can be disabled using gnutls_certificate_send_x509_rdn_sequence(). 🙈

---

🎀 RETURNS 🎀

the number of certificates processed — or a negative error code on error 😭 (not the slay ending we wanted, but okay)

---

⭐ SINCE ⭐

2.4.0 — an OG, she's been here since 2.4.0, respect the elders 👑

---

🐛 REPORTING BUGS 🐛

found a bug? not me manifesting that, but if it happens, report bugs to <bugs@gnutls.org>. 📧

home page: https://www.gnutls.org — go say hi, she's lovely 🌸

---

💜 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. fr fr, that's the license, and it's giving generous ✨

---

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

that's the link bestie, go read the whole saga 📖

---

and that's the page!! 🫶 from the gnutls manual, version 3.8.13, gnutls_certificate_set_x509_trust(3) — mwah, periodt 💖✨🎀