HP-UX Reference (11i v1 05/09) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

bind(2) bind(2)

NAME

bind - bind an address to a socket

SYNOPSIS

#include <sys/socket.h>

AF_CCITT only

#include <x25/x25addrstr.h>

AF_INET, AF_INET6 and AF_VME_LINK only

#include <netinet/in.h>

AF_UNIX only

#include <sys/un.h>

int bind(int s, const void *addr, int addrlen);

_XOPEN_SOURCE_EXTENDED only (UNIX 98)

int bind(int s, const struct sockaddr *addr, socklen_t addrlen);

Obsolescent _XOPEN_SOURCE_EXTENDED only (UNIX 95)

int bind(int s, const struct sockaddr *addr, size_t addrlen);

DESCRIPTION

The bind() system call assigns an address to an unbound socket. When a socket is created with

socket(), it exists in an address space (address family) but has no address assigned. bind()

causes

the socket whose descriptor is s to become bound to the address speciﬁed in the socket address structure

pointed to by addr.

addrlen must specify the size of the address structure. Since the size of the socket address structure varies

between socket address families, the correct socket address structure should be used with each address

family (for example,

struct sockaddr_in for AF_INET and AF_VME_LINK, struct

sockaddr_in6

for AF_INET6, and struct sockaddr_un for AF_UNIX). Typically, the

sizeof() function is used to pass this value in the bind() call (for example, sizeof(struct

sockaddr_in)

The rules used in address binding vary between communication domains. For example, when binding an

AF_UNIX socket to a path name (such as /tmp/mysocket

), an open ﬁle having that name is created in

the ﬁle system. When the bound socket is closed, that ﬁle still exists unless it is removed or unlinked.

When binding an AF_INET socket or an AF_INET6 socket, sin_port can be a port number or it can be zero.

If sin_port is zero, the system assigns an unused port number automatically.

AF_VME_LINK Only

The

bind() system call is used only by servers and not clients.

RETURN VALUE

bind() returns the following values:

0 Successful completion.

-1 Failure. errno is set to indicate the error.

ERRORS

If bind() fails, errno is set to one of the following values.

[EACCES] The requested address is protected, and the current user has inadequate per-

mission to access it. (This error can be returned by AF_INET or AF_INET6

only.)

[EADDRINUSE] The speciﬁed address is already in use.

[EADDRNOTAVAIL] The speciﬁed address is invalid or not available from the local machine, or for

AF_CCITT sockets which use "wild card" addressing, the speciﬁed address

space overlays the address space of an existing bind.

[EAFNOSUPPORT] The speciﬁed address is not a valid address for the address family of this

socket.

HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 2−−29