diff options
Diffstat (limited to 'usr/src/man/man3iscsit')
| -rw-r--r-- | usr/src/man/man3iscsit/it_config_load.3iscsit | 182 | ||||
| -rw-r--r-- | usr/src/man/man3iscsit/it_ini_create.3iscsit | 188 | ||||
| -rw-r--r-- | usr/src/man/man3iscsit/it_portal_create.3iscsit | 139 | ||||
| -rw-r--r-- | usr/src/man/man3iscsit/it_tgt_create.3iscsit | 291 | ||||
| -rw-r--r-- | usr/src/man/man3iscsit/it_tpg_create.3iscsit | 175 |
5 files changed, 975 insertions, 0 deletions
diff --git a/usr/src/man/man3iscsit/it_config_load.3iscsit b/usr/src/man/man3iscsit/it_config_load.3iscsit new file mode 100644 index 0000000..046fed8 --- /dev/null +++ b/usr/src/man/man3iscsit/it_config_load.3iscsit @@ -0,0 +1,182 @@ +'\" te +.\" Copyright (c) 2008, Sun Microsystems Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH IT_CONFIG_LOAD 3ISCSIT "Oct 1, 2008" +.SH NAME +it_config_load, it_config_commit, it_config_setprop, it_config_free \- set and +retrieve configuration data for the iSCSI Target Port Provider +.SH SYNOPSIS +.LP +.nf +cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-liscsit\fR [ \fIlibrary\fR\&.\|.\|. ] +#include <libiscsit.h> + +\fBint\fR \fBit_config_load\fR(\fBit_config_t **\fR\fIcfg\fR); +.fi + +.LP +.nf +\fBint\fR \fBit_config_commit\fR(\fBit_config_t *\fR\fIcfg\fR); +.fi + +.LP +.nf +\fBint\fR \fBit_config_setprop\fR(\fBit_config_t *\fR\fIcfg\fR, \fBnvlist_t *\fR\fIproplist\fR, + \fBnvlist_t **\fR\fIerrlist\fR); +.fi + +.LP +.nf +\fBvoid\fR \fBit_config_free\fR(\fBit_config_t *\fR\fIcfg\fR); +.fi + +.SH PARAMETERS +.sp +.ne 2 +.na +\fB\fIcfg\fR\fR +.ad +.RS 12n +a pointer to the iSCSI configuration structure +.RE + +.sp +.ne 2 +.na +\fB\fIproplist\fR\fR +.ad +.RS 12n +a pointer to an \fBnvlist_t\fR containing the global properties to be set +.RE + +.sp +.ne 2 +.na +\fB\fIerrlist\fR\fR +.ad +.RS 12n +an optional pointer to an \fBnvlist_t\fR that will be used to store specific +errors (if any) when validating global properties +.RE + +.SH DESCRIPTION +.sp +.LP +The \fBit_config_load()\fR function allocates and creates an \fBit_config_t\fR +structure representing the current iSCSI configuration. This structure is +compiled using the "provider" data returned by +\fBstmfGetProviderData\fR(3STMF). If there is no provider data associated with +iscsit, the \fBit_config_t\fR structure is set to a default configuration. +.sp +.LP +The \fBit_config_commit()\fR function informs the iscsit service that the +configuration has changed and commits the new configuration to the persistent +store by calling \fBstmfSetProviderData\fR(3STMF). This function can be called +multiple times during a configuration sequence, if necessary. +.sp +.LP +The \fBit_config_setprop()\fR function validates the provided property list and +sets the global properties for iSCSI Target. If \fIerrlist\fR is not +\fINULL\fR, this function returns detailed errors for each property that +failed. The format for \fIerrorlist\fR is \fIkey\fR = \fIproperty\fR, +\fIvalue\fR = \fIerror\fR string. +.sp +.LP +The \fBit_config_free()\fR function frees resources associated with the +\fBit_config_t\fR structure. +.sp +.LP +Global nvlist properties are as follows: +.sp + +.sp +.TS +c c c +l l l . +\fBnvlist\fR Key Type Valid Values +_ +\fBalias\fR \fBstring\fR any string +\fBauth\fR \fBstring\fR \fBradius\fR, \fBchap\fR, or \fBnone\fR +\fBisns\fR \fBboolean\fR \fBB_TRUE\fR, \fBB_FALSE\fR +\fBisnsserver\fR \fBstring\fR array T{ +Array of portal specifications of the form IPaddress:port. Port is optional; if not specified, the default iSNS port number of 3205 will be used. IPv6 addresses should be enclosed in square brackets '[' ']'. If "none" is specified, all defined iSNS servers will be removed from the configuration. +T} +\fBradiusserver\fR \fBstring\fR T{ +IPaddress:port specification as described for 'isnsserver' +T} +\fBradiussecret\fR \fBstring\fR T{ +string of at least 12 characters but not more than 255 characters. secret will be base64 encoded when stored. +T} +.TE + +.SH RETURN VALUES +.sp +.LP +The \fBit_config_load()\fR, \fBit_config_commit()\fR, and +\fBit_config_setprop()\fR functions return 0 on success and an error value on +failure. +.SH ERRORS +.sp +.LP +The \fBit_config_load()\fR, \fBit_config_commit()\fR, and +\fBit_config_setprop()\fR functions will fail if: +.sp +.ne 2 +.na +\fB\fBEINVAL\fR\fR +.ad +.RS 10n +A parameter or property is invalid. +.RE + +.sp +.ne 2 +.na +\fB\fBENOMEM\fR\fR +.ad +.RS 10n +Resources could not be allocated. +.RE + +.sp +.LP +The \fBit_config_commit()\fR function will also fail if: +.sp +.ne 2 +.na +\fB\fBSTMF_ERROR_SERVICE_DATA_VERSION\fR\fR +.ad +.sp .6 +.RS 4n +The configuration was updated by another client. See +\fBstmfSetProviderData\fR(3STMF). +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +_ +Interface Stability Committed +_ +MT-Level MT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBit_ini_create\fR(3ISCSIT), \fBit_portal_create\fR(3ISCSIT), +\fBit_tgt_create\fR(3ISCSIT), \fBit_tpg_create\fR(3ISCSIT), +\fBlibiscsit\fR(3LIB), \fBlibnvpair\fR(3LIB), \fBlibstmf\fR(3LIB), +\fBstmfGetProviderData\fR(3STMF), \fBstmfSetProviderData\fR(3STMF), +\fBattributes\fR(5) diff --git a/usr/src/man/man3iscsit/it_ini_create.3iscsit b/usr/src/man/man3iscsit/it_ini_create.3iscsit new file mode 100644 index 0000000..56944f9 --- /dev/null +++ b/usr/src/man/man3iscsit/it_ini_create.3iscsit @@ -0,0 +1,188 @@ +'\" te +.\" Copyright (c) 2008, Sun Microsystems Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH IT_INI_CREATE 3ISCSIT "Oct 1, 2008" +.SH NAME +it_ini_create, it_ini_setprop, it_ini_delete, it_ini_free \- create, modify and +delete iSCSI Initiator Contexts +.SH SYNOPSIS +.LP +.nf +cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-liscsit\fR [ \fIlibrary\fR\&.\|.\|. ] +#include <libiscsit.h> + +\fBint\fR \fBit_ini_create\fR(\fBit_config_t *\fR\fIcfg\fR, \fBit_ini_t **\fR\fIini\fR, + \fBchar *\fR\fIini_node_name\fR); +.fi + +.LP +.nf +\fBint\fR \fBit_ini_setprop\fR(\fBit_ini_t *\fR\fIini\fR, \fBnvlist_t *\fR\fIproplist\fR, + \fBnvlist_t **\fR\fIerrlist\fR);); +.fi + +.LP +.nf +\fBvoid\fR \fBit_ini_delete\fR(\fBit_config_t *\fR\fIcfg\fR, \fBit_ini_t *\fR\fIini\fR); +.fi + +.LP +.nf +\fBvoid\fR \fBit_ini_free\fR(\fBit_ini_t *\fR\fIini\fR); +.fi + +.SH PARAMETERS +.sp +.ne 2 +.na +\fB\fIcfg\fR\fR +.ad +.RS 17n +a pointer t the iSCSI configuration structure +.RE + +.sp +.ne 2 +.na +\fB\fIini\fR\fR +.ad +.RS 17n +a pointer to the \fBit_ini_t\fR structure representing the initiator context +.RE + +.sp +.ne 2 +.na +\fB\fIini_node_name\fR\fR +.ad +.RS 17n +the iSCSI node name of the remote initiator +.RE + +.sp +.ne 2 +.na +\fB\fIproplist\fR\fR +.ad +.RS 17n +a pointer to an \fBnvlist_t\fR containing the initiator properties to be set +.RE + +.sp +.ne 2 +.na +\fB\fIerrlist\fR\fR +.ad +.RS 17n +an optional pointer to an \fBnvlist_t\fR that will be used to store specific +errors (if any) when validating initiator properties +.RE + +.SH DESCRIPTION +.sp +.LP +The \fBit_ini_create()\fR function adds an initiator context to the global +configuration. +.sp +.LP +The \fBit_ini_setprop()\fR function validates the provided property list and +sets the properties for the specified initiator. If \fIerrlist\fR is not +\fINULL\fR, this function returns detailed errors for each property that +failed. The format for \fIerrlist\fR is \fIkey\fR = \fIproperty\fR, +\fIvalue\fR = \fIerror\fR string. +.sp +.LP +The \fBit_ini_delete()\fR function removes the specified initiator context from +the global configuration. +.sp +.LP +The \fBit_ini_free()\fR function deallocates resources of an \fBit_ini_t\fR +structure. If \fIini\fR\(->\fInext\fR is not \fINULL\fR, this function frees +all members of the list. +.sp +.LP +Configuration changes as a result of these functions are not instantiated until +the modified configuration is committed by calling +\fBit_config_commit\fR(3ISCSIT). +.sp +.LP +Initiator nvlist properties are as follows: +.sp + +.sp +.TS +c c c +l l l . +\fBnvlist\fR Key Type Valid Values +_ +\fBchapuser\fR \fBstring\fR any string, or \fBnone\fR to remove +\fBchapsecret\fR \fBstring\fR T{ +string of at least 12 characters but not more than 255 characters. secret will be base64 encoded when stored. +T} +.TE + +.SH RETURN VALUES +.sp +.LP +The \fBit_ini_create()\fR, \fBit_ini_setprop()\fR, and \fBit_ini_delete()\fR +functions return 0 on success and an error value on failure. +.SH ERRORS +.sp +.LP +The \fBit_ini_create()\fR, \fBit_ini_setprop()\fR, and \fBit_ini_delete()\fR +functions will fail if: +.sp +.ne 2 +.na +\fB\fBEEXIST\fR\fR +.ad +.RS 10n +The requested initiator context is already configured. +.RE + +.sp +.ne 2 +.na +\fB\fBEINVAL\fR\fR +.ad +.RS 10n +A parameter or property is invalid. +.RE + +.sp +.ne 2 +.na +\fB\fBENOMEM\fR\fR +.ad +.RS 10n +Resources could not be allocated. +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +_ +Interface Stability Committed +_ +MT-Level MT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBit_config_commit\fR(3ISCSIT), \fBit_portal_create\fR(3ISCSIT), +\fBit_tgt_create\fR(3ISCSIT), \fBit_tpg_create\fR(3ISCSIT), +\fBlibiscsit\fR(3LIB), \fBlibnvpair\fR(3LIB), \fBlibstmf\fR(3LIB), +\fBstmfGetProviderData\fR(3STMF), \fBstmfSetProviderData\fR(3STMF), +\fBattributes\fR(5) diff --git a/usr/src/man/man3iscsit/it_portal_create.3iscsit b/usr/src/man/man3iscsit/it_portal_create.3iscsit new file mode 100644 index 0000000..ef12705 --- /dev/null +++ b/usr/src/man/man3iscsit/it_portal_create.3iscsit @@ -0,0 +1,139 @@ +'\" te +.\" Copyright (c) 2008, Sun Microsystems Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH IT_PORTAL_CREATE 3ISCSIT "Oct 1, 2008" +.SH NAME +it_portal_create, it_portal_delete \- create and delete iSCSI portals +.SH SYNOPSIS +.LP +.nf +cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-liscsit\fR [ \fIlibrary\fR\&.\|.\|. ] +#include <libiscsit.h> + +\fBint\fR \fBit_portal_create\fR(\fBit_config_t *\fR\fIcfg\fR, \fBit_tpg_t *\fR\fItpg\fR, + \fBit_portal_t **\fR\fIportal\fR, \fBchar *\fR\fIportal_ip_port\fR); +.fi + +.LP +.nf +\fBvoid\fR \fBit_portal_delete\fR(\fBit_config_t *\fR\fIcfg\fR, \fBit_tpg_t *\fR\fItpg\fR, + \fBit_portal_t *\fR\fIportal\fR); +.fi + +.SH PARAMETERS +.sp +.ne 2 +.na +\fB\fIcfg\fR\fR +.ad +.RS 18n +a pointer to the iSCSI configuration structure +.RE + +.sp +.ne 2 +.na +\fB\fItpg\fR\fR +.ad +.RS 18n +a pointer to the \fBit_tpg_t\fR structure representing the target portal group +.RE + +.sp +.ne 2 +.na +\fB\fIportal\fR\fR +.ad +.RS 18n +a pointer to the \fBit_portal_t\fR structure representing the portal +.RE + +.sp +.ne 2 +.na +\fB\fIportal_ip_port\fR\fR +.ad +.RS 18n +a string containing an appropriatedly formatted IP address:port. Both IPv4 and +IPv6 addresses are permitted. IPv6 addresses should be enclosed in square +brackets ('[', ']'). +.RE + +.SH DESCRIPTION +.sp +.LP +The \fBit_portal_create()\fR function adds an \fBit_portal_t\fR structure +representing a new portal to the specified target portal group. A portal may +belong to one and only one target portal group. +.sp +.LP +The \fBit_portal_delete()\fR function removes the specified portal from the +specified target portal group. +.sp +.LP +Configuration changes as a result of these functions are not instantiated until +the modified configuration is committed by calling +\fBit_config_commit\fR(3ISCSIT). +.SH RETURN VALUES +.sp +.LP +The \fBit_portal_create()\fR function returns 0 on success and an error value +on failure. +.SH ERRORS +.sp +.LP +The \fBit_portal_create()\fR function will fail if: +.sp +.ne 2 +.na +\fB\fBEEXIST\fR\fR +.ad +.RS 10n +The portal was already configured for another portal group. +.RE + +.sp +.ne 2 +.na +\fB\fBEINVAL\fR\fR +.ad +.RS 10n +A parameter is invalid. +.RE + +.sp +.ne 2 +.na +\fB\fBENOMEM\fR\fR +.ad +.RS 10n +Resources could not be allocated. +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +_ +Interface Stability Committed +_ +MT-Level MT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBit_ini_create\fR(3ISCSIT), \fBit_tgt_create\fR(3ISCSIT), +\fBit_tpg_create\fR(3ISCSIT), \fBlibiscsit\fR(3LIB), +\fBit_config_commit\fR(3ISCSIT), \fBlibiscsit\fR(3LIB), \fBlibnvpair\fR(3LIB), +\fBlibstmf\fR(3LIB), \fBattributes\fR(5) diff --git a/usr/src/man/man3iscsit/it_tgt_create.3iscsit b/usr/src/man/man3iscsit/it_tgt_create.3iscsit new file mode 100644 index 0000000..30cc41f --- /dev/null +++ b/usr/src/man/man3iscsit/it_tgt_create.3iscsit @@ -0,0 +1,291 @@ +'\" te +.\" Copyright (c) 2008, Sun Microsystems Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH IT_TGT_CREATE 3ISCSIT "Oct 1, 2008" +.SH NAME +it_tgt_create, it_tgt_setprop, it_tgt_delete, it_tpgt_create, it_tpgt_delete, +it_tgt_free, it_tpgt_free \- create, modify and delete iSCSI Targets +.SH SYNOPSIS +.LP +.nf +cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-liscsit\fR [ \fIlibrary\fR\&.\|.\|. ] +#include <libiscsit.h> + +\fBint\fR \fBit_tgt_create\fR(\fBit_config_t **\fR\fIcfg\fR, \fBit_tgt_t **\fR\fItgt\fR, + \fBchar *\fR\fItgt_name\fR); +.fi + +.LP +.nf +\fBint\fR \fBit_tgt_setprop\fR(\fBit_config_t *\fR\fIcfg\fR \fBit_tgt_t *\fR\fItgt\fR, + \fBnvlist_t *\fR\fIproplist\fR, \fBnvlist_t **\fR\fIerrlist\fR); +.fi + +.LP +.nf +\fBint\fR \fBit_tgt_delete\fR(\fBit_config_t *\fR\fIcfg\fR, \fBit_tgt_t *\fR\fItgt\fR, + \fBboolean_t\fR \fIforce\fR); +.fi + +.LP +.nf +\fBint\fR \fBit_tpgt_create\fR(\fBit_config_t *\fR\fIcfg\fR, \fBit_tgt_t *\fR\fItgt\fR, + \fBit_tpgt_t **\fR\fItpgt\fR, \fBchar *\fR\fItpg_name\fR, \fBuint16_t\fR \fItpgt_tag\fR); +.fi + +.LP +.nf +\fBvoid\fR \fBit_tpgt_delete\fR(\fBit_config_t *\fR\fIcfg\fR, \fBit_tgt_t *\fR\fItgt\fR, + \fBit_tpgt_t *\fR\fItpgt\fR); +.fi + +.LP +.nf +\fBvoid\fR \fBit_tgt_free\fR(\fBit_tgt_t *\fR\fItgt\fR); +.fi + +.LP +.nf +\fBvoid\fR \fBit_tpgt_free\fR(\fBit_tpgt_t *\fR\fItpgt\fR); +.fi + +.SH PARAMETERS +.sp +.ne 2 +.na +\fB\fIcfg\fR\fR +.ad +.RS 13n +a pointer to the iSCSI configuration structure +.RE + +.sp +.ne 2 +.na +\fB\fItgt\fR\fR +.ad +.RS 13n +a pointer to an iSCSI target structure +.RE + +.sp +.ne 2 +.na +\fB\fItgt_name\fR\fR +.ad +.RS 13n +the target node name for the target to be created. The name must be in either +IQN or EUI format. If this value is \fINULL\fR, a node name will be generated +automatically in IQN format. +.RE + +.sp +.ne 2 +.na +\fB\fIproplist\fR\fR +.ad +.RS 13n +a pointer to an \fBnvlist_t\fR containing the target properties to be set +.RE + +.sp +.ne 2 +.na +\fB\fIerrlist\fR\fR +.ad +.RS 13n +an optional pointer to an \fBnvlist_t\fR that will be used to store specific +errors (if any) when validating target properties +.RE + +.sp +.ne 2 +.na +\fB\fIforce\fR\fR +.ad +.RS 13n +a boolean value indicating if the target should be set to offline before +removing it from the configuration. If not specified, the operation will fail +if the target is determined to be online +.RE + +.sp +.ne 2 +.na +\fB\fItpgt\fR\fR +.ad +.RS 13n +a pointer to a target portal group tag structure +.RE + +.sp +.ne 2 +.na +\fB\fItpgt_name\fR\fR +.ad +.RS 13n +the name of the target portal group to be associated with this target portal +group tag +.RE + +.sp +.ne 2 +.na +\fB\fItpgt_tag\fR\fR +.ad +.RS 13n +a 16-bit numerical identifier for this target portal group tag. Valid values +are 2 through 65535. If tpgt_tag is '0', \fBit_tpgt_create()\fR will assign an +appropriate tag number. If \fItpgt_tag\fR is != 0, and the requested tag number +is unavailable, another value will be chosen. +.RE + +.SH DESCRIPTION +.sp +.LP +The \fBit_tgt_create()\fR function allocates and creates an \fBit_tgt_t\fR +structure representing a new iSCSI target node. If \fItgt_name\fR is +\fINULL\fR, then a unique target node name will be generated automatically. +Otherwise, the value of \fItgt_name\fR will be used as the target node name. +The new \fBit_tgt_t\fR structure is added to the target list +(\fIcfg_tgt_list\fR) in the configuration structure. +.sp +.LP +The \fBit_tgt_setprop()\fR function validates the provided property list and +sets the properties for the specified target. If \fIerrlist\fR is not +\fINULL\fR, this function returns detailed errors for each property that +failed. The format for \fIerrlist\fR is \fIkey\fR = \fIproperty\fR, +\fIvalue\fR = \fIerror\fR string. +.sp +.LP +The \fBit_tgt_delete()\fR function removes the target represented by \fItgt\fR +from the configuration. The \fItgt\fR argument is an existing \fBit_tgt_t\fR +structure within the configuration \fIcfg\fR. +.sp +.LP +The \fBit_tpgt_create()\fR function allocates and creates an \fBit_tpgt_t\fR +structure representing a new iSCSI target portal group tag. The new +\fBit_tpgt_t\fR structure is added to the target \fItpgt\fR list +(\fItgt_tpgt_list\fR) in the \fBit_tgt_t\fR structure. +.sp +.LP +The \fBit_tpgt_delete()\fR function removes the target portal group tag +represented by \fItpgt\fR, from the configuration. The \fItpgt\fR argument is +an existing \fBis_tpgt_t\fR structure within the target \fItgt\fR. +.sp +.LP +The \fBit_tgt_free()\fR function frees an \fBit_tgt_t\fR structure. If +\fItgt\fR\(->\fInext\fR is not \fINULL\fR, this function frees all structures +in the list. +.sp +.LP +The \fBit_tpgt_free()\fR function deallocates resources of an \fBit_tpgt_t\fR +structure. If \fItpgt\fR->\fInext\fR is not \fINULL\fR, this function frees +all members of the list. +.sp +.LP +Configuration changes as a result of these functions are not instantiated until +the modified configuration is committed by calling +\fBit_config_commit\fR(3ISCSIT). +.sp +.LP +Target nvlist properties are as follows: +.sp + +.sp +.TS +c c c +l l l . +\fBnvlist\fR Key Type Valid Values +_ +\fBtargetchapuser\fR \fBstring\fR any string, or \fBnone\fR to remove +\fBtargetchapsecret\fR \fBstring\fR T{ +string of at least 12 characters but not more than 255 characters. secret will be base64 encoded when stored. +T} +\fBalias\fR \fBstring\fR any string or \fBnone\fR to remove +\fBauth\fR \fBstring\fR \fBradius\fR, \fBchap\fR, or \fBnone\fR +.TE + +.SH RETURN VALUES +.sp +.LP +The \fBit_tgt_create()\fR, \fBit_tgt_setprop()\fR, \fBit_tgt_delete()\fR, +\fBit_tpgt_create()\fR, and \fBit_tpgt_delete()\fR functions return 0 on +success and an error value on failure. +.SH ERRORS +.sp +.LP +The \fBit_tgt_create()\fR, \fBit_tgt_setprop()\fR, \fBit_tgt_delete()\fR, +\fBit_tpgt_create()\fR, and \fBit_tpgt_delete()\fR functions will fail if: +.sp +.ne 2 +.na +\fB\fBE2BIG\fR\fR +.ad +.RS 10n +All tag numbers are already in use. +.RE + +.sp +.ne 2 +.na +\fB\fBEBUSY\fR\fR +.ad +.RS 10n +The target is online. +.RE + +.sp +.ne 2 +.na +\fB\fBEEXIST\fR\fR +.ad +.RS 10n +The requested target node name is already configured. +.RE + +.sp +.ne 2 +.na +\fB\fBEINVAL\fR\fR +.ad +.RS 10n +A parameter or property is invalid. +.RE + +.sp +.ne 2 +.na +\fB\fBENOMEM\fR\fR +.ad +.RS 10n +Resources could not be allocated. +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +_ +Interface Stability Committed +_ +MT-Level MT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBit_config_commit\fR(3ISCSIT), \fBit_ini_create\fR(3ISCSIT), +\fBit_portal_create\fR(3ISCSIT), \fBit_tpg_create\fR(3ISCSIT), +\fBlibiscsit\fR(3LIB), \fBlibnvpair\fR(3LIB), \fBlibstmf\fR(3LIB), +\fBattributes\fR(5) diff --git a/usr/src/man/man3iscsit/it_tpg_create.3iscsit b/usr/src/man/man3iscsit/it_tpg_create.3iscsit new file mode 100644 index 0000000..2ba3628 --- /dev/null +++ b/usr/src/man/man3iscsit/it_tpg_create.3iscsit @@ -0,0 +1,175 @@ +'\" te +.\" Copyright (c) 2008, Sun Microsystems Inc. All Rights Reserved. +.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. +.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. +.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] +.TH IT_TPG_CREATE 3ISCSIT "Oct 1, 2008" +.SH NAME +it_tpg_create, it_tpg_delete, it_tpg_free \- create and delete iSCSI +target portal groups +.SH SYNOPSIS +.LP +.nf +cc [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-liscsit\fR [ \fIlibrary\fR\&.\|.\|. ] +#include <libiscsit.h> + +\fBint\fR \fBit_tpg_create\fR(\fBit_config_t *\fR\fIcfg\fR, \fBit_tpg_t **\fR\fItpg\fR, + \fBchar *\fR\fItpg_name\fR, \fBchar *\fR\fIportal_ip_port\fR); +.fi + +.LP +.nf +\fBint\fR \fBit_tpg_delete\fR(\fBit_config_t *\fR\fIcfg\fR, \fBit_tpg_t *\fR\fItpg\fR, + \fBboolean_t\fR \fIforce\fR);); +.fi + +.LP +.nf +\fBvoid\fR \fBit_tpg_free\fR(\fBit_tpg_t *\fR\fItpg\fR); +.fi + +.SH PARAMETERS +.sp +.ne 2 +.na +\fB\fIcfg\fR\fR +.ad +.RS 18n +a pointer t the iSCSI configuration structure +.RE + +.sp +.ne 2 +.na +\fB\fItpg\fR\fR +.ad +.RS 18n +a pointer to the \fBit_tpg_t\fR structure representing the target portal group +.RE + +.sp +.ne 2 +.na +\fB\fItpg_name\fR\fR +.ad +.RS 18n +an identifier for the target portal group +.RE + +.sp +.ne 2 +.na +\fB\fIportal_ip_port\fR\fR +.ad +.RS 18n +a string containing an appropriately formatted IP \fBaddress\fR:\fBport\fR. +Both IPv4 and IPv6 addresses are permitted. This value becomes the first portal +in the target portal group. Applications can add additional values using +\fBit_portal_create\fR(3ISCSIT) before committing the target portal group. IPv6 +addresses should be enclosed in square brackets ('[', ']'). +.RE + +.sp +.ne 2 +.na +\fB\fIforce\fR\fR +.ad +.RS 18n +boolean value indicating if the target portal group should be removed even if +it is associated with one or more targets. If not \fBB_TRUE\fR, the operation +will fail if the target product group is associated with a target. +.RE + +.SH DESCRIPTION +.sp +.LP +The \fBit_tpg_create()\fR function allocates and creates an \fBit_tpg_t\fR +structure representing a new iSCSI target portal group. The new \fBit_tpg_t\fR +structure is added to the global \fItpg\fR list (\fIcfg_tgt_list\fR) in the +\fBit_config_t\fR structure. +.sp +.LP +The \fBit_tpg_delete()\fR function deletes the target portal group represented +by \fItpg\fR, where \fItpg\fR is an existing \fBit_tpg_t\fR structure within +the global configuration \fIcfg\fR. +.sp +.LP +The \fBit_tpg_free()\fR function deallocates resources associated with an +\fBit_tpg_t\fR structure. If \fItpg\fR->\fInext\fR is not \fINULL\fR, this +function frees all members of the list. +.sp +.LP +Configuration changes as a result of these functions are not instantiated until +the modified configuration is committed by calling +\fBit_config_commit\fR(3ISCSIT). +.SH RETURN VALUES +.sp +.LP +The \fBit_tpg_create()\fR and \fBit_tpg_delete()\fR functions return 0 on +success and an error value on failure. +.SH ERRORS +.sp +.LP +The \fBit_tpg_create()\fR and \fBit_tpg_delete()\fR functions will fail if: +.sp +.ne 2 +.na +\fB\fBEBUSY\fR\fR +.ad +.RS 10n +The portal group is associated with one or more targets. +.RE + +.sp +.ne 2 +.na +\fB\fBEEXIST\fR\fR +.ad +.RS 10n +The portal was already configured for another portal group associated with this +target. +.RE + +.sp +.ne 2 +.na +\fB\fBEINVAL\fR\fR +.ad +.RS 10n +A parameter is invalid. +.RE + +.sp +.ne 2 +.na +\fB\fBENOMEM\fR\fR +.ad +.RS 10n +Resources could not be allocated. +.RE + +.SH ATTRIBUTES +.sp +.LP +See \fBattributes\fR(5) for descriptions of the following attributes: +.sp + +.sp +.TS +box; +c | c +l | l . +ATTRIBUTE TYPE ATTRIBUTE VALUE +_ +Interface Stability Committed +_ +MT-Level MT-Safe +.TE + +.SH SEE ALSO +.sp +.LP +\fBit_config_commit\fR(3ISCSIT), \fBit_ini_create\fR(3ISCSIT), +\fBit_portal_create\fR(3ISCSIT), \fBit_tgt_create\fR(3ISCSIT), +\fBlibiscsit\fR(3LIB), \fBlibnvpair\fR(3LIB), \fBlibstmf\fR(3LIB), +\fBattributes\fR(5) |