43 lines
827 B
Text
43 lines
827 B
Text
|
.TH DUP 2
|
||
|
|
.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 ).
|
||
|
|
File descriptors are allocated dynamically,
|
||
|
|
so to prevent unwarranted growth of the file descriptor table,
|
||
|
|
.I dup
|
||
|
|
requires that
|
||
|
|
.I newfd
|
||
|
|
be no greater than 20 more than the highest file descriptor ever used by
|
||
|
|
the program.
|
||
|
|
.SH SOURCE
|
||
|
|
.B /sys/src/libc/9syscall
|
||
|
|
.SH SEE ALSO
|
||
|
|
.IR intro (2),
|
||
|
|
.IR dup (3)
|
||
|
|
.SH DIAGNOSTICS
|
||
|
|
Sets
|
||
|
|
.IR errstr .
|