listen(2N)                                             listen(2N)



     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(2N), a backlog for incoming connections is specified
          with listen(2N) and then the connections are accepted with
          accept(2N).  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.

     RETURN VALUE
          A 0 return value indicates success; -1 indicates an error.

     ERRORS
          listen will fail if:

          [EBADF]             The argument s is not a valid descrip-
                              tor.

          [ENOTSOCK]          The argument s is not a socket.

          [EOPNOTSUPP]        The operation is not supported on a
                              socket.

          If a connection request arrives with the queue full the
          client will receive an error with an indication of ECONNRE-
          FUSED.  The socket is not of a type that supports the opera-
          tion listen.

     SEE ALSO
          accept(2N), connect(2N), socket(2N).

     BUGS
          The backlog is currently limited (silently) to 5.














     April, 1990                                                     1