1.  ssssoooocccckkkkeeeetttt____rrrreeeelllleeeeaaaasssseeee((((3333))))      MMMMuuuuddddOOOOSSSS ((((5555 SSSSeeeepppp 1111999999994444))))       ssssoooocccckkkkeeeetttt____rrrreeeelllleeeeaaaasssseeee((((3333))))
    3.  NNNNAAAAMMMMEEEE
    4.       socket_release() - release ownership of a socket to another
    5.       object
    7.  SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
    8.       #include <socket_err.h>
    10.       int socket_release( int socket, object ob,
    11.                           string release_callback );
    13.  DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
    14.       socket_release() is used to change ownership (and control)
    15.       of a socket to another object.  It is useful in daemon
    16.       objects (like inetd) which handle connection set-up and then
    17.       transfer a connected socket to another object for further
    18.       processing.
    20.       Socket ownership transfer involves a handshake between the
    21.       current owner object and the socket to which the current
    22.       owner wishes to transfer the socket.  The handshake is
    23.       initiated when socket_release() is called.  socket_release()
    24.       does appropriate security/integrity checking and then calls
    25.       the release_callback function in object ob.  This function
    26.       is used to notify ob that socket ownership is being
    27.       transferred to it.  It is then ob's responsibility to call
    28.       socket_acquire() within the release callback function.  If
    29.       socket_acquire() is called then the handshake is complete
    30.       and socket ownership has been successfully transferred to
    31.       ob.  ob may decline to accept responsibility for the socket
    32.       by not calling socket_acquire(), in which case ownership
    33.       does not change and the current socket owner must decide how
    34.       to respond to this.
    36.       If the socket owner is successfully transfered then
    37.       socket_release() returns EESUCCESS.  If ob does not accept
    38.       ownership for the socket then EESOCKNOTRLSD is returned.
    39.       Other errors can be returned based on security violation,
    40.       bad socket descriptor vbalues, etc.
    42.  SSSSEEEEEEEE AAAALLLLSSSSOOOO
    43.       socket_acquire(3)
    45.  Page 1                                          (Writen 5/23/97)