Copyright (c) 1983 Regents of the University of California.
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.
@(#)listen.2 6.1 (Berkeley) 05/15/85
All rights reserved. The Berkeley software License Agreement
specifies the terms and conditions for redistribution.
@(#)listen.2 6.1 (Berkeley) 05/15/85
LISTEN 2 ""
C 5 NAME
listen - listen for connections on a socket
SYNOPSIS
listen(s, backlog) int s, backlog;
DESCRIPTION
To accept connections, a socket
is first created with
socket (2), a backlog for incoming connections is specified with
listen (2) and then the connections are
accepted with
accept (2). The
listen call applies only to sockets of type
SOCK_STREAM
or
SOCK_PKTSTREAM.
The backlog parameter defines the maximum length the queue of pending connections may grow to. If a connection request arrives with the queue full the client will receive an error with an indication of ECONNREFUSED.
"RETURN VALUE
A 0 return value indicates success; -1 indicates an error.
"ERRORS
The call fails if:
20 [EBADF] The argument s is not a valid descriptor.
20 [ENOTSOCK] The argument s is not a socket.
20 [EOPNOTSUPP] The socket is not of a type that supports the operation listen.
"SEE ALSO"
accept(2), connect(2), socket(2)
BUGS
The
backlog is currently limited (silently) to 5.