|
0
|
1 |
.TH fd_copy 3
|
|
|
2 |
.SH NAME
|
|
|
3 |
fd_copy \- duplicate a descriptor
|
|
|
4 |
.SH SYNTAX
|
|
|
5 |
.B #include <fd.h>
|
|
|
6 |
|
|
|
7 |
int \fBfd_copy\fP(\fIto\fR,\fIfrom\fR);
|
|
|
8 |
|
|
|
9 |
int \fIto\fR;
|
|
|
10 |
.br
|
|
|
11 |
int \fIfrom\fR;
|
|
|
12 |
.SH DESCRIPTION
|
|
|
13 |
.B fd_copy
|
|
|
14 |
copies
|
|
|
15 |
descriptor
|
|
|
16 |
.I from
|
|
|
17 |
to descriptor
|
|
|
18 |
.IR to .
|
|
|
19 |
If
|
|
|
20 |
.I to
|
|
|
21 |
was already open,
|
|
|
22 |
.B fd_copy
|
|
|
23 |
closes it.
|
|
|
24 |
.B fd_copy
|
|
|
25 |
always leaves
|
|
|
26 |
.I from
|
|
|
27 |
intact;
|
|
|
28 |
if
|
|
|
29 |
.I to
|
|
|
30 |
and
|
|
|
31 |
.I from
|
|
|
32 |
are the same number,
|
|
|
33 |
.B fd_copy
|
|
|
34 |
does nothing.
|
|
|
35 |
|
|
|
36 |
.B fd_copy
|
|
|
37 |
returns 0 on success, -1 on error.
|
|
|
38 |
.B fd_copy
|
|
|
39 |
does not guarantee that
|
|
|
40 |
.I to
|
|
|
41 |
will remain open, if it was open, in case of error.
|
|
|
42 |
.SH "SEE ALSO"
|
|
|
43 |
dup(2),
|
|
|
44 |
fd_move(3)
|