listen(2POSIX)

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ATTRIBUTES | SEE ALSO | RESTRICTIONS

NAME

listen- listen for connections on a socket

SYNOPSIS

#include <sys/types.h>
#include <sys/socket.h>

int listen(int s, int backlog);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

FEATURES

POSIX_SOCKETS

DESCRIPTION

To accept connections, a socket is first created using socket(2POSIX). The ability to accept incoming connections and a queue limit for incoming connections are specified using listen. The connections are accepted using accept(2POSIX). The listen call applies only to sockets of type SOCK_STREAM.

The backlog parameter defines the maximum length of the queue of pending connections. If a connection request arrives when the queue is full, the client may receive an error message (ECONNREFUSED), or, if the underlying protocol supports retransmission, the request may be ignored to enable retries.

RETURN VALUE

Upon successful completion, listen returns 0; otherwise it returns -1 and sets errno to indicate one of the following error conditions:

[EBADF]

The s argument is not a valid descriptor.

[ENOTSOCK]

The s argument is not a socket.

[EOPNOTSUPP]

The socket is not of a type that supports the listen operation.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving
MT-level	MT-safe

SEE ALSO

accept(2POSIX), connect(2POSIX), socket(2POSIX)

RESTRICTIONS

The backlog is currently limited (silently) to 5.

ChorusOS 5.0  Last Revised December 2001

NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ATTRIBUTES | SEE ALSO | RESTRICTIONS