Go to main content

man pages section 3: Extended Library Functions, Volume 2

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

IMA_SetStaticDiscovery (3IMA)

Name

IMA_SetStaticDiscovery - Enables or disables static target discovery for a PHBA, LHBA, or network portal

Synopsis

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

IMA_STATUS IMA_SetStaticDiscovery(
     /* in */      IMA_OID oid,
     /* in */      IMA_BOOL enableStaticDiscovery
);

Parameters

oid

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

enableStaticDiscovery

Set to the value, IMA_TRUE if static target discovery is being enabled for the specified PHBA or LHBA.

Set to the value, IMA_FALSE if static target discovery is being disabled.

Description

The IMA_SetStaticDiscovery() API enables or disables static target discovery 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 enabling or disabling static discovery is not supported by the specified PHBA or LHBA.

IMA_ERROR_INVALID_PARAMETER

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

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 network portal object.

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the oid argument does not specify a PHBA, LHBA, or network portal known to the system.

IMA_ERROR_LAST_PRIMARY_DISCOVERY_METHOD

Returned if the enableStaticDiscovery argument is set to the value, IMA_FALSE, and static target discovery is the last primary discovery method for a PHBA, LHBA, or network portal. This means that both iSNS target discovery and SLP target discovery are either disabled or not supported.

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/library/storage/snia-ima
Interface Stability
Volatile
MT-Level
Safe

See Also

libima(3LIB), attributes(7), IMA_GetDiscoveryProperties(3IMA), IMA_SetIsnsDiscovery(3IMA), IMA_SetSlpDiscovery(3IMA), IMA_SetSendTargetsDiscovery(3IMA)