iSCSI Management Library Functions         ittpgcreate(3ISCSIT)



NAME
     ittpgcreate,  ittpgdelete,  ittpgfree  -  create   and
     delete iSCSI target portal groups

SYNOPSIS
     cc [ flag... ] file... -liscsit [ library... ]
     #include 

     int ittpgcreate(itconfigt *cfg, ittpgt **tpg,
          char *tpgname, char *portalipport);


     int ittpgdelete(itconfigt *cfg, ittpgt *tpg,
          booleant force););


     void ittpgfree(ittpgt *tpg);


PARAMETERS
     cfg               a pointer t the iSCSI configuration struc-
                       ture


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


     tpgname          an identifier for the target portal group


     portalipport    a string containing an appropriately  for-
                       matted IP address:port. Both IPv4 and IPv6
                       addresses  are   permitted.   This   value
                       becomes  the  first  portal  in the target
                       portal group. Applications can  add  addi-
                       tional             values            using
                       itportalcreate(3ISCSIT)  before  commit-
                       ting   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 BTRUE, the operation will fail if the
                       target product group is associated with  a
                       target.






SunOS 5.11           Last change: 1 Oct 2008                    1






iSCSI Management Library Functions         ittpgcreate(3ISCSIT)



DESCRIPTION
     The  ittpgcreate()  function  allocates  and  creates   an
     ittpgt  structure  representing  a new iSCSI target portal
     group. The new ittpgt structure is added to the global tpg
     list (cfgtgtlist) in the itconfigt structure.


     The ittpgdelete() function deletes the target portal group
     represented by tpg, where tpg is an existing ittpgt struc-
     ture within the global configuration cfg.


     The ittpgfree() function deallocates resources  associated
     with  an  ittpgt structure. If tpg->next is not NUL, 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 itconfigcommit(3ISCSIT).

RETURN VALUES
     The ittpgcreate() and ittpgdelete() functions  return  0
     on success and an error value on failure.

ERORS
     The ittpgcreate() and ittpgdelete() functions will  fail
     if:

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


     EXIST    The portal was already configured for another por-
               tal group associated with this target.


     EINVAL    A parameter is invalid.


     ENOMEM    Resources could not be allocated.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:









SunOS 5.11           Last change: 1 Oct 2008                    2






iSCSI Management Library Functions         ittpgcreate(3ISCSIT)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     itconfigcommit(3ISCSIT),           itinicreate(3ISCSIT),
     itportalcreate(3ISCSIT),           ittgtcreate(3ISCSIT),
     libiscsit(3LIB),  libnvpair(3LIB),   libstmf(3LIB),   attri-
     butes(5)









































SunOS 5.11           Last change: 1 Oct 2008                    3