opensolaris man page for stmfgetproviderdata

stmfGetProviderData(3STMF)			   SCSI Target Mode Framework Library Functions 			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 free-
		       ing 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 lib-
       stmf(3LIB).

SunOS 5.11							    7 Oct 2008						stmfGetProviderData(3STMF)