
### NAME

    socket_create() - create an efun socket

### SYNOPSIS

    #include <socket_err.h>

    int socket_create( int mode, string read_callback,
                       void | string close_callback );

### DESCRIPTION

    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.

### RETURN VALUES

    socket_create() returns:

        a non-negative descriptor on success.

        a negative value indicated below on error.

### ERRORS

    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.

### SEE ALSO

    socket_accept(3), socket_bind(3),  socket_close(3),  socket_connect(3),
    socket_listen(3), socket_write(3)

