man pages section 3: Extended Library Functions, Volume 2

IMA_SetDataDigestValues (3IMA)

Name

IMA_SetDataDigestValues - Sets the list of checksums that can be negotiated for data 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 data digest values are to be set

digestValueCount

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

pDigestValueList

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

Description

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

Return Values

IMA_STATUS_REBOOT_NECESSARY

Returned if a reboot is necessary before the setting of the specified digest values takes 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)