c_cpp/lib/gnulib/doc/posix-functions/dup2.texi

   1 @node dup2
   2 @section @code{dup2}
   3 @findex dup2
   4
   5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/dup2.html}
   6
   7 Gnulib module: dup2 or dup2-obsolete
   8
   9 Portability problems fixed by either Gnulib module @code{dup2} or @code{dup2-obsolete}:
  10 @itemize
  11 @item
  12 This function always returns 0 for success on some platforms:
  13 mingw, MSVC 9.
  14
  15 @item
  16 This function can hang when duplicating an fd to itself on some platforms:
  17 mingw, MSVC 9.
  18
  19 @item
  20 This function crashes when invoked with invalid arguments on some platforms:
  21 Cygwin 1.7.17, MSVC 9.
  22
  23 @item
  24 This function crashes when invoked with valid arguments on some platforms:
  25 Cygwin 1.7.25.
  26
  27 @item
  28 This function fails with @code{EINVAL} when duplicating an fd to itself:
  29 Android.
  30
  31 @item
  32 This function resets the @code{FD_CLOEXEC} flag when duplicating an fd
  33 to itself on some platforms:
  34 Haiku.
  35
  36 @item
  37 This function returns 0 for @code{dup2 (1, 1)} on some platforms:
  38 Cygwin 1.5.x.
  39
  40 @item
  41 This function may return @code{-EBADF} instead of @code{-1} on some platforms:
  42 Linux releases between July 2008 and May 2009 (versions 2.6.27 to 2.6.29).
  43
  44 @item
  45 This function returns @code{EMFILE} instead of @code{EBADF} for
  46 large targets, which interferes with using
  47 @code{dup2(fd,fd)==fd)} as the minimal @code{EBADF} filter:
  48 AIX 7.1, FreeBSD 6.1, Cygwin 1.5.
  49 @end itemize
  50
  51 Portability problems fixed by Gnulib module @code{dup2-obsolete}:
  52 @itemize
  53 @item
  54 This function is missing on some older platforms.
  55 @end itemize
  56
  57 Portability problems not fixed by Gnulib:
  58 @itemize
  59 @end itemize