From the NannyMUD documentation

LAST CHANGE

2001-10-02

FUNCTION

NAME
        socket_listen - Listen for connections on a socket.


SYNTAX
	#include 
	#include 

        int socket_listen(int s, string listen_callback)

DESCRIPTION
	To accept connections, a socket is first created with
	socket_create(), the socket is them put into listening mode
	with socket_listen(), and the connections are accepted with
	socket_accept(). 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.

        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 in efun/socket/socket_accept


SEE ALSO
        socket_connect in efun/socket/socket_connect


SEE ALSO
        socket_create in efun/socket/socket_create
        socket_create in efun/socket/socket_create