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)