dat_rmr_create(3dat) [sunos man page]
dat_rmr_create(3DAT) Direct Access Transport Library Functions dat_rmr_create(3DAT) NAME
dat_rmr_create - create an RMR for the specified Protection Zone SYNOPSIS
cc [ flag... ] file... -ldat [ library... ] #include <dat/udat.h> DAT_RETURN dat_rmr_create( IN DAT_PZ_HANDLE pz_handle, OUT DAT_RMR_HANDLE *rmr_handle ) PARAMETERS
pz_handle Handle for an instance of the Protection Zone. rmr_handle Handle for the created instance of an RMR. DESCRIPTION
The dat_rmr_create() function creates an RMR for the specified Protection Zone. This operation is relatively heavy. The created RMR can be bound to a memory region within the LMR through a lightweight dat_rmr_bind(3DAT) operation that generates rmr_context. If the operation fails (does not return DAT_SUCCESS), the return values of rmr_handle are undefined and Consumers should not use them. The pz_handle parameter provide Consumers a way to restrict access to an RMR by authorized connection only. RETURN VALUES
DAT_SUCCESS The operation was successful. DAT_INSUFFICIENT_RESOURCES The operation failed due to resource limitations. DAT_INVALID_HANDLE The pz_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 |Safe | +-----------------------------+-----------------------------+ SEE ALSO
dat_rmr_bind(3DAT) , libdat(3LIB), attributes(5) SunOS 5.10 16 Jul 2004 dat_rmr_create(3DAT)
Check Out this Related 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)