1.  ssssoooocccckkkkeeeetttt____aaaacccccccceeeepppptttt((((3333))))       MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))        ssssoooocccckkkkeeeetttt____aaaacccccccceeeepppptttt((((3333))))
    3.  NNNNAAAAMMMMEEEE
    4.       socket_accept() - accept a connection on a socket
    6.  SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
    7.       #include <socket_err.h>
    9.       int socket_accept( int s, string read_callback,
    10.                          string write_callback );
    12.  DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
    13.       The argument s is a socket that has been created with
    14.       socket_create(3), bound to an address with socket_bind(3),
    15.       and is listening for connections after a socket_listen(3).
    16.       socket_accept() extracts the first connection on the queue
    17.       of pending connections, creates a new socket with the same
    18.       properties of s and allocates a new file descriptor for the
    19.       socket. If no pending connections are present on the queue,
    20.       socket_accept() returns an error as described below. The
    21.       accepted socket is used to read and write data to and from
    22.       the socket which connected to this one; it is not used to
    23.       accept more connections. The original socket s remains open
    24.       for accepting further connections.
    26.       The argument read_callback is the name of a function for the
    27.       driver to call when the new socket (not the accepting
    28.       socket) receives data.  The write callback should follow
    29.       this format:
    31.            void read_callback(int fd)
    33.       Where fd is the socket which is ready to accept data.
    35.       The argument write_callback is the name of a function for
    36.       the driver to call when the new socket (not the accepting
    37.       socket) is ready to be written to. The write callback should
    38.       follow this format:
    40.            void write_callback(int fd)
    42.       Where fd is the socket which is ready to be written to.
    44.       Note: The close_callback of the accepting socket (not the
    45.       new socket) is called if the new socket closes unexpectedly,
    46.       i.e. not as the result of a socket_close(3) call. The close
    47.       callback should follow this format:
    49.            void close_callback(int fd)
    51.       Where fd is the socket which has closed.
    53.  Page 1                                          (Writen 5/23/97)
    55.  ssssoooocccckkkkeeeetttt____aaaacccccccceeeepppptttt((((3333))))       MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))        ssssoooocccckkkkeeeetttt____aaaacccccccceeeepppptttt((((3333))))
    57.  RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
    58.       socket_accept() returns a non-negative descriptor for the
    59.       accepted socket on success. On failure, it returns a
    60.       negative value. socket_error(3) can be used on the return
    61.       value to get a text description of the error.
    63.  EEEERRRRRRRROOOORRRRSSSS
    64.       EEFDRANGE      Descriptor out of range.
    66.       EEBADF         Descriptor is invalid.
    68.       EESECURITY     Security violation attempted.
    70.       EEMODENOTSUPP  Socket mode not supported.
    72.       EENOTLISTN     Socket not listening.
    74.       EEWOULDBLOCK   Operation would block.
    76.       EEINTR         Interrupted system call.
    78.       EEACCEPT       Problem with accept.
    80.       EENOSOCKS      No more available efun sockets.
    82.  SSSSEEEEEEEE AAAALLLLSSSSOOOO
    83.       socket_bind(3), socket_connect(3), socket_create(3),
    84.       socket_listen(3)
    86.  Page 2                                          (Writen 5/23/97)