|Skip Navigation Links|
|Exit Print View|
|man pages section 3: Extended Library Functions, Volume 4 Oracle Solaris 11.1 Information Library|
- set the access state of a logical unit to standby mode
cc [ flag... ] file... -lstmf [ library... ] #include <libstmf.h> int stmfSetAluaState(stmfGuid *luGuid);
a pointer to an stmfGuid structure containing the guid of the logical unit to set to standby
The stmfLuStandby() function sets the access state of a logical unit to standby mode. When successfully set, a standby logical unit switches its asymmetric logical unit access state to a one of “Transition to Standby” (see stmfGetLuProp(3STMF). Once moved to this state, the backing store for the logical unit will be released by the logical unit provider (sbd for disk devices). To move a logical unit out of “Standby” or the “Transition to Standby” state, stmfImportLu(3STMF) or the import-lu subcommand of stmfadm(1M) must be executed on the logical unit. On a successful logical unit import, the access state of the logical unit will move to “Active” in addition to sending a message to its peer that will complete the peer's transition to “Standby”. The current access state for the logical unit can be retrieved using stmfGetLuProp() where the property type is STMF_LU_PROP_ACCESS_STATE.
The following values are returned:
The guid does not exist.
The API call was successful.
See attributes(5) for descriptions of the following attributes: