it_ini_create(3ISCSIT)iSCSI Management Library Functionsit_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 ini‐
tiator properties
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 struc‐
ture. If ini→next is not NULL, this function frees all members of the
list.
Configuration changes as a result of these functions are not instanti‐
ated 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 ALSOit_config_commit(3ISCSIT), it_portal_create(3ISCSIT), it_tgt_cre‐
ate(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)