Return to accept.2 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man2

Annotation of 43BSDTahoe/man/man2/accept.2, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1983 Regents of the University of California.
        !             2: .\" All rights reserved.  The Berkeley software License Agreement
        !             3: .\" specifies the terms and conditions for redistribution.
        !             4: .\"
        !             5: .\"    @(#)accept.2    6.3 (Berkeley) 5/22/86
        !             6: .\"
        !             7: .TH ACCEPT 2 "May 22, 1986"
        !             8: .UC 5
        !             9: .SH NAME
        !            10: accept \- accept a connection on a socket
        !            11: .SH SYNOPSIS
        !            12: .ft B
        !            13: .nf
        !            14: #include <sys/types.h>
        !            15: #include <sys/socket.h>
        !            16: .PP
        !            17: .ft B
        !            18: ns = accept(s, addr, addrlen)
        !            19: int ns, s;
        !            20: struct sockaddr *addr;
        !            21: int *addrlen;
        !            22: .fi
        !            23: .SH DESCRIPTION
        !            24: The argument
        !            25: .I s
        !            26: is a socket that has been created with
        !            27: .IR socket (2),
        !            28: bound to an address with
        !            29: .IR bind (2),
        !            30: and is listening for connections after a
        !            31: .IR listen (2).
        !            32: .I Accept
        !            33: extracts the first connection
        !            34: on the queue of pending connections, creates
        !            35: a new socket with the same properties of 
        !            36: .I s
        !            37: and allocates a new file descriptor,
        !            38: .IR ns ,
        !            39: for the socket.  If no pending connections are
        !            40: present on the queue, and the socket is not marked
        !            41: as non-blocking,
        !            42: .I accept
        !            43: blocks the caller until a connection is present.
        !            44: If the socket is marked non-blocking and no pending
        !            45: connections are present on the queue, 
        !            46: .I accept
        !            47: returns an error as described below.
        !            48: The accepted socket,
        !            49: .IR ns ,
        !            50: may not be used
        !            51: to accept more connections.  The original socket
        !            52: .I s
        !            53: remains open.
        !            54: .PP
        !            55: The argument
        !            56: .I addr
        !            57: is a result parameter that is filled in with
        !            58: the address of the connecting entity,
        !            59: as known to the communications layer.
        !            60: The exact format of the
        !            61: .I addr
        !            62: parameter is determined by the domain in which the communication
        !            63: is occurring.
        !            64: The 
        !            65: .I addrlen
        !            66: is a value-result parameter; it should initially contain the
        !            67: amount of space pointed to by
        !            68: .IR addr ;
        !            69: on return it will contain the actual length (in bytes) of the
        !            70: address returned.
        !            71: This call
        !            72: is used with connection-based socket types, currently with SOCK_STREAM.
        !            73: .PP
        !            74: It is possible to
        !            75: .IR select (2)
        !            76: a socket for the purposes of doing an
        !            77: .I accept
        !            78: by selecting it for read.
        !            79: .SH "RETURN VALUE
        !            80: The call returns \-1 on error.  If it succeeds, it returns a non-negative
        !            81: integer that is a descriptor for the accepted socket.
        !            82: .SH ERRORS
        !            83: The \fIaccept\fP will fail if:
        !            84: .TP 20
        !            85: [EBADF]
        !            86: The descriptor is invalid.
        !            87: .TP 20
        !            88: [ENOTSOCK]
        !            89: The descriptor references a file, not a socket.
        !            90: .TP 20
        !            91: [EOPNOTSUPP]
        !            92: The referenced socket is not of type SOCK_STREAM.
        !            93: .TP 20
        !            94: [EFAULT]
        !            95: The \fIaddr\fP parameter is not in a writable part of the
        !            96: user address space.
        !            97: .TP 20
        !            98: [EWOULDBLOCK]
        !            99: The socket is marked non-blocking and no connections
        !           100: are present to be accepted.
        !           101: .SH SEE ALSO
        !           102: bind(2), connect(2), listen(2), select(2), socket(2)

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