opensolaris man page for dat_ep_reset

dat_ep_reset(3DAT)				     Direct Access Transport Library Functions					dat_ep_reset(3DAT)

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

SYNOPSIS
       cc [ flag... ] file... -ldat [ library... ]
       #include <dat/udat.h>

       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. Endpoint 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 completion of the "marker" from the EVD, it is guar-
       anteed that all previously posted DTO and RMR completions for the Endpoint were dequeued for that EVD. Now,  it is safe to reset  the  End-
       point without losing any completions.

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard: uDAPL, 1.1, 1.2    |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.11							    16 Jul 2004 						dat_ep_reset(3DAT)