NAME
     socket_listen() - listen for connections on a socket

SYNOPSIS
     #include 
     #include 

     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
     socket_accept(3), socket_connect(3), socket_create(3)

Help topics available:

socket_accept	socket_acquire	socket_bind	socket_error	socket_listen
socket_close	socket_release	socket_write	socket_address	socket_connect
socket_create