Merge branch 'stable'
[gnulib.git] / doc / posix-functions / select.texi
index 1c64752..e9a916f 100644 (file)
@@ -2,28 +2,38 @@
 @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: ---
+Gnulib module: select
 
 Portability problems fixed by Gnulib:
 @itemize
+@item
+On Windows platforms (excluding Cygwin), @code{select} can only be
+called on descriptors created by the @code{socket} function, not on regular
+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.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
-mingw.
-@item
 When you call @code{select} with a timeout, some implementations modify the
 timeout parameter so that upon return from the function, it contains the
 amount of time not slept.  Other implementations leave the timeout parameter
 unmodified.
 @item
-On Windows platforms (excluding Cygwin) and on BeOS, @code{select} can only be
-called on descriptors created by the @code{socket} function, not on regular
-file descriptors.
+On BeOS, @code{select} can only be called on descriptors created by the
+@code{socket} function, not on regular file descriptors.
+@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}.