iSCSI Management Library Functions      itportalcreate(3ISCSIT)



NAME
     itportalcreate, itportaldelete - create and delete iSCSI
     portals

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

     int itportalcreate(itconfigt *cfg, ittpgt *tpg,
          itportalt **portal, char *portalipport);


     void itportaldelete(itconfigt *cfg, ittpgt *tpg,
          itportalt *portal);


PARAMETERS
     cfg               a  pointer  to  the  iSCSI   configuration
                       structure


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


     portal            a pointer  to  the  itportalt  structure
                       representing the portal


     portalipport    a string containing an appropriatedly for-
                       matted IP address:port. Both IPv4 and IPv6
                       addresses are  permitted.  IPv6  addresses
                       should  be  enclosed  in  square  brackets
                       ('[', ']').


DESCRIPTION
     The itportalcreate() function adds an  itportalt  struc-
     ture  representing a new portal to the specified target por-
     tal group. A portal may belong to one and  only  one  target
     portal group.


     The itportaldelete() 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 itconfigcommit(3ISCSIT).





SunOS 5.11           Last change: 1 Oct 2008                    1






iSCSI Management Library Functions      itportalcreate(3ISCSIT)



RETURN VALUES
     The itportalcreate() function returns 0 on success and  an
     error value on failure.

ERORS
     The itportalcreate() function will fail if:

     EXIST    The portal was already configured for another por-
               tal group.


     EINVAL    A parameter is invalid.


     ENOMEM    Resources could not be allocated.


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



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


SEE ALSO
     itinicreate(3ISCSIT),              ittgtcreate(3ISCSIT),
     ittpgcreate(3ISCSIT),                     libiscsit(3LIB),
     itconfigcommit(3ISCSIT), libiscsit(3LIB), libnvpair(3LIB),
     libstmf(3LIB), attributes(5)


















SunOS 5.11           Last change: 1 Oct 2008                    2