tree 6a9b1f851772eeac6a8b4bd0391e2e987d86dc11
parent 7a1eefd3cd8f697b33bf5348ea4d5c1e581dcdb6
author David Benjamin <davidben@chromium.org> 1445140806 -0400
committer Adam Langley <alangley@gmail.com> 1445885018 +0000

Document the rest of ssl.h.

Although Chromium actually uses SSL_(get_)state as part of its fallback
reason heuristic, that function really should go in the deprecated
bucket. I kept SSL_state_string_long since having a human-readable
string is probably useful for logging.

SSL_set_SSL_CTX was only half-documented as the behavior of this
function is very weird. This warrants further investigation and
rethinking.

SSL_set_shutdown is absurd. I added an assert to trip up clearing bits
and set it to a bitwise OR since clearing bits may mess up the state
machine. Otherwise there's enough consumers and it's not quite the same
as SSL_CTX_set_quiet_shutdown that I've left it alone for now.

Change-Id: Ie35850529373a5a795f6eb04222668ff76d84aaa
Reviewed-on: https://boringssl-review.googlesource.com/6312
Reviewed-by: Adam Langley <alangley@gmail.com>