Manual Pages for UNIX Operating System command usage for man stmfSetAluaState

SCSI Target Mode Framework Library Functions
                                          stmfSetAluaState(3STMF)



NAME
     stmfSetAluaState - set the Asymmetric  Logical  Unit  Access
     State (ALUA) mode for STMF

SYNOPSIS
     cc [ flag... ] file... -lstmf [ library... ]
     #include 

     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 function  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, stmfAddViewEntry(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  attri-
     butes:




SunOS 5.11          Last change: 29 Sep 2009                    1






SCSI Target Mode Framework Library Functions
                                          stmfSetAluaState(3STMF)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | Safe                        |
    |_____________________________|_____________________________|


SEE ALSO
     stmfadm(1M),     libstmf(3LIB),     stmfAddViewEntry(3STMF),
     stmfInitProxyDoor(3STMF), attributes(5)










































SunOS 5.11          Last change: 29 Sep 2009                    2






SCSI Target Mode Framework Library Functions
                                          stmfSetAluaState(3STMF)






















































SunOS 5.11          Last change: 29 Sep 2009                    3