listen(2N)                                             listen(2N)



NAME
     listen - listens 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.

STATUS MESSAGES AND VALUES
     A 0 return value indicates success; -1 indicates an error.

     The listen program will fail if:

     EBADF
          The argument s is not a valid descriptor.

     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
     ECONNREFUSED.  The socket is not of a type that supports the
     operation listen.

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

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














January 1992                                                    1