summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>2003-12-13 22:12:53 (GMT)
committerGuido van Rossum <guido@python.org>2003-12-13 22:12:53 (GMT)
commit5a92175fbce5b2244e6873457bec48d359ffadbc (patch)
tree6e4babf6eeea74d6f41f579f2c8e267ef64ef58b
parent2cbdc2a461eb2bb5e2437f4e04952cde1155204a (diff)
downloadcpython-5a92175fbce5b2244e6873457bec48d359ffadbc.zip
cpython-5a92175fbce5b2244e6873457bec48d359ffadbc.tar.gz
cpython-5a92175fbce5b2244e6873457bec48d359ffadbc.tar.bz2
After hearing from someone who gave up on timeout sockets due to a
mistake in his code, I'm adding a note explaining that you should call settimeout() before connect().
-rw-r--r--Doc/lib/libsocket.tex4
1 files changed, 4 insertions, 0 deletions
diff --git a/Doc/lib/libsocket.tex b/Doc/lib/libsocket.tex
index 09c4c8d..1c48108 100644
--- a/Doc/lib/libsocket.tex
+++ b/Doc/lib/libsocket.tex
@@ -625,6 +625,10 @@ method should only be used when the socket is in blocking mode; in
timeout or non-blocking mode file operations that cannot be completed
immediately will fail.
+Note that the \method{connect()} operation is subject to the timeout
+setting, and in general it is recommended to call
+\method{settimeout()} before calling \method{connect()}.
+
\begin{methoddesc}[socket]{setsockopt}{level, optname, value}
Set the value of the given socket option (see the \UNIX{} manual page
\manpage{setsockopt}{2}). The needed symbolic constants are defined in