xref: /minix3/crypto/external/bsd/openssl/dist/doc/ssl/SSL_session_reused.pod (revision 0a6a1f1d05b60e214de2f05a7310ddd1f0e590e7)
1ebfedea0SLionel Sambuc=pod
2ebfedea0SLionel Sambuc
3ebfedea0SLionel Sambuc=head1 NAME
4ebfedea0SLionel Sambuc
5ebfedea0SLionel SambucSSL_session_reused - query whether a reused session was negotiated during handshake
6ebfedea0SLionel Sambuc
7ebfedea0SLionel Sambuc=head1 SYNOPSIS
8ebfedea0SLionel Sambuc
9ebfedea0SLionel Sambuc #include <openssl/ssl.h>
10ebfedea0SLionel Sambuc
11ebfedea0SLionel Sambuc int SSL_session_reused(SSL *ssl);
12ebfedea0SLionel Sambuc
13ebfedea0SLionel Sambuc=head1 DESCRIPTION
14ebfedea0SLionel Sambuc
15ebfedea0SLionel SambucQuery, whether a reused session was negotiated during the handshake.
16ebfedea0SLionel Sambuc
17ebfedea0SLionel Sambuc=head1 NOTES
18ebfedea0SLionel Sambuc
19ebfedea0SLionel SambucDuring the negotiation, a client can propose to reuse a session. The server
20ebfedea0SLionel Sambucthen looks up the session in its cache. If both client and server agree
21ebfedea0SLionel Sambucon the session, it will be reused and a flag is being set that can be
22ebfedea0SLionel Sambucqueried by the application.
23ebfedea0SLionel Sambuc
24ebfedea0SLionel Sambuc=head1 RETURN VALUES
25ebfedea0SLionel Sambuc
26ebfedea0SLionel SambucThe following return values can occur:
27ebfedea0SLionel Sambuc
28ebfedea0SLionel Sambuc=over 4
29ebfedea0SLionel Sambuc
30*0a6a1f1dSLionel Sambuc=item Z<>0
31ebfedea0SLionel Sambuc
32ebfedea0SLionel SambucA new session was negotiated.
33ebfedea0SLionel Sambuc
34*0a6a1f1dSLionel Sambuc=item Z<>1
35ebfedea0SLionel Sambuc
36ebfedea0SLionel SambucA session was reused.
37ebfedea0SLionel Sambuc
38ebfedea0SLionel Sambuc=back
39ebfedea0SLionel Sambuc
40ebfedea0SLionel Sambuc=head1 SEE ALSO
41ebfedea0SLionel Sambuc
42ebfedea0SLionel SambucL<ssl(3)|ssl(3)>, L<SSL_set_session(3)|SSL_set_session(3)>,
43ebfedea0SLionel SambucL<SSL_CTX_set_session_cache_mode(3)|SSL_CTX_set_session_cache_mode(3)>
44ebfedea0SLionel Sambuc
45ebfedea0SLionel Sambuc=cut
46