gnutls_x509_tr...erify_named_crt(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_verify_named_crt 💖

okay so bestie, welcome to the gnutls manual — yes, the gnutls, the manual you're holding right now. This page is gnutls_x509_tr...erify_named_crt(3), and it's literally just about one little function: gnutls_x509_trust_list_verify_named_crt. Let's get into it 🫶

✨ NAME ✨

gnutls_x509_trust_list_verify_named_crt — API function

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_trust_list_verify_named_crt(gnutls_x509_trust_list_t
list, gnutls_x509_crt_t cert, const void * name, size_t name_size,
unsigned int flags, unsigned int * voutput,
gnutls_verify_output_function func);

🎀 ARGUMENTS 🎀

  • gnutls_x509_trust_list_t list — The list. your lil roster of trust, the squad, the guest list at the door 💅
  • gnutls_x509_crt_t cert — is the certificate to be verified. this is the one we're putting under the microscope, no cap 🔍
  • const void * name — is the certificate's name. the name we're matching against, bestie
  • size_t name_size — is the certificate's name size. how big that name is, in bytes, pls don't get it wrong 🙈
  • unsigned int flags — Flags that may be used to change the verification algorithm. Use OR of the gnutls_certificate_verify_flags enumerations. mix and match with OR, it's giving custom vibe check ✨
  • unsigned int * voutput — will hold the certificate verification output. the receipts go here 📝
  • gnutls_verify_output_function func — If non-null will be called on each chain element verification with the output. so like, a little callback that gets pinged for every link in the chain, okay?? 👑

🦋 DESCRIPTION 🦋

This function will try to find a certificate that is associated with the provided name --see gnutls_x509_trust_list_add_named_crt(). If a match is found the certificate is considered valid. Periodt. 💯

In addition to that this function will also check CRLs. Not me doing the extra credit, but yes, we do check those. 😌

The voutput parameter will hold an OR'ed sequence of gnutls_certificate_status_t flags.

Additionally a certificate verification profile can be specified from the ones in gnutls_certificate_verification_profiles_t by ORing the result of GNUTLS_PROFILE_TO_VFLAGS() to the verification flags. slay, custom profiles, we love to see it 🌈

⭐ RETURNS ⭐

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. so like, zero is the good ending, anything negative is the plot twist 😭

🧚 SINCE 🧚

3.0.0 — she's been iconic since day one, fr fr 💜

💀 REPORTING BUGS 💀

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. (translation: take it, share it, remix it — just keep the copyright notice and this notice, bestie, that's the whole deal 🫶)

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

okay that's the whole page!! you ate that 💅✨ this was gnutls version 3.8.13, page gnutls_x509_tr...erify_named_crt(3) — mwah, go verify something cute 💖🌸🦋

📦 where this page comes from