]> git.ipfire.org Git - thirdparty/openssl.git/commit
Additional updates to SSL_CTX_sess_set_get_cb.pod
authorBenjamin Kaduk <bkaduk@akamai.com>
Thu, 16 Jan 2020 22:37:44 +0000 (14:37 -0800)
committerBenjamin Kaduk <kaduk@mit.edu>
Fri, 13 Mar 2020 22:55:49 +0000 (15:55 -0700)
commitd3133cc77cd0b052b6792d3e1edb9e5a202c6695
treee3cff396db046bc701388bb94e48cd5d580e38bf
parent9011225188e0779833617516bdd76ab122fe2509
Additional updates to SSL_CTX_sess_set_get_cb.pod

Generally modernize the language.

Refer to TLS instead of SSL/TLS, and try to have more consistent
usage of commas and that/which.

Reword some descriptions to avoid implying that a list of potential
reasons for behavior is an exhaustive list.

Clarify how get_session_cb() is only called on servers (i.e., in general,
and that it's given the session ID proposed by the client).

Clarify the semantics of the get_cb()'s "copy" argument.
The behavior seems to have changed in commit
8876bc054802b043a3ec95554b6c5873291770be, though the behavior prior
to that commit was not to leave the reference-count unchanged if
*copy was not written to -- instead, libssl seemed to assume that the
callback already had incremented the reference count.

Reviewed-by: Tomas Mraz <tmraz@fedoraproject.org>
(Merged from https://github.com/openssl/openssl/pull/10943)

(cherry picked from commit 06f876837a8ec76b28c42953731a156c0c3700e2)
doc/man3/SSL_CTX_sess_set_get_cb.pod