Manual Pages for UNIX Operating System command usage for man it_portal_create

iSCSI Management Library Functions      it_portal_create(3ISCSIT)



NAME
     it_portal_create, it_portal_delete - create and delete iSCSI
     portals

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

     int it_portal_create(it_config_t *cfg, it_tpg_t *tpg,
          it_portal_t **portal, char *portal_ip_port);


     void it_portal_delete(it_config_t *cfg, it_tpg_t *tpg,
          it_portal_t *portal);


PARAMETERS
     cfg               a  pointer  to  the  iSCSI   configuration
                       structure


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


     portal            a pointer  to  the  it_portal_t  structure
                       representing the portal


     portal_ip_port    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 it_portal_create() function adds an  it_portal_t  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 it_portal_delete() 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 it_config_commit(3ISCSIT).





SunOS 5.11           Last change: 1 Oct 2008                    1






iSCSI Management Library Functions      it_portal_create(3ISCSIT)



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

ERRORS
     The it_portal_create() function will fail if:

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


     EINVAL    A parameter is invalid.


     ENOMEM    Resources could not be allocated.


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     it_ini_create(3ISCSIT),              it_tgt_create(3ISCSIT),
     it_tpg_create(3ISCSIT),                     libiscsit(3LIB),
     it_config_commit(3ISCSIT), libiscsit(3LIB), libnvpair(3LIB),
     libstmf(3LIB), attributes(5)


















SunOS 5.11           Last change: 1 Oct 2008                    2