int connect (
const struct sockaddr *address,
size_t address_len );
[POSIX] The definition of the connect() function in POSIX.1g Draft 6.6 uses a socklen_t data type instead of a size_t data type as specified in XNS4.0 (the previous definition).
[DIGITAL] The following definition of the connect() function does not conform to current standards and is supported only for backward compatibility (see standards(5)):
int connect (
struct sockaddr *address,
int address_len );
Interfaces documented on this reference page conform to industry standards as follows:
The connect function also supports POSIX.1g Draft 6.6.
Refer to the standards(5) reference page for more information about industry standards and associated tags.
Specifies a file descriptor for the socket. Points to a sockaddr structure, the format of which is determined by the domain and by the behavior requested for the socket. The sockaddr structure is an overlay for a sockaddr_in or sockaddr_un structure, depending on which of the supported address families is active.
The connect() function requests a connection between two sockets. The kernel sets up the communications links between the sockets; both sockets must use the same address format and protocol.
The connect() function performs a different action for each of the following types of initiating sockets: If the initiating socket is SOCK_DGRAM, the connect() function establishes the peer address. The peer address identifies the socket where all datagrams are sent on subsequent send() functions. It also identifies the socket from where datagrams can be received; datagrams from other peer addresses are not delivered.
If the function fails for a connection mode socket, applications should use the close() function to deallocate the socket and descriptor. If attempting to reinitiate the connection, applications should create a new socket.
Upon successful completion, the connect() function returns a value of 0 (zero). Otherwise, a value of -1 is returned and errno is set to indicate the error.
If the connect() function fails, errno may be set to one of the following values: Search permission is denied for a component of the path prefix; or write access to the named socket is denied. The specified address is already in use. The specified address is not available from the local machine. The addresses in the specified address family cannot be used with this socket. A connection request is already in progress for the specified socket. The socket parameter is not valid. The attempt to connect was rejected. The address parameter is not in a readable part of the user address space. [POSIX] The specified host is not reachable. O_NONBLOCK is set for the file descriptor for the socket and the connection cannot be immediately established; the connection will be established asynchronously. The connect() function was interrupted by a signal while waiting for the connection to be established. The connection establishment may continue asynchronously. [POSIX] The value of the address_len parameter is invalid for the specified address family; or the sa_family field in the socket address structure is invalid for the protocol. An I/O error occurred while reading from or writing to the file system. The socket is already connected. Too many symbolic links were encountered in translating the pathname in address. A component of the pathname exceeded NAME_MAX characters, or an entire pathname exceeded PATH_MAX characters. [POSIX] The local network connection is not operational. No route to the network or host is present. [POSIX] Insufficient resources are available in the system to complete the call. A component of the pathname does not name an existing file or the pathname is an empty string. A component of the path prefix of the pathname in address is not a directory. The socket parameter refers to a file, not a socket. The specified address has a different type than the socket bound to the specified peer address. The establishment of a connection timed out before a connection was made. The socket is marked nonblocking, so the connection cannot be immediately completed. The application program can select the socket for writing during the connection process.
Functions: accept(2), bind(2), socket(2), getsockname(2), select(2), send(2).
Standards: standards(5). delim off