bind(2)

NAME

bind − bind a name to a socket

SYNTAX

#include <sys/types.h>
#include <sys/socket.h>

bind(s, name, namelen)
int s;
struct sockaddr *name;
int namelen;

#include <sys/types.h>
#include <sys/socket.h>
#include <sys/un.h>

bind(s, name, namelen)
int s;
struct sockaddr_un *name;
int namelen;

DESCRIPTION

The bind system call assigns a name to an unnamed socket. When a socket is created with socket() it exists in a name space (address family) but has no name assigned. The bind system call requests the name, be assigned to the socket.

Binding a name in the UNIX domain creates a socket in the file system which must be deleted by the caller when it is no longer needed using unlink(.).

The sockaddr specifies a general address family. The sockaddr_un specifies an address family in the UNIX domain.

The rules used in name binding vary between communication domains. Consult the manual entries in section 4 for detailed information.

RETURN VALUE

If the bind is successful, a 0 value is returned. A return value of −1 indicates an error, which is further specified in the global errno.

DIAGNOSTICS

The bind call will fail if:

[EBADF]
S is not a valid descriptor.

[ENOTSOCK]
S is not a socket.

[EADDRNOTAVAIL]
The specified address is not available from the local machine.

[EADDRINUSE]
The specified address is already in use.

[EINVAL]
The socket is already bound to an address.

[EACCESS]
The requested address is protected, and the current user has inadequate permission to access it.

[EFAULT]
The name parameter is not in a valid part of the user address space.

The following errors are specific to binding names in the UNIX domain.

[ENOTDIR]
A component of the path prefix is not a directory.

[ENAMETOOLONG]
A component of a pathname exceeded 255 characters, or an entire pathname exceeded 1023 characters.

[ENOENT]
A prefix component of the path name does not exist.

[ELOOP]
Too many symbolic links were encountered in translating the pathname.

[EIO] An I/O error occurred while making the directory entry or allocating the inode.

[EROFS]
The name would reside on a read-only file system.

[EISDIR]
A null pathname was specified.

Museum