Copyright (C) 2009, Sun Microsystems, Inc. All Rights Reserved
Copyright 1989 AT&T
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
cc [ flag ... ] file ... -lsocket -lnsl [ library ... ] #include <sys/types.h> #include <sys/socket.h> int bind(int s, const struct sockaddr *name, int namelen);
The bind() function 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. The bind() function requests that the name pointed to by name be assigned to the socket.
Upon successful completion 0 is returned. Otherwise, -1 is returned and errno is set to indicate the error.
The bind() function will fail if: EACCES
The requested address is protected, and {PRIV_NET_PRIVADDR} is not asserted in the effective set of the current process.
The specified address is already in use.
The specified address is not available on the local machine.
s is not a valid descriptor.
namelen is not the size of a valid address for the specified address family. The socket is already bound to an address. Socket options are inconsistent with port attributes.
There were insufficient STREAMS resources for the operation to complete.
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.
An I/O error occurred while making the directory entry or allocating the inode.
A null pathname was specified.
Too many symbolic links were encountered in translating the pathname in name.
A component of the path prefix of the pathname in name does not exist.
A component of the path prefix of the pathname in name is not a directory.
The inode would reside on a read-only file system.
See attributes(7) for descriptions of the following attributes:
| ATTRIBUTE TYPE ATTRIBUTE VALUE |
| MT-Level Safe |
unlink (2), socket.h (3HEAD), sockaddr (3SOCKET), socket (3SOCKET), attributes (7), privileges (7)
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 by using unlink(2).
The rules used in name binding vary between communication domains.