xref: /freebsd/crypto/openssl/doc/man3/SSL_SESSION_get0_peer.pod (revision b077aed33b7b6aefca7b17ddb250cf521f938613)
1e71b7053SJung-uk Kim=pod
2e71b7053SJung-uk Kim
3e71b7053SJung-uk Kim=head1 NAME
4e71b7053SJung-uk Kim
5e71b7053SJung-uk KimSSL_SESSION_get0_peer
6e71b7053SJung-uk Kim- get details about peer's certificate for a session
7e71b7053SJung-uk Kim
8e71b7053SJung-uk Kim=head1 SYNOPSIS
9e71b7053SJung-uk Kim
10e71b7053SJung-uk Kim #include <openssl/ssl.h>
11e71b7053SJung-uk Kim
12e71b7053SJung-uk Kim X509 *SSL_SESSION_get0_peer(SSL_SESSION *s);
13e71b7053SJung-uk Kim
14e71b7053SJung-uk Kim=head1 DESCRIPTION
15e71b7053SJung-uk Kim
16e71b7053SJung-uk KimSSL_SESSION_get0_peer() returns the peer certificate associated with the session
17e71b7053SJung-uk KimB<s> or NULL if no peer certificate is available. The caller should not free the
18e71b7053SJung-uk Kimreturned value (unless L<X509_up_ref(3)> has also been called).
19e71b7053SJung-uk Kim
20e71b7053SJung-uk Kim=head1 RETURN VALUES
21e71b7053SJung-uk Kim
22e71b7053SJung-uk KimSSL_SESSION_get0_peer() returns a pointer to the peer certificate or NULL if
23e71b7053SJung-uk Kimno peer certificate is available.
24e71b7053SJung-uk Kim
25e71b7053SJung-uk Kim=head1 SEE ALSO
26e71b7053SJung-uk Kim
27e71b7053SJung-uk KimL<ssl(7)>
28e71b7053SJung-uk Kim
29e71b7053SJung-uk Kim=head1 COPYRIGHT
30e71b7053SJung-uk Kim
31e71b7053SJung-uk KimCopyright 2017 The OpenSSL Project Authors. All Rights Reserved.
32e71b7053SJung-uk Kim
33*b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License").  You may not use
34e71b7053SJung-uk Kimthis file except in compliance with the License.  You can obtain a copy
35e71b7053SJung-uk Kimin the file LICENSE in the source distribution or at
36e71b7053SJung-uk KimL<https://www.openssl.org/source/license.html>.
37e71b7053SJung-uk Kim
38e71b7053SJung-uk Kim=cut
39