NAME
|
NAME
|
listen - listen for connections on a socket
|
listen - listen for connections on a socket
|
|
|
SYNOPSIS
|
SYNOPSIS
|
#include <network.h>
|
#include <network.h>
|
|
|
int listen(int s, int backlog);
|
int listen(int s, int backlog);
|
|
|
DESCRIPTION
|
DESCRIPTION
|
To accept connections, a socket is first created with
|
To accept connections, a socket is first created with
|
socket(2), a willingness to accept incoming connections
|
socket(2), a willingness to accept incoming connections
|
and a queue limit for incoming connections are specified
|
and a queue limit for incoming connections are specified
|
with listen, and then the connections are accepted with
|
with listen, and then the connections are accepted with
|
accept(2). The listen call applies only to sockets of
|
accept(2). The listen call applies only to sockets of
|
type SOCK_STREAM or SOCK_SEQPACKET.
|
type SOCK_STREAM or SOCK_SEQPACKET.
|
|
|
The backlog parameter defines the maximum length the queue
|
The backlog parameter defines the maximum length the queue
|
of pending connections may grow to. If a connection
|
of pending connections may grow to. If a connection
|
request arrives with the queue full the client may receive
|
request arrives with the queue full the client may receive
|
an error with an indication of ECONNREFUSED or, if the
|
an error with an indication of ECONNREFUSED or, if the
|
underlying protocol supports retransmission, the request
|
underlying protocol supports retransmission, the request
|
may be ignored so that retries may succeed.
|
may be ignored so that retries may succeed.
|
|
|
RETURN VALUE
|
RETURN VALUE
|
On success, zero is returned. On error, -1 is returned,
|
On success, zero is returned. On error, -1 is returned,
|
and errno is set appropriately.
|
and errno is set appropriately.
|
|
|
ERRORS
|
ERRORS
|
EBADF The argument s is not a valid descriptor.
|
EBADF The argument s is not a valid descriptor.
|
|
|
ENOTSOCK
|
ENOTSOCK
|
The argument s is not a socket.
|
The argument s is not a socket.
|
|
|
EOPNOTSUPP
|
EOPNOTSUPP
|
The socket is not of a type that supports the lis-
|
The socket is not of a type that supports the lis-
|
ten operation.
|
ten operation.
|
|
|