Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dat_rmr_free(3dat) [opensolaris man page]

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

NAME
dat_rmr_free - destroy an instance of the RMR SYNOPSIS
cc [ flag... ] file... -ldat [ library... ] #include <dat/udat.h> DAT_RETURN dat_rmr_free ( IN DAT_RMR_HANDLE rmr_handle ) PARAMETERS
rmr_handle Handle for an instance of the RMR to be destroyed. DESCRIPTION
The dat_rmr_free() function destroys an instance of the RMR. Use of the handle of the destroyed RMR in any subsequent operation except for the dat_rmr_free() fails. Any remote RDMA operation that uses the destroyed RMR rmr_context, whose Transport-specific request arrived to the local host after the dat_rmr_free() has completed, fails and reports a protection violation. Remote RDMA operation that uses the destroyed RMR rmr_context, whose Transport-specific request arrived to the local host prior to the dat_rmr_free() return, might or might not complete successfully. If it fails, DAT_DTO_ERR_REMOTE_ACCESS is reported in DAT_DTO_COMPLETION_STATUS for the remote RDMA DTO and the connection is broken. The dat_rmr_free() function is allowed on either bound or unbound RMR. If RMR is bound, dat_rmr_free() unbinds (free HCA TPT and other resources and whatever else binds with length of 0 should do), and then free RMR. RETURN VALUES
DAT_SUCCESS The operation was successful. DAT_INVALID_HANDLE The rmr_handle handle 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_free(3DAT)

Check Out this Related Man Page

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)
Man Page