diff --git a/Doc/library/ssl.rst b/Doc/library/ssl.rst index 08824feeb3958f2..76adee4d88ba021 100644 --- a/Doc/library/ssl.rst +++ b/Doc/library/ssl.rst @@ -1315,6 +1315,20 @@ SSL sockets also have the following additional methods and attributes: .. versionadded:: 3.2 +.. attribute:: SSLSocket.eager_recv + + If set to ``True``, a call to :meth:`~socket.socket.recv()` or + :meth:`~socket.socket.recv_into()` on a + :ref:`non-blocking ` TLS socket + will drop the GIL once to read the entire buffer instead of reading at most + one TLS record (16 KB). + + .. note:: + Reading the entire buffer can include the TLS EOF segment, which will + close the TLS layer without raising :exc:`SSLEOFError`. + + .. versionadded:: 3.11 + .. attribute:: SSLSocket.server_side A boolean which is ``True`` for server-side sockets and ``False`` for