doc/posix-functions/read.texi

   1 @node read
   2 @section @code{read}
   3 @findex read
   4
   5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/read.html}
   6
   7 Gnulib module: stdio, nonblocking
   8
   9 Portability problems fixed by Gnulib module @code{stdio}, together with module @code{nonblocking}:
  10 @itemize
  11 @item
  12 When reading from a non-blocking pipe whose buffer is empty, this function
  13 fails with @code{errno} being set to @code{EINVAL} instead of @code{EAGAIN} on
  14 some platforms:
  15 mingw.
  16 @end itemize
  17
  18 Portability problems not fixed by Gnulib:
  19 @itemize
  20 @item
  21 This function may fail with error @code{EINTR}, even in programs that don't
  22 install any signal handlers, on some platforms:
  23 MacOS X 10.5.
  24 @end itemize
  25
  26 For handling @code{EINTR}, Gnulib provides a module @samp{safe-read} with a
  27 function @code{safe_read}.