1.1 KiB
1.1 KiB
Name
sendfd - send a file descriptor to a local socket peer
Synopsis
#include <sys/socket.h>
int sendfd(int sockfd, int fd);
Description
Send an open file descriptor to a local socket peer connected via sockfd. This is a non-blocking call that will fail if there are too many file descriptors already waiting to be received by the peer.
File descriptors are sent out-of-band and do not affect the regular data streams.
Return value
If a file descriptor is successfully received, it is returned as a positive integer. Otherwise, -1 is returned and errno is set to indicate the error.
Errors
EBADF:sockfdorfdis not an open file descriptor.ENOTSOCK:sockfddoes not refer to a socket.EAFNOSUPPORT:sockfddoes not refer to a local domain socket.ENOTCONN:sockfdrefers to a socket which is not connected.EINVAL:sockfddoes not refer to a connected or accepted socket.EBUSY: There are too many file descriptors already waiting to be received by the peer.
History
sendfd() was first introduced in Plan 9 from User Space.