| .TH DUP 3 |
| .SH NAME |
| dup \- duplicate an open file descriptor |
| .SH SYNOPSIS |
| .B #include <u.h> |
| .br |
| .B #include <libc.h> |
| .PP |
| .B |
| int dup(int oldfd, int newfd) |
| .SH DESCRIPTION |
| Given a file descriptor, |
| .IR oldfd , |
| referring to an open file, |
| .I dup |
| returns a new file descriptor referring to the same file. |
| .PP |
| If |
| .I newfd |
| is \-1 the system chooses the lowest available file descriptor. |
| Otherwise, |
| .I dup |
| will use |
| .I newfd |
| for the new file descriptor |
| (closing any old file associated with |
| .IR newfd ). |
| .SH SOURCE |
| .B /usr/local/plan9/src/lib9/dup.c |
| .SH DIAGNOSTICS |
| Sets |
| .IR errstr . |
| .SH BUGS |
| .I Dup |
| is a macro for |
| .I p9dup |
| to avoid name conflicts with the Unix function; see |
| .IR intro (3). |
