From cfb2a0a8559d6d4b3011f1bc04147d25819c7907 Mon Sep 17 00:00:00 2001 From: Victor Stinner Date: Fri, 10 Oct 2014 12:45:10 +0200 Subject: Issue #22564: ssl doc: mention asyncio in the non-blocking section --- Doc/library/ssl.rst | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst index 6489ecf..095a831 100644 --- a/Doc/library/ssl.rst +++ b/Doc/library/ssl.rst @@ -794,7 +794,7 @@ SSL sockets also have the following additional methods and attributes: instead, and return the number of bytes read. Raise :exc:`SSLWantReadError` or :exc:`SSLWantWriteError` if the socket is - non-blocking and the read would block. + :ref:`non-blocking ` and the read would block. As at any time a re-negotiation is possible, a call to :meth:`read` can also cause write operations. @@ -805,7 +805,7 @@ SSL sockets also have the following additional methods and attributes: *buf* argument must be an object supporting the buffer interface. Raise :exc:`SSLWantReadError` or :exc:`SSLWantWriteError` if the socket is - non-blocking and the write would block. + :ref:`non-blocking ` and the write would block. As at any time a re-negotiation is possible, a call to :meth:`write` can also cause read operations. @@ -1691,6 +1691,14 @@ thus several things you need to be aware of: except ssl.SSLWantWriteError: select.select([], [sock], []) +.. seealso:: + + The :mod:`asyncio` module supports non-blocking SSL sockets and provides a + higher level API. It polls for events using the :mod:`selectors` module and + handles :exc:`SSLWantWriteError`, :exc:`SSLWantReadError` and + :exc:`BlockingIOError` exceptions. It runs the SSL handshake asynchronously + as well. + .. _ssl-security: -- cgit v0.12