opensolaris man page for stmfsetproviderdataprot

stmfSetProviderDataProt(3STMF)			   SCSI Target Mode Framework Library Functions 		    stmfSetProviderDataProt(3STMF)

NAME
       stmfSetProviderDataProt - retrieve data for the specified provider

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

       int stmfSetProviderDataProt(char *providerName, nvlist_t **nvl,
	    int providerType, uint64_t *token);

PARAMETERS
       providerName    The name of the provider for which data is being set.

       nvl	       A pointer to a pointer to an nvlist_t containing the nvlist to be set.

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

       token	       A  pointer to a uint64_t that contains the value returned from a successful call to stmfGetProviderDataProt(3STMF). If this
		       argument is NULL, the token is ignored. Otherwise, the token will be verified against the current data. If the token repre-
		       sents stale data, the call fails.

		       On success, token will contain the new token for the data being set and can be used in subsequent calls to stmfSetProvider-
		       Data(3STMF). On failure the contents are undefined.

DESCRIPTION
       The stmfSetProviderDataProt() function sets the data for the specified provider.

RETURN VALUES
       The following values are returned:

       STMF_ERROR_PROV_DATA_STALE    The token value represents stale 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 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

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

SunOS 5.11							    7 Oct 2008					    stmfSetProviderDataProt(3STMF)