bind(3SOCKET) Sockets Library Functions bind(3SOCKET)
NAME
bind - bind a name to a socket
SYNOPSIS
cc [ flag ... ] file ... -lsocket -lnsl [ library ... ]
#include <sys/types.h>
#include <sys/socket.h>
int bind(int s, const struct sockaddr *name, int namelen);
DESCRIPTION
bind() assigns a name to an unnamed socket. When a socket is created with socket(3SOCKET), it exists in a name space (address family) but
has no name assigned. bind() requests that the name pointed to by name be assigned to the socket.
RETURN VALUES
If the bind is successful, 0 is returned. A return value of -1 indicates an error, which is further specified in the global errno.
ERRORS
The bind() call will fail if:
EACCES The requested address is protected, and {PRIV_NET_PRIVADDR} is not asserted in the effective set of the current
process.
EADDRINUSE The specified address is already in use.
EADDRNOTAVAIL The specified address is not available on the local machine.
EBADF s is not a valid descriptor.
EINVAL namelen is not the size of a valid address for the specified address family.
EINVAL The socket is already bound to an address.
ENOSR There were insufficient STREAMS resources for the operation to complete.
ENOTSOCK s is a descriptor for a file, not a socket.
The following errors are specific to binding names in the UNIX domain:
EACCES Search permission is denied for a component of the path prefix of the pathname in name.
EIO An I/O error occurred while making the directory entry or allocating the inode.
EISDIR A null pathname was specified.
ELOOP Too many symbolic links were encountered in translating the pathname in name.
ENOENT A component of the path prefix of the pathname in name does not exist.
ENOTDIR A component of the path prefix of the pathname in name is not a directory.
EROFS The inode would reside on a read-only file system.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|MT-Level |Safe |
+-----------------------------+-----------------------------+
SEE ALSO
unlink(2), socket(3SOCKET), attributes(5), privileges(5), socket.h(3HEAD)
NOTES
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 byus-
ing unlink(2).
The rules used in name binding vary between communication domains.
SunOS 5.10 20 Feb 2003 bind(3SOCKET)
