NAME

bind − bind a name to a socket

SYNOPSIS

#include <sys/socket.h>

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

DESCRIPTION

Bind assigns gives a name to a 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 the name be assigned to the socket. 

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. 

ERRORS

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 lies outside the valid part of the process’s address space. 

SEE ALSO

connect(2), listen(2), socket(2)

Sun System Release 0.3  —  25 April 1983