From: Hernan Perez Masci <hmasci@uolsinectis.com.ar>
Date: Fri, 8 Apr 2005 15:28:28 +0000 (-0300)
Subject: perlfunc.pod: incomplete select description
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=ec8ce15a509319429ec7650026fe4a9ff9f2ee0d;p=p5sagit%2Fp5-mst-13.2.git

perlfunc.pod: incomplete select description
Message-Id: <200504081528.28307.hmasci@uolsinectis.com.ar>

p4raw-id: //depot/perl@24224
---

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 552587a..921bc2d 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -4605,6 +4605,12 @@ portability of C<select>.
 
 On error, C<select> returns C<undef> and sets C<$!>.
 
+Note: on some Unixes, the select(2) system call may report a socket file
+descriptor as "ready for reading", when actually no data is available,
+thus a subsequent read blocks. It can be avoided using always the
+O_NONBLOCK flag on the socket. See select(2) and fcntl(2) for further
+details.
+
 B<WARNING>: One should not attempt to mix buffered I/O (like C<read>
 or <FH>) with C<select>, except as permitted by POSIX, and even
 then only on POSIX systems.  You have to use C<sysread> instead.