LISTEN(2)               COMMAND REFERENCE               LISTEN(2)



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(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.

     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.

DIAGNOSTICS
     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.

RETURN VALUE
     [0]  Listen was successful.

     [-1] Listen was unsuccessful.

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

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
















Printed 5/12/88                                                 1

%%index%%
na:288,95;
sy:383,435;
de:818,746;
di:1564,424;
rv:1988,313;
ca:2301,148;
se:2449,179;
%%index%%000000000120