summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2010-07-11 09:23:11 (GMT)
committerGeorg Brandl <georg@python.org>2010-07-11 09:23:11 (GMT)
commit0104bcdb801b643eeb9f1845e026fcefdecfc48e (patch)
tree1608353b5ea4b72443fb395a9b0fde7682b1d9d0
parentd3950527e7b51129accad96a9890ab99224e918a (diff)
downloadcpython-0104bcdb801b643eeb9f1845e026fcefdecfc48e.zip
cpython-0104bcdb801b643eeb9f1845e026fcefdecfc48e.tar.gz
cpython-0104bcdb801b643eeb9f1845e026fcefdecfc48e.tar.bz2
#6774: explain shutdown() behavior varying with platform.
-rw-r--r--Doc/library/socket.rst4
1 files changed, 3 insertions, 1 deletions
diff --git a/Doc/library/socket.rst b/Doc/library/socket.rst
index 1cc0f04..75d86b7 100644
--- a/Doc/library/socket.rst
+++ b/Doc/library/socket.rst
@@ -748,7 +748,9 @@ timeout error of its own regardless of any Python socket timeout setting.
Shut down one or both halves of the connection. If *how* is :const:`SHUT_RD`,
further receives are disallowed. If *how* is :const:`SHUT_WR`, further sends
are disallowed. If *how* is :const:`SHUT_RDWR`, further sends and receives are
- disallowed.
+ disallowed. Depending on the platform, shutting down one half of the connection
+ can also close the opposite half (e.g. on Mac OS X, ``shutdown(SHUT_WR)`` does
+ not allow further reads on the other end of the connection).
Note that there are no methods :meth:`read` or :meth:`write`; use
:meth:`~socket.recv` and :meth:`~socket.send` without *flags* argument instead.