NAME

listen − listen for connections on a socket

SYNOPSIS

int 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:

[EBADF] The argument s is not a valid descriptor. 

[ENOTSOCK] The argument s is not a socket. 

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

NOTE

This call is defined in the 88open Binary and Object Compatibility Standards’ Networking Supplements (BCSNS and OCSNS) for use in BCSNS/OCSNS compliant applications.  OCSNS-defined functions may be accessed by passing OCS options to cc(1) and ld(1). 

SEE ALSO

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

BUGS

The backlog is currently limited (silently) to 5. 

CX/UX Programmer’s Reference Manual