MirBSD manpage: SSL_set_session(3)


SSL_SET_SESSION(3)           OpenSSL           SSL_SET_SESSION(3)

NAME

     SSL_set_session - set a TLS/SSL session to be used during
     TLS/SSL connect

SYNOPSIS

      #include <openssl/ssl.h>

      int SSL_set_session(SSL *ssl, SSL_SESSION *session);

DESCRIPTION

     SSL_set_session() sets session to be used when the TLS/SSL
     connection is to be established. SSL_set_session() is only
     useful for TLS/SSL clients. When the session is set, the
     reference count of session is incremented by 1. If the ses-
     sion is not reused, the reference count is decremented again
     during SSL_connect(). Whether the session was reused can be
     queried with the SSL_session_reused(3) call.

     If there is already a session set inside ssl (because it was
     set with SSL_set_session() before or because the same ssl
     was already used for a connection), SSL_SESSION_free() will
     be called for that session.

NOTES

     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).

RETURN VALUES

     The following return values can occur:

     0   The operation failed; check the error stack to find out
         the reason.

     1   The operation succeeded.

SEE ALSO

     ssl(3), SSL_SESSION_free(3), SSL_get_session(3),
     SSL_session_reused(3), SSL_CTX_set_session_cache_mode(3)

MirBSD #10-current         2014-11-26                           1

Generated on 2022-12-24 01:00:14 by $MirOS: src/scripts/roff2htm,v 1.113 2022/12/21 23:14:31 tg Exp $ — This product includes material provided by mirabilos.

These manual pages and other documentation are copyrighted by their respective writers; their sources are available at the project’s CVSweb, AnonCVS and other mirrors. The rest is Copyright © 2002–2022 MirBSD.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report — diffs preferred.

Kontakt / Impressum & Datenschutzerklärung