Go to main content

man pages section 3: Extended Library Functions, Volume 2

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

IMA_GetDataDigestValues (3IMA)

Name

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

Synopsis

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

IMA_STATUS IMA_GetDataDigestValues(
/* 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 data structure allocated by the caller.

On entry, the value pointed to contains the maximum number of entries that can be placed in the pDigestValueList argument. When returned by the IMA_GetDataDigestValues() API, the pDigestValueCount argument contains the number of entries that were actually placed in the pDigestValueList argument.

pDigestValueList

A pointer to an array of the IMA_DIGEST_TYPE data structure allocated by the caller. If the value is NULL, then the value pointed to by the pDigestValueCount argument on entry is zero.

If the value is not NULL when this argument is successfully returned, then the array is filled in with the digest values currently being used by the LHBA or the target. These entries will be sorted in decreasing order of preference for use by the LHBA or the target.

Description

The IMA_GetDataDigestValues() API gets the list of checksums that can be negotiated for data 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)