xref: /freebsd/crypto/openssl/doc/man3/SSL_SESSION_get0_peer.pod (revision a03411e84728e9b267056fd31c7d1d9d1dc1b01e)
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 Apache License 2.0 (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