man pages section 3: Extended Library Functions, Volume 2

IMA_SetMutualLocalAuth (3IMA)

Name

IMA_SetMutualLocalAuth - Sets whether mutual authentication is performed for the specified authentication method for a specified object ID

Synopsis

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

IMA_STATUS IMA_SetMutualAuth (
    /* in */     IMA_OID oid,
    /* in */     IMA_AUTHMETHOD method,
    /* in */     IMA_BOOL mutualAuthEnabled
);

Parameters

oid

The object ID of the target, static target or discovery address whose mutual authentication behavior is being set.

method

The authentication method of the object ID for which mutual authentication behavior is being set.

mutualAuthEnabled

A boolean indicating whether mutual authentication will be performed for the specified object ID for the specified authentication method.

• If this parameter is set to the value, IMA_TRUE, the initiator will perform mutual authentication for the specified object ID for the specified authentication method.

• If this parameter is set to the value, IMA_FALSE, the initiator will not perform the mutual authentication.

Description

The IMA_SetMutualLocalAuth() API sets whether mutual authentication is performed for the specified authentication method for a specified object ID.

Return Values

IMA_STATUS_REBOOT_NECESSARY

Returned if a reboot is necessary before the setting of the authentication parameters takes effect

IMA_ERROR_INVALID_PARAMETER

• Returned if the method argument does not specify a valid or supported authentication method

• Returned if the method argument has the value, IMA_AUTHMETHOD_NONE

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

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 a target, static target or discovery address

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the oid argument does not specify an object ID 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), IMA_GetMutualLocalAuthParms(3IMA), IMA_SetMutualLocalAuthParms(3IMA), IMA_GetMutualLocalAuth(3IMA), IMA_AddLHBAMutualAuthParms(3IMA), IMA_RemoveLHBAMutualAuthParms(3IMA), IMA_GetLHBAMutualAuthParmsList(3IMA)