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), socket(2).












Printed 10/17/86                                                1

%%index%%
na:72,79;
sy:151,283;
de:434,678;
di:1112,367;
rv:1479,229;
ca:1708,120;
se:1828,143;
%%index%%000000000119