man pages section 3: Extended Library Functions, Volume 2

IMA_AddLHBAMutualAuthParms (3IMA)

Name

IMA_AddLHBAMutualAuthParms - Adds mutual authentication parameters

Synopsis

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

IMA_STATUS IMA_AddLHBAMutualAuthParms(
 /* in */     IMA_OID oid,
 /* in */     IMA_AUTHMETHOD method,
 /* in */     IMA_TARGET_AUTHPARMS pParms
);

Parameters

oid

The object ID of a logical host bus adapter (LHBA) object to which the authentication parameters are to be added.

method

The authentication method of the object ID to which authentication parameters are to be added.

pParms

An IMA_TARGET_AUTHPARMS data structure which contains the new authentication parameters to add to the list for the specified LHBA object.

Description

The IMA_AddLHBAMutualAuthParms() API adds a mutual authentication parameter to the list for a specified LHBA object.

Return Values

IMA_ERROR_INVALID_PARAMETER

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

• Returned if method has the value, IMA_AUTHMETHOD_NONE

• Returned if the pParms argument is NULL, or 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 object.

IMA_ERROR_NOT_SUPPORTED

Returned if the LHBA object does not support setting of the mutual authentication parameters list.

IMA_ERROR_OBJECT_NOT_FOUND

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

attributes(7), attributes(7), IMA_GetLHBAMutualAuthParmsList(3IMA), IMA_RemoveLHBAMutualAuthParms(3IMA)