SSL_get_peer_cert_chain.pod revision 76866
168651Skris=pod 268651Skris 368651Skris=head1 NAME 468651Skris 568651SkrisSSL_get_peer_cert_chain - get the X509 certificate chain of the peer 668651Skris 768651Skris=head1 SYNOPSIS 868651Skris 968651Skris #include <openssl/ssl.h> 1068651Skris 1168651Skris STACKOF(X509) *SSL_get_peer_cert_chain(SSL *ssl); 1268651Skris 1368651Skris=head1 DESCRIPTION 1468651Skris 1568651SkrisSSL_get_peer_cert_chain() returns a pointer to STACKOF(X509) certificates 1668651Skrisforming the certificate chain of the peer. If called on the client side, 1768651Skristhe stack also contains the peer's certificate; if called on the server 1876866Skrisside, the peer's certificate must be obtained separately using 1968651SkrisL<SSL_get_peer_certificate(3)|SSL_get_peer_certificate(3)>. 2068651SkrisIf the peer did not present a certificate, NULL is returned. 2168651Skris 2268651Skris=head1 NOTES 2368651Skris 2468651SkrisThe peer certificate chain is not necessarily available after reusing 2568651Skrisa session, in which case a NULL pointer is returned. 2668651Skris 2768651SkrisThe reference count of the STACKOF(X509) object is not incremented. 2868651SkrisIf the corresponding session is freed, the pointer must not be used 2968651Skrisany longer. 3068651Skris 3168651Skris=head1 RETURN VALUES 3268651Skris 3368651SkrisThe following return values can occur: 3468651Skris 3568651Skris=over 4 3668651Skris 3768651Skris=item NULL 3868651Skris 3968651SkrisNo certificate was presented by the peer or no connection was established 4068651Skrisor the certificate chain is no longer available when a session is reused. 4168651Skris 4268651Skris=item Pointer to a STACKOF(X509) 4368651Skris 4468651SkrisThe return value points to the certificate chain presented by the peer. 4568651Skris 4668651Skris=back 4768651Skris 4868651Skris=head1 SEE ALSO 4968651Skris 5068651SkrisL<ssl(3)|ssl(3)>, L<SSL_get_peer_certificate(3)|SSL_get_peer_certificate(3)> 5168651Skris 5268651Skris=cut 53