man pages section 3: Extended Library Functions, Volume 2

IMA_RemoveDiscoveryAddress (3IMA)

Name

IMA_RemoveDiscoveryAddress - Removes a discovery address used for send targets discovery by a physical network port or LHBA

Synopsis

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

IMA_STATUS IMA_RemoveDiscoveryAddress(
     /* in */     IMA_OID discoveryAddressOid
);

Parameters

discoveryAddressOid

The object ID of the discovery address that is to no longer be used for send targets discovery

Description

The IMA_RemoveDiscoveryAddress() API removes a discovery address used for send targets discovery by a physical network port or logical host bus adapter (LHBA).

Return Values

IMA_STATUS_REBOOT_NECESSARY

Returned if a reboot is necessary before the specified discovery address is no longer used for send targets discovery

IMA_ERROR_INVALID_OBJECT_TYPE

Returned if the discoveryAddressOid argument does not specify a valid object type

IMA_ERROR_INCORRECT_OBJECT_TYPE

Returned if the discoveryAddressOid argument does not specify a discovery address object

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the discoveryAddressOid argument does not specify a discovery address known to the system

IMA_ERROR_LU_EXPOSED

Returned if the discoveryAddressOid argument specifies an iSCSI target that currently has a logical unit (LU) exposed to the operating system

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_AddDiscoveryAddress(3IMA), IMA_GetDiscoveryAddressProperties(3IMA), IMA_GetDiscoveryProperties(3IMA), IMA_SetSendTargetsDiscovery(3IMA)