1gnutls_certificate_get_peers(3)     gnutls     gnutls_certificate_get_peers(3)
2
3
4

NAME

6       gnutls_certificate_get_peers - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       const  gnutls_datum_t  *  gnutls_certificate_get_peers(gnutls_session_t
12       session, unsigned int * list_size);
13

ARGUMENTS

15       gnutls_session_t          session
16                   is a gnutls session
17
18       unsigned int * list_size
19                   is the length of the certificate list (may be NULL)
20

DESCRIPTION

22       Get the peer's raw certificate (chain) as sent by the peer.  These cer‐
23       tificates  are  in  raw  format  (DER encoded for X.509).  In case of a
24       X.509 then a certificate list may be present.  The list is provided  as
25       sent  by  the  server; the server must send as first certificate in the
26       list its own certificate, following the issuer's certificate, then  the
27       issuer's  issuer  etc.  However,  there  are servers which violate this
28       principle and thus on certain occasions this may be an unsorted list.
29
30       In resumed sessions, this function will return the  peer's  certificate
31       list as used in the first/original session.
32

RETURNS

34       a  pointer  to  a gnutls_datum_t containing the peer's certificates, or
35       NULL in case of an error or if no certificate was used.
36

REPORTING BUGS

38       Report bugs to <bugs@gnutls.org>.
39       Home page: http://www.gnutls.org
40
41

43       Copyright © 2001-2018 Free Software Foundation, Inc., and others.
44       Copying and distribution of this file, with  or  without  modification,
45       are  permitted  in  any  medium  without royalty provided the copyright
46       notice and this notice are preserved.
47

SEE ALSO

49       The full documentation for gnutls is maintained as  a  Texinfo  manual.
50       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
51       visit
52
53       http://www.gnutls.org/manual/
54
55gnutls                               3.6.5     gnutls_certificate_get_peers(3)
Impressum