man pages section 3: Extended Library Functions, Volume 2

IMA_GetAddressKeys (3IMA)

Name

IMA_GetAddressKeys - Gets the address keys of a target

Synopsis

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

IMA_STATUS IMA_GetAddressKeys(
  /* in */     IMA_OID targetOid,
  /* out */    IMA_ADDRESS_KEYS **ppKeys
);

Parameters

targetOid

The object ID of the target whose address keys are being retrieved.

ppKeys

A pointer to a pointer to an IMA_ADDRESS_KEYS data structure allocated by the caller.

If successfully returned, this argument contains a pointer to an IMA_ADDRESS_KEYS data structure.

Description

The IMA_GetAddressKeys() API gets the address keys of a target.

Return Values

IMA_ERROR_INVALID_PARAMETER

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

IMA_ERROR_INVALID_OBJECT_TYPE

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

IMA_ERROR_INCORRECT_OBJECT_TYPE

Returned if the targetOid argument does not specify a target object

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the targetOid argument does not specify a target known to the system

IMA_ERROR_TARGET_TIMEOUT

Returned if the target fails to respond to an iSCSI discovery session creation from an initiator.

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)