stmfGetProviderData(3STMF)

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