stmfGetStmfProp - retrieve default stmf properties for luns and targets
cc [ flag... ] file... –lstmf [ library... ] #include <libstmf.h> int stmfGetStmfProp(uint8_t propType, 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 the hold the returned property value, propLen will contain the required size of the buffer and STMF_ERROR_INVALID_ARG will be returned.
This function gets the default properties for the specified property type. All property values are expressed in human-readable form. The propType argument can be one of the following values:
Retrieve the current default state for luns. The default value is “online”.
Retrieve the current default state for target ports. the default value is “online”.
Retrieve the current setting of whether LUNs should be set to Active in a call to stmfImportLu(3STMF). The default value is “false”.
8 characters representing the vendor ID assignment. The STMF_LU_PROP_VID will be used to provide backward compatibility for clients that are dependent on this being a very specific format. The value set using STMF_LU_PROP_VID in stmfSetStmfProp() will override any settings that have been applied through STMF_LU_PROP_VID in stmfSetLuProp(). Setting STMF_LU_PROP_VID as NULL can unset this property. For more information, see the stmfSetStmfProp(3STMF) and stmfSetLuProp(3STMF) man pages.
16 characters representing the product ID assignment. The STMF_LU_PROP_PID will be used to provide backward compatibility for clients that are dependent on this being a very specific format. The value set using STMF_LU_PROP_PID in stmfSetStmfProp() will override any settings that have been applied through STMF_LU_PROP_PID in stmfSetLuProp(). Setting STMF_LU_PROP_PID as NULL can unset this property. For more information, see the stmfSetStmfProp(3STMF) and stmfSetLuProp(3STMF) man pages.
The following values are returned:
The API call was successful.
Either the propType or propVal argument is invalid.
The specified propType was not found in the system.
See attributes(7) for descriptions of the following attributes:
|