bind(3SOCKET)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | NOTES

NAME

bind- Bind a name to a socket

SYNOPSIS

cc [flags...] file ... -lsocket -lnsl [library...]


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

int bind (int s, const struct sockaddr *name, socklen_t *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. The socket is bound to a single-level port (SLP), unless the calling process possesses the PRIV_NET_MAC_READ privilege, when it is bound to a multilevel port (MLP).

RETURN VALUES

bind() returns:

0

On success.

-1

On failure, and sets errno to indicate the error.

ERRORS

The bind() call will fail if:

EACCES

The requested address is protected and the current user has inadequate permission to access it. The calling process must have the PRIV_NET_PRIVADDR privilege to override this restriction.

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

SUMMARY OF TRUSTED SOLARIS CHANGES

If the calling process possesses the PRIV_NET_MAC_READ privilege, the socket is bound to a multilevel port (MLP); otherwise, the socket is bound to a single-level port (SLP). To override the access restriction on privileged ports, the calling process must have the PRIV_NET_PRIVADDR privilege.

SEE ALSO

Trusted Solaris 8 Reference Manual

unlink(2)

SunOS 5.8 Reference Manual

socket(3HEAD), socket(3SOCKET), attributes(5)

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 (using unlink(2)).

The rules used in name binding vary between communication domains.

Trusted Solaris 8  Last Revised 11 Aug 2000

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO | NOTES