SSL_get_peer_cert_chain(3)

SSL_get_peer_cert_chain(3)   OpenSSL   SSL_get_peer_cert_chain(3)

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.2t               Last change: 2019-09-10                    1