STMFGETLURESOURCE(3STMF) SCSI Target Mode Framework Library Functions

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 |
+--------------------+-----------------+

SEE ALSO

libstmf(3LIB), stmfFreeLuResource(3STMF), attributes(7)

May 8, 2009 STMFGETLURESOURCE(3STMF)