set a TLS/SSL session to be used during TLS/SSL
to be used when the TLS/SSL
connection is to be established.
() is only useful for
TLS/SSL clients. When the session is set, the reference count of
is incremented by 1. If the session
is not reused, the reference count is decremented again during
(). Whether the session was
reused can be queried with the
If there is already a session set inside ssl
(because it was set with
before or because the same ssl
used for a connection),
will be called for that session.
objects keep internal link
information about the session cache list when being inserted into one
object's session cache. One
object, regardless of its
reference count, must therefore only be used with one
object (and the
objects created from this
The following return values can occur:
- The operation failed; check the error stack to find out the reason.
- The operation succeeded.
() first appeared in SSLeay
0.5.2 and has been available since OpenBSD 2.4