From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Tue, 20 Feb 2024 15:00:30 +0000 (+0100) Subject: [3.11] gh-112020: Document the meaning of empty bytes returned by socket.recv() ... X-Git-Tag: v3.11.9~167 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5a0d51b6291f55652e0ac577988fbb5f28279e04;p=thirdparty%2FPython%2Fcpython.git [3.11] gh-112020: Document the meaning of empty bytes returned by socket.recv() (GH-112055) (GH-115723) (cherry picked from commit e71468ba4f5fb2da0cefe9e923b01811cb53fb5f) Co-authored-by: talcs --- diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst index 809c8469e01f..3a5368717ac1 100644 --- a/Doc/library/socket.rst +++ b/Doc/library/socket.rst @@ -1506,8 +1506,9 @@ to sockets. Receive data from the socket. The return value is a bytes object representing the data received. The maximum amount of data to be received at once is specified - by *bufsize*. See the Unix manual page :manpage:`recv(2)` for the meaning of - the optional argument *flags*; it defaults to zero. + by *bufsize*. A returned empty bytes object indicates that the client has disconnected. + See the Unix manual page :manpage:`recv(2)` for the meaning of the optional argument + *flags*; it defaults to zero. .. note::