DragonFly On-Line Manual Pages

Search: Section:  

gnutls_x509_trust_list_set_getissuer_function(3)                        gnutls


NAME

       gnutls_x509_trust_list_set_getissuer_function - API function


SYNOPSIS

       #include <gnutls/x509.h>

       void
       gnutls_x509_trust_list_set_getissuer_function(gnutls_x509_trust_list_t
       tlist, gnutls_x509_trust_list_getissuer_function * func);


ARGUMENTS

       gnutls_x509_trust_list_t tlist
                   is a gnutls_x509_trust_list_t type.

       gnutls_x509_trust_list_getissuer_function * func
                   is the callback function


DESCRIPTION

       This function sets a callback to be called when the peer's certificate
       chain is incomplete due a missing intermediate certificate. The
       callback may provide the missing certificate for use during
       verification.

       The callback's function prototype is defined in gnutls/x509.h as:

       int (*callback)(gnutls_x509_trust_list_t list, const gnutls_x509_crt_t
       cert, gnutls_x509_crt_t **issuers, unsigned int *issuers_size);

       If the callback function is provided then gnutls will call it during
       the certificate verification procedure. The callback may wish to use
       gnutls_x509_crt_get_authority_info_access() to get a URI from which to
       attempt to download the missing issuer certificate, if available.

       On a successful call, the callback shall allocate the 'issuers' array
       with gnutls_x509_crt_list_import2(). The ownership of both the array
       and the elements is transferred to the caller and thus the application
       does not need to maintain the memory after the call.

       The callback function should return 0 if the missing issuer certificate
       for 'crt' was properly populated and added to the 'issuers', or
       non-zero to continue the certificate list verification but with issuer
       as NULL.


SINCE

       3.7.0


REPORTING BUGS

       Report bugs to <bugs@gnutls.org>.
       Home page: https://www.gnutls.org


COPYRIGHT

       Copyright (C) 2001- 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

       The full documentation for gnutls is maintained as a Texinfo manual.
       If the /usr/local/share/doc/gnutls/ directory does not contain the HTML
       form visit

       https://www.gnutls.org/manual/

gnutls                               3.7.9
                              gnutls_x509_trust_list_set_getissuer_function(3)

Search: Section: