2004-02-27 17:04:02 +00:00
|
|
|
.TH io_passfd 3
|
|
|
|
|
.SH NAME
|
|
|
|
|
io_passfd \- pass a file descriptor over a Unix Domain socket
|
|
|
|
|
.SH SYNTAX
|
2017-05-13 22:51:26 +00:00
|
|
|
.B #include <libowfat/io.h>
|
2004-02-27 17:04:02 +00:00
|
|
|
|
|
|
|
|
int \fBio_passfd\fP(int64 sock,int64 fd);
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
io_passfd transfers the file descriptor \fIfd\fR over the Unix Domain
|
|
|
|
|
socket \fIsock\fR. This works much like dup(2), only that the copy of
|
|
|
|
|
the descriptor appears not in this process but at the other end of the
|
|
|
|
|
Unix Domain socket (which therefore must be a process on the same
|
|
|
|
|
system).
|
|
|
|
|
|
|
|
|
|
The peer can then use io_receivefd(3) to receive the file descriptor.
|
|
|
|
|
|
|
|
|
|
Note that the passed descriptor stays open in the sending process.
|
2004-05-13 12:40:09 +00:00
|
|
|
.SH "RETURN VALUE"
|
|
|
|
|
io_passfd returns 0 on success, -1 on error (setting errno accordingly).
|
2004-02-27 17:04:02 +00:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
io_receivefd(3)
|
