listen(3N)                                                listen(3N)


       NAME
             listen - listen for connections on a socket

       SYNOPSIS
             cc [options] file -lsocket -lnsl
             #include <sys/socket.h>
             int listen(int s, int backlog);

       DESCRIPTION
             To accept connections, a socket is first created with socket,
             a backlog for incoming connections is specified with listen
             and then the connections are accepted with accept.  The listen
             call applies only to sockets of type SOCK_STREAM or
             SOCK_SEQPACKET.

             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.

          Files
             /usr/lib/locale/locale/LC_MESSAGES/uxnsl

          Return Values
             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.

       REFERENCES
             accept(3N), connect(3N), socket(3N)

       NOTICES
             There is currently no backlog limit.







                           Copyright 1994 Novell, Inc.               Page 1