BIND(2) | System Calls Manual | BIND(2) |
bind
— bind a name
to a socket
#include
<sys/socket.h>
int
bind
(int
s, const struct sockaddr
*name, socklen_t
namelen);
bind
()
assigns a name to an unnamed socket. When a socket is created with
socket(2) it exists in a name
space (address family) but has no name assigned.
bind
() requests that name be
assigned to the socket. namelen indicates the amount
of space pointed to by name, in bytes; the
sa_len member of name is
ignored.
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.
Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the error.
The bind
() function will fail if:
EBADF
]ENOTSOCK
]EADDRNOTAVAIL
]EADDRINUSE
]EINVAL
]EAFNOSUPPORT
]ENOBUFS
]EACCES
]EFAULT
]The following errors are specific to binding names in the UNIX-domain.
ENOTDIR
]ENAMETOOLONG
]NAME_MAX
characters, or an entire pathname (including the terminating NUL) exceeded
PATH_MAX
bytes.ENOENT
]ELOOP
]EIO
]EROFS
]EISDIR
]The bind
() function conforms to
IEEE Std 1003.1-2008 (“POSIX.1”).
The bind
() system call first appeared in
4.1cBSD.
October 11, 2015 | OpenBSD-6.1 |