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(7) 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(7)

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)