1SSL_get_ex_data_X509_STORE_CTX_idx(3)OpenSSSLSL_get_ex_data_X509_STORE_CTX_idx(3)
2
3
4

NAME

6       SSL_get_ex_data_X509_STORE_CTX_idx - get ex_data index to access SSL
7       structure from X509_STORE_CTX
8

SYNOPSIS

10        #include <openssl/ssl.h>
11
12        int SSL_get_ex_data_X509_STORE_CTX_idx(void);
13

DESCRIPTION

15       SSL_get_ex_data_X509_STORE_CTX_idx() returns the index number under
16       which the pointer to the SSL object is stored into the X509_STORE_CTX
17       object.
18

NOTES

20       Whenever a X509_STORE_CTX object is created for the verification of the
21       peers certificate during a handshake, a pointer to the SSL object is
22       stored into the X509_STORE_CTX object to identify the connection
23       affected.  To retrieve this pointer the X509_STORE_CTX_get_ex_data()
24       function can be used with the correct index. This index is globally the
25       same for all X509_STORE_CTX objects and can be retrieved using
26       SSL_get_ex_data_X509_STORE_CTX_idx(). The index value is set when
27       SSL_get_ex_data_X509_STORE_CTX_idx() is first called either by the
28       application program directly or indirectly during other SSL setup
29       functions or during the handshake.
30
31       The value depends on other index values defined for X509_STORE_CTX
32       objects before the SSL index is created.
33

RETURN VALUES

35       >=0 The index value to access the pointer.
36
37       <0  An error occurred, check the error stack for a detailed error
38           message.
39

EXAMPLES

41       The index returned from SSL_get_ex_data_X509_STORE_CTX_idx() allows to
42       access the SSL object for the connection to be accessed during the
43       verify_callback() when checking the peers certificate. Please check the
44       example in SSL_CTX_set_verify(3),
45

SEE ALSO

47       ssl(3), SSL_CTX_set_verify(3), CRYPTO_set_ex_data(3)
48
49
50
511.0.2k                            2017-01-S2S6L_get_ex_data_X509_STORE_CTX_idx(3)
Impressum