STMFCREATELU(3STMF)STMFCREATELU(3STMF)NAMEstmfCreateLu - create a logical unit
SYNOPSIS
cc [ flag... ] file... -lstmf [ library... ]
#include <libstmf.h>
int stmfCreateLu(luResource hdl, stmfGuid *luGuid);
PARAMETERS
hdl
The logical unit resource returned from a previous call to
stmfCreateLuResource(3STMF).
luGuid
If non-null, it must contain a pointer to an stmfGuid struc‐
ture allocated by the caller. On successful return from this
API, it will contain the guid of the newly created logical
unit. If luGuid is NULL, this argument is ignored.
DESCRIPTION
The stmfCreateLu function creates a logical unit in stmf using the
properties of hdl. See stmfSetLuProp(3STMF) for a complete description
of properties and their possible values.
RETURN VALUES
The following values are returned:
STMF_STATUS_SUCCESS
The API call was successful.
STMF_ERROR_FILE_IN_USE
The filename specified by the STMF_LU_PROP_DATA_FILENAME or
STMF_LU_PROP_META_FILENAME was in use.
STMF_ERROR_GUID_IN_USE
The guid specified by the STMF_LU_PROP_GUID property is already
being used.
STMF_ERROR_INVALID_BLKSIZE
The blocksize specified by STMF_LU_PROP_BLOCK_SIZE is invalid.
STMF_ERROR_WRITE_CACHE_SET
The requested write cache setting could not be provided.
STMF_ERROR_SIZE_OUT_OF_RANGE
The specified logical unit size is not supported.
STMF_ERROR_META_FILE_NAME
The specified meta file could not be accessed.
STMF_ERROR_DATA_FILE_NAME
The specified data file could not be accessed.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Interface Stability │ Committed │
├────────────────────┼─────────────────┤
│MT-Level │ Safe │
└────────────────────┴─────────────────┘
SEE ALSOlibstmf(3LIB), stmfCreateLuResource(3STMF), stmfSetLuProp(3STMF),
attributes(5)
May 8, 2009 STMFCREATELU(3STMF)