#include <sys/types.h>
#include <sys/socket.h> int
connect (int s const struct sockaddr *name socklen_t namelen);
DESCRIPTION
The
Fa s
argument
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
Fa name ,
which is an address in the communications space of the socket.
Each communications space interprets the
Fa name
argument 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.
RETURN VALUES
Rv -std connect
ERRORS
The
connect ();
system call fails if:
Bq Er EBADF
The
Fa s
argument
is not a valid descriptor.
Bq Er ENOTSOCK
The
Fa s
argument
is a descriptor for a file, not a socket.
Bq Er EADDRNOTAVAIL
The specified address is not available on this machine.
Bq Er EAFNOSUPPORT
Addresses in the specified address family cannot be used with this socket.
Bq Er EISCONN
The socket is already connected.
Bq Er ETIMEDOUT
Connection establishment timed out without establishing a connection.
Bq Er ECONNREFUSED
The attempt to connect was forcefully rejected.
Bq Er ENETUNREACH
The network is not reachable from this host.
Bq Er EHOSTUNREACH
The remote host is not reachable from this host.
Bq Er EADDRINUSE
The address is already in use.
Bq Er EFAULT
The
Fa name
argument specifies an area outside
the process address space.
Bq Er EINPROGRESS
The socket is non-blocking
and the connection cannot
be completed immediately.
It is possible to
select(2)
for completion by selecting the socket for writing.
Bq Er EINTR
The connection attempt was interrupted by the delivery of a signal.
The connection will be established in the background,
as in the case of
Er EINPROGRESS .
Bq Er EALREADY
A previous connection attempt has not yet been completed.
Bq Er EACCES
An attempt is made to connect to a broadcast address (obtained through the
INADDR_BROADCAST
constant or the
INADDR_NONE
return value) through a socket that does not provide broadcast functionality.
Bq Er EAGAIN
An auto-assigned port number was requested but no auto-assigned ports
are available.
Increasing the port range specified by
sysctl(3)
MIB variables
net.inet.ip.portrange.first
and
net.inet.ip.portrange.last
may alleviate the problem.
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.
Bq Er ENOTDIR
A component of the path prefix is not a directory.
Bq Er ENAMETOOLONG
A component of a pathname exceeded 255 characters,
or an entire path name exceeded 1023 characters.
Bq Er ENOENT
The named socket does not exist.
Bq Er EACCES
Search permission is denied for a component of the path prefix.
Bq Er EACCES
Write access to the named socket is denied.
Bq Er ELOOP
Too many symbolic links were encountered in translating the pathname.
