Manual Pages for UNIX Operating System command usage for man dat_ep_reset

Direct Access Transport Library Functions      dat_ep_reset(3DAT)



NAME
     dat_ep_reset - transition the local Endpoint from a  Discon-
     nected to an Unconnected state

SYNOPSIS
     cc [ flag... ] file... -ldat [ library... ]
     #include 

     DAT_RETURN
         dat_ep_reset (
         IN    DAT_EP_HANDLE    ep_handle
         )


PARAMETERS
     ep_handle    Handle for an instance of Endpoint.


DESCRIPTION
     The dat_ep_reset() function transitions the  local  Endpoint
     from a Disconnected to an Unconnected state.


     The operation might cause the loss  of  any  completions  of
     previously posted DTOs and RMRs that were not dequeued yet.


     The dat_ep_reset() function is valid for  both  Disconnected
     and Unconnected states. For Unconnected state, the operation
     is no-op because the Endpoint is already in  an  Unconnected
     state. For an Unconnected state, the preposted Recvs are not
     affected by the call.

RETURN VALUES
     DAT_SUCCESS           The operation was successful.


     DAT_INVALID_HANDLE    ep_handle is invalid.


     DAT_INVALID_STATE     Parameter in an  invalid  state.  End-
                           point  is  not  in the valid state for
                           reset.


USAGE
     If the Consumer wants to ensure  that  all  Completions  are
     dequeued,  the  Consumer can post DTO or RMR operations as a
     "marker"   that   are   flushed   to   recv_evd_handle    or
     request_evd_handle. Now, when the Consumer dequeues the com-
     pletion of the "marker" from the EVD, it is guaranteed  that
     all  previously  posted  DTO  and  RMR  completions  for the



SunOS 5.11          Last change: 16 Jul 2004                    1






Direct Access Transport Library Functions      dat_ep_reset(3DAT)



     Endpoint were dequeued for that EVD. Now,   it  is  safe  to
     reset the Endpoint without losing any completions.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Unsafe                      |
    |_____________________________|_____________________________|
    | Standard                    | uDAPL, 1.1, 1.2             |
    |_____________________________|_____________________________|


SEE ALSO
     libdat(3LIB), attributes(5)

































SunOS 5.11          Last change: 16 Jul 2004                    2