NAME

stmfGetLuResource - get a logical unit resource for a currently registered logical unit

SYNOPSIS

cc [ flag... ] file... -lstmf [ library... ]
#include <libstmf.h>
int stmfGetLuResource(stmfGuid *luGuid, luResource *hdl);

PARAMETERS

luGuid

The guid of logical unit to retrieve.

hdl

The logical unit resource to create.

DESCRIPTION

The stmfGetLuResource() function retrieves a logical unit resource hdl for a given logical unit. The luGuid argument must represent a currently registered stmf logical unit. This retrieved resource is a set of device-specific properties for a logical unit device. This allocates an luResource hdl of device type matching luGuid. The stmfFreeLuResource(3STMF) function should be used when hdl is no longer needed.

RETURN VALUES

The following values are returned:

STMF_STATUS_SUCCESS

The API call was successful.

STMF_ERROR_NOT_FOUND

The guid does not exist.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Committed
MT-Level	Safe