diff options
author | lloyd <lloyd@randombit.net> | 2012-06-29 13:24:23 +0000 |
---|---|---|
committer | lloyd <lloyd@randombit.net> | 2012-06-29 13:24:23 +0000 |
commit | ae0530ad7a8a6b341d66dfb92303e4dd48e69f86 (patch) | |
tree | 4f0e84514855a2adfe546bd51ce90decdcb9d2d4 | |
parent | b4b0f986adf31c94af35e9d8b69942c8ea865d7f (diff) |
Improve TLS::Channel documentation
-rw-r--r-- | doc/tls.txt | 17 |
1 files changed, 13 insertions, 4 deletions
diff --git a/doc/tls.txt b/doc/tls.txt index 591bbdd92..247d6f7c9 100644 --- a/doc/tls.txt +++ b/doc/tls.txt @@ -48,13 +48,12 @@ available: .. cpp:function:: bool is_active() Returns true if and only if a handshake has been completed on this - connection. + connection and the connection has not been subsequently closed. .. cpp:function:: bool is_closed() - Returns true if and only if a close notification has been sent or - received, or if a fatal alert of any kind was received from the - counterparty. + Returns true if and only if either a close notification or a fatal + alert message have been either sent or received. .. cpp:function:: void renegotiate(bool force_full_renegotiation = false) @@ -62,6 +61,16 @@ available: protocol to ignore this request. If a successful renegotiation occurs, the *handshake_complete* callback will be called again. + If *force_full_renegotiation* is false, then the client will + attempt to simply renew the current session - this will refresh the + symmetric keys but will not change the session master + secret. Otherwise it will initiate a completely new session. + + For a server, if *force_full_renegotiation* is false, then a + session resumption will be allowed if the client attempts + it. Otherwise the server will prevent resumption and force the + creation of a new session. + .. cpp:function:: std::vector<X509_Certificate> peer_cert_chain() Returns the certificate chain of the server |