Linux and UNIX Man Pages

Test Your Knowledge in Computers #919
Difficulty: Medium
The Unix epoch is the time 00:00:00 EST on 1 January 1970.
True or False?
Linux & Unix Commands - Search Man Pages

it_ini_free(3iscsit) [opensolaris man page]

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)

Check Out this Related Man Page

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

NAME
it_portal_create, it_portal_delete - create and delete iSCSI portals SYNOPSIS
cc [ flag... ] file... -liscsit [ library... ] #include <libiscsit.h> int it_portal_create(it_config_t *cfg, it_tpg_t *tpg, it_portal_t **portal, char *portal_ip_port); void it_portal_delete(it_config_t *cfg, it_tpg_t *tpg, it_portal_t *portal); PARAMETERS
cfg a pointer to the iSCSI configuration structure tpg a pointer to the it_tpg_t structure representing the target portal group portal a pointer to the it_portal_t structure representing the portal portal_ip_port a string containing an appropriatedly formatted IP address:port. Both IPv4 and IPv6 addresses are permitted. IPv6 addresses should be enclosed in square brackets ('[', ']'). DESCRIPTION
The it_portal_create() function adds an it_portal_t structure representing a new portal to the specified target portal group. A portal may belong to one and only one target portal group. The it_portal_delete() function removes the specified portal from the specified target portal group. Configuration changes as a result of these functions are not instantiated until the modified configuration is committed by calling it_con- fig_commit(3ISCSIT). RETURN VALUES
The it_portal_create() function returns 0 on success and an error value on failure. ERRORS
The it_portal_create() function will fail if: EEXIST The portal was already configured for another portal group. EINVAL A parameter 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_ini_create(3ISCSIT), it_tgt_create(3ISCSIT), it_tpg_create(3ISCSIT), libiscsit(3LIB), it_config_commit(3ISCSIT), libiscsit(3LIB), libn- vpair(3LIB), libstmf(3LIB), attributes(5) SunOS 5.11 1 Oct 2008 it_portal_create(3ISCSIT)

Featured Tech Videos