socket_connect(3)     LPC Library Functions     socket_connect(3)

NNAAMMEE
       socket_connect() - initiate a connection on a socket

SSYYNNOOPPSSIISS
       #include <socket_err.h>

       int socket_connect( int s, string address,
                           string read_callback,
                           string write_callback );

DDEESSCCRRIIPPTTIIOONN
       The argument s is a socket. s must be either a STREAM mode
       or a MUD mode socket. address is the address to which  the
       socket  will  attempt to connect.  address is of the form:
       "127.0.0.1 23"

       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 write_callback is the name of a function for
       the driver to call when the socket is ready to be  written
       to. The write callback should follow this format:

              void write_callback(int fd)

       Where fd is the socket which is ready to be written to.

RREETTUURRNN VVAALLUUEESS
       socket_connect() returns:

              EESUCCESS on success.

              a negative value indicated below on error.

EERRRROORRSS
       EEFDRANGE      Descriptor out of range.

       EEBADF         Descriptor is invalid.

       EESECURITY     Security violation attempted.

       EEMODENOTSUPP  Socket mode not supported.

       EEISLISTEN     Socket is listening.

MudOS                       5 Sep 1994                          1

socket_connect(3)     LPC Library Functions     socket_connect(3)

       EEISCONN       Socket is already connected.

       EEBADADDR      Problem with address format.

       EEINTR         Interrupted system call.

       EEADDRINUSE    Address already in use.

       EEALREADY      Operation already in progress.

       EECONNREFUSED  Connection refused.

       EECONNECT      Problem with connect.

SSEEEE AALLSSOO
       socket_accept(3), socket_close(3), socket_create(3)

MudOS                       5 Sep 1994                          2