CONNECT(2)              COMMAND REFERENCE              CONNECT(2)



NAME
     connect - initiate a connection on a socket

SYNOPSIS
     #include <sys/types.h>
     #include <sys/socket.h>

     connect(s, name, namelen)
     int s;
     struct sockaddr *name;
     int namelen;

DESCRIPTION
     The parameter s is a socket.  If it is of type SOCK_DGRAM,
     then this call permanently specifies the peer to which
     datagrams are to be sent; if it is of type SOCK_STREAM, then
     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.  Each communications
     space interprets the name parameter in its own way.

DIAGNOSTICS
     The call fails if:

     [EBADF]
         S is not a valid descriptor.

     [ENOTSOCK]
         S is a descriptor for a file, not a socket.

     [EADDRNOTAVAIL]
         The specified address (for internet domain sockets) or
         name (for Unix domain sockets) is not available on this
         machine.

     [EAFNOSUPPORT]
         Addresses in the specified address family cannot be used
         with this socket.

     [EISCONN]
         The socket is already connected.

     [ETIMEDOUT]
         Connection establishment timed out without establishing
         a connection.

     [ECONNREFUSED]
         The attempt to connect was forcefully rejected.

     [ENETUNREACH]
         The network isn't reachable from this host.




Printed 10/17/86                                                1

CONNECT(2)              COMMAND REFERENCE              CONNECT(2)



     [EADDRINUSE]
         The address (for internet domain sockets) or name (for
         Unix domain sockets) is already in use.

     [EFAULT]
         The name parameter specifies an area outside the process
         address space.

     [EWOULDBLOCK]
         The socket is non-blocking and the and the connection
         cannot be completed immediately.  It is possible to
         select(2) the socket while it is connecting by selecting
         it for writing.

     [EDFSREF]
         Name for a Unix domain socket references a file on a
         remote system (which is not allowed).  If you need that
         capability, use an internet domain socket.

RETURN VALUE
     [0] Successful binding or connection.

     [-1]
         Unsuccessful binding or connection.  A more specific
         error code is stored in errno.

SEE ALSO
     accept(2), select(2), socket(2), getsockname(2).



























Printed 10/17/86                                                2

%%index%%
na:72,79;
sy:151,817;
de:968,540;
di:1508,827;2479,695;
rv:3174,246;
se:3420,195;
%%index%%000000000115