diff options
author | TJ Saunders <tj@castaglia.org> | 2016-05-26 15:40:13 -0700 |
---|---|---|
committer | Rich Salz <rsalz@openssl.org> | 2016-05-31 17:16:29 -0400 |
commit | bd01f6498c2c5007df64ba88c5d88ff15b0376cb (patch) | |
tree | eae87797af4e605a3af32ddfbe81221ca414500e /doc/ssl | |
parent | 6d1e7709c67fa258527e58b797dc581c4e236f20 (diff) | |
download | openssl-bd01f6498c2c5007df64ba88c5d88ff15b0376cb.tar.gz |
Add an SSL_SESSION accessor for obtaining the protocol version number, with
accompanying documentation.
Reviewed-by: Matt Caswell <matt@openssl.org>
Reviewed-by: Rich Salz <rsalz@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/1135)
Diffstat (limited to 'doc/ssl')
-rw-r--r-- | doc/ssl/SSL_SESSION_get_protocol_version.pod | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/doc/ssl/SSL_SESSION_get_protocol_version.pod b/doc/ssl/SSL_SESSION_get_protocol_version.pod new file mode 100644 index 0000000000..e9e4f6df50 --- /dev/null +++ b/doc/ssl/SSL_SESSION_get_protocol_version.pod @@ -0,0 +1,54 @@ +=pod + +=head1 NAME + +SSL_SESSION_get_protocol_version - retrieve session protocol version + +=head1 SYNOPSIS + + #include <openssl/ssl.h> + + int SSL_SESSION_get_protocol_version(const SSL_SESSION *s); + +=head1 DESCRIPTION + +SSL_SESSION_get_protocol_version() returns the time at which the session B<s> was +established. The time is given in seconds since the Epoch and therefore +compatible to the time delivered by the time() call. + +SSL_SESSION_set_time() replaces the creation time of the session B<s> with +the chosen value B<tm>. + +SSL_SESSION_get_timeout() returns the timeout value set for session B<s> +in seconds. + +SSL_SESSION_set_timeout() sets the timeout value for session B<s> in seconds +to B<tm>. + +The SSL_get_time(), SSL_set_time(), SSL_get_timeout(), and SSL_set_timeout() +functions are synonyms for the SSL_SESSION_*() counterparts. + +=head1 RETURN VALUES + +SSL_SESSION_get_protocol_version() returns a number indicating the protocol +version used for the session; this number matches the constants I<e.g.> +B<TLS1_VERSION> or B<TLS1_2_VERSION>. + +If the function is passed the NULL pointer for the session B<s>, 0 is returned. + +=head1 SEE ALSO + +L<ssl(3)>, +L<SSL_CTX_set_timeout(3)>, +L<SSL_get_default_timeout(3)> + +=head1 COPYRIGHT + +Copyright 2001-2016 The OpenSSL Project Authors. All Rights Reserved. + +Licensed under the OpenSSL license (the "License"). You may not use +this file except in compliance with the License. You can obtain a copy +in the file LICENSE in the source distribution or at +L<https://www.openssl.org/source/license.html>. + +=cut |