socket_create() - create an efun socket
int socket_create( int mode, string read_callback,
void | string close_callback );
socket_create() creates an efun socket. mode determines which type of
socket is created. Currently supported socket modes are:
0 MUD for sending LPC data types using TCP protocol.
1 STREAM for sending raw data using TCP protocol.
2 DATAGRAM for using UDP protocol.
3 STREAM_BINARY for exchange binary message with TCP protocol.
4 DATAGRAM_BINARY for exchange binary message with UDP protocol.
The argument read_callback is the name of a function for the driver to
call when the socket gets data from its peer. The read callback should
follow this format:
void read_callback(int fd, mixed message)
Where fd is the socket which received the data, and message is the data
which was received.
In non-binary mode, message will be sanitized with UTF8 encoding and returned as an string.
In binary mode, raw messages will be returned as a buffer.
The argument close_callback is the name of a function for the driver to
call if the socket closes unexpectedly, i.e. not as the result of a
socket_close(3) call. The close callback should follow this format:
void close_callback(int fd)
Where fd is the socket which has closed. NOTE: close_callback is not
used with DATAGRAM mode sockets.
a non-negative descriptor on success.
a negative value indicated below on error.
EEMODENOTSUPP Socket mode not supported.
EESOCKET Problem creating socket.
EESETSOCKOPT Problem with setsockopt.
EENONBLOCK Problem setting non-blocking mode.
EENOSOCKS No more available efun sockets.
EESECURITY Security violation attempted.
socket_accept(3), socket_bind(3), socket_close(3), socket_connect(3),