diff options
author | Paul Kehrer <paul.l.kehrer@gmail.com> | 2019-02-03 15:01:52 -0600 |
---|---|---|
committer | Alex Gaynor <alex.gaynor@gmail.com> | 2019-02-03 16:01:52 -0500 |
commit | 91e69f3b47aea16c4cbd0beb9a220b1bb760dfbe (patch) | |
tree | 554c453b373477c311d4ebfefdc103a4b17cd14a | |
parent | 57f8a533c3615e7df110561d1be56621a129e4e4 (diff) | |
download | cryptography-91e69f3b47aea16c4cbd0beb9a220b1bb760dfbe.tar.gz cryptography-91e69f3b47aea16c4cbd0beb9a220b1bb760dfbe.tar.bz2 cryptography-91e69f3b47aea16c4cbd0beb9a220b1bb760dfbe.zip |
update the thread link (#4748)
* update the thread link
linkcheck doing its job!
* update our locking information
-rw-r--r-- | docs/hazmat/bindings/openssl.rst | 19 |
1 files changed, 9 insertions, 10 deletions
diff --git a/docs/hazmat/bindings/openssl.rst b/docs/hazmat/bindings/openssl.rst index ac65aa97..ac9ccedf 100644 --- a/docs/hazmat/bindings/openssl.rst +++ b/docs/hazmat/bindings/openssl.rst @@ -33,16 +33,15 @@ OpenSSL version 1.0.1 and greater. Threading --------- -``cryptography`` enables OpenSSLs `thread safety facilities`_ in two different -ways depending on the configuration of your system. Normally the locking -callbacks provided by your Python implementation specifically for OpenSSL will -be used. However, if you have linked ``cryptography`` to a different version of -OpenSSL than that used by your Python implementation we enable an alternative -locking callback. This version is implemented in Python and so may result in -lower performance in some situations. In particular parallelism is reduced -because it has to acquire the GIL whenever any lock operations occur within -OpenSSL. +``cryptography`` enables OpenSSLs `thread safety facilities`_ in several +different ways depending on the configuration of your system. For users on +OpenSSL 1.1.0 or newer (including anyone who uses a binary wheel) the OpenSSL +internal locking callbacks are automatically used. Otherwise, we first attempt +to use the callbacks provided by your Python implementation specifically for +OpenSSL. This will work in every case except where ``cryptography`` is linked +against a different version of OpenSSL than the one used by your Python +implementation. For this final case we have a C-based locking callback. .. _`CFFI`: https://cffi.readthedocs.io .. _`OpenSSL`: https://www.openssl.org/ -.. _`thread safety facilities`: https://www.openssl.org/docs/man1.0.2/crypto/threads.html +.. _`thread safety facilities`: https://www.openssl.org/docs/man1.0.2/man3/CRYPTO_THREADID_set_callback.html |