Return to accept.2 CVS log

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

Annotation of cci/usr/src/man/man2/accept.2, revision 1.1.1.1

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