stmfModifyLu(3STMSCSI Target Mode Framework Library FunctiostmfModifyLu(3STMF)NAME
stmfModifyLu, stmfModifyLuByFname - modify a logical unit
SYNOPSIS
cc [ flag... ] file... -lstmf [ library... ]
#include <libstmf.h>
int stmfModifyLu(stmfGuid *luGuid, uint32_t prop, const char *propVal)
int stmfModifyLu(uint16_t dType, const char *fname, uint32_t prop,
const char *propVal)
PARAMETERS
luGuid The guid of logical unit to modify.
fname The filename of logical unit to modify.
dType Type of logical unit. See stmfCreateLuResource(3STMF).
prop A property type value. See DESCRIPTION for valid values.
propVal A property value.
DESCRIPTION
The stmfModifyLu() and stmfModifyLuByFname() functions modify the prop‐
erties of a logical unit device.
Valid properties for modify STMF_DISK:
STMF_LU_PROP_ACCESS_STATE
Asymmetric access state for the logical unit. Set to one of:
0 Active
1 Transition to Active
2 Standby
3 Transition to Standby
STMF_LU_PROP_ALIAS
Up to 255 characters representing a user defined name for the
device.
Default: Set to file name of backing store.
STMF_LU_PROP_SIZE
Numeric value with optional suffix (for example, 100G, 1T) to spec‐
ify unit of size.
Default: Size of device specified in the STMF_LU_PROP_DATA_FILENAME
property value.
STMF_LU_PROP_WRITE_CACHE_DISABLE
Write back cache disable. When specified as "true" or "false",
specifies write back cache disable behavior.
Default: Writeback cache setting of the backing store device speci‐
fied by STMF_LU_PROP_DATA_FILENAME.
STMF_LU_PROP_WRITE_PROTECT
Write protect bit. When specified as "true" or "false", specifies
whether the device behaves as a write protected device.
Default: "false"
RETURN VALUES
The following values are returned:
STMF_STATUS_SUCCESS
The API call was successful.
STMF_ERROR_INVALID_ARG
Either prop or propVal is unrecognized.
STMF_ERROR_INVALID_PROPSIZE
The size of propVal is invalid.
STMF_ERROR_INVALID_PROP
The value of prop is unknown for this resource type.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOlibstmf(3LIB), stmfCreateLuResource(3STMF), attributes(5)SunOS 5.11 16 Nov 2009 stmfModifyLu(3STMF)