STMFGETPROVIDERDATA(3STMF) SCSI Target Mode Framework Library Functions


NAME


stmfGetProviderData - retrieve the data for the specified provider

SYNOPSIS


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

int stmfGetProviderData(char *providerName, nvlist_t **nvl,
int providerType);


PARAMETERS


providerNane
The name of the provider for which data is being
retrieved.


nvl
A pointer to a pointer to an nvlist_t. On success, this
will contain the nvlist retrieved. Caller is responsible
for freeing the returned nvlist by calling
nvlist_free(3NVPAIR).


providerType
The value for this parameter must be either
STMF_LU_PROVIDER_TYPE or STMF_PORT_PROVIDER_TYPE.


DESCRIPTION


The stmfGetProviderData() function retrieves the data for the specified
provider.

RETURN VALUES


The following values are returned:

STMF_ERROR_NOMEM
The library was unable to allocate sufficient
memory to return the data.


STMF_STATUS_SUCCESS
The API call was successful.


ATTRIBUTES


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


+--------------------+----------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+----------------------+
|Interface Stability | Committed (Obsolete) |
+--------------------+----------------------+
|MT-Level | Safe |
+--------------------+----------------------+

SEE ALSO


libstmf(3LIB), nvlist_free(3NVPAIR), stmfGetProviderDataProt(3STMF),
attributes(5)

NOTES


The stmfGetProviderData() function is deprecated in favor of
stmfGetProviderDataProt(3STMF) and may be removed in a future revision of
libstmf(3LIB).


October 7, 2008 STMFGETPROVIDERDATA(3STMF)