1.  ssssoooocccckkkkeeeetttt____ccccoooonnnnnnnneeeecccctttt((((3333))))      MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))       ssssoooocccckkkkeeeetttt____ccccoooonnnnnnnneeeecccctttt((((3333))))
    3.  NNNNAAAAMMMMEEEE
    4.       socket_connect() - initiate a connection on a socket
    6.  SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
    7.       #include <socket_err.h>
    9.       int socket_connect( int s, string address,
    10.                           string read_callback,
    11.                           string write_callback );
    13.  DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
    14.       The argument s is a socket. s must be either a STREAM mode
    15.       or a MUD mode socket. address is the address to which the
    16.       socket will attempt to connect.  address is of the form:
    17.       "127.0.0.1 23"
    19.       The argument read_callback is the name of a function for the
    20.       driver to call when the socket gets data from its peer. The
    21.       read callback should follow this format:
    23.            void read_callback(int fd, mixed message)
    25.       Where fd is the socket which received the data, and message
    26.       is the data which was received.
    28.       The argument write_callback is the name of a function for
    29.       the driver to call when the socket is ready to be written
    30.       to. The write callback should follow this format:
    32.            void write_callback(int fd)
    34.       Where fd is the socket which is ready to be written to.
    36.  RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
    37.       socket_connect() returns:
    39.            EESUCCESS on success.
    41.            a negative value indicated below on error.
    43.  EEEERRRRRRRROOOORRRRSSSS
    44.       EEFDRANGE      Descriptor out of range.
    46.       EEBADF         Descriptor is invalid.
    48.       EESECURITY     Security violation attempted.
    50.       EEMODENOTSUPP  Socket mode not supported.
    52.  Page 1                                          (Writen 5/23/97)
    54.  ssssoooocccckkkkeeeetttt____ccccoooonnnnnnnneeeecccctttt((((3333))))      MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))       ssssoooocccckkkkeeeetttt____ccccoooonnnnnnnneeeecccctttt((((3333))))
    56.       EEISLISTEN     Socket is listening.
    58.       EEISCONN       Socket is already connected.
    60.       EEBADADDR      Problem with address format.
    62.       EEINTR         Interrupted system call.
    64.       EEADDRINUSE    Address already in use.
    66.       EEALREADY      Operation already in progress.
    68.       EECONNREFUSED  Connection refused.
    70.       EECONNECT      Problem with connect.
    72.  SSSSEEEEEEEE AAAALLLLSSSSOOOO
    73.       socket_accept(3), socket_close(3), socket_create(3)
    75.  Page 2                                          (Writen 5/23/97)