Update SSL_CTX_sess_set_new_cb(3) docs for refcounts
authorBenjamin Kaduk <bkaduk@akamai.com>
Wed, 15 Jan 2020 00:22:52 +0000 (16:22 -0800)
committerBen Kaduk <kaduk@mit.edu>
Thu, 16 Jan 2020 21:41:50 +0000 (13:41 -0800)
commit017015ceecaf2b4464aeeeb9a051dbe91d17f6e2
treefd87b3f102c292a7cb0582e63d57b0b064d35e08
parent56c59ddd99da05c2f30832cccaffb873a8481555
Update SSL_CTX_sess_set_new_cb(3) docs for refcounts

The existing documentation for the new-session callback was unclear
about the requirements on the callback with respect to reference-handling
of the session object being created.  Be more explicit about the
(non-)requirements on the callback code for "success" (1) and "ignore"
(0) return values.

Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/10848)

(cherry picked from commit 188d4ec82a9b0085ac5841cce3eda95efb94f2b4)
doc/man3/SSL_CTX_sess_set_get_cb.pod