regex: test for buffer overrun

[gnulib.git] / doc / posix-functions / select.texi

diff --git a/doc/posix-functions/select.texi b/doc/posix-functions/select.texi
index 0b52c27..26fb202 100644 (file)
--- a/doc/posix-functions/select.texi
+++ b/doc/posix-functions/select.texi
@@ -2,7 +2,7 @@
 @section @code{select}
 @findex select
 
-POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/select.html}
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/select.html}
 
 Gnulib module: select
 
@@ -18,6 +18,10 @@ placed in @code{errno}, and @code{WSAGetLastError} must be used instead.
 @item
 This function fails when the @code{nfds} argument is 0 on some platforms:
 Interix 3.5.
+@item
+On some platforms, this function fails to detect invalid fds with
+EBADF, but only if they lie beyond the current maximum open fd:
+FreeBSD 8.2.
 @end itemize
 
 Portability problems not fixed by Gnulib:
@@ -31,10 +35,18 @@ unmodified.
 On BeOS, @code{select} can only be called on descriptors created by the
 @code{socket} function, not on regular file descriptors.
 @item
+Under Windows, when passing a pipe, Gnulib's @code{select} replacement might
+return 0 even before the timeout has passed.  Programs using it with pipes can
+thus busy wait.
+@item
 On Solaris 2.6 and older, @code{select} applied to a file descriptor opened
 for reading and associated with @code{/dev/null} hangs, waiting for input,
 when instead it should return immediately.
 @item
 On Linux, when some file descriptor refers to a regular file, @code{select}
 may fail, setting @code{errno} to @code{EBADF}.
+@item
+This function is declared in @code{<unistd.h>}, not @code{<sys/select.h>},
+on some platforms:
+IRIX 5.3.
 @end itemize