diff options
Diffstat (limited to 'Doc/library/socket.rst')
| -rw-r--r-- | Doc/library/socket.rst | 21 |
1 files changed, 15 insertions, 6 deletions
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst index bbe512b..4877301 100644 --- a/Doc/library/socket.rst +++ b/Doc/library/socket.rst @@ -26,6 +26,15 @@ files, buffer allocation on receive operations is automatic, and buffer length is implicit on send operations. +.. seealso:: + + Module :mod:`socketserver` + Classes that simplify writing network servers. + + Module :mod:`ssl` + A TLS/SSL wrapper for socket objects. + + Socket families --------------- @@ -487,12 +496,6 @@ The module :mod:`socket` exports the following constants and functions: same as ``type(socket(...))``. -.. seealso:: - - Module :mod:`socketserver` - Classes that simplify writing network servers. - - .. _socket-objects: Socket Objects @@ -522,6 +525,12 @@ correspond to Unix system calls applicable to sockets. remote end will receive no more data (after queued data is flushed). Sockets are automatically closed when they are garbage-collected. + .. note:: + :meth:`close()` releases the resource associated with a connection but + does not necessarily close the connection immediately. If you want + to close the connection in a timely fashion, call :meth:`shutdown()` + before :meth:`close()`. + .. method:: socket.connect(address) |