1gnutls_x509_trust_list_iter_get_ca(3)gnutlsgnutls_x509_trust_list_iter_get_ca(3)
2
3
4

NAME

6       gnutls_x509_trust_list_iter_get_ca - API function
7

SYNOPSIS

9       #include <gnutls/x509.h>
10
11       int  gnutls_x509_trust_list_iter_get_ca(gnutls_x509_trust_list_t  list,
12       gnutls_x509_trust_list_iter_t * iter, gnutls_x509_crt_t * crt);
13

ARGUMENTS

15       gnutls_x509_trust_list_t list
16                   The list
17
18       gnutls_x509_trust_list_iter_t * iter
19                   A pointer to an iterator (initially the iterator should  be
20                   NULL)
21
22       gnutls_x509_crt_t * crt
23                   where the certificate will be copied
24

DESCRIPTION

26       This  function obtains a certificate in the trust list and advances the
27       iterator to the next certificate. The certificate returned in  crt must
28       be deallocated with gnutls_x509_crt_deinit().
29
30       When    past    the    last    element    is    accessed   GNUTLS_E_RE‐
31       QUESTED_DATA_NOT_AVAILABLE is returned and the iterator is reset.
32
33       The iterator is deinitialized and reset to NULL automatically  by  this
34       function  after  iterating  through  all  elements  until  GNUTLS_E_RE‐
35       QUESTED_DATA_NOT_AVAILABLE is returned. If  the  iteration  is  aborted
36       early,      it     must     be     manually     deinitialized     using
37       gnutls_x509_trust_list_iter_deinit().
38

RETURNS

40       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative  er‐
41       ror value.
42

SINCE

44       3.4.0
45

REPORTING BUGS

47       Report bugs to <bugs@gnutls.org>.
48       Home page: https://www.gnutls.org
49
50

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

SEE ALSO

58       The  full  documentation  for gnutls is maintained as a Texinfo manual.
59       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
60       visit
61
62       https://www.gnutls.org/manual/
63
64gnutls                               3.8.2gnutls_x509_trust_list_iter_get_ca(3)
Impressum