stmfSetAluaState(SCSIFTarget Mode Framework Library FunstmfSetAluaState(3STMF)NAMEstmfSetAluaState - set the Asymmetric Logical Unit Access State (ALUA)
mode for STMF
SYNOPSIS
cc [ flag... ] file... -lstmf [ library... ]
#include <libstmf.h>
int stmfSetAluaState(boolean_t alua_enabled, uint32_t node);
PARAMETERS
alua_enabled B_TRUE when enabling ALUA mode; B_FALSE when disabling
ALUA mode.
node Must be the value 0 or 1.
DESCRIPTION
The stmfSetAluaState() function sets the Asymmetric Logical Unit Access
State (ALUA) mode for STMF. When alua_enabled is set to B_FALSE, node
is ignored; otherwise, node must be set to 0 or 1. The node setting
must be different for each node in a paired configuration. This func‐
tion should be called only after the STMF proxy door service has been
initialized (see stmfInitProxyDoor(3STMF)). When the ALUA state is
enabled, all STMF logical units will be registered on the peer node as
standby logical units. The standby logical units can then be exported
to any SCSI initiator using the existing mechanisms in STMF, stmfAd‐
dViewEntry(3STMF) or the add-view subcommand of stmfadm(1M). If ALUA
mode is already enabled, it is valid to call this interface again with
enabled set to B_TRUE. This action would result in a re-initialization
of the ALUA mode and can be used during recovery of a failed peer node.
RETURN VALUES
The following values are returned:
STMF_ERROR_INVALID_ARG Either alua_enabled or node was incorrectly
set.
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), stmfAddViewEntry(3STMF), stmfInitProxy‐
Door(3STMF), attributes(5)SunOS 5.11 29 Sep 2009 stmfSetAluaState(3STMF)