listen(2N)                                             listen(2N)



     NAME
          listen - listen for connections on a socket

     SYNOPSIS
          listen(s, backlog)
          int s, backlog;

          cc ... -lnet

     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
          SOCKSTREAM or SOCKPKTSTREAM.

          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.

     LINKING
          This library is accessed by specifying -lnet as the last
          argument to the compile line, e.g.:

            cc -o prog prog.c -lnet

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

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









     Page 1                                        (last mod. 1/14/87)