Commit | Line | Data |
---|---|---|
2117e02e MW |
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) |