STMFSETPROVIDERDATAPROT(3STMF) SCSI Target Mode Framework Library Functions


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


October 7, 2008 STMFSETPROVIDERDATAPROT(3STMF)