|CONNECT(2)||System Calls Manual||CONNECT(2)|
connect — initiate
a connection on a socket
s, const struct sockaddr
The parameter s is a socket. If it is of
SOCK_DGRAM, this call specifies the peer with
which the socket is to be associated; this address is that to which
datagrams are to be sent, and the only address from which datagrams are to
be received. If the socket is of type
this call attempts to make a connection to another socket. The other socket
is specified by name, which is an address in the
communications space of the socket. namelen indicates
the amount of space pointed to by name, in bytes; the
sa_len member of name is
ignored. Each communications space interprets the name
parameter in its own way. Generally, stream sockets may use
only once; datagram sockets may use
multiple times to change their association. Datagram sockets may dissolve
the association by connecting to an invalid address, such as a null
If the connection or binding succeeds, 0 is returned. Otherwise a -1 is returned, and a more specific error code is stored in errno.
connect() call fails if:
SO_ERRORto check for error conditions.
The following errors are specific to connecting names in the UNIX-domain. These errors may not apply in future versions of the UNIX IPC domain.
NAME_MAXcharacters, or an entire pathname (including the terminating NUL) exceeded
SOCK_STREAMwhereas name may refer to a socket of type
connect() function conforms to
IEEE Std 1003.1-2008 (“POSIX.1”).
connect() system call first appeared
|October 11, 2015||OpenBSD-6.0|