listen(3N)

NAME
     listen - listen for connections on a socket

SYNOPSIS
     int listen(int s, int backlog);

DESCRIPTION
     To accept connections, a socket is first created with socket, a backlog
     for incoming connections is specified with listen and then the
     connections are accepted with accept.  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 descriptor.

     ENOTSOCK            The argument s is not a socket.

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

NOTES
     There is currently no backlog limit.