
     socket_listen(3)       MudOS (5 Sep 1994)        socket_listen(3)

     NAME
          socket_listen() - listen for connections on a socket

     SYNOPSIS
          #include <socket_err.h>

          int socket_listen( int s, string listen_callback );

     DESCRIPTION
          To accept connections, a socket is first created with
          socket_create(3), the socket is them put into listening mode
          with socket_listen(3), and the connections are accepted with
          socket_accept(3). The socket_listen() call applies only to
          sockets of type STREAM or MUD.

          The argument listen_callback is the name of a function for
          the driver to call when a connection is requested on the
          listening socket. The listen callback should follow this
          format:

               void listen_callback(int fd)

          Where fd is the listening socket.

     RETURN VALUES
          socket_listen() returns:

               EESUCCESS on success.

               a negative value indicated below on error.

     ERRORS
          EEFDRANGE      Descriptor out of range.

          EEBADF         Descriptor is invalid.

          EESECURITY     Security violation attempted.

          EEMODENOTSUPP  Socket mode not supported.

          EENOADDR       Socket not bound to an address.

          EEISCONN       Socket is already connected.

          EELISTEN       Problem with listen.

     SEE ALSO

     Page 1                                          (printed 3/16/95)

     socket_listen(3)       MudOS (5 Sep 1994)        socket_listen(3)

          socket_accept(3), socket_connect(3), socket_create(3)

     Page 2                                          (printed 3/16/95)

