From: bazmoz Date: Sun, 27 Dec 2020 16:35:14 +0000 (+0530) Subject: Updated SSL_CTX_new doc X-Git-Tag: openssl-3.0.0-alpha10~6 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3497cc8776d50397ceefbd41bd3356a7f5d30c14;p=thirdparty%2Fopenssl.git Updated SSL_CTX_new doc Fixes #13703 Reviewed-by: Ben Kaduk Reviewed-by: Matt Caswell (Merged from https://github.com/openssl/openssl/pull/13741) --- diff --git a/doc/man3/SSL_CTX_new.pod b/doc/man3/SSL_CTX_new.pod index b71cda9be09..4093e657e80 100644 --- a/doc/man3/SSL_CTX_new.pod +++ b/doc/man3/SSL_CTX_new.pod @@ -73,11 +73,12 @@ functions =head1 DESCRIPTION -SSL_CTX_new_ex() creates a new B object as a framework to -establish TLS/SSL or DTLS enabled connections using the library context -I (see L). Any cryptographic algorithms that are used -by any B objects created from this B will be fetched from the -I using the property query string I (see +SSL_CTX_new_ex() creates a new B object, which holds various +configuration and data relevant to TLS/SSL or DTLS session establishment. The +library context I (see L) is used to provide the +cryptographic algorithms needed for the session. Any cryptographic algorithms +that are used by any B objects created from this B will be fetched +from the I using the property query string I (see L. Either or both the I or I parameters may be NULL. @@ -90,6 +91,10 @@ SSL_CTX_free) decrements it. When the reference count drops to zero, any memory or resources allocated to the B object are freed. SSL_CTX_up_ref() increments the reference count for an existing B structure. +An B object should not be changed after it is used to create any B +objects or from multiple threads concurrently, since the implementation does not +provide serialization of access for these cases. + =head1 NOTES The SSL_CTX object uses I as the connection method.