openssl/doc/ssl
Geoff Thorpe e0db2eed8d Correct and enhance the behaviour of "internal" session caching as it
relates to SSL_CTX flags and the use of "external" session caching. The
existing flag, "SSL_SESS_CACHE_NO_INTERNAL_LOOKUP" remains but is
supplemented with a complimentary flag, "SSL_SESS_CACHE_NO_INTERNAL_STORE".
The bitwise OR of the two flags is also defined as
"SSL_SESS_CACHE_NO_INTERNAL" and is the flag that should be used by most
applications wanting to implement session caching *entirely* by its own
provided callbacks. As the documented behaviour contradicted actual
behaviour up until recently, and since that point behaviour has itself been
inconsistent anyway, this change should not introduce any compatibility
problems. I've adjusted the relevant documentation to elaborate about how
this works.

Kudos to "Nadav Har'El" <nyh@math.technion.ac.il> for diagnosing these
anomalies and testing this patch for correctness.

PR: 311
2002-10-29 00:33:04 +00:00
..
d2i_SSL_SESSION.pod Update information as a partial response to the post 2001-10-12 12:29:16 +00:00
SSL_accept.pod Manual page for SSL_do_handshake(). 2002-07-19 11:05:50 +00:00
SSL_alert_type_string.pod ispell 2001-09-07 06:13:40 +00:00
SSL_CIPHER_get_name.pod ispell 2001-02-16 02:09:53 +00:00
SSL_clear.pod SSL_clear != SSL_free/SSL_new 2002-02-27 08:08:57 +00:00
SSL_COMP_add_compression_method.pod Make clear, that using the compression layer is currently not recommended. 2001-08-23 09:42:12 +00:00
SSL_connect.pod Manual page for SSL_do_handshake(). 2002-07-19 11:05:50 +00:00
SSL_CTX_add_extra_chain_cert.pod Even though it is not really practical people should know about it. 2002-02-15 07:41:42 +00:00
SSL_CTX_add_session.pod Correct and enhance the behaviour of "internal" session caching as it 2002-10-29 00:33:04 +00:00
SSL_CTX_ctrl.pod New functions SSL[_CTX]_set_msg_callback(). 2001-10-20 17:56:36 +00:00
SSL_CTX_flush_sessions.pod Documenting session caching, 2nd step. 2001-02-04 18:05:27 +00:00
SSL_CTX_free.pod Typo. 2001-09-13 15:18:51 +00:00
SSL_CTX_get_ex_new_index.pod Typos. 2001-05-14 09:52:44 +00:00
SSL_CTX_get_verify_mode.pod New docs and new facts in older docs. 2000-10-12 09:56:36 +00:00
SSL_CTX_load_verify_locations.pod ispell 2001-09-07 06:13:40 +00:00
SSL_CTX_new.pod Fix wrong information about SSL_set_connect_state()... 2001-07-25 12:12:51 +00:00
SSL_CTX_sess_number.pod ispell 2001-02-16 02:09:53 +00:00
SSL_CTX_sess_set_cache_size.pod Typos in links between manual pages 2002-07-10 19:35:54 +00:00
SSL_CTX_sess_set_get_cb.pod Typos in links between manual pages 2002-07-10 19:35:54 +00:00
SSL_CTX_sessions.pod ispell 2001-02-16 02:09:53 +00:00
SSL_CTX_set_cert_store.pod Typo. 2002-06-04 20:43:10 +00:00
SSL_CTX_set_cert_verify_callback.pod Add 'void *' argument to app_verify_callback. 2002-02-28 10:52:56 +00:00
SSL_CTX_set_cipher_list.pod Additional inline reference. 2001-07-23 12:57:37 +00:00
SSL_CTX_set_client_CA_list.pod Fix wrong information with respect to CAs listed to the client 2001-04-12 16:02:34 +00:00
SSL_CTX_set_client_cert_cb.pod Correct wrong usage information. 2002-06-12 20:15:18 +00:00
SSL_CTX_set_default_passwd_cb.pod Clarify! (based on recent mailing-list discussions) 2001-07-11 15:10:28 +00:00
SSL_CTX_set_generate_session_id.pod Describe new callback for session id generation. 2001-02-23 21:38:42 +00:00
SSL_CTX_set_info_callback.pod remove incorrect 'callback' prototype 2001-11-10 02:12:56 +00:00
SSL_CTX_set_max_cert_list.pod Make maximum certifcate chain size accepted from the peer application 2001-09-11 13:08:51 +00:00
SSL_CTX_set_mode.pod Clarify! (based on recent mailing-list discussions) 2001-07-11 15:10:28 +00:00
SSL_CTX_set_msg_callback.pod Missing =back. 2002-08-15 10:59:55 +00:00
SSL_CTX_set_options.pod Typos in links between manual pages 2002-07-10 19:35:54 +00:00
SSL_CTX_set_quiet_shutdown.pod SSL_shutdown() has even more properties... 2001-08-17 15:09:31 +00:00
SSL_CTX_set_session_cache_mode.pod Correct and enhance the behaviour of "internal" session caching as it 2002-10-29 00:33:04 +00:00
SSL_CTX_set_session_id_context.pod New manual page for a hardly known but important item :-) 2001-01-31 14:14:20 +00:00
SSL_CTX_set_ssl_version.pod Add newly learned knowledge from yesterday's discussion. 2001-03-08 17:24:02 +00:00
SSL_CTX_set_timeout.pod More details about session timeout settings. 2001-08-17 16:36:51 +00:00
SSL_CTX_set_tmp_dh_callback.pod ispell 2001-09-07 06:13:40 +00:00
SSL_CTX_set_tmp_rsa_callback.pod ispell 2001-09-07 06:13:40 +00:00
SSL_CTX_set_verify.pod As discussed recently on openssl-users. 2001-08-23 15:00:11 +00:00
SSL_CTX_use_certificate.pod Even though it is not really practical people should know about it. 2002-02-15 07:41:42 +00:00
SSL_do_handshake.pod Manual page for SSL_do_handshake(). 2002-07-19 11:05:50 +00:00
SSL_free.pod Finish first round of session cache documentation. 2001-02-13 14:00:09 +00:00
SSL_get_ciphers.pod New documentation about things related to SSL_CIPHER. Submitted by Lutz Jaenicke <Lutz.Jaenicke@aet.TU-Cottbus.DE> 2000-09-18 16:42:30 +00:00
SSL_get_client_CA_list.pod Even though it is not really practical people should know about it. 2002-02-15 07:41:42 +00:00
SSL_get_current_cipher.pod New documentation about things related to SSL_CIPHER. Submitted by Lutz Jaenicke <Lutz.Jaenicke@aet.TU-Cottbus.DE> 2000-09-18 16:42:30 +00:00
SSL_get_default_timeout.pod More details about session timeout settings. 2001-08-17 16:36:51 +00:00
SSL_get_error.pod mention SSL_do_handshake() 2002-07-29 12:35:19 +00:00
SSL_get_ex_data_X509_STORE_CTX_idx.pod Documentation about SSL_get_ex_data_X509_STORE_CTX_idx and 2001-01-20 16:22:43 +00:00
SSL_get_ex_new_index.pod Typos. 2001-05-14 09:52:44 +00:00
SSL_get_fd.pod ispell and some other nit-picking 2000-09-16 15:39:28 +00:00
SSL_get_peer_cert_chain.pod ispell 2001-02-16 02:09:53 +00:00
SSL_get_peer_certificate.pod ispell 2001-09-07 06:13:40 +00:00
SSL_get_rbio.pod ispell and some other nit-picking 2000-09-16 15:39:28 +00:00
SSL_get_session.pod Clarify reference count handling/removal of session 2001-11-19 11:11:23 +00:00
SSL_get_SSL_CTX.pod One more function documented. 2001-08-17 15:54:50 +00:00
SSL_get_verify_result.pod ispell 2001-02-16 02:09:53 +00:00
SSL_get_version.pod SSL_get_version() was an easy one :-) 2001-02-23 21:05:56 +00:00
SSL_library_init.pod Change IMPORTANT to WARNING for greater emphasis. 2000-09-21 17:21:15 +00:00
SSL_load_client_CA_file.pod More SSL functions documented. Submitted by Lutz Jaenicke <Lutz.Jaenicke@aet.TU-Cottbus.DE> 2000-10-03 22:02:28 +00:00
SSL_new.pod One more function documented. 2001-08-17 15:54:50 +00:00
SSL_pending.pod Fix SSL_peek and SSL_pending. 2000-12-25 18:40:46 +00:00
SSL_read.pod Rework section about return values another time (based on hints from 2001-09-13 13:21:38 +00:00
SSL_rstate_string.pod More manual pages. Constify. 2001-08-23 17:22:43 +00:00
SSL_SESSION_free.pod Update information as a partial response to the post 2001-10-12 12:29:16 +00:00
SSL_SESSION_get_ex_new_index.pod Typos. 2001-05-14 09:52:44 +00:00
SSL_SESSION_get_time.pod More details about session timeout settings. 2001-08-17 16:36:51 +00:00
SSL_session_reused.pod Some more documentation bits. 2001-07-20 18:57:15 +00:00
SSL_set_bio.pod Change spelling back to "behaviour" and "flavour" instead of the 2000-09-16 16:00:38 +00:00
SSL_set_connect_state.pod Manual page for SSL_do_handshake(). 2002-07-19 11:05:50 +00:00
SSL_set_fd.pod Change spelling back to "behaviour" and "flavour" instead of the 2000-09-16 16:00:38 +00:00
SSL_set_session.pod Update information as a partial response to the post 2001-10-12 12:29:16 +00:00
SSL_set_shutdown.pod More interdependencies with respect to shutdown behaviour. 2001-08-20 14:34:16 +00:00
SSL_set_verify_result.pod New documents. Lutz Jaenicke <Lutz.Jaenicke@aet.TU-Cottbus.DE> 2000-09-20 16:55:26 +00:00
SSL_shutdown.pod More interdependencies with respect to shutdown behaviour. 2001-08-20 14:34:16 +00:00
SSL_state_string.pod More docs. 2001-08-24 14:29:48 +00:00
SSL_want.pod One more step on the way for complete documentation... 2001-08-17 14:32:38 +00:00
SSL_write.pod The behaviour is undefined when calling SSL_write() with num=0. 2002-07-19 11:53:54 +00:00
ssl.pod Manual page for SSL_do_handshake(). 2002-07-19 11:05:50 +00:00