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