1.  ssssoooocccckkkkeeeetttt____ccccrrrreeeeaaaatttteeee((((3333))))       MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))        ssssoooocccckkkkeeeetttt____ccccrrrreeeeaaaatttteeee((((3333))))
    3.  NNNNAAAAMMMMEEEE
    4.       socket_create() - create an efun socket
    6.  SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
    7.       #include <socket_err.h>
    9.       int socket_create( int mode, string read_callback,
    10.                          void | string close_callback );
    12.  DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
    13.       socket_create() creates an efun socket. mode determines
    14.       which type of socket is created. Currently supported socket
    15.       modes are:
    17.       MUD         for sending LPC data types using TCP protocol.
    19.       STREAM      for sending raw data using TCP protocol.
    21.       DATAGRAM    for using UDP protocol.
    23.       The argument read_callback is the name of a function for the
    24.       driver to call when the socket gets data from its peer. The
    25.       read callback should follow this format:
    27.            void read_callback(int fd, mixed message)
    29.       Where fd is the socket which received the data, and message
    30.       is the data which was received.
    32.       The argument close_callback is the name of a function for
    33.       the driver to call if the socket closes unexpectedly, i.e.
    34.       not as the result of a socket_close(3) call. The close
    35.       callback should follow this format:
    37.            void close_callback(int fd)
    39.       Where fd is the socket which has closed.  NOTE:
    40.       close_callback is not used with DATAGRAM mode sockets.
    42.  RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
    43.       socket_create() returns:
    45.            a non-negative descriptor on success.
    47.            a negative value indicated below on error.
    49.  EEEERRRRRRRROOOORRRRSSSS
    50.       EEMODENOTSUPP  Socket mode not supported.
    52.  Page 1                                          (Writen 5/23/97)
    54.  ssssoooocccckkkkeeeetttt____ccccrrrreeeeaaaatttteeee((((3333))))       MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))        ssssoooocccckkkkeeeetttt____ccccrrrreeeeaaaatttteeee((((3333))))
    56.       EESOCKET       Problem creating socket.
    58.       EESETSOCKOPT   Problem with setsockopt.
    60.       EENONBLOCK     Problem setting non-blocking mode.
    62.       EENOSOCKS      No more available efun sockets.
    64.       EESECURITY     Security violation attempted.
    66.  SSSSEEEEEEEE AAAALLLLSSSSOOOO
    67.       socket_accept(3), socket_bind(3), socket_close(3),
    68.       socket_connect(3), socket_listen(3), socket_write(3)
    70.  Page 2                                          (Writen 5/23/97)