1stmfCreateLu(3STMFS)CSI Target Mode Framework Library FunctionsstmfCreateLu(3STMF)
2
3
4

NAME

6       stmfCreateLu - create a logical unit
7

SYNOPSIS

9       cc [ flag... ] file... -lstmf [ library... ]
10       #include <libstmf.h>
11
12       int stmfCreateLu(luResource hdl, stmfGuid *luGuid);
13
14

PARAMETERS

16       hdl       The  logical  unit  resource returned from a previous call to
17                 stmfCreateLuResource(3STMF).
18
19
20       luGuid    If non-null, it must contain a pointer to an stmfGuid  struc‐
21                 ture  allocated by the caller. On successful return from this
22                 API, it will contain the guid of the  newly  created  logical
23                 unit. If luGuid is NULL, this argument is ignored.
24
25

DESCRIPTION

27       The  stmfCreateLu  function  creates  a  logical unit in stmf using the
28       properties of hdl. See stmfSetLuProp(3STMF) for a complete  description
29       of properties and their possible values.
30

RETURN VALUES

32       The following values are returned:
33
34       STMF_STATUS_SUCCESS
35
36           The API call was successful.
37
38
39       STMF_ERROR_FILE_IN_USE
40
41           The   filename   specified  by  the  STMF_LU_PROP_DATA_FILENAME  or
42           STMF_LU_PROP_META_FILENAME was in use.
43
44
45       STMF_ERROR_GUID_IN_USE
46
47           The guid specified by the  STMF_LU_PROP_GUID  property  is  already
48           being used.
49
50
51       STMF_ERROR_INVALID_BLKSIZE
52
53           The blocksize specified by STMF_LU_PROP_BLOCK_SIZE is invalid.
54
55
56       STMF_ERROR_WRITE_CACHE_SET
57
58           The requested write cache setting could not be provided.
59
60
61       STMF_ERROR_SIZE_OUT_OF_RANGE
62
63           The specified logical unit size is not supported.
64
65
66       STMF_ERROR_META_FILE_NAME
67
68           The specified meta file could not be accessed.
69
70
71       STMF_ERROR_DATA_FILE_NAME
72
73           The specified data file could not be accessed.
74
75

ATTRIBUTES

77       See attributes(5) for descriptions of the following attributes:
78
79
80
81
82       ┌─────────────────────────────┬─────────────────────────────┐
83       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
84       ├─────────────────────────────┼─────────────────────────────┤
85       │Interface Stability          │Committed                    │
86       ├─────────────────────────────┼─────────────────────────────┤
87       │MT-Level                     │Safe                         │
88       └─────────────────────────────┴─────────────────────────────┘
89

SEE ALSO

91       libstmf(3LIB),    stmfCreateLuResource(3STMF),    stmfSetLuProp(3STMF),
92       attributes(5)
93
94
95
96SunOS 5.11                        8 May 2009               stmfCreateLu(3STMF)
Impressum