man pages section 3: Extended Library Functions, Volume 2

IMA_GetDiscoveryAddressOidList (3IMA)

Name

IMA_GetDiscoveryAddressOidList - Gets a list of object IDs of all discovery addresses associated with the specified LHBA or PNP

Synopsis

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

IMA_STATUS IMA_GetDiscoveryAddressOidList(
 /* in */     IMA_OID oid,
 /* out */    IMA_OID_LIST **ppList
);

Parameters

oid

The Object ID of the LHBA (logical host bus adapter) or physical network port (PNP) object for which to retrieve discovery addresses.

ppList

A pointer to a IMA_OID_LIST data structure. If successfully returned, this argument contains a pointer to an IMA_OID_LIST data structure that contains the object ID's of all discovery addresses associated with the specified object.

Description

the IMA_GetDiscoveryAddressOidList() API gets a list of object ID's of all discovery addresses associated with the specified LHBA or PNP.

Return Values

IMA_ERROR_INVALID_PARAMETER

Returned if the ppList argument is NULL, or specifies a memory area to which data cannot be written

IMA_ERROR_NOT_SUPPORTED

Returned if send targets discovery is not supported by the specified PNP or LHBA

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 an LHBA or a PNP object

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the oid argument does not specify an object known to the 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_FreeMemory(3IMA), IMA_AddDiscoveryAddress(3IMA), IMA_RemoveDiscoveryAddress(3IMA), IMA_GetDiscoveryAddressProperties(3IMA)