stmfSetLuProp, stmfGetLuProp - set or get a logical unit property
cc [ flag... ] file... -lstmf [ library... ] #include <libstmf.h> int stmfSetLuProp(luResource hdl, uint32_t prop, const char *propVal);
int stmfGetLuProp(luResource hdl, uint32_t prop, char *propVal, size_t *propLen);
A property type value. See DESCRIPTION for valid values.
A property value.
The length of the specified property value. If propLen was of an insufficient size to hold the returned property value, propLen will contain the required size of the buffer and STMF_ERROR_INVALID_ARG will be returned.
These functions set or get property values. All property values are expressed in human-readable form. Boolean properties are expressed in case insensitive form of “true” or “false”. Properties that are represented by ASCII hexadecimal contain no leading characters to indicate a base hexadecimal representation (that is, no leading “0x”). The prop argument can be one of the following values:
Asymmetric access state for the logical unit. Set to one of:
Transition to Standby
Transition to Active
Up to 255 characters representing a user defined name for the device.
Default: Set to file name of backing store.
Numeric value for block size in bytes in 2^n.
Organizational Unique Identifier. 6 hexadecimal ASCII characters representing the IEEE OUI company id assignment. This will be used to generate the device identifier (GUID).
Character value representing the file name of the backing store device.
ASCII hexadecimal string of 32 characters representing the unique identifier for the device. This must be of valid 32 hexadecimal ASCII characters representing a valid NAA Registered Extended Identifier.
Default: Set by framework to a generated value.
8 hexadecimal ASCII characters representing the host ID assignment. This will be used to generate the globally unique identifier (GUID) for the logical unit.
Default: identifier returned by hostid(1).
Metadata file name. When specified, will be used to hold the SCSI metadata for the logical unit.
Default: None. If this value is not specified, the value specified in STMF_LU_PROP_DATA_FILENAME will be used.
Up to 1024 characters representing Management Network Address URLs. More than one URL can be passed using space delimited URLs.
Up to 16 characters of product identification that will be reflected in the Standard INQUIRY data returned for the device.
Default: sSet to COMSTAR.
Serial Number. Specifies the SCSI Vital Product Data Serial Number (page 80h). It is a character value up to 252 bytes in length.
Software interface identification VPD page 84h. A set of identifiers representing software features on a logical unit. Each identifier is six ASCII hexadecimal characters. More than one identifier can be passed using space-delimited identifiers. The identifier is made unique by the use of the OUI (STMF_LU_PROP_COMPANY_ID). There is a maximum of 42 identifiers.
Numeric value w/optional suffix, e.g. 100G, 1T, to specify unit of size.
Default: Size of the device specified in the STMF_LU_PROP_DATA_FILENAME property value.
8 characters of vendor identification per SCSI SPC-3 and will be reflected in the Standard INQUIRY data returned for the device.
Default: Set to SUN.
Write cache setting changeable. Specified as “true” or “false”. When “true”, a SCSI MODE SELECT from the initiator can change the WRITE CACHE ENABLE bit on the caching mode page. When false, the WRITE CACHE ENABLE bit is not changeable. This setting does not impact the ability for stmfadm(8) or libstmf(3LIB) to modify the write cache disable setting.
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 specified by STMF_LU_PROP_DATA_FILENAME.
Write protect bit. When specified as “true” or “false”, specifies whether the device behaves as a write protected device.
The following values are returned:
The API call was successful.
Either prop or propVal is unrecognized.
The size of propVal is invalid.
The value of prop is unknown for this resource type.
See attributes(7) for descriptions of the following attributes: