From 2448bb8cf71b383d39433f8af891232c60392868 Mon Sep 17 00:00:00 2001 From: Matt Caswell Date: Tue, 8 May 2018 16:28:44 +0100 Subject: [PATCH] Document when a new session ticket gets created on resumption Reviewed-by: Viktor Dukhovni (Merged from https://github.com/openssl/openssl/pull/6198) --- doc/man3/SSL_CTX_set_session_ticket_cb.pod | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/man3/SSL_CTX_set_session_ticket_cb.pod b/doc/man3/SSL_CTX_set_session_ticket_cb.pod index c7b51dd16b..3066534223 100644 --- a/doc/man3/SSL_CTX_set_session_ticket_cb.pod +++ b/doc/man3/SSL_CTX_set_session_ticket_cb.pod @@ -77,6 +77,12 @@ the key that was used to encrypt the session ticket. When the B callback is invoked, the SSL_get_session() function can be used to retrieve the SSL_SESSION for SSL_SESSION_set1_ticket_appdata(). +By default, in TLSv1.2 and below, a new session ticket is not issued on a +successful resumption and therefore B will not be called. In TLSv1.3 the +default behaviour is to always issue a new ticket on resumption. In both cases +this behaviour can be changed if a ticket key callback is in use (see +L). + =head1 RETURN VALUES The SSL_CTX_set_session_ticket_cb(), SSL_SESSION_set1_ticket_appdata() and -- 2.25.1