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

NAME

       it_tpg_create, it_tpg_delete, it_tpg_free - create and	      delete iSCSI target portal groups

SYNOPSIS

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

       int it_tpg_create(it_config_t *cfg, it_tpg_t **tpg,
	    char *tpg_name, char *portal_ip_port);

       int it_tpg_delete(it_config_t *cfg, it_tpg_t *tpg,
	    boolean_t force););

       void it_tpg_free(it_tpg_t *tpg);

PARAMETERS

       cfg		 a pointer t the iSCSI configuration structure

       tpg		 a pointer to the it_tpg_t structure representing the target portal group

       tpg_name 	 an identifier for the target portal group

       portal_ip_port	 a  string  containing	an appropriately formatted IP address:port. Both IPv4 and IPv6 addresses are permitted. This value
			 becomes the first portal in the target portal group. Applications can add additional values using  it_portal_create(3ISC-
			 SIT) before committing the target portal group. IPv6 addresses should be enclosed in square brackets ('[', ']').

       force		 boolean  value indicating if the target portal group should be removed even if it is associated with one or more targets.
			 If not B_TRUE, the operation will fail if the target product group is associated with a target.

DESCRIPTION

       The it_tpg_create() function allocates and creates an it_tpg_t structure representing a new iSCSI target portal	group.	The  new  it_tpg_t
       structure is added to the global tpg list (cfg_tgt_list) in the it_config_t structure.

       The  it_tpg_delete()  function  deletes	the target portal group represented by tpg, where tpg is an existing it_tpg_t structure within the
       global configuration cfg.

       The it_tpg_free() function deallocates resources associated with an it_tpg_t structure. If tpg->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).

RETURN VALUES

       The it_tpg_create() and it_tpg_delete() functions return 0 on success and an error value on failure.

ERRORS

       The it_tpg_create() and it_tpg_delete() functions will fail if:

       EBUSY	 The portal group is associated with one or more targets.

       EEXIST	 The portal was already configured for another portal group associated with this target.

       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_config_commit(3ISCSIT), it_ini_create(3ISCSIT),  it_portal_create(3ISCSIT),  it_tgt_create(3ISCSIT),	libiscsit(3LIB),  libnvpair(3LIB),
       libstmf(3LIB), attributes(5)

SunOS 5.11							    1 Oct 2008						    it_tpg_create(3ISCSIT)