Commit 0abb903b authored by Matt Caswell's avatar Matt Caswell
Browse files

Document when a session gets removed from cache 



Document the fact that if a session is not closed down cleanly then the
session gets removed from the cache and marked as non-resumable.

Fixes #4720

Reviewed-by: default avatarRich Salz <rsalz@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/6054)
parent 5791a917

doc/ssl/SSL_get_session.pod

+5 −0
Original line number Diff line number Diff line
@@ -28,6 +28,11 @@ count of the B<SSL_SESSION> is incremented by one. 
The ssl session contains all information required to re-establish the

connection without a new handshake.



A session will be automatically removed from the session cache and marked as

non-resumable if the connection is not closed down cleanly, e.g. if a fatal

error occurs on the connection or L<SSL_shutdown(3)> is not called prior to

L<SSL_free(3)>.



SSL_get0_session() returns a pointer to the actual session. As the

reference counter is not incremented, the pointer is only valid while

the connection is in use. If L<SSL_clear(3)> or