Go to main content

man pages section 3: Extended Library Functions, Volume 2

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

IMA_GetHeaderDigestValues (3IMA)

Name

IMA_GetHeaderDigestValues - Gets the list of checksums that can be negotiated for digests

Synopsis

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

IMA_STATUS IMA_GetHeaderDigestValues(
 /* in */       IMA_OID oid,
 /* in,out */   IMA_UINT *pDigestValueCount,
 /* out */      IMA_DIGEST_TYPE *pDigestValueList;
);

Parameters

oid

The object ID of a logical host bus adapter (LHBA) or target whose digest values are to be retrieved.

pDigestValueCount

A pointer to an IMA_UINT allocated by the caller.

On entry, this argument contains the maximum number of entries that can be placed into the pDigestValueList argument. On return, this argument contains the number of entries actually placed into the pDigestValueList argument.

pDigestValueList

A pointer to an array of IMA_DIGEST_TYPE data allocated by the caller or NULL.

If this argument is not NULL when successfully returned, the array contains the digest values being used by the LHBA or target. These values are in decreasing order of preference for use by the LHBA or target.

If this argument is NULL, then the value pointed to by the pDigestValueCount argument on entry is zero.

Description

The IMA_GetHeaderDigestValues() API gets the list of checksums that can be negotiated for digests.

Return Values

IMA_ERROR_INVALID_PARAMETER

Returned if the pDigestValueList argument 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 target

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the oid argument does not specify an LHBA or target 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)