1.  ssssoooocccckkkkeeeetttt____lllliiiisssstttteeeennnn((((3333))))       MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))        ssssoooocccckkkkeeeetttt____lllliiiisssstttteeeennnn((((3333))))
    3.  NNNNAAAAMMMMEEEE
    4.       socket_listen() - listen for connections on a socket
    6.  SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
    7.       #include <socket_err.h>
    9.       int socket_listen( int s, string listen_callback );
    11.  DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
    12.       To accept connections, a socket is first created with
    13.       socket_create(3), the socket is them put into listening mode
    14.       with socket_listen(3), and the connections are accepted with
    15.       socket_accept(3). The socket_listen() call applies only to
    16.       sockets of type STREAM or MUD.
    18.       The argument listen_callback is the name of a function for
    19.       the driver to call when a connection is requested on the
    20.       listening socket. The listen callback should follow this
    21.       format:
    23.            void listen_callback(int fd)
    25.       Where fd is the listening socket.
    27.  RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
    28.       socket_listen() returns:
    30.            EESUCCESS on success.
    32.            a negative value indicated below on error.
    34.  EEEERRRRRRRROOOORRRRSSSS
    35.       EEFDRANGE      Descriptor out of range.
    37.       EEBADF         Descriptor is invalid.
    39.       EESECURITY     Security violation attempted.
    41.       EEMODENOTSUPP  Socket mode not supported.
    43.       EENOADDR       Socket not bound to an address.
    45.       EEISCONN       Socket is already connected.
    47.       EELISTEN       Problem with listen.
    49.  SSSSEEEEEEEE AAAALLLLSSSSOOOO
    51.  Page 1                                          (Writen 5/23/97)
    53.  ssssoooocccckkkkeeeetttt____lllliiiisssstttteeeennnn((((3333))))       MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))        ssssoooocccckkkkeeeetttt____lllliiiisssstttteeeennnn((((3333))))
    55.       socket_accept(3), socket_connect(3), socket_create(3)
    57.  Page 2                                          (Writen 5/23/97)