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 This function crashes when invoked with invalid arguments on some platforms:
  13 MSVC 9.
  14 @item
  15 When reading from a non-blocking pipe whose buffer is empty, this function
  16 fails with @code{errno} being set to @code{EINVAL} instead of @code{EAGAIN} on
  17 some platforms:
  18 mingw, MSVC 9.
  19 @end itemize
  20
  21 Portability problems not fixed by Gnulib:
  22 @itemize
  23 @item
  24 This function may fail with error @code{EINTR}, even in programs that don't
  25 install any signal handlers, on some platforms:
  26 Mac OS X 10.5.
  27 @end itemize
  28
  29 For handling @code{EINTR}, Gnulib provides a module @samp{safe-read} with a
  30 function @code{safe_read}.