rsm_release_controller(3rsm) [sunos man page]
rsm_get_controller(3RSM) Remote Shared Memory Library Functions rsm_get_controller(3RSM) NAME
rsm_get_controller, rsm_get_controller_attr, rsm_release_controller - get or release a controller handle SYNOPSIS
cc [ flag... ] file... -lrsm [ library... ] #include <rsmapi.h> int rsm_get_controller(char *name, rsmapi_controller_handle_t *controller); int rsm_get_controller_attr(rsmapi_controller_handle_t chdl, rsmapi_controller_attr_t *attr); int rsm_release_controller(rsmapi_controller_handle_t chdl); DESCRIPTION
The controller functions provide mechanisms for obtaining access to a controller, determining the characteristics of the controller, and releasing the controller. The rsm_get_controller() function acquires a controller handle through the controller argument. The name argument is the specific con- troller instance (for example, "sci0" or "loopback"). This controller handle is used for subsequent RSMAPI calls. The rsm_get_controller_attr() function obtains a controller's attributes through the attr argument. The chdl argument is the controller handle obtained by the rsm_get_controller() call. The attribute structure is defined in the <rsmapi> header. The rsm_release_controller() function releases the resources associated with the controller identified by the controller handle chdl, obtained by calling rsm_get_controller(). Each rsm_release_controller() call must have a corresponding rsm_get_controller() call. It is illegal to access a controller or segments exported or imported using a released controller. RETURN VALUES
Upon successful completion, these functions return 0. Otherwise, an error value is returned to indicate the error. ERRORS
The rsm_get_controller(), rsm_get_controller_attr(), and rsm_release_controller() functions can return the following errors: RSMERR_BAD_CTLR_HNDL Invalid controller handle. The rsm_get_controller() and rsm_get_controller_attr() functions can return the following errors: RSMERR_BAD_ADDR Bad address. The rsm_get_controller() function can return the following errors: RSMERR_CTLR_NOT_PRESENT Controller not present. RSMERR_INSUFFICIENT_MEM Insufficient memory. RSMERR_BAD_LIBRARY_VERSION Invalid library version. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
rsm_memseg_export_create(3RSM), rsm_memseg_import_connect(3RSM), attributes(5) SunOS 5.10 8 Jun 2001 rsm_get_controller(3RSM)
Check Out this Related Man Page
rsm_create_localmemory_handle(3RSM) Remote Shared Memory Library Functions rsm_create_localmemory_handle(3RSM) NAME
rsm_create_localmemory_handle, rsm_free_localmemory_handle - create or free local memory handle SYNOPSIS
cc [ flag... ] file... -lrsm [ library... ] #include <rsmapi.h> int rsm_create_localmemory_handle( rsmapi_controller_handle_t handle, rsm_localmemory_handle_t *l_handle, caddr_t local_vaddr, size_t length); int rsm_free_localmemory_handle( rsmapi_controller_handle_t handle, rsm_localmemory_handle_t l_handle); DESCRIPTION
The rsm_create_localmemory_handle() and rsm_free_localmemory_handle() functions are supporting functions for rsm_memseg_import_putv(3RSM) and rsm_memseg_import_getv(3RSM). The rsm_create_localmemory_handle() function creates a local memory handle to be used in the I/O vector component of a scatter-gather list of subsequent rsm_memseg_import_putv() and rsm_memseg_import_getv() calls. The handle argument specifies the controller handle obtained from rsm_get_controller(3RSM). The l_handle argument is a pointer to the location for the function to return the local memory handle. The local_vaddr argument specifies the local virtual address; it should be aligned at a page boundary. The length argument specifies the length of memory spanned by the handle. The rsm_free_localmemory_handle() function unlocks the memory range for the local handle specified by l_handle and releases the associated system resources. The handle argument specifies the controller handle. All handles created by a process are freed when the process exits, but the process should call rsm_free_localmemory_handle() as soon as possible to free the system resources. RETURN VALUES
Upon successful completion, these functions return 0. Otherwise, an error value is returned to indicate the error. ERRORS
The rsm_create_localmemory_handle() and rsm_free_localmemory_handle() functions can return the following errors: RSMERR_BAD_CTLR_HNDL Invalid controller handle. RSMERR_BAD_LOCALMEM_HNDL Invalid local memory handle. The rsm_create_localmemory_handle() function can return the following errors: RSMERR_BAD_LENGTH Invalid length. RSMERR_BAD_ADDRESS Invalid address. RSMERR_INSUFFICIENT_MEM Insufficient memory. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ |ATTRIBUTE TYPE |ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Evolving | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
rsm_memseg_import_putv(3RSM), attributes(5) SunOS 5.11 8 Jun 2001 rsm_create_localmemory_handle(3RSM)