LISTEN(3N-SVR4) RISC/os Reference Manual LISTEN(3N-SVR4)
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() and then the connections are accepted with
accept(2). The listen() call applies only to sockets of
type SOCK_STREAM or SOCK_SEQPACKET.
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:
EBADF The argument s is not a valid descrip-
tor.
ENOTSOCK The argument s is not a socket.
EOPNOTSUPP The socket is not of a type that sup-
ports the operation listen.
NOTES
There is currently no backlog limit.
Printed 11/19/92 Page 1