1.  ssssoooocccckkkkeeeetttt____aaaaccccqqqquuuuiiiirrrreeee((((3333))))      MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))       ssssoooocccckkkkeeeetttt____aaaaccccqqqquuuuiiiirrrreeee((((3333))))
    3.  NNNNAAAAMMMMEEEE
    4.       socket_acquire() - assume ownership of a socket
    6.  SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
    7.       #include <socket_err.h>
    9.       int socket_acquire( int socket, string read_callback,
    10.                           string write_callback,
    11.                           string close_callback );
    13.  DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
    14.       socket_acquire() is called to complete the handshake begun
    15.       by socket_release() for transferring ownership (and control)
    16.       of a socket to a new object.  socket_release() calls the
    17.       release callback function within the new owner object to
    18.       notify the object that it wishes to pass control of the
    19.       socket on.  It is the responsibility of the new owner socket
    20.       to decide whether it wishes to accept the socket.  It it
    21.       does, then socket_acquire() is called to complete the
    22.       transfer.  If not, then the callback simply returns without
    23.       completing the handshake.
    25.       In the former case the handshake is completed and the new
    26.       object becomes the socket owner.  The read, write and close
    27.       callback function parameters refer to functions within the
    28.       new object.  These are specified so that the MudOS driver
    29.       will know which functions to call within the new object.
    30.       Decling to acquire the socket will cause socket_release() to
    31.       return EESOCKNOTRLSD so the owner can perform appropriate
    32.       clean-up.
    34.       socket_acquire() may only be called within the context of
    35.       thr release callback function and only with the socket
    36.       specified.
    38.  SSSSEEEEEEEE AAAALLLLSSSSOOOO
    39.       socket_release(3)
    41.  Page 1                                          (Writen 5/23/97)