iSCSI Management Library Functions         itinicreate(3ISCSIT)



NAME
     itinicreate, itinisetprop, itinidelete, itinifree  -
     create, modify and delete iSCSI Initiator Contexts

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

     int itinicreate(itconfigt *cfg, itinit **ini,
          char *ininodename);


     int itinisetprop(itinit *ini, nvlistt *proplist,
          nvlistt **errlist););


     void itinidelete(itconfigt *cfg, itinit *ini);


     void itinifree(itinit *ini);


PARAMETERS
     cfg              a pointer t the iSCSI configuration  struc-
                      ture


     ini              a  pointer  to   the   itinit   structure
                      representing the initiator context


     ininodename    the iSCSI node name of the remote initiator


     proplist         a pointer to  an  nvlistt  containing  the
                      initiator properties to be set


     errlist          an optional pointer  to  an  nvlistt  that
                      will  be  used to store specific errors (if
                      any) when validating initiator properties


DESCRIPTION
     The itinicreate() function adds an  initiator  context  to
     the global configuration.


     The itinisetprop() function validates  the  provided  pro-
     perty list and sets the properties for the specified initia-
     tor.  If errlist is not NUL, this function returns detailed
     errors  for  each  property  that  failed.   The  format for



SunOS 5.11           Last change: 1 Oct 2008                    1






iSCSI Management Library Functions         itinicreate(3ISCSIT)



     errlist is key = property, value = error string.


     The itinidelete() function removes the specified initiator
     context from the global configuration.


     The  itinifree()  function  deallocates  resources  of  an
     itinit  structure. If ini->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).


     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 itinicreate(), itinisetprop(),  and  itinidelete()
     functions return 0 on success and an error value on failure.

ERORS
     The itinicreate(), itinisetprop(),  and  itinidelete()
     functions will fail if:

     EXIST    The requested initiator context is already config-
               ured.


     EINVAL    A parameter or property 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         itinicreate(3ISCSIT)



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


SEE ALSO
     itconfigcommit(3ISCSIT),        itportalcreate(3ISCSIT),
     ittgtcreate(3ISCSIT),              ittpgcreate(3ISCSIT),
     libiscsit(3LIB),       libnvpair(3LIB),       libstmf(3LIB),
     stmfGetProviderData(3STMF),      stmfSetProviderData(3STMF),
     attributes(5)








































SunOS 5.11           Last change: 1 Oct 2008                    3