NAME    [Toc]    [Back]

       SSL_get_peer_cert_chain  -  Get the X509 certificate chain
       of the peer

SYNOPSIS    [Toc]    [Back]

       #include <openssl/ssl.h>

       STACKOF(X509) *SSL_get_peer_cert_chain(
               SSL *ssl );

DESCRIPTION    [Toc]    [Back]

       The SSL_get_peer_cert_chain() function returns  a  pointer
       to  STACKOF(X509)  certificates  forming  the  certificate
       chain of the peer. If called on the client side, the stack
       also  contains  the  peer's  certificate; if called on the
       server side, the peer's certificate must be obtained separately
  using  the SSL_get_peer_certificate() function. If
       the peer did not present a certificate, NULL is  returned.

NOTES    [Toc]    [Back]

       The  peer  certificate  chain is not necessarily available
       after reusing a session, in which case a NULL  pointer  is
       returned.

       The  reference  count  of  the STACKOF(X509) object is not
       incremented.  If the corresponding session is  freed,  the
       pointer must not be used.

RETURN VALUES    [Toc]    [Back]

       The  following return values can occur: No certificate was
       presented by the peer or no connection was established  or
       the  certificate  chain is no longer available when a session
 is reused.  The return value points to  the  certificate
 chain presented by the peer.

SEE ALSO    [Toc]    [Back]

       Functions: ssl(3), SSL_get_peer_certificate(3)



                                       SSL_get_peer_cert_chain(3)