From fcf6fca1d584aa2af7e9917e566347b1797213b0 Mon Sep 17 00:00:00 2001 From: Paul Kehrer Date: Sat, 12 Mar 2016 16:21:24 -0400 Subject: add two faq entries for common errors --- docs/faq.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/faq.rst b/docs/faq.rst index 363a350f..14077691 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -23,5 +23,20 @@ OpenSSL. You're seeing this error because your copy of pip is too old to find our wheel files. Upgrade your copy of pip with ``pip install -U pip`` and then try install ``cryptography`` again. +Starting ``cryptography`` using ``mod_wsgi`` produces an ``InternalError`` during a call in ``_register_osrandom_engine`` +------------------------------------------------------------------------------------------------------------------------- + +This happens because ``mod_wsgi`` uses sub-interpreters, which can cause a +problem during initialization of the OpenSSL backend. To resolve this set the +`WSGIApplicationGroup`_ to ``%{GLOBAL}`` in the ``mod_wsgi`` configuration. + +``cryptography`` raised an ``InternalError`` and I'm not sure what to do? +------------------------------------------------------------------------- + +Frequently ``InternalError`` is raised when there are errors on the OpenSSL +error stack that were placed there by other libraries that are also using +OpenSSL. Try removing the other libraries and see if the problem persists. + .. _`NaCl`: https://nacl.cr.yp.to/ .. _`PyNaCl`: https://pynacl.readthedocs.org +.. _`WSGIApplicationGroup`: https://modwsgi.readthedocs.org/en/develop/configuration-directives/WSGIApplicationGroup.html -- cgit v1.2.3 From 4e9bd8cf1f56f18e49991d2964bb89df56eb0d63 Mon Sep 17 00:00:00 2001 From: Paul Kehrer Date: Sat, 12 Mar 2016 16:33:39 -0400 Subject: add more language --- docs/faq.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/faq.rst b/docs/faq.rst index 14077691..3456ba97 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -36,7 +36,11 @@ problem during initialization of the OpenSSL backend. To resolve this set the Frequently ``InternalError`` is raised when there are errors on the OpenSSL error stack that were placed there by other libraries that are also using OpenSSL. Try removing the other libraries and see if the problem persists. +If you have no other libraries using OpenSSL in your process, or they do not +appear to be at fault, it's possible that this is a bug in ``cryptography``. +Please file an `issue`_ with instructions on how to reproduce it. .. _`NaCl`: https://nacl.cr.yp.to/ .. _`PyNaCl`: https://pynacl.readthedocs.org .. _`WSGIApplicationGroup`: https://modwsgi.readthedocs.org/en/develop/configuration-directives/WSGIApplicationGroup.html +.. _`issue`: https://github.com/pyca/cryptography/issues -- cgit v1.2.3