man pages section 3: Extended Library Functions, Volume 2

IMA_SetHeaderDigestValues (3IMA)

Name

IMA_SetHeaderDigestValues - Sets the list of checksums that can be negotiated for header digests

Synopsis

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

IMA_STATUS IMA_SetDataDigestValues(
     /* in */      IMA_OID oid,
     /* in */      IMA_UINT digestValueCount,
     /* in */      const IMA_DIGEST_TYPE *pDigestValueList;
);

Parameters

oid

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

digestValueCount

The number of digest values in the pDigestValueList argument. There is at least one entry in the list

pDigestValueList

A list of one or more digest values that the LHBA or target will use

Description

The IMA_SetHeaderDigestValues () API sets the list of checksums that can be negotiated for header digests.

Return Values

IMA_STATUS_REBOOT_NECESSARY

Returned if a reboot is necessary before the setting of the specified digest values will take effect

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

IMA_ERROR_INVALID_PARAMETER

• Returned if the digestValueCount argument is zero

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

• Returned if the pDigestValueList argument contains duplicate values

• Returned if the pDigestValueList argument contains an invalid value

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)