man pages section 3: Extended Library Functions, Volume 2

SUN_IMA_GetSendTargetsList (3IMA)

Name

SUN_IMA_GetSendTargetsList - Gets a list of the properties of all discovery addresses associated with the specified LHBA or PHBA

Synopsis

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

IMA_STATUS SUN_IMA_GetSendTargetsList(
       /* in */     IMA_OID oid,
       /* in */     IMA_TARGET_ADDRESS address,
       /* out */    SUN_IMA_DISCOVERY_ADDRESS_KEY_PROPERTIES **ppList
);

Parameters

oid

The object ID of the logical host bus adapter (LHBA) or physical host bus adapter (PHBA) .

address

The address which is used for discovery by the SendTargets.

ppList

A pointer to a pointer to a SUN_IMA_DISCOVERY_ADDRESS_KEY_PROPERTIES data structure. If returned successfully, this argument contains a pointer to a SUN_IMA_DISCOVERY_ADDRESS_KEY_PROPERTIES data structure that contains the properties of all of the discovery addresses associated with the specified LHBA or PHBA.

Description

The SUN_IMA_GetSendTargetsList() API gets a list of the properties of all discovery addresses associated with the specified LHBA or PHBA.

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_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 PHBA

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)