stmfLuStandby(3STSCSI Target Mode Framework Library FunctistmfLuStandby(3STMF)NAMEstmfLuStandby - set the access state of a logical unit to standby mode
SYNOPSIS
cc [ flag... ] file... -lstmf [ library... ]
#include <libstmf.h>
int stmfSetAluaState(stmfGuid *luGuid);
PARAMETERS
luGuid a pointer to an stmfGuid structure containing the guid of the
logical unit to set to standby
DESCRIPTION
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 back‐
ing 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 log‐
ical 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 stm‐
fGetLuProp() where the property type is STMF_LU_PROP_ACCESS_STATE.
RETURN VALUES
The following values are returned:
STMF_ERROR_NOT_FOUND The guid does not exist.
STMF_STATUS_SUCCESS The API call was successful.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOstmfadm(1M), libstmf(3LIB), stmfGetLuProp(3STMF), stmfImportLu(3STMF),
attributes(5)SunOS 5.11 29 Sep 2009 stmfLuStandby(3STMF)