Clarify warning

This commit is contained in:
Bodo Möller 2011-10-13 13:24:13 +00:00
parent f7d514f449
commit 8070cb5f87

View File

@ -39,10 +39,16 @@ for a description of the method's properties.
SSL_clear() resets the SSL object to allow for another connection. The SSL_clear() resets the SSL object to allow for another connection. The
reset operation however keeps several settings of the last sessions reset operation however keeps several settings of the last sessions
(some of these settings were made automatically during the last (some of these settings were made automatically during the last
handshake). It only makes sense when opening a new session (or reusing handshake). It only makes sense for a new connection with the exact
an old one) with the same peer that shares these settings. same peer that shares these settings, and may fail if that peer
SSL_clear() is not a short form for the sequence changes its settings between connections. Use the sequence
L<SSL_free(3)|SSL_free(3)>; L<SSL_new(3)|SSL_new(3)>; . L<SSL_get_session(3)|SSL_get_session(3)>;
L<SSL_new(3)|SSL_new(3)>;
L<SSL_set_session(3)|SSL_set_session(3)>;
L<SSL_free(3)|SSL_free(3)>
instead to avoid such failures
(or simply L<SSL_free(3)|SSL_free(3)>; L<SSL_new(3)|SSL_new(3)>
if session reuse is not desired).
=head1 RETURN VALUES =head1 RETURN VALUES