]> Savannah Git Hosting - gnulib.git/commitdiff
poll/select: document portability problems not fixed by Gnulib.
authorPaolo Bonzini <pbonzini@redhat.com>
Thu, 13 Sep 2012 06:51:16 +0000 (08:51 +0200)
committerPaolo Bonzini <pbonzini@redhat.com>
Thu, 13 Sep 2012 06:57:01 +0000 (08:57 +0200)
* doc/posix-functions/poll.texi: poll does not work well on
pipes under Windows.  It has the same limitations as select on
BeOS.
* doc/posix-functions/select.texi: select does not work well
on pipes under Windows.

ChangeLog
doc/posix-functions/poll.texi
doc/posix-functions/select.texi

index 18225e4ff0ae32a70c128daf51a53fec8e5be1b5..ab09b0e6402cb898fd19fe4a0c4de3a28ef00542 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2012-09-13  Paolo Bonzini  <bonzini@gnu.org>
+
+       poll/select: document portability problems not fixed by Gnulib.
+       * doc/posix-functions/poll.texi: poll does not work well on
+       pipes under Windows.  It has the same limitations as select on
+       BeOS.
+       * doc/posix-functions/select.texi: select does not work well
+       on pipes under Windows.
+
 2012-09-10  Paul Eggert  <eggert@cs.ucla.edu>
 
        fcntl-h: check for AIX 7.1 bug with O_NOFOLLOW and O_CREAT
index 1c3da5bb2caa4ef37017b1b3762a08f12cffcbfd..da619b99ddf9153287196f66aafc48d3b66759ce 100644 (file)
@@ -19,4 +19,12 @@ Mac OS X 10.4.0, AIX 5.3.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+Under BeOS, Gnulib's @code{poll} replacement 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{poll} replacement might
+return 0 even before the timeout has passed.  Programs using it with pipes can
+thus busy wait.
 @end itemize
index e59b3cf8e69afe03b85c35082954a9af12c408c0..c13b30f55ac893d5d1aa603f04cfbc4e491011db 100644 (file)
@@ -31,6 +31,10 @@ 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.