Return to connect.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/connect.2, revision 1.1

1.1     ! root        1: .TH CONNECT 2 "7 July 1983"
        !             2: .UC 4
        !             3: .SH NAME
        !             4: connect \- initiate a connection on a socket
        !             5: .SH SYNOPSIS
        !             6: .nf
        !             7: .ft B
        !             8: #include <sys/types.h>
        !             9: #include <sys/socket.h>
        !            10: #include <sys/un.h>           /* for Unix domain only */
        !            11: #include <netinet/in.h>       /* for Internet domain only */
        !            12: .PP
        !            13: .ft B
        !            14: connect(s, name, namelen)
        !            15: int s;
        !            16: struct sockaddr *name;
        !            17: int namelen;
        !            18: .fi
        !            19: .SH DESCRIPTION
        !            20: The parameter
        !            21: .I s
        !            22: is a socket.
        !            23: If it is of type SOCK_DGRAM,
        !            24: then this call permanently specifies the peer to which
        !            25: datagrams are to be sent;
        !            26: if it is of type SOCK_STREAM,
        !            27: then this call attempts to make a connection to
        !            28: another socket.
        !            29: The other socket is specified by
        !            30: .I name
        !            31: which is an address in the communications space of the socket.
        !            32: Each communications space interprets the
        !            33: .I name
        !            34: parameter in its own way.
        !            35: .SH "RETURN VALUE
        !            36: If the connection or binding succeeds, then 0 is returned.
        !            37: Otherwise a \-1 is returned, and a more specific error
        !            38: code is stored in \fIerrno\fP.
        !            39: .SH "ERRORS
        !            40: The call fails if:
        !            41: .TP 20
        !            42: [EBADF]
        !            43: .I S
        !            44: is not a valid descriptor.
        !            45: .TP 20
        !            46: [ENOTSOCK]
        !            47: .I S
        !            48: is a descriptor for a file, not a socket.
        !            49: .TP 20
        !            50: [EADDRNOTAVAIL]
        !            51: The specified address is not available on this machine.
        !            52: .TP 20
        !            53: [EAFNOSUPPORT]
        !            54: Addresses in the specified address family cannot be used with this socket.
        !            55: .TP 20
        !            56: [EISCONN]
        !            57: The socket is already connected.
        !            58: .TP 20
        !            59: [ETIMEDOUT]
        !            60: Connection establishment timed out without establishing a connection.
        !            61: .TP 20
        !            62: [ECONNREFUSED]
        !            63: The attempt to connect was forcefully rejected.
        !            64: .TP 20
        !            65: [ENETUNREACH]
        !            66: The network isn't reachable from this host.
        !            67: .TP 20
        !            68: [EADDRINUSE]
        !            69: The address is already in use.
        !            70: .TP 20
        !            71: [EFAULT]
        !            72: The \fIname\fP parameter specifies an area outside
        !            73: the process address space.
        !            74: .TP 20
        !            75: [EWOULDBLOCK]
        !            76: The socket is non-blocking and the
        !            77: and the connection cannot
        !            78: be completed immediately.
        !            79: It is possible to
        !            80: .IR select (2)
        !            81: the socket while it is connecting by selecting it for writing.
        !            82: .SH SEE ALSO
        !            83: accept(2), select(2), socket(2), getsockname(2).
        !            84: See also bind(2) for address formats in different communication domains.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.