stmfsetproviderdataprot(3stmf) [opensolaris man page]

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)

it_ini_create(3ISCSIT)					iSCSI Management Library Functions				    it_ini_create(3ISCSIT)

NAME

       it_ini_create, it_ini_setprop, it_ini_delete, it_ini_free - create, modify and delete iSCSI Initiator Contexts

SYNOPSIS

       cc [ flag... ] file... -liscsit [ library... ]
       #include <libiscsit.h>

       int it_ini_create(it_config_t *cfg, it_ini_t **ini,
	    char *ini_node_name);

       int it_ini_setprop(it_ini_t *ini, nvlist_t *proplist,
	    nvlist_t **errlist););

       void it_ini_delete(it_config_t *cfg, it_ini_t *ini);

       void it_ini_free(it_ini_t *ini);

PARAMETERS

       cfg		a pointer t the iSCSI configuration structure

       ini		a pointer to the it_ini_t structure representing the initiator context

       ini_node_name	the iSCSI node name of the remote initiator

       proplist 	a pointer to an nvlist_t containing the initiator properties to be set

       errlist		an  optional  pointer to an nvlist_t that will be used to store specific errors (if any) when validating initiator proper-
			ties

DESCRIPTION

       The it_ini_create() function adds an initiator context to the global configuration.

       The it_ini_setprop() function validates the provided property list and sets the properties for the specified initiator.	If errlist is  not
       NULL, this function returns detailed errors for each property that failed.  The format for errlist is key = property, value = error string.

       The it_ini_delete() function removes the specified initiator context from the global configuration.

       The it_ini_free() function deallocates resources of an it_ini_t structure. If ini->next is not NULL, this function frees all members of the
       list.

       Configuration changes as a result of these functions are not instantiated until the modified configuration is committed by calling  it_con-
       fig_commit(3ISCSIT).

       Initiator nvlist properties are as follows:

       nvlist Key     Type		    Valid Values
       ---------------------------------------------------------------
       chapuser     string	any string, or none to remove
       chapsecret   string	string of at least 12 characters but
				not  more   than   255	 characters.
				secret	will  be base64 encoded when
				stored.

RETURN VALUES

       The it_ini_create(), it_ini_setprop(), and it_ini_delete() functions return 0 on success and an error value on failure.

ERRORS

       The it_ini_create(), it_ini_setprop(), and it_ini_delete() functions will fail if:

       EEXIST	 The requested initiator context is already configured.

       EINVAL	 A parameter or property is invalid.

       ENOMEM	 Resources could not be allocated.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       it_config_commit(3ISCSIT), it_portal_create(3ISCSIT),  it_tgt_create(3ISCSIT),  it_tpg_create(3ISCSIT),	libiscsit(3LIB),  libnvpair(3LIB),
       libstmf(3LIB), stmfGetProviderData(3STMF), stmfSetProviderData(3STMF), attributes(5)

SunOS 5.11							    1 Oct 2008						    it_ini_create(3ISCSIT)