Document incompatibility between wheel package and ssl module

Close #543.
This commit is contained in:
Daniele Varrazzo 2017-06-14 01:45:47 +01:00
parent 338dbe70a6
commit 9b4de93bdc

View File

@ -56,11 +56,20 @@ using something like ``pip install -U pip``)
.. note:: .. note::
The binary packages come with their own versions of a few C libraries, The binary packages come with their own versions of a few C libraries,
among which libpq and libssl, which will be used regardless of other among which ``libpq`` and ``libssl``, which will be used regardless of other
libraries available on the client: upgrading the system libraries will not libraries available on the client: upgrading the system libraries will not
upgrade the libraries used by `!psycopg2`. Please build `!psycopg2` from upgrade the libraries used by `!psycopg2`. Please build `!psycopg2` from
source if you want to maintain binary upgradeability. source if you want to maintain binary upgradeability.
.. warning::
Because the `!psycopg` wheel package uses its own ``libssl`` binary, it is
incompatible with other extension modules binding with ``libssl`` as well,
for instance the Python `ssl` module: the result will likely be a
segfault. If you need using both `!psycopg2` and other libraries using
``libssl`` please :ref:`install psycopg from source
<install-from-source>`.
If you prefer to use the system libraries available on your client you can use If you prefer to use the system libraries available on your client you can use
the :command:`pip` ``--no-binary`` option: the :command:`pip` ``--no-binary`` option:
@ -105,8 +114,8 @@ Build prerequisites
These notes illustrate how to compile Psycopg on Linux. If you want to compile These notes illustrate how to compile Psycopg on Linux. If you want to compile
Psycopg on other platforms you may have to adjust some details accordingly. Psycopg on other platforms you may have to adjust some details accordingly.
Psycopg is a C wrapper to the libpq PostgreSQL client library. To install it Psycopg is a C wrapper around the libpq_ PostgreSQL client library. To install
from sources you will need: it from sources you will need:
- A C compiler. - A C compiler.