Go to main content

man pages section 3: Extended Library Functions, Volume 4

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

stmfSetLuListActive (3STMF)

Name

stmfSetLuListActive - Set a list of COMSTAR LUNs toSTMF_ACCESS_ACTIVE

Synopsis

cc [ flag... ] file... -lstmf [ library... ]
#include <libstmf.h>
int stmfSetLuListActive(stmfGuidList *stmfLuList,
stmfLuListStatus **luListErrStatus);

Parameters

stmfLuList

An array LUN list which each individual LUN in the list is represented by the LUN GUID.

luListErrStatus

A pointer to a pointer to structure stmfLuListStatus. On successful return, it is set to NULL. On failure, it will contain a list of each LUN that is failed the set to STMF_ACCESS_ACTIVE along with the error status.

Description

This stmfSetLuListActive() function takes a list of LUN GUIDs and sets each of the LUNs' access state to STMF_ACCESS_ACTIVE. For more information on the access state, see stmfLuStandby(3STMF)

Return Values

The following values are returned:

STMF_STATUS_SUCCESS

The API call is successful. On successful completion,luListErrStatus parameter is set to NULL .

STMF_STATUS_ERROR

One or more LUNs fails to set to STMF_ACCESS_ACTIVE state. With the error status returned. luListErrStatus parameter contains a list of LUNs which has problem to be set to STMF_ACCESS_ACTIVE state.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
Safe

See Also

libstmf(3LIB), stmfGetAluaState(3STMF), stmfSetAluaState(3STMF), attributes(7)