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

NAME

       dat_rmr_query - provide RMR parameters

SYNOPSIS

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

       DAT_RETURN
	   dat_rmr_query (
	   IN	 DAT_RMR_HANDLE        rmr_handle,
	   IN	 DAT_RMR_PARAM_MASK    rmr_param_mask,
	   OUT	 DAT_RMR_PARAM	       *rmr_param
	   )

PARAMETERS

       rmr_handle	 Handle for an instance of the RMR.

       rmr_param_mask	 Mask for RMR parameters.

       rmr_param	 Pointer to a Consumer-allocated structure that the Provider fills with RMR parameters.

DESCRIPTION

       The dat_rmr_query() function provides RMR parameters to the Consumer. The Consumer passes in a pointer to the Consumer-allocated structures
       for RMR parameters that the Provider fills.

       The rmr_param_mask parameter allows Consumers to specify which  parameters  to  query.  The  Provider  returns  values  for  rmr_param_mask
       requested parameters. The Provider can return values for any other parameters.

       Not  all parameters can have a value at all times. For example, lmr_handle, target_address, segment_length, mem_privileges, and rmr_context
       are not defined for an unbound RMR.

RETURN VALUES

       DAT_SUCCESS		The operation was successful.

       DAT_INVALID_PARAMETER	The rmr_param_mask parameter is invalid.

       DAT_INVALID_HANDLE	The mr_handle parameter is invalid.

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_rmr_query(3DAT)