[openssl-commits] [openssl] OpenSSL_1_1_0-stable update

Richard Levitte levitte at openssl.org
Tue Mar 28 19:54:38 UTC 2017

The branch OpenSSL_1_1_0-stable has been updated
       via  fd2975883d51c475247d3d8a5919b380944b9a46 (commit)
      from  37e4be4a8612958848c1cbe2e6c2f9d97aaa4cca (commit)

- Log -----------------------------------------------------------------
commit fd2975883d51c475247d3d8a5919b380944b9a46
Author: Jon Spillett <jon.spillett at oracle.com>
Date:   Tue Mar 28 16:22:07 2017 +1000

    Add documentation for SSL_*_ex_data() functions
    [skip ci]
    Reviewed-by: Rich Salz <rsalz at openssl.org>
    Reviewed-by: Richard Levitte <levitte at openssl.org>
    (Merged from https://github.com/openssl/openssl/pull/3050)
    (cherry picked from commit 09fdfa4b2fe4c9770c27cd523a5bf55b1d50eac9)


Summary of changes:
 doc/ssl/SSL_CTX_set_ex_data.pod | 57 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 doc/ssl/SSL_CTX_set_ex_data.pod

diff --git a/doc/ssl/SSL_CTX_set_ex_data.pod b/doc/ssl/SSL_CTX_set_ex_data.pod
new file mode 100644
index 0000000..cb88ea0
--- /dev/null
+++ b/doc/ssl/SSL_CTX_set_ex_data.pod
@@ -0,0 +1,57 @@
+=head1 NAME
+SSL_CTX_get_ex_data, SSL_CTX_set_ex_data,
+SSL_get_ex_data, SSL_set_ex_data,
+SSL_SESSION_get_ex_data, SSL_SESSION_set_ex_data
+- Store and retrieve extra data from the SSL_CTX, SSL or SSL_SESSION
+=head1 SYNOPSIS
+ #include <openssl/ssl.h>
+ void *SSL_CTX_get_ex_data(const SSL_CTX *s, int idx);
+ int SSL_CTX_set_ex_data(SSL_CTX *s, int idx, void *arg);
+ void *SSL_get_ex_data(const SSL *s, int idx);
+ int SSL_set_ex_data(SSL *s, int idx, void *arg);
+ int SSL_SESSION_set_ex_data(SSL_SESSION *s, int idx, void *arg);
+ void *SSL_SESSION_get_ex_data(const SSL_SESSION *s, int idx);
+SSL*_set_ex_data() functions can be used to store arbitrary user data into the
+B<SSL_CTX>, B<SSL> or B<SSL_SESSION>. The user must supply a unique index
+which they can subsequently use to retrieve the data using SSL*_get_ex_data().
+For more detailed information see L<CRYPTO_get_ex_data(3)> and
+L<CRYPTO_set_ex_data(3)> which implement these functions and
+L<CRYPTO_get_ex_new_index(3)> for generating a unique index.
+The SSL*_set_ex_data() functions return 1 if the item is successfully stored
+and 0 if it is not.
+The SSL*_get_ex_data() functions return the ex_data pointer if successful,
+otherwise NULL.
+=head1 SEE ALSO
+L<CRYPTO_get_ex_data(3)>, L<CRYPTO_set_ex_data(3)>,
+Copyright 2017 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

More information about the openssl-commits mailing list