man pages section 3: Extended Library Functions, Volume 4

Exit Print View

Updated: July 2014
 
 

stmfImportLu(3STMF)

Name

stmfImportLu - import a logical unit

Synopsis

cc [ flag... ] file... -lstmf [ library... ]
#include <libstmf.h>

int stmfImportLu(uint16_t dType, char *fname, stmfGuid *luGuid);

Parameters

dtype

the device type of the logical unit being imported. Only STMF_DISK is currently supported.

fname

the filename of the logical unit being imported

luGuid

pointer to a stmfGuid allocated by the caller. On success, this contains the guid of the imported logical unit. If luGuid is NULL, this parameter is ignored.

Description

The stmfImportLu() function imports a previously created logical unit. The fname argument must be set to the filename where the metadata for the logical unit is stored. See stmfCreateLu(3STMF).

Return Values

The following values are returned:

STMF_STATUS_SUCCESS

The API call was successful.

STMF_ERROR_INVALID_ARG

The dType or fname argument was invalid.

STMF_ERROR_META_FILE_NAME

The specified meta file could not be accessed.

STMF_ERROR_DATA_FILE_NAME

The 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 also

stmfCreateLu(3STMF), attributes(5)