3 cfa37a7b 2004-04-10 devnull dup \- duplicate an open file descriptor
4 cfa37a7b 2004-04-10 devnull .SH SYNOPSIS
5 cfa37a7b 2004-04-10 devnull .B #include <u.h>
7 cfa37a7b 2004-04-10 devnull .B #include <libc.h>
10 cfa37a7b 2004-04-10 devnull int dup(int oldfd, int newfd)
11 cfa37a7b 2004-04-10 devnull .SH DESCRIPTION
12 cfa37a7b 2004-04-10 devnull Given a file descriptor,
13 cfa37a7b 2004-04-10 devnull .IR oldfd ,
14 cfa37a7b 2004-04-10 devnull referring to an open file,
16 cfa37a7b 2004-04-10 devnull returns a new file descriptor referring to the same file.
20 cfa37a7b 2004-04-10 devnull is \-1 the system chooses the lowest available file descriptor.
21 cfa37a7b 2004-04-10 devnull Otherwise,
25 cfa37a7b 2004-04-10 devnull for the new file descriptor
26 cfa37a7b 2004-04-10 devnull (closing any old file associated with
27 cfa37a7b 2004-04-10 devnull .IR newfd ).
28 cfa37a7b 2004-04-10 devnull .SH SOURCE
29 058b0118 2005-01-03 devnull .B /usr/local/plan9/src/lib9/dup.c
30 cfa37a7b 2004-04-10 devnull .SH DIAGNOSTICS
32 cfa37a7b 2004-04-10 devnull .IR errstr .
35 058b0118 2005-01-03 devnull is a macro for
37 058b0118 2005-01-03 devnull to avoid name conflicts with the Unix function; see
38 058b0118 2005-01-03 devnull .IR intro (3).