GNU/Linux |
RedHat 5.2(Apollo) |
|
![]() |
bind(2) |
![]() |
bind − bind a name to a socket
#include
<sys/types.h>
#include <sys/socket.h>
int bind(int sockfd, struct sockaddr *my_addr, int addrlen);
bind gives the socket, sockfd, the local address my_addr. my_addr is addrlen bytes long. Traditionally, this is called "assigning a name to a socket" (when a socket is created with socket(2), it exists in a name space (address family) but has no name assigned.)
Binding a name in the UNIX domain creates a socket in the file system that must be deleted by the caller when it is no longer needed (using unlink(2)).
The rules used in name binding vary between communication domains. Consult the manual entries in section 4 for detailed information.
On success, zero is returned. On error, −1 is returned, and errno is set appropriately.
EBADF |
sockfd is not a valid descriptor. | ||
EINVAL |
The socket is already bound to an address. This may change in the future: see linux/unix/sock.c for details. | ||
EACCES |
The address is protected, and the user is not the super-user. |
ENOTSOCK
Argument is a descriptor for a file, not a socket.
The following errors are specific to UNIX domain (AF_UNIX) sockets:
EINVAL |
The addr_len was wrong, or the socket was not in the AF_UNIX family. | ||
EROFS |
The socket inode would reside on a read-only file system. | ||
EFAULT |
my_addr points outside your accessible address space. |
ENAMETOOLONG
my_addr is too long.
ENOENT |
The file does not exist. | ||
ENOMEM |
Insufficient kernel memory was available. | ||
ENOTDIR |
A component of the path prefix is not a directory. | ||
EACCES |
Search permission is denied on a component of the path prefix. | ||
ELOOP |
Too many symbolic links were encountered in resolving my_addr. |
SVr4, 4.4BSD (the bind function first appeared in BSD 4.2). SVr4 documents additional EADDRNOTAVAIL, EADDRINUSE, ENOSR general error conditions, and additional EIO, EISDIR and EROFS Unix-domain error conditions.
accept(2), connect(2), listen(2), socket(2), getsockname(2)
![]() |
bind(2) | ![]() |