1stmfModifyLu(3STMFS)CSI Target Mode Framework Library FunctionsstmfModifyLu(3STMF)
2
3
4

NAME

6       stmfModifyLu, stmfModifyLuByFname - modify a logical uni
7

SYNOPSIS

9       cc [ flag... ] file... -lstmf [ library... ]
10       #include <libstmf.h>
11
12       int stmfModifyLu(stmfGuid *luGuid, uint32_t prop, const char *propVal)
13
14
15       int stmfModifyLu(uint16_t dType, const char *fname, uint32_t prop,
16            const char *propVal)
17
18

PARAMETERS

20       luGuid     The guid of logical unit to modify.
21
22
23       fname      The filename of logical unit to modify.
24
25
26       dType      Type of logical unit. See stmfCreateLuResource(3STMF).
27
28
29       prop       A property type value. See DESCRIPTION for valid values.
30
31
32       propVal    A property value.
33
34

DESCRIPTION

36       The stmfModifyLu() and stmfModifyLuByFname() functions modify the prop‐
37       erties of a logical unit device.
38
39
40       Valid properties for modify STMF_DISK:
41
42       STMF_LU_PROP_ALIAS
43
44           Up to 255 characters representing  a  user  defined  name  for  the
45           device.
46
47           Default: Set to file name of backing store.
48
49
50       STMF_LU_PROP_SIZE
51
52           Numeric value with optional suffix (for example, 100G, 1T) to spec‐
53           ify unit of size.
54
55           Default: Size of device specified in the STMF_LU_PROP_DATA_FILENAME
56           property value.
57
58
59       STMF_LU_PROP_WRITE_CACHE_DISABLE
60
61           Write  back  cache  disable.  When  specified as "true" or "false",
62           specifies write back cache disable behavior.
63
64           Default: Writeback cache setting of the backing store device speci‐
65           fied by STMF_LU_PROP_DATA_FILENAME.
66
67
68       STMF_LU_PROP_WRITE_PROTECT
69
70           Write  protect  bit. When specified as "true" or "false", specifies
71           whether the device behaves as a write protected device.
72
73           Default: "false"
74
75

RETURN VALUES

77       The following values are returned:
78
79       STMF_STATUS_SUCCESS
80
81           The API call was successful.
82
83
84       STMF_ERROR_INVALID_ARG
85
86           Either prop or propVal is unrecognized.
87
88
89       STMF_ERROR_INVALID_PROPSIZE
90
91           The size of propVal is invalid.
92
93
94       STMF_ERROR_NO_PROP
95
96           The value of prop is unknown for this resource type.
97
98

ATTRIBUTES

100       See attributes(5) for descriptions of the following attributes:
101
102
103
104
105       ┌─────────────────────────────┬─────────────────────────────┐
106       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
107       ├─────────────────────────────┼─────────────────────────────┤
108       │Interface Stability          │Committed                    │
109       ├─────────────────────────────┼─────────────────────────────┤
110       │MT-Level                     │Safe                         │
111       └─────────────────────────────┴─────────────────────────────┘
112

SEE ALSO

114       libstmf(3LIB), stmfCreateLuResource(3STMF), attributes(5)
115
116
117
118SunOS 5.11                        8 May 2009               stmfModifyLu(3STMF)
Impressum