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

개요

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

IMA_SetIsnsDiscovery(3ima)

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 ef‐
           fect.


       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