socket_create(3) LPC Library Functions socket_create(3)
NNAAMMEE
socket_create() - create an efun socket
SSYYNNOOPPSSIISS
#include <socket_err.h>
int socket_create( int mode, string read_callback,
void | string close_callback );
DDEESSCCRRIIPPTTIIOONN
socket_create() creates an efun socket. mode determines
which type of socket is created. Currently supported
socket modes are:
MUD for sending LPC data types using TCP protocol.
STREAM for sending raw data using TCP protocol.
DATAGRAM for using 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 mes-
sage is the data which was received.
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.
RREETTUURRNN VVAALLUUEESS
socket_create() returns:
a non-negative descriptor on success.
a negative value indicated below on error.
EERRRROORRSS
EEMODENOTSUPP Socket mode not supported.
EESOCKET Problem creating socket.
MudOS 5 Sep 1994 1
socket_create(3) LPC Library Functions socket_create(3)
EESETSOCKOPT Problem with setsockopt.
EENONBLOCK Problem setting non-blocking mode.
EENOSOCKS No more available efun sockets.
EESECURITY Security violation attempted.
SSEEEE AALLSSOO
socket_accept(3), socket_bind(3), socket_close(3),
socket_connect(3), socket_listen(3), socket_write(3)
MudOS 5 Sep 1994 2