socket_listen(3)      LPC Library Functions      socket_listen(3)

NNAAMMEE
       socket_listen() - listen for connections on a socket

SSYYNNOOPPSSIISS
       #include <socket_err.h>

       int socket_listen( int s, string listen_callback );

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

RREETTUURRNN VVAALLUUEESS
       socket_listen() returns:

              EESUCCESS on success.

              a negative value indicated below on error.

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

SSEEEE AALLSSOO
       socket_accept(3), socket_connect(3), socket_create(3)

MudOS                       5 Sep 1994                          1