xref: /freebsd/crypto/openssl/doc/man3/SSL_session_reused.pod (revision c93b6e5fa24ba172ab271432c6692f9cc604e15a)
1=pod
2
3=head1 NAME
4
5SSL_session_reused - query whether a reused session was negotiated during handshake
6
7=head1 SYNOPSIS
8
9 #include <openssl/ssl.h>
10
11 int SSL_session_reused(const SSL *ssl);
12
13=head1 DESCRIPTION
14
15Query, whether a reused session was negotiated during the handshake.
16
17=head1 NOTES
18
19During the negotiation, a client can propose to reuse a session. The server
20then looks up the session in its cache. If both client and server agree
21on the session, it will be reused and a flag is being set that can be
22queried by the application.
23
24=head1 RETURN VALUES
25
26The following return values can occur:
27
28=over 4
29
30=item Z<>0
31
32A new session was negotiated.
33
34=item Z<>1
35
36A session was reused.
37
38=back
39
40=head1 SEE ALSO
41
42L<ssl(7)>, L<SSL_set_session(3)>,
43L<SSL_CTX_set_session_cache_mode(3)>
44
45=head1 COPYRIGHT
46
47Copyright 2001-2019 The OpenSSL Project Authors. All Rights Reserved.
48
49Licensed under the OpenSSL license (the "License").  You may not use
50this file except in compliance with the License.  You can obtain a copy
51in the file LICENSE in the source distribution or at
52L<https://www.openssl.org/source/license.html>.
53
54=cut
55