Provided by: libssl-doc_1.0.2g-1ubuntu4.20_all bug

NAME
       SSL_get_peer_cert_chain - get the X509 certificate chain of the peer


SYNOPSIS
        #include <openssl/ssl.h>

        STACK_OF(X509) *SSL_get_peer_cert_chain(const SSL *ssl);


DESCRIPTION
       SSL_get_peer_cert_chain() returns a pointer to STACK_OF(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 SSL_get_peer_certificate(3).
       If the peer did not present a certificate, NULL is returned.


NOTES
       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 STACK_OF(X509) object is not incremented.  If the corresponding session is
       freed, the pointer must not be used any longer.


RETURN VALUES
       The following return values can occur:

       NULL
           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.

       Pointer to a STACK_OF(X509)
           The return value points to the certificate chain presented by the peer.


SEE ALSO
       ssl(3), SSL_get_peer_certificate(3)

1.0.2g                                             2016-03-01                      SSL_get_peer_cert_chain(3SSL)