man pages section 3: Extended Library Functions, Volume 2

IMA_AddStaticDiscoveryTarget (3IMA)

Name

IMA_AddStaticDiscoveryTarget - Adds a target to be statically discovered

Synopsis

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

IMA_STATUS IMA_AddStaticDiscoveryTarget(
  /* in */     IMA_OID oid,
  /* in */     const IMA_STATIC_DISCOVERY_TARGET staticDiscoveryTarget,
  /* out */    IMA_OID *pStaticDiscoveryTargetOid
);

Parameters

oid

The object ID of the physical network port (PNP) or logical host bus adapter (LHBA) object to which the target to be discovered is added.

staticDiscoveryTarget

• The name and address of the target to add to the specified PNP's

• The name and address of the list of LHBA targets that are to be statically discovered.

pStaticDiscoveryTargetOid

Either a pointer to an IMA_OID structure allocated by the caller or NULL. If not NULL, when successfully returned, this argument contains the object ID of the static discovery target added by the API.

Description

The IMA_AddStaticDiscoveryTarget() API adds a target to be statically discovered by the specified PNP or LHBA object.

Return Values

IMA_STATUS_REBOOT_NECESSARY

Returned if a reboot is necessary before discovery of the specified target takes effect

IMA_ERROR_NOT_SUPPORTED

Returned if static target discovery is not supported by the specified PNP or LHBA object

IMA_ERROR_INVALID_PARAMETER

• Returned if the staticDiscoveryTarget argument is NULL, or specifies a memory area from which data cannot be read

• Returned if the staticDiscoveryTarget argument specifies an empty structure

• Returned if the pStaticDiscoveryTargetOid 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 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_RemoveStaticDiscoveryTarget(3IMA), IMA_GetStaticDiscoveryTargetProperties(3IMA), IMA_RegisterForObjectVisibilityChanges(3IMA), IMA_GetDiscoveryProperties(3IMA), IMA_SetStaticDiscovery(3IMA)