listen(2) System Calls Manual listen(2)
NAME
listen - listen for connections on a socket
SYNOPSIS
DESCRIPTION
To accept connections, a socket is first created using a queue for incoming connections is activated using and then connections are
accepted using applies only to unconnected sockets of type SOCK_STREAM. Except for AF_VME_LINK, if the socket has not been bound to a
local port before is invoked, the system automatically binds a local port for the socket to listen on (see inet(7F)). For sockets in the
address family AF_CCITT and AF_VME_LINK, the socket be bound to an address by using before connection establishment can continue, otherwise
an error is returned.
A listen queue is established for the socket specified by the s parameter, which is a socket descriptor.
backlog defines the desirable queue length for pending connections. The actual queue length may be greater than the specified backlog. If
a connection request arrives when the queue is full, the client will receive an error.
backlog is limited to the range of 0 to which is defined in is currently set to 4096. If any other value is specified, the system automat-
ically assigns the closest value within the range. Note that for a backlog of 0 specifies only 1 pending connection is allowed at any
given time. For a backlog of 0 specifies no further connection is allowed.
X/Open Sockets Compilation Environment
See xopen_networking(7).
DEPENDENCIES
AF_CCITT
Call-acceptance can be controlled by the call described in Upon successful completion, returns 0; otherwise, it returns -1 and sets to
indicate the error.
ERRORS
fails if any of the following conditions are encountered:
s is not a valid file descriptor.
The socket s has not been bound to an address by using
s is a valid file descriptor but it is not a socket.
The socket referenced by
s does not support
The socket has been shut down or is already connected.
WARNINGS
Linking binary objects compiled to specification and binary objects compiled to specification to the same executable may result in unex-
pected behavior, including application abnormal termination and unexpected socket errors. See xopen_networking(7) for details and remedy.
FUTURE DIRECTION
Currently, the default behavior is the however, it might be changed to in a future release. At that time, any behavior that is incompati-
ble with might be obsoleted. Applications that conform to the X/Open specification now will avoid migration problems (see xopen_network-
ing(7)).
AUTHOR
was developed by HP and the University of California, Berkeley.
SEE ALSO
accept(2), connect(2), socket(2), thread_safety(5), xopen_networking(7), inet(7F).
STANDARDS CONFORMANCE
listen(2)