int
connect(int s, const struct sockaddr *name, socklen_t namelen)
s
is a socket.
If it is of type
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
SOCK_STREAM,
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.
Each communications space interprets the
name
parameter in its own way.
Generally, stream sockets may successfully
connect()
only once; datagram sockets may use
connect()
multiple times to change their association.
Datagram sockets may dissolve the association
by connecting to an invalid address, such as a null address.
If a
connect()
call is interrupted by a signal, it will return with errno set to
EINTR
and the connection attempt will proceed as if the socket was non-blocking.
Subsequent calls to
connect()
will set errno to
EALREADY.
)
call fails if:
EBADF]s
is not a valid descriptor.
ENOTSOCK]s
is a descriptor for a file, not a socket.
EADDRNOTAVAIL]EAFNOSUPPORT]EISCONN]ETIMEDOUT]ECONNREFUSED]ENETUNREACH]EADDRINUSE]EFAULT]name
parameter specifies an area outside
the process address space.
EINPROGRESS]SO_ERROR
option at the
SOL_SOCKET
level.
The returned socket error status is zero on success, or one of the
error codes listed here on failure.
EALREADY])
was interrupted by a signal, and the connection attempt has not yet
been completed.
EINTR]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.
ENOTDIR]ENAMETOOLONG]{NAME_MAX}
characters, or an entire path name exceeded
{PATH_MAX}
characters.
ENOENT]EACCES]ELOOP])
function call appeared in
4.2BSD.