SSL_ctrl(3) — Subroutines
NAME
SSL_ctrl − Performs an operation (get or set information in SSL) for the SSL structure
SYNOPSIS
#include <openssl/ssl.h>
long SSL_ctrl(
SSL ∗s,
int cmd,
long larg,
char ∗parg );
DESCRIPTION
The SSL_ctrl() function performs an operation (get or set information in SSL) for the SSL structure. The second argument cmd accepts the macros in the following table:
Table 1: Macros for cmd""
| SSLv2 | SSLv3 | TLSv1 | |
| SSL_CTRL_GET_READ_AHEAD | YES | YES | YES |
| SSL_CTRL_SET_READ_AHEAD | YES | YES | YES |
| SSL_CTRL_OPTIONS | YES | YES | YES |
| SSL_CTRL_MODE | YES | YES | YES |
| SSL_CTRL_GET_SESSION_REUSED | YES | YES | NO |
| SSL_CTRL_GET_CLIENT_CERT_REQUEST | NO | YES | NO |
| SSL_CTRL_GET_NUM_RENEGOTIATIONS | NO | YES | NO |
| SSL_CTRL_CLEAR_NUM_RENEGOTIATIONS | NO | YES | NO |
| SSL_CTRL_GET_TOTAL_RENEGOTIATIONS | NO | YES | NO |
| SSL_CTRL_GET_FLAGS | NO | YES | NO |
| SSL_CTRL_NEED_TMP_RSA | NO | YES(#ifndef NO_RSA) | NO |
| SSL_CTRL_SET_TMP_RSA | NO | YES(#ifndef NO_RSA) | NO |
| SSL_CTRL_SET_TMP_RSA_CB | NO | YES(#ifndef NO_RSA) | NO |
| SSL_CTRL_SET_TMP_DH | NO | YES(#ifndef NO_DH) | NO |
| SSL_CTRL_SET_TMP_DH_CB | NO | YES(#ifndef NO_DH) | NO |
RETURN VALUES
The SSL_ctrl() function returns a long. The return value depends on the type of command cmd passed to this API.
SEE ALSO
Functions: SSL_CTX_ctrl(3), SSL_callback_ctrl(3), SSL_CTX_callback_ctrl(3)