Manual Pages for UNIX Operating System command usage for man stmfModifyLu

SCSI Target Mode Framework Library Functions  stmfModifyLu(3STMF)



NAME
     stmfModifyLu, stmfModifyLuByFname - modify a logical unit

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

     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 properties 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




SunOS 5.11          Last change: 16 Nov 2009                    1






SCSI Target Mode Framework Library Functions  stmfModifyLu(3STMF)



         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 specify 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 specified 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 pro-
         tected 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.





SunOS 5.11          Last change: 16 Nov 2009                    2






SCSI Target Mode Framework Library Functions  stmfModifyLu(3STMF)



     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  attri-
     butes:



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


SEE ALSO
     libstmf(3LIB), stmfCreateLuResource(3STMF), attributes(5)




























SunOS 5.11          Last change: 16 Nov 2009                    3