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 81e5611..26fb202 100644 (file)
--- a/doc/posix-functions/select.texi
+++ b/doc/posix-functions/select.texi
@@ -2,9 +2,9 @@
 @section @code{select}
 @findex select
 
-POSIX specification: @url{http://www.opengroup.org/susv3xsh/select.html}
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/select.html}
 
-Gnulib module: sys_select
+Gnulib module: select
 
 Portability problems fixed by Gnulib:
 @itemize
@@ -15,6 +15,13 @@ file descriptors.
 @item
 On Windows platforms (excluding Cygwin), error codes for @code{accept} are not
 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:
@@ -28,6 +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