febbd53cc90eedc24e3f2b2708395ce5110b3689
[gnulib.git] / 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
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function always returns 0 for success on some platforms:
13 mingw.
14
15 @item
16 This function can hang when duplicating an fd to itself on some platforms:
17 mingw.
18
19 @item
20 This function returns 0 for @code{dup2 (1, 1)} on some platforms:
21 Cygwin 1.5.x.
22
23 @item
24 This function may return @code{-EBADF} instead of @code{-1} on some platforms:
25 Linux releases between July 2008 and May 2009 (versions 2.6.27 to 2.6.29).
26
27 @item
28 This function returns @code{EMFILE} instead of @code{EBADF} for
29 extremely large targets, which interferes with using
30 @code{dup2(fd,fd)==fd)} as the minimal @code{EBADF} filter:
31 FreeBSD 6.1, Cygwin 1.5.
32
33 @item
34 This function is missing on some older platforms.
35 @end itemize
36
37 Portability problems not fixed by Gnulib:
38 @itemize
39 @end itemize