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)


illumos May 8, 2009 STMFGETLURESOURCE(3STMF)