4ed7e40a863be95ac7248bbe004c3f09bed2fd9e
[openssl.git] / doc / man3 / SSL_SESSION_get0_hostname.pod
1 =pod
2
3 =head1 NAME
4
5 SSL_SESSION_get0_hostname - retrieve the SNI hostname associated with a session
6
7 =head1 SYNOPSIS
8
9  #include <openssl/ssl.h>
10
11  const char *SSL_SESSION_get0_hostname(const SSL_SESSION *s);
12
13 =head1 DESCRIPTION
14
15 SSL_SESSION_get0_hostname() retrieves the SNI value that was sent by the
16 client when the session was created, or NULL if no value was sent.
17
18 The value returned is a pointer to memory maintained within B<s> and
19 should not be free'd.
20
21 =head1 SEE ALSO
22
23 L<ssl(7)>,
24 L<d2i_SSL_SESSION(3)>,
25 L<SSL_SESSION_get_time(3)>,
26 L<SSL_SESSION_free(3)>
27
28 =head1 COPYRIGHT
29
30 Copyright 2016 The OpenSSL Project Authors. All Rights Reserved.
31
32 Licensed under the OpenSSL license (the "License").  You may not use
33 this file except in compliance with the License.  You can obtain a copy
34 in the file LICENSE in the source distribution or at
35 L<https://www.openssl.org/source/license.html>.
36
37 =cut