SSL_SESSION_get_time(3)SSL_SESSION_get_time(3)NAME
SSL_SESSION_get_time, SSL_SESSION_set_time, SSL_SESSION_get_timeout,
SSL_SESSION_set_timeout - Retrieve and manipulate session time and
timeout settings
SYNOPSIS
#include <openssl/ssl.h>
long SSL_SESSION_get_time(
SSL_SESSION *s ); long SSL_SESSION_set_time(
SSL_SESSION *s,
long tm ); long SSL_SESSION_get_timeout(
SSL_SESSION *s ); long SSL_SESSION_set_timeout(
SSL_SESSION *s,
long tm ); long SSL_get_time(
SSL_SESSION *s ); long SSL_set_time(
SSL_SESSION *s,
long tm ); long SSL_get_timeout(
SSL_SESSION *s ); long SSL_set_timeout(
SSL_SESSION *s,
long tm );
DESCRIPTION
The SSL_SESSION_get_time() function returns the time at which the ses‐
sion s was established. The time is given in seconds since the Epoch
and therefore compatible to the time delivered by the time() call.
The SSL_SESSION_set_time() function replaces the creation time of the
session s with the chosen value tm.
The SSL_SESSION_get_timeout() function returns the timeout value set
for session s in seconds.
The SSL_SESSION_set_timeout() function sets the timeout value for ses‐
sion s in seconds to tm.
The SSL_get_time(), SSL_set_time(), SSL_get_timeout(), and
SSL_set_timeout() functions are synonyms for the SSL_SESSION_*() coun‐
terparts.
NOTES
Sessions are expired by examining the creation time and the timeout
value. Both are set at creation time of the session to the actual time
and the default timeout value at creation, respectively, as set by the
SSL_CTX_set_timeout() function. Using these functions it is possible to
extend or shorten the lifetime of the session.
RETURN VALUES
The SSL_SESSION_get_time() and SSL_SESSION_get_timeout() functions
return the currently valid values.
The SSL_SESSION_set_time() and SSL_SESSION_set_timeout() functions
return 1 on success.
If any of the function is passed the NULL pointer for the session s, 0
is returned.
SEE ALSO
Functions: ssl(3), SSL_CTX_set_timeout(3), SSL_get_default_timeout(3)SSL_SESSION_get_time(3)
