man pages section 3: Extended Library Functions, Volume 2

IMA_AddDiscoveryAddress (3IMA)

Name

IMA_AddDiscoveryAddress - Adds DiscoveryAddress

Synopsis

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

IMA_STATUS IMA_AddDiscoveryAddress(
  /* in */     IMA_OID oid,
  /* in */     const IMA_TARGET_ADDRESS discoveryAddress,
  /* out */    IMA_OID *pDiscoveryAddressOid
);

Parameters

oid

The object ID of the physical network port (PNP), or logical host bus adapter (LHBA) object to which the discovery address is being added.

discoveryAddress

The target address of the target to add to the specified PNP objects, or the list of LHBA discovery addresses that are to be used in a send targets discovery session.

pDiscoveryAddressOid

Either the pointer to an IMA_OID structure allocated by the caller, or NULL. If this argument is not NULL, then on successful return, this argument contains the object ID of the discovery address added by the IMA_AddDiscoveryAddress() API.

Description

The IMA_AddDiscoveryAddress() API adds a discovery address to be used for send targets discovery by the specified PNP or LHBA object.

Return Values

IMA_STATUS_REBOOT_NECESSARY

Returned if a reboot is necessary before the discovery address is used by the PNP or LHBA in a send targets discovery session.

IMA_ERROR_NOT_SUPPORTED

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

IMA_ERROR_INVALID_PARAMETER

• Returned if discoveryAddress is NULL, or specifies a memory area from which data cannot be read.

• Returned if discoveryAddress specifies an empty structure.

• Returned if the pDiscoveryAddressOid argument is not NULL, and 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 a PNP or LHBA object.

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the oid argument does not specify a PNP or LHBA 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_RemoveDiscoveryAddress(3IMA), IMA_GetDiscoveryAddressProperties(3IMA), IMA_RegisterForObjectVisibilityChanges(3IMA), IMA_GetDiscoveryProperties(3IMA)