gnutls_x509_trust_list_verify_named_crt(3) — Linux manual page


gnutls_x509_...ify_named_crt(3)  gnutls  gnutls_x509_...ify_named_crt(3)

NAME         top

       gnutls_x509_trust_list_verify_named_crt - API function

SYNOPSIS         top

       #include <gnutls/x509.h>

       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         top

       gnutls_x509_trust_list_t list
                   The list

       gnutls_x509_crt_t cert
                   is the certificate to be verified

       const void * name
                   is the certificate's name

       size_t name_size
                   is the certificate's name size

       unsigned int flags
                   Flags that may be used to change the verification
                   algorithm. Use OR of the
                   gnutls_certificate_verify_flags enumerations.

       unsigned int * voutput
                   will hold the certificate verification output.

       gnutls_verify_output_function func
                   If non-null will be called on each chain element
                   verification with the output.

DESCRIPTION         top

       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. In addition to that this
       function will also check CRLs. 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.

RETURNS         top

       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a
       negative error value.

SINCE         top


REPORTING BUGS         top

       Report bugs to <>.
       Home page:

COPYRIGHT         top

       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.

SEE ALSO         top

       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

COLOPHON         top

       This page is part of the GnuTLS (GnuTLS Transport Layer Security
       Library) project.  Information about the project can be found at
       ⟨⟩.  If you have a bug report for this
       manual page, send it to  This page was obtained
       from the tarball gnutls-3.8.2.tar.xz fetched from
       ⟨⟩ on 2023-12-22.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to

gnutls                            3.8.2  gnutls_x509_...ify_named_crt(3)