Wed Feb 19 16:47:50 2003
Standard preamble:
======================================================================
\\$1
.. ..
.... Set up some character translations and predefined strings. \*(-- will
give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
double quote, and \*(R" will give a right double quote. | will give a
real vertical bar. \*(C+ will give a nicer C++. Capital omega is used
to do unbreakable dashes and therefore won't be available. \*(C` and
\*(C' expand to `' in nroff, nothing in troff, for use with C<>
.tr \(*W-|\(bv\*(Tr . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\}
If the F register is turned on, we'll generate index entries on stderr
for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
index entries marked with X<> in POD. Of course, you'll have to process
the output yourself in some meaningful fashion.
. de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\}
For nroff, turn off justification. Always turn off hyphenation; it
makes way too many mistakes in technical documents.
Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
Fear. Run. Save yourself. No user-serviceable parts.
.bd B 3 . \" fudge factors for nroff and troff . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] .\} . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents . \" corrections for vroff . \" for low resolution devices (crt and lpr) \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} ======================================================================
Title "ssl 3"
At first the library must be initialized; see SSL_library_init(3).
Then an \s-1SSL_CTX\s0 object is created as a framework to establish \s-1TLS/SSL\s0 enabled connections (see SSL_CTX_new(3)). Various options regarding certificates, algorithms etc. can be set in this object.
When a network connection has been created, it can be assigned to an \fB\s-1SSL\s0 object. After the \s-1SSL\s0 object has been created using SSL_new(3), SSL_set_fd(3) or SSL_set_bio(3) can be used to associate the network connection with the object.
Then the \s-1TLS/SSL\s0 handshake is performed using SSL_accept(3) or SSL_connect(3) respectively. SSL_read(3) and SSL_write(3) are used to read and write data on the \s-1TLS/SSL\s0 connection. SSL_shutdown(3) can be used to shut down the \s-1TLS/SSL\s0 connection.
0 p "long SSL_CTX_add_extra_chain_cert(\s-1SSL_CTX\s0 *ctx, X509 *x509);" 4 Item "long SSL_CTX_add_extra_chain_cert(SSL_CTX *ctx, X509 *x509);" p "int SSL_CTX_add_session(\s-1SSL_CTX\s0 *ctx, \s-1SSL_SESSION\s0 *c);" 4 Item "int SSL_CTX_add_session(SSL_CTX *ctx, SSL_SESSION *c);" p "int SSL_CTX_check_private_key(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_check_private_key(SSL_CTX *ctx);" p "long SSL_CTX_ctrl(\s-1SSL_CTX\s0 *ctx, int cmd, long larg, char *parg);" 4 Item "long SSL_CTX_ctrl(SSL_CTX *ctx, int cmd, long larg, char *parg);" p "void SSL_CTX_flush_sessions(\s-1SSL_CTX\s0 *s, long t);" 4 Item "void SSL_CTX_flush_sessions(SSL_CTX *s, long t);" p "void SSL_CTX_free(\s-1SSL_CTX\s0 *a);" 4 Item "void SSL_CTX_free(SSL_CTX *a);" p "char *SSL_CTX_get_app_data(\s-1SSL_CTX\s0 *ctx);" 4 Item "char *SSL_CTX_get_app_data(SSL_CTX *ctx);" p "X509_STORE *SSL_CTX_get_cert_store(\s-1SSL_CTX\s0 *ctx);" 4 Item "X509_STORE *SSL_CTX_get_cert_store(SSL_CTX *ctx);" p "\s-1STACK\s0 *SSL_CTX_get_client_CA_list(\s-1SSL_CTX\s0 *ctx);" 4 Item "STACK *SSL_CTX_get_client_CA_list(SSL_CTX *ctx);" p "int (*SSL_CTX_get_client_cert_cb(\s-1SSL_CTX\s0 *ctx))(\s-1SSL\s0 *ssl, X509 **x509, \s-1EVP_PKEY\s0 **pkey);" 4 Item "int (*SSL_CTX_get_client_cert_cb(SSL_CTX *ctx))(SSL *ssl, X509 **x509, EVP_PKEY **pkey);" p "char *SSL_CTX_get_ex_data(\s-1SSL_CTX\s0 *s, int idx);" 4 Item "char *SSL_CTX_get_ex_data(SSL_CTX *s, int idx);" p "int SSL_CTX_get_ex_new_index(long argl, char *argp, int (*new_func);(void), int (*dup_func)(void), void (*free_func)(void))" 4 Item "int SSL_CTX_get_ex_new_index(long argl, char *argp, int (*new_func);(void), int (*dup_func)(void), void (*free_func)(void))" p "void (*SSL_CTX_get_info_callback(\s-1SSL_CTX\s0 *ctx))(\s-1SSL\s0 *ssl, int cb, int ret);" 4 Item "void (*SSL_CTX_get_info_callback(SSL_CTX *ctx))(SSL *ssl, int cb, int ret);" p "int SSL_CTX_get_quiet_shutdown(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_get_quiet_shutdown(SSL_CTX *ctx);" p "int SSL_CTX_get_session_cache_mode(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_get_session_cache_mode(SSL_CTX *ctx);" p "long SSL_CTX_get_timeout(\s-1SSL_CTX\s0 *ctx);" 4 Item "long SSL_CTX_get_timeout(SSL_CTX *ctx);" p "int (*SSL_CTX_get_verify_callback(\s-1SSL_CTX\s0 *ctx))(int ok, X509_STORE_CTX *ctx);" 4 Item "int (*SSL_CTX_get_verify_callback(SSL_CTX *ctx))(int ok, X509_STORE_CTX *ctx);" p "int SSL_CTX_get_verify_mode(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_get_verify_mode(SSL_CTX *ctx);" p "int SSL_CTX_load_verify_locations(\s-1SSL_CTX\s0 *ctx, char *CAfile, char *CApath);" 4 Item "int SSL_CTX_load_verify_locations(SSL_CTX *ctx, char *CAfile, char *CApath);" p "long SSL_CTX_need_tmp_RSA(\s-1SSL_CTX\s0 *ctx);" 4 Item "long SSL_CTX_need_tmp_RSA(SSL_CTX *ctx);" p "\s-1SSL_CTX\s0 *SSL_CTX_new(\s-1SSL_METHOD\s0 *meth);" 4 Item "SSL_CTX *SSL_CTX_new(SSL_METHOD *meth);" p "int SSL_CTX_remove_session(\s-1SSL_CTX\s0 *ctx, \s-1SSL_SESSION\s0 *c);" 4 Item "int SSL_CTX_remove_session(SSL_CTX *ctx, SSL_SESSION *c);" p "int SSL_CTX_sess_accept(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_accept(SSL_CTX *ctx);" p "int SSL_CTX_sess_accept_good(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_accept_good(SSL_CTX *ctx);" p "int SSL_CTX_sess_accept_renegotiate(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_accept_renegotiate(SSL_CTX *ctx);" p "int SSL_CTX_sess_cache_full(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_cache_full(SSL_CTX *ctx);" p "int SSL_CTX_sess_cb_hits(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_cb_hits(SSL_CTX *ctx);" p "int SSL_CTX_sess_connect(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_connect(SSL_CTX *ctx);" p "int SSL_CTX_sess_connect_good(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_connect_good(SSL_CTX *ctx);" p "int SSL_CTX_sess_connect_renegotiate(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_connect_renegotiate(SSL_CTX *ctx);" p "int SSL_CTX_sess_get_cache_size(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_get_cache_size(SSL_CTX *ctx);" p "\s-1SSL_SESSION\s0 *(*SSL_CTX_sess_get_get_cb(\s-1SSL_CTX\s0 *ctx))(\s-1SSL\s0 *ssl, unsigned char *data, int len, int *copy);" 4 Item "SSL_SESSION *(*SSL_CTX_sess_get_get_cb(SSL_CTX *ctx))(SSL *ssl, unsigned char *data, int len, int *copy);" p "int (*SSL_CTX_sess_get_new_cb(\s-1SSL_CTX\s0 *ctx)(\s-1SSL\s0 *ssl, \s-1SSL_SESSION\s0 *sess);" 4 Item "int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx)(SSL *ssl, SSL_SESSION *sess);" p "void (*SSL_CTX_sess_get_remove_cb(\s-1SSL_CTX\s0 *ctx)(\s-1SSL_CTX\s0 *ctx, \s-1SSL_SESSION\s0 *sess);" 4 Item "void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx)(SSL_CTX *ctx, SSL_SESSION *sess);" p "int SSL_CTX_sess_hits(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_hits(SSL_CTX *ctx);" p "int SSL_CTX_sess_misses(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_misses(SSL_CTX *ctx);" p "int SSL_CTX_sess_number(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_number(SSL_CTX *ctx);" p "void SSL_CTX_sess_set_cache_size(\s-1SSL_CTX\s0 *ctx,t);" 4 Item "void SSL_CTX_sess_set_cache_size(SSL_CTX *ctx,t);" p "void SSL_CTX_sess_set_get_cb(\s-1SSL_CTX\s0 *ctx, \s-1SSL_SESSION\s0 *(*cb)(\s-1SSL\s0 *ssl, unsigned char *data, int len, int *copy));" 4 Item "void SSL_CTX_sess_set_get_cb(SSL_CTX *ctx, SSL_SESSION *(*cb)(SSL *ssl, unsigned char *data, int len, int *copy));" p "void SSL_CTX_sess_set_new_cb(\s-1SSL_CTX\s0 *ctx, int (*cb)(\s-1SSL\s0 *ssl, \s-1SSL_SESSION\s0 *sess));" 4 Item "void SSL_CTX_sess_set_new_cb(SSL_CTX *ctx, int (*cb)(SSL *ssl, SSL_SESSION *sess));" p "void SSL_CTX_sess_set_remove_cb(\s-1SSL_CTX\s0 *ctx, void (*cb)(\s-1SSL_CTX\s0 *ctx, \s-1SSL_SESSION\s0 *sess));" 4 Item "void SSL_CTX_sess_set_remove_cb(SSL_CTX *ctx, void (*cb)(SSL_CTX *ctx, SSL_SESSION *sess));" p "int SSL_CTX_sess_timeouts(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_sess_timeouts(SSL_CTX *ctx);" p "\s-1LHASH\s0 *SSL_CTX_sessions(\s-1SSL_CTX\s0 *ctx);" 4 Item "LHASH *SSL_CTX_sessions(SSL_CTX *ctx);" p "void SSL_CTX_set_app_data(\s-1SSL_CTX\s0 *ctx, void *arg);" 4 Item "void SSL_CTX_set_app_data(SSL_CTX *ctx, void *arg);" p "void SSL_CTX_set_cert_store(\s-1SSL_CTX\s0 *ctx, X509_STORE *cs);" 4 Item "void SSL_CTX_set_cert_store(SSL_CTX *ctx, X509_STORE *cs);" p "void SSL_CTX_set_cert_verify_cb(\s-1SSL_CTX\s0 *ctx, int (*cb)(), char *arg)" 4 Item "void SSL_CTX_set_cert_verify_cb(SSL_CTX *ctx, int (*cb)(), char *arg)" p "int SSL_CTX_set_cipher_list(\s-1SSL_CTX\s0 *ctx, char *str);" 4 Item "int SSL_CTX_set_cipher_list(SSL_CTX *ctx, char *str);" p "void SSL_CTX_set_client_CA_list(\s-1SSL_CTX\s0 *ctx, \s-1STACK\s0 *list);" 4 Item "void SSL_CTX_set_client_CA_list(SSL_CTX *ctx, STACK *list);" p "void SSL_CTX_set_client_cert_cb(\s-1SSL_CTX\s0 *ctx, int (*cb)(\s-1SSL\s0 *ssl, X509 **x509, \s-1EVP_PKEY\s0 **pkey));" 4 Item "void SSL_CTX_set_client_cert_cb(SSL_CTX *ctx, int (*cb)(SSL *ssl, X509 **x509, EVP_PKEY **pkey));" p "void SSL_CTX_set_default_passwd_cb(\s-1SSL_CTX\s0 *ctx, int (*cb);(void))" 4 Item "void SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, int (*cb);(void))" p "void SSL_CTX_set_default_read_ahead(\s-1SSL_CTX\s0 *ctx, int m);" 4 Item "void SSL_CTX_set_default_read_ahead(SSL_CTX *ctx, int m);" p "int SSL_CTX_set_default_verify_paths(\s-1SSL_CTX\s0 *ctx);" 4 Item "int SSL_CTX_set_default_verify_paths(SSL_CTX *ctx);" p "int SSL_CTX_set_ex_data(\s-1SSL_CTX\s0 *s, int idx, char *arg);" 4 Item "int SSL_CTX_set_ex_data(SSL_CTX *s, int idx, char *arg);" p "void SSL_CTX_set_info_callback(\s-1SSL_CTX\s0 *ctx, void (*cb)(\s-1SSL\s0 *ssl, int cb, int ret));" 4 Item "void SSL_CTX_set_info_callback(SSL_CTX *ctx, void (*cb)(SSL *ssl, int cb, int ret));" p "void SSL_CTX_set_msg_callback(\s-1SSL_CTX\s0 *ctx, void (*cb)(int write_p, int version, int content_type, const void *buf, size_t len, \s-1SSL\s0 *ssl, void *arg));" 4 Item "void SSL_CTX_set_msg_callback(SSL_CTX *ctx, void (*cb)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg));" p "void SSL_CTX_set_msg_callback_arg(\s-1SSL_CTX\s0 *ctx, void *arg);" 4 Item "void SSL_CTX_set_msg_callback_arg(SSL_CTX *ctx, void *arg);" p "void SSL_CTX_set_options(\s-1SSL_CTX\s0 *ctx, unsigned long op);" 4 Item "void SSL_CTX_set_options(SSL_CTX *ctx, unsigned long op);" p "void SSL_CTX_set_quiet_shutdown(\s-1SSL_CTX\s0 *ctx, int mode);" 4 Item "void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode);" p "void SSL_CTX_set_session_cache_mode(\s-1SSL_CTX\s0 *ctx, int mode);" 4 Item "void SSL_CTX_set_session_cache_mode(SSL_CTX *ctx, int mode);" p "int SSL_CTX_set_ssl_version(\s-1SSL_CTX\s0 *ctx, \s-1SSL_METHOD\s0 *meth);" 4 Item "int SSL_CTX_set_ssl_version(SSL_CTX *ctx, SSL_METHOD *meth);" p "void SSL_CTX_set_timeout(\s-1SSL_CTX\s0 *ctx, long t);" 4 Item "void SSL_CTX_set_timeout(SSL_CTX *ctx, long t);" p "long SSL_CTX_set_tmp_dh(SSL_CTX* ctx, \s-1DH\s0 *dh);" 4 Item "long SSL_CTX_set_tmp_dh(SSL_CTX* ctx, DH *dh);" p "long SSL_CTX_set_tmp_dh_callback(\s-1SSL_CTX\s0 *ctx, \s-1DH\s0 *(*cb)(void));" 4 Item "long SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx, DH *(*cb)(void));" p "long SSL_CTX_set_tmp_rsa(\s-1SSL_CTX\s0 *ctx, \s-1RSA\s0 *rsa);" 4 Item "long SSL_CTX_set_tmp_rsa(SSL_CTX *ctx, RSA *rsa);" p "SSL_CTX_set_tmp_rsa_callback" 4 Item "SSL_CTX_set_tmp_rsa_callback"
\f(CW\*(C`long \f(CBSSL_CTX_set_tmp_rsa_callback(SSL_CTX *\f(CBctx, RSA *(*\f(CBcb)(SSL *\f(CBssl, int \f(CBexport, int \f(CBkeylength));\*(C' .Sp Sets the callback which will be called when a temporary private key is required. The \f(CB\*(C`export\*(C' flag will be set if the reason for needing a temp key is that an export ciphersuite is in use, in which case, \fB\f(CB\*(C`keylength\*(C' will contain the required keylength in bits. Generate a key of appropriate size (using ???) and return it. p "SSL_set_tmp_rsa_callback" 4 Item "SSL_set_tmp_rsa_callback" long SSL_set_tmp_rsa_callback(\s-1SSL\s0 *ssl, \s-1RSA\s0 *(*cb)(\s-1SSL\s0 *ssl, int export, int keylength)); .Sp The same as SSL_CTX_set_tmp_rsa_callback, except it operates on an \s-1SSL\s0 session instead of a context. p "void SSL_CTX_set_verify(\s-1SSL_CTX\s0 *ctx, int mode, int (*cb);(void))" 4 Item "void SSL_CTX_set_verify(SSL_CTX *ctx, int mode, int (*cb);(void))"
0 p "int SSL_CTX_use_PrivateKey(\s-1SSL_CTX\s0 *ctx, \s-1EVP_PKEY\s0 *pkey);" 4 Item "int SSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey);" p "int SSL_CTX_use_PrivateKey_ASN1(int type, \s-1SSL_CTX\s0 *ctx, unsigned char *d, long len);" 4 Item "int SSL_CTX_use_PrivateKey_ASN1(int type, SSL_CTX *ctx, unsigned char *d, long len);" p "int SSL_CTX_use_PrivateKey_file(\s-1SSL_CTX\s0 *ctx, char *file, int type);" 4 Item "int SSL_CTX_use_PrivateKey_file(SSL_CTX *ctx, char *file, int type);" p "int SSL_CTX_use_RSAPrivateKey(\s-1SSL_CTX\s0 *ctx, \s-1RSA\s0 *rsa);" 4 Item "int SSL_CTX_use_RSAPrivateKey(SSL_CTX *ctx, RSA *rsa);" p "int SSL_CTX_use_RSAPrivateKey_ASN1(\s-1SSL_CTX\s0 *ctx, unsigned char *d, long len);" 4 Item "int SSL_CTX_use_RSAPrivateKey_ASN1(SSL_CTX *ctx, unsigned char *d, long len);" p "int SSL_CTX_use_RSAPrivateKey_file(\s-1SSL_CTX\s0 *ctx, char *file, int type);" 4 Item "int SSL_CTX_use_RSAPrivateKey_file(SSL_CTX *ctx, char *file, int type);" p "int SSL_CTX_use_certificate(\s-1SSL_CTX\s0 *ctx, X509 *x);" 4 Item "int SSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x);" p "int SSL_CTX_use_certificate_ASN1(\s-1SSL_CTX\s0 *ctx, int len, unsigned char *d);" 4 Item "int SSL_CTX_use_certificate_ASN1(SSL_CTX *ctx, int len, unsigned char *d);" p "int SSL_CTX_use_certificate_file(\s-1SSL_CTX\s0 *ctx, char *file, int type);" 4 Item "int SSL_CTX_use_certificate_file(SSL_CTX *ctx, char *file, int type);"
.Sh "\s-1DEALING\s0 \s-1WITH\s0 \s-1SESSIONS\s0" Subsection "DEALING WITH SESSIONS" Here we document the various \s-1API\s0 functions which deal with the \s-1SSL/TLS\s0 sessions defined in the \s-1SSL_SESSION\s0 structures. p "int SSL_SESSION_cmp(\s-1SSL_SESSION\s0 *a, \s-1SSL_SESSION\s0 *b);" 4 Item "int SSL_SESSION_cmp(SSL_SESSION *a, SSL_SESSION *b);"
0 p "void SSL_SESSION_free(\s-1SSL_SESSION\s0 *ss);" 4 Item "void SSL_SESSION_free(SSL_SESSION *ss);" p "char *SSL_SESSION_get_app_data(\s-1SSL_SESSION\s0 *s);" 4 Item "char *SSL_SESSION_get_app_data(SSL_SESSION *s);" p "char *SSL_SESSION_get_ex_data(\s-1SSL_SESSION\s0 *s, int idx);" 4 Item "char *SSL_SESSION_get_ex_data(SSL_SESSION *s, int idx);" p "int SSL_SESSION_get_ex_new_index(long argl, char *argp, int (*new_func);(void), int (*dup_func)(void), void (*free_func)(void))" 4 Item "int SSL_SESSION_get_ex_new_index(long argl, char *argp, int (*new_func);(void), int (*dup_func)(void), void (*free_func)(void))" p "long SSL_SESSION_get_time(\s-1SSL_SESSION\s0 *s);" 4 Item "long SSL_SESSION_get_time(SSL_SESSION *s);" p "long SSL_SESSION_get_timeout(\s-1SSL_SESSION\s0 *s);" 4 Item "long SSL_SESSION_get_timeout(SSL_SESSION *s);" p "unsigned long SSL_SESSION_hash(\s-1SSL_SESSION\s0 *a);" 4 Item "unsigned long SSL_SESSION_hash(SSL_SESSION *a);" p "\s-1SSL_SESSION\s0 *SSL_SESSION_new(void);" 4 Item "SSL_SESSION *SSL_SESSION_new(void);" p "int SSL_SESSION_print(\s-1BIO\s0 *bp, \s-1SSL_SESSION\s0 *x);" 4 Item "int SSL_SESSION_print(BIO *bp, SSL_SESSION *x);" p "int SSL_SESSION_print_fp(\s-1FILE\s0 *fp, \s-1SSL_SESSION\s0 *x);" 4 Item "int SSL_SESSION_print_fp(FILE *fp, SSL_SESSION *x);" p "void SSL_SESSION_set_app_data(\s-1SSL_SESSION\s0 *s, char *a);" 4 Item "void SSL_SESSION_set_app_data(SSL_SESSION *s, char *a);" p "int SSL_SESSION_set_ex_data(\s-1SSL_SESSION\s0 *s, int idx, char *arg);" 4 Item "int SSL_SESSION_set_ex_data(SSL_SESSION *s, int idx, char *arg);" p "long SSL_SESSION_set_time(\s-1SSL_SESSION\s0 *s, long t);" 4 Item "long SSL_SESSION_set_time(SSL_SESSION *s, long t);" p "long SSL_SESSION_set_timeout(\s-1SSL_SESSION\s0 *s, long t);" 4 Item "long SSL_SESSION_set_timeout(SSL_SESSION *s, long t);"
.Sh "\s-1DEALING\s0 \s-1WITH\s0 \s-1CONNECTIONS\s0" Subsection "DEALING WITH CONNECTIONS" Here we document the various \s-1API\s0 functions which deal with the \s-1SSL/TLS\s0 connection defined in the \s-1SSL\s0 structure. p "int SSL_accept(\s-1SSL\s0 *ssl);" 4 Item "int SSL_accept(SSL *ssl);"
0 p "int SSL_add_dir_cert_subjects_to_stack(\s-1STACK\s0 *stack, const char *dir);" 4 Item "int SSL_add_dir_cert_subjects_to_stack(STACK *stack, const char *dir);" p "int SSL_add_file_cert_subjects_to_stack(\s-1STACK\s0 *stack, const char *file);" 4 Item "int SSL_add_file_cert_subjects_to_stack(STACK *stack, const char *file);" p "int SSL_add_client_CA(\s-1SSL\s0 *ssl, X509 *x);" 4 Item "int SSL_add_client_CA(SSL *ssl, X509 *x);" p "char *SSL_alert_desc_string(int value);" 4 Item "char *SSL_alert_desc_string(int value);" p "char *SSL_alert_desc_string_long(int value);" 4 Item "char *SSL_alert_desc_string_long(int value);" p "char *SSL_alert_type_string(int value);" 4 Item "char *SSL_alert_type_string(int value);" p "char *SSL_alert_type_string_long(int value);" 4 Item "char *SSL_alert_type_string_long(int value);" p "int SSL_check_private_key(\s-1SSL\s0 *ssl);" 4 Item "int SSL_check_private_key(SSL *ssl);" p "void SSL_clear(\s-1SSL\s0 *ssl);" 4 Item "void SSL_clear(SSL *ssl);" p "long SSL_clear_num_renegotiations(\s-1SSL\s0 *ssl);" 4 Item "long SSL_clear_num_renegotiations(SSL *ssl);" p "int SSL_connect(\s-1SSL\s0 *ssl);" 4 Item "int SSL_connect(SSL *ssl);" p "void SSL_copy_session_id(\s-1SSL\s0 *t, \s-1SSL\s0 *f);" 4 Item "void SSL_copy_session_id(SSL *t, SSL *f);" p "long SSL_ctrl(\s-1SSL\s0 *ssl, int cmd, long larg, char *parg);" 4 Item "long SSL_ctrl(SSL *ssl, int cmd, long larg, char *parg);" p "int SSL_do_handshake(\s-1SSL\s0 *ssl);" 4 Item "int SSL_do_handshake(SSL *ssl);" p "\s-1SSL\s0 *SSL_dup(\s-1SSL\s0 *ssl);" 4 Item "SSL *SSL_dup(SSL *ssl);" p "\s-1STACK\s0 *SSL_dup_CA_list(\s-1STACK\s0 *sk);" 4 Item "STACK *SSL_dup_CA_list(STACK *sk);" p "void SSL_free(\s-1SSL\s0 *ssl);" 4 Item "void SSL_free(SSL *ssl);" p "\s-1SSL_CTX\s0 *SSL_get_SSL_CTX(\s-1SSL\s0 *ssl);" 4 Item "SSL_CTX *SSL_get_SSL_CTX(SSL *ssl);" p "char *SSL_get_app_data(\s-1SSL\s0 *ssl);" 4 Item "char *SSL_get_app_data(SSL *ssl);" p "X509 *SSL_get_certificate(\s-1SSL\s0 *ssl);" 4 Item "X509 *SSL_get_certificate(SSL *ssl);" p "const char *SSL_get_cipher(\s-1SSL\s0 *ssl);" 4 Item "const char *SSL_get_cipher(SSL *ssl);" p "int SSL_get_cipher_bits(\s-1SSL\s0 *ssl, int *alg_bits);" 4 Item "int SSL_get_cipher_bits(SSL *ssl, int *alg_bits);" p "char *SSL_get_cipher_list(\s-1SSL\s0 *ssl, int n);" 4 Item "char *SSL_get_cipher_list(SSL *ssl, int n);" p "char *SSL_get_cipher_name(\s-1SSL\s0 *ssl);" 4 Item "char *SSL_get_cipher_name(SSL *ssl);" p "char *SSL_get_cipher_version(\s-1SSL\s0 *ssl);" 4 Item "char *SSL_get_cipher_version(SSL *ssl);" p "\s-1STACK\s0 *SSL_get_ciphers(\s-1SSL\s0 *ssl);" 4 Item "STACK *SSL_get_ciphers(SSL *ssl);" p "\s-1STACK\s0 *SSL_get_client_CA_list(\s-1SSL\s0 *ssl);" 4 Item "STACK *SSL_get_client_CA_list(SSL *ssl);" p "\s-1SSL_CIPHER\s0 *SSL_get_current_cipher(\s-1SSL\s0 *ssl);" 4 Item "SSL_CIPHER *SSL_get_current_cipher(SSL *ssl);" p "long SSL_get_default_timeout(\s-1SSL\s0 *ssl);" 4 Item "long SSL_get_default_timeout(SSL *ssl);" p "int SSL_get_error(\s-1SSL\s0 *ssl, int i);" 4 Item "int SSL_get_error(SSL *ssl, int i);" p "char *SSL_get_ex_data(\s-1SSL\s0 *ssl, int idx);" 4 Item "char *SSL_get_ex_data(SSL *ssl, int idx);" p "int SSL_get_ex_data_X509_STORE_CTX_idx(void);" 4 Item "int SSL_get_ex_data_X509_STORE_CTX_idx(void);" p "int SSL_get_ex_new_index(long argl, char *argp, int (*new_func);(void), int (*dup_func)(void), void (*free_func)(void))" 4 Item "int SSL_get_ex_new_index(long argl, char *argp, int (*new_func);(void), int (*dup_func)(void), void (*free_func)(void))" p "int SSL_get_fd(\s-1SSL\s0 *ssl);" 4 Item "int SSL_get_fd(SSL *ssl);" p "void (*SSL_get_info_callback(\s-1SSL\s0 *ssl);)(void)" 4 Item "void (*SSL_get_info_callback(SSL *ssl);)(void)" p "\s-1STACK\s0 *SSL_get_peer_cert_chain(\s-1SSL\s0 *ssl);" 4 Item "STACK *SSL_get_peer_cert_chain(SSL *ssl);" p "X509 *SSL_get_peer_certificate(\s-1SSL\s0 *ssl);" 4 Item "X509 *SSL_get_peer_certificate(SSL *ssl);" p "\s-1EVP_PKEY\s0 *SSL_get_privatekey(\s-1SSL\s0 *ssl);" 4 Item "EVP_PKEY *SSL_get_privatekey(SSL *ssl);" p "int SSL_get_quiet_shutdown(\s-1SSL\s0 *ssl);" 4 Item "int SSL_get_quiet_shutdown(SSL *ssl);" p "\s-1BIO\s0 *SSL_get_rbio(\s-1SSL\s0 *ssl);" 4 Item "BIO *SSL_get_rbio(SSL *ssl);" p "int SSL_get_read_ahead(\s-1SSL\s0 *ssl);" 4 Item "int SSL_get_read_ahead(SSL *ssl);" p "\s-1SSL_SESSION\s0 *SSL_get_session(\s-1SSL\s0 *ssl);" 4 Item "SSL_SESSION *SSL_get_session(SSL *ssl);" p "char *SSL_get_shared_ciphers(\s-1SSL\s0 *ssl, char *buf, int len);" 4 Item "char *SSL_get_shared_ciphers(SSL *ssl, char *buf, int len);" p "int SSL_get_shutdown(\s-1SSL\s0 *ssl);" 4 Item "int SSL_get_shutdown(SSL *ssl);" p "\s-1SSL_METHOD\s0 *SSL_get_ssl_method(\s-1SSL\s0 *ssl);" 4 Item "SSL_METHOD *SSL_get_ssl_method(SSL *ssl);" p "int SSL_get_state(\s-1SSL\s0 *ssl);" 4 Item "int SSL_get_state(SSL *ssl);" p "long SSL_get_time(\s-1SSL\s0 *ssl);" 4 Item "long SSL_get_time(SSL *ssl);" p "long SSL_get_timeout(\s-1SSL\s0 *ssl);" 4 Item "long SSL_get_timeout(SSL *ssl);" p "int (*SSL_get_verify_callback(\s-1SSL\s0 *ssl);)(void)" 4 Item "int (*SSL_get_verify_callback(SSL *ssl);)(void)" p "int SSL_get_verify_mode(\s-1SSL\s0 *ssl);" 4 Item "int SSL_get_verify_mode(SSL *ssl);" p "long SSL_get_verify_result(\s-1SSL\s0 *ssl);" 4 Item "long SSL_get_verify_result(SSL *ssl);" p "char *SSL_get_version(\s-1SSL\s0 *ssl);" 4 Item "char *SSL_get_version(SSL *ssl);" p "\s-1BIO\s0 *SSL_get_wbio(\s-1SSL\s0 *ssl);" 4 Item "BIO *SSL_get_wbio(SSL *ssl);" p "int SSL_in_accept_init(\s-1SSL\s0 *ssl);" 4 Item "int SSL_in_accept_init(SSL *ssl);" p "int SSL_in_before(\s-1SSL\s0 *ssl);" 4 Item "int SSL_in_before(SSL *ssl);" p "int SSL_in_connect_init(\s-1SSL\s0 *ssl);" 4 Item "int SSL_in_connect_init(SSL *ssl);" p "int SSL_in_init(\s-1SSL\s0 *ssl);" 4 Item "int SSL_in_init(SSL *ssl);" p "int SSL_is_init_finished(\s-1SSL\s0 *ssl);" 4 Item "int SSL_is_init_finished(SSL *ssl);" p "\s-1STACK\s0 *SSL_load_client_CA_file(char *file);" 4 Item "STACK *SSL_load_client_CA_file(char *file);" p "void SSL_load_error_strings(void);" 4 Item "void SSL_load_error_strings(void);" p "\s-1SSL\s0 *SSL_new(\s-1SSL_CTX\s0 *ctx);" 4 Item "SSL *SSL_new(SSL_CTX *ctx);" p "long SSL_num_renegotiations(\s-1SSL\s0 *ssl);" 4 Item "long SSL_num_renegotiations(SSL *ssl);" p "int SSL_peek(\s-1SSL\s0 *ssl, void *buf, int num);" 4 Item "int SSL_peek(SSL *ssl, void *buf, int num);" p "int SSL_pending(\s-1SSL\s0 *ssl);" 4 Item "int SSL_pending(SSL *ssl);" p "int SSL_read(\s-1SSL\s0 *ssl, void *buf, int num);" 4 Item "int SSL_read(SSL *ssl, void *buf, int num);" p "int SSL_renegotiate(\s-1SSL\s0 *ssl);" 4 Item "int SSL_renegotiate(SSL *ssl);" p "char *SSL_rstate_string(\s-1SSL\s0 *ssl);" 4 Item "char *SSL_rstate_string(SSL *ssl);" p "char *SSL_rstate_string_long(\s-1SSL\s0 *ssl);" 4 Item "char *SSL_rstate_string_long(SSL *ssl);" p "long SSL_session_reused(\s-1SSL\s0 *ssl);" 4 Item "long SSL_session_reused(SSL *ssl);" p "void SSL_set_accept_state(\s-1SSL\s0 *ssl);" 4 Item "void SSL_set_accept_state(SSL *ssl);" p "void SSL_set_app_data(\s-1SSL\s0 *ssl, char *arg);" 4 Item "void SSL_set_app_data(SSL *ssl, char *arg);" p "void SSL_set_bio(\s-1SSL\s0 *ssl, \s-1BIO\s0 *rbio, \s-1BIO\s0 *wbio);" 4 Item "void SSL_set_bio(SSL *ssl, BIO *rbio, BIO *wbio);" p "int SSL_set_cipher_list(\s-1SSL\s0 *ssl, char *str);" 4 Item "int SSL_set_cipher_list(SSL *ssl, char *str);" p "void SSL_set_client_CA_list(\s-1SSL\s0 *ssl, \s-1STACK\s0 *list);" 4 Item "void SSL_set_client_CA_list(SSL *ssl, STACK *list);" p "void SSL_set_connect_state(\s-1SSL\s0 *ssl);" 4 Item "void SSL_set_connect_state(SSL *ssl);" p "int SSL_set_ex_data(\s-1SSL\s0 *ssl, int idx, char *arg);" 4 Item "int SSL_set_ex_data(SSL *ssl, int idx, char *arg);" p "int SSL_set_fd(\s-1SSL\s0 *ssl, int fd);" 4 Item "int SSL_set_fd(SSL *ssl, int fd);" p "void SSL_set_info_callback(\s-1SSL\s0 *ssl, void (*cb);(void))" 4 Item "void SSL_set_info_callback(SSL *ssl, void (*cb);(void))" p "void SSL_set_msg_callback(\s-1SSL\s0 *ctx, void (*cb)(int write_p, int version, int content_type, const void *buf, size_t len, \s-1SSL\s0 *ssl, void *arg));" 4 Item "void SSL_set_msg_callback(SSL *ctx, void (*cb)(int write_p, int version, int content_type, const void *buf, size_t len, SSL *ssl, void *arg));" p "void SSL_set_msg_callback_arg(\s-1SSL\s0 *ctx, void *arg);" 4 Item "void SSL_set_msg_callback_arg(SSL *ctx, void *arg);" p "void SSL_set_options(\s-1SSL\s0 *ssl, unsigned long op);" 4 Item "void SSL_set_options(SSL *ssl, unsigned long op);" p "void SSL_set_quiet_shutdown(\s-1SSL\s0 *ssl, int mode);" 4 Item "void SSL_set_quiet_shutdown(SSL *ssl, int mode);" p "void SSL_set_read_ahead(\s-1SSL\s0 *ssl, int yes);" 4 Item "void SSL_set_read_ahead(SSL *ssl, int yes);" p "int SSL_set_rfd(\s-1SSL\s0 *ssl, int fd);" 4 Item "int SSL_set_rfd(SSL *ssl, int fd);" p "int SSL_set_session(\s-1SSL\s0 *ssl, \s-1SSL_SESSION\s0 *session);" 4 Item "int SSL_set_session(SSL *ssl, SSL_SESSION *session);" p "void SSL_set_shutdown(\s-1SSL\s0 *ssl, int mode);" 4 Item "void SSL_set_shutdown(SSL *ssl, int mode);" p "int SSL_set_ssl_method(\s-1SSL\s0 *ssl, \s-1SSL_METHOD\s0 *meth);" 4 Item "int SSL_set_ssl_method(SSL *ssl, SSL_METHOD *meth);" p "void SSL_set_time(\s-1SSL\s0 *ssl, long t);" 4 Item "void SSL_set_time(SSL *ssl, long t);" p "void SSL_set_timeout(\s-1SSL\s0 *ssl, long t);" 4 Item "void SSL_set_timeout(SSL *ssl, long t);" p "void SSL_set_verify(\s-1SSL\s0 *ssl, int mode, int (*callback);(void))" 4 Item "void SSL_set_verify(SSL *ssl, int mode, int (*callback);(void))" p "void SSL_set_verify_result(\s-1SSL\s0 *ssl, long arg);" 4 Item "void SSL_set_verify_result(SSL *ssl, long arg);" p "int SSL_set_wfd(\s-1SSL\s0 *ssl, int fd);" 4 Item "int SSL_set_wfd(SSL *ssl, int fd);" p "int SSL_shutdown(\s-1SSL\s0 *ssl);" 4 Item "int SSL_shutdown(SSL *ssl);" p "int SSL_state(\s-1SSL\s0 *ssl);" 4 Item "int SSL_state(SSL *ssl);" p "char *SSL_state_string(\s-1SSL\s0 *ssl);" 4 Item "char *SSL_state_string(SSL *ssl);" p "char *SSL_state_string_long(\s-1SSL\s0 *ssl);" 4 Item "char *SSL_state_string_long(SSL *ssl);" p "long SSL_total_renegotiations(\s-1SSL\s0 *ssl);" 4 Item "long SSL_total_renegotiations(SSL *ssl);" p "int SSL_use_PrivateKey(\s-1SSL\s0 *ssl, \s-1EVP_PKEY\s0 *pkey);" 4 Item "int SSL_use_PrivateKey(SSL *ssl, EVP_PKEY *pkey);" p "int SSL_use_PrivateKey_ASN1(int type, \s-1SSL\s0 *ssl, unsigned char *d, long len);" 4 Item "int SSL_use_PrivateKey_ASN1(int type, SSL *ssl, unsigned char *d, long len);" p "int SSL_use_PrivateKey_file(\s-1SSL\s0 *ssl, char *file, int type);" 4 Item "int SSL_use_PrivateKey_file(SSL *ssl, char *file, int type);" p "int SSL_use_RSAPrivateKey(\s-1SSL\s0 *ssl, \s-1RSA\s0 *rsa);" 4 Item "int SSL_use_RSAPrivateKey(SSL *ssl, RSA *rsa);" p "int SSL_use_RSAPrivateKey_ASN1(\s-1SSL\s0 *ssl, unsigned char *d, long len);" 4 Item "int SSL_use_RSAPrivateKey_ASN1(SSL *ssl, unsigned char *d, long len);" p "int SSL_use_RSAPrivateKey_file(\s-1SSL\s0 *ssl, char *file, int type);" 4 Item "int SSL_use_RSAPrivateKey_file(SSL *ssl, char *file, int type);" p "int SSL_use_certificate(\s-1SSL\s0 *ssl, X509 *x);" 4 Item "int SSL_use_certificate(SSL *ssl, X509 *x);" p "int SSL_use_certificate_ASN1(\s-1SSL\s0 *ssl, int len, unsigned char *d);" 4 Item "int SSL_use_certificate_ASN1(SSL *ssl, int len, unsigned char *d);" p "int SSL_use_certificate_file(\s-1SSL\s0 *ssl, char *file, int type);" 4 Item "int SSL_use_certificate_file(SSL *ssl, char *file, int type);" p "int SSL_version(\s-1SSL\s0 *ssl);" 4 Item "int SSL_version(SSL *ssl);" p "int SSL_want(\s-1SSL\s0 *ssl);" 4 Item "int SSL_want(SSL *ssl);" p "int SSL_want_nothing(\s-1SSL\s0 *ssl);" 4 Item "int SSL_want_nothing(SSL *ssl);" p "int SSL_want_read(\s-1SSL\s0 *ssl);" 4 Item "int SSL_want_read(SSL *ssl);" p "int SSL_want_write(\s-1SSL\s0 *ssl);" 4 Item "int SSL_want_write(SSL *ssl);" p "int SSL_want_x509_lookup(s);" 4 Item "int SSL_want_x509_lookup(s);" p "int SSL_write(\s-1SSL\s0 *ssl, const void *buf, int num);" 4 Item "int SSL_write(SSL *ssl, const void *buf, int num);"