STMFSETPROVIDERDATAPROT(3STMF)STMFSETPROVIDERDATAPROT(3STMF)NAMEstmfSetProviderDataProt - 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 stmfGetProviderDat‐
aProt(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 ALSOlibstmf(3LIB), nvlist_free(3NVPAIR), stmfGetProviderDataProt(3STMF),
stmfSetProviderData(3STMF), attributes(5)
Oct 7, 2008 STMFSETPROVIDERDATAPROT(3STMF)