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 © 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/share/doc/gnutls/
       directory does not contain the HTML form visit

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

gnutls                                                3.7.3     gnutls_x509_trust_list_set_getissuer_function(3)