GNUTLS_X509_TRUST_LIST_VERIFY_CRT(3)

✨ NAME ✨

gnutls_x509_trust_list_verify_crt β€” bestie, it's the API function that checks whether your cert is actually valid πŸ’…

This one lives in the gnutls manual, section 3, and honestly? she's kind of a big deal.


πŸŽ€ SYNOPSIS πŸŽ€

#include <gnutls/x509.h>

int gnutls_x509_trust_list_verify_crt(gnutls_x509_trust_list_t list,
gnutls_x509_crt_t * cert_list, unsigned int cert_list_size, unsigned int
flags, unsigned int * voutput, gnutls_verify_output_function func);

okay so that's the whole signature, no notes, iconic πŸ’–


🌸 ARGUMENTS 🌸

  • gnutls_x509_trust_list_t list β€” literally just the list. the trust list. that's her 🫢
  • gnutls_x509_crt_t * cert_list β€” the certificate list that's getting verified, bestie. this is the whole point ✨
  • unsigned int cert_list_size β€” the size of that certificate list. yes queen, tell me how many πŸ“
  • unsigned int flags β€” flags that may be used to change the verification algorithm. you use the OR of the gnutls_certificate_verify_flags enumerations. so like, smash them together with | πŸ’…
  • unsigned int * voutput β€” this lil pointer will hold the certificate verification output. she's an out-param, she's doing her job 😌
  • gnutls_verify_output_function func β€” if this is non-null, it'll get called on each chain element verification with the output. a callback! main character energy fr fr πŸ‘‘

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so this function will try to verify the given certificate and return its status. simple as that πŸ’–

the voutput parameter will hold an OR'ed sequence of gnutls_certificate_status_t flags β€” so it's like a little mood board of everything that went down during verification 🌈

the details of the verification are the same as in gnutls_x509_trust_list_verify_crt2(). so if you want the deep lore, that's where it lives, iykyk ✨


⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (0) is returned πŸŽ‰ otherwise you get a negative error value, which is giving "not today bestie" 😭


🌈 SINCE 🌈

3.0 β€” she's been around since 3.0, an absolute elder stateswoman of the API, we stan a legacy queen πŸ‘‘


πŸ™ˆ REPORTING BUGS πŸ™ˆ

found something cursed? report bugs to <bugs@gnutls.org> πŸ“§

home page: https://www.gnutls.org β€” go say hi 🫢


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 like, you can absolutely share this around, just keep the receipts, no cap πŸ’…


πŸ”₯ 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/

ngl the fastest way to actually get this function is to read gnutls_x509_trust_list_verify_crt2() too, since the details are literally the same. obsessed with the consistency fr fr ✨

and that's the whole page, bestie β€” gnutls 3.8.13, dated gnutls_x509_trust_list_verify_crt(3), mwah πŸ’‹ thanks for reading, go verify some certs, slay πŸŽ€

πŸ“¦ where this page comes from