diff --git a/Doc/howto/sockets.rst b/Doc/howto/sockets.rst index cbc49d15a0771b..593705c999dbbb 100644 --- a/Doc/howto/sockets.rst +++ b/Doc/howto/sockets.rst @@ -167,9 +167,10 @@ request, then reads a reply. That's it. The socket is discarded. This means tha a client can detect the end of the reply by receiving 0 bytes. But if you plan to reuse your socket for further transfers, you need to realize -that *there is no* :abbr:`EOT (End of Transfer)` *on a socket.* I repeat: if a socket -``send`` or ``recv`` returns after handling 0 bytes, the connection has been -broken. If the connection has *not* been broken, you may wait on a ``recv`` +that *there is no* :abbr:`EOT (End of Transfer)` *on a socket.* I repeat: if a +``recv`` returns 0 bytes, the connection has been broken. A ``send`` on a +broken connection will raise an :exc:`OSError` instead. If the connection has +*not* been broken, you may wait on a ``recv`` forever, because the socket will *not* tell you that there's nothing more to read (for now). Now if you think about that a bit, you'll come to realize a fundamental truth of sockets: *messages must either be fixed length* (yuck), *or @@ -201,6 +202,8 @@ length message:: sent = self.sock.send(msg[totalsent:]) if sent == 0: raise RuntimeError("socket connection broken") + # Note: in practice, send() on a broken connection + # raises OSError rather than returning 0. totalsent = totalsent + sent def myreceive(self):