IMA_SetIsnsDiscovery(3ima) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

IMA_SetIsnsDiscovery(3ima)

iSCSI Management API                                IMA_SetIsnsDiscovery(3IMA)



NAME
       IMA_SetIsnsDiscovery  - Enables or disables iSNS target discovery for a
       PHBA, LHBA, or network portal

SYNOPSIS
       cc [ flag... ] file... -lima [ library... ]
       #include <ima.h>

       IMA_STATUS IMA_SetIsnsDiscovery(
            /* in */    IMA_OID oid,
            /* in */    IMA_BOOL enableIsnsDiscovery,
            /* in */    IMA_ISNS_DISCOVERY_METHOD discoveryMethod,
            /* in */    const IMA_HOST_ID *iSnsHost
       );

PARAMETERS
       oid

           The object ID of the physical host bus adapter (PHBA), logical host
           bus  adapter  (LHBA), or network portal whose iSNS target discovery
           properties are being set.


       enableIsnsDiscovery


               o      Set to the value, IMA_TRUE if the PHBA, LHBA, or network
                      portal will discover targets using the iSNS protocol.


               o      Set to the value, IMA_FALSE if the PHBA,LHBA, or network
                      portal will not discover targets using the  iSNS  proto‐
                      col.



       discoveryMethod


               o      If  the  enableIsnsDiscovery  argument has the value the
                      value,  IMA_TRUE,  then  this  parameter  specifies  the
                      method that is used to discover the iSNS server.


               o      If   this  parameter  has  the  value,  IMA_ISNS_DISCOV‐
                      ERY_METHOD_STATIC, then the iSNS server will be  discov‐
                      ered  statically.  In  this  case the iSnsHost parameter
                      contains the name or address of the iSNS server, and the
                      iSNS server at that location is used.


               o      If   this  parameter  has  the  value,  IMA_ISNS_DISCOV‐
                      ERY_METHOD_DHCP, then the iSNS server will be discovered
                      using the DHCP protocol.


               o      If   this  parameter  has  the  value,  IMA_ISNS_DISCOV‐
                      ERY_METHOD_SLP, then the iSNS server will be  discovered
                      using the SLP protocol.



       iSnsHost


               o      If  the  enableIsnsDiscovery  argument  has  the  value,
                      IMA_TRUE,  and  the  discoveryMethod  argument  has  the
                      value,  IMA_ISNS_DISCOVERY_METHOD_STATIC, then this is a
                      pointer to the host name of the iSNS server to be used.


               o      If  the  enableIsnsDiscovery  argument  has  the  value,
                      IMA_FALSE,  or  the enableIsnsDiscovery argument has the
                      value, IMA_TRUE, but the discoveryMethod  argument  does
                      not  have  the  value, IMA_ISNS_DISCOVERY_METHOD_STATIC,
                      then this parameter is NULL.




DESCRIPTION
       The IMA_SetIsnsDiscovery() API enables or disables the iSNS target dis‐
       covery property for a PHBA, LHBA, or network portal.

RETURN VALUES
       IMA_STATUS_REBOOT_NECESSARY

           Returned  if  a  reboot  is  necessary  before  this call will take
           effect.


       IMA_ERROR_NOT_SUPPORTED

           Returned if the enabling or disabling of the iSNS target  discovery
           property  is  not supported by the specified PHBA, LHBA, or network
           portal.


       IMA_ERROR_INVALID_PARAMETER


               o      Returned if the enableIsnsDiscovery argument has a value
                      other than the value, IMA_TRUE, or the value, IMA_FALSE.


               o      Returned  if  the  discoveryMethod  argument has a value
                      other than

                   o      IMA_ISNS_DISCOVERY_METHOD_STATIC


                   o      IMA_ISNS_DISCOVERY_METHOD_DHCP


                   o      IMA_ISNS_DISCOVERY_METHOD_SLP



               o      Returned if enabledIsnsDiscovery has the value  IMA_TRUE
                      and  domainName  is NULL or specifies a memory area from
                      which data cannot be read.



       IMA_ERROR_INVALID_OBJECT_TYPE

           Returned if the oid argument does not specify a valid object type.


       IMA_ERROR_INCORRECT_OBJECT_TYPE

           Returned if the oid argument does not specify a PHBA, LHBA, or net‐
           work portal object.


       IMA_ERROR_OBJECT_NOT_FOUND

           Returned if the oid argument does not specify a PHBA, LHBA, or net‐
           work portal that is currently known to the system.


       IMA_ERROR_LAST_PRIMARY_DISCOVERY_METHOD

           Returned if the enableIsnsDiscovery argument is set to  the  value,
           IMA_FALSE,  and iSNS target discovery is the last primary discovery
           method for the PHBA or LHBA. This means that both  the  SLP  target
           discovery  and  static  target discovery properties are either dis‐
           abled or not supported.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ Availabilitysystem/library/storage/snia-ima _ Interface
       StabilityVolatile _ MT-LevelSafe


SEE ALSO
       libima(3LIB), attributes(7), IMA_GetDiscoveryProperties(3IMA), IMA_Set‐
       SlpDiscovery(3IMA),  IMA_SetStaticDiscovery(3IMA),  IMA_SetSendTargets‐
       Discovery(3IMA)



Oracle Solaris 11.4               27 Nov 2017
                                                    IMA_SetIsnsDiscovery(3IMA)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3