From 084adb601f2d375395c6cdcedf8af91f1065fe4e Mon Sep 17 00:00:00 2001 From: Rob Austein Date: Mon, 9 Oct 2006 16:22:20 +0000 Subject: Feh, wrong vendor branch merge proceedure, clean up before trying again. svn path=/openssl/vendor/0.9.8d; revision=374 --- openssl/vendor/0.9.8d/doc/ssl/SSL_get_session.pod | 73 ----------------------- 1 file changed, 73 deletions(-) delete mode 100644 openssl/vendor/0.9.8d/doc/ssl/SSL_get_session.pod (limited to 'openssl/vendor/0.9.8d/doc/ssl/SSL_get_session.pod') diff --git a/openssl/vendor/0.9.8d/doc/ssl/SSL_get_session.pod b/openssl/vendor/0.9.8d/doc/ssl/SSL_get_session.pod deleted file mode 100644 index 0c41caa9..00000000 --- a/openssl/vendor/0.9.8d/doc/ssl/SSL_get_session.pod +++ /dev/null @@ -1,73 +0,0 @@ -=pod - -=head1 NAME - -SSL_get_session - retrieve TLS/SSL session data - -=head1 SYNOPSIS - - #include - - SSL_SESSION *SSL_get_session(const SSL *ssl); - SSL_SESSION *SSL_get0_session(const SSL *ssl); - SSL_SESSION *SSL_get1_session(SSL *ssl); - -=head1 DESCRIPTION - -SSL_get_session() returns a pointer to the B actually used in -B. The reference count of the B is not incremented, so -that the pointer can become invalid by other operations. - -SSL_get0_session() is the same as SSL_get_session(). - -SSL_get1_session() is the same as SSL_get_session(), but the reference -count of the B is incremented by one. - -=head1 NOTES - -The ssl session contains all information required to re-establish the -connection without a new handshake. - -SSL_get0_session() returns a pointer to the actual session. As the -reference counter is not incremented, the pointer is only valid while -the connection is in use. If L or -L is called, the session may be removed completely -(if considered bad), and the pointer obtained will become invalid. Even -if the session is valid, it can be removed at any time due to timeout -during L. - -If the data is to be kept, SSL_get1_session() will increment the reference -count, so that the session will not be implicitly removed by other operations -but stays in memory. In order to remove the session -L must be explicitly called once -to decrement the reference count again. - -SSL_SESSION objects keep internal link information about the session cache -list, when being inserted into one SSL_CTX object's session cache. -One SSL_SESSION object, regardless of its reference count, must therefore -only be used with one SSL_CTX object (and the SSL objects created -from this SSL_CTX object). - -=head1 RETURN VALUES - -The following return values can occur: - -=over 4 - -=item NULL - -There is no session available in B. - -=item Pointer to an SSL - -The return value points to the data of an SSL session. - -=back - -=head1 SEE ALSO - -L, L, -L, -L - -=cut -- cgit v1.2.3