1gnutls_x509_trust_list_set_getigsnsuutelrs_g_fnxuu5nt0cl9ts_itornu(s3t)_list_set_getissuer_function(3)
2
3
4

NAME

6       gnutls_x509_trust_list_set_getissuer_function - API function
7

SYNOPSIS

9       #include <gnutls/x509.h>
10
11       void                         gnutls_x509_trust_list_set_getissuer_func‐
12       tion(gnutls_x509_trust_list_t   tlist,    gnutls_x509_trust_list_getis‐
13       suer_function * func);
14

ARGUMENTS

16       gnutls_x509_trust_list_t tlist
17                   is a gnutls_x509_trust_list_t type.
18
19       gnutls_x509_trust_list_getissuer_function * func
20                   is the callback function
21

DESCRIPTION

23       This  function sets a callback to be called when the peer's certificate
24       chain is incomplete due a missing intermediate certificate.  The  call‐
25       back may provide the missing certificate for use during verification.
26
27       The callback's function prototype is defined in gnutls/x509.h as:
28
29       int  (*callback)(gnutls_x509_trust_list_t list, const gnutls_x509_crt_t
30       cert, gnutls_x509_crt_t **issuers, unsigned int *issuers_size);
31
32       If the callback function is provided then gnutls will  call  it  during
33       the  certificate  verification  procedure. The callback may wish to use
34       gnutls_x509_crt_get_authority_info_access() to get a URI from which  to
35       attempt to download the missing issuer certificate, if available.
36
37       On  a  successful call, the callback shall allocate the 'issuers' array
38       with gnutls_x509_crt_list_import2(). The ownership of  both  the  array
39       and  the elements is transferred to the caller and thus the application
40       does not need to maintain the memory after the call.
41
42       The callback function should return 0 if the missing issuer certificate
43       for  'crt'  was  properly  populated  and  added  to  the 'issuers', or
44       non-zero to continue the certificate list verification but with  issuer
45       as NULL.
46

SINCE

48       3.7.0
49

REPORTING BUGS

51       Report bugs to <bugs@gnutls.org>.
52       Home page: https://www.gnutls.org
53
54

56       Copyright © 2001- Free Software Foundation, Inc., and others.
57       Copying  and  distribution  of this file, with or without modification,
58       are permitted in any medium without royalty provided the copyright  no‐
59       tice and this notice are preserved.
60

SEE ALSO

62       The  full  documentation  for gnutls is maintained as a Texinfo manual.
63       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
64       visit
65
66       https://www.gnutls.org/manual/
67
68gnutls                        gnutls_3x.570.98_trust_list_set_getissuer_function(3)
Impressum