man pages section 3: Extended Library Functions, Volume 2

IMA_GetLHBAMutualAuthParmsList (3IMA)

Name

IMA_GetLHBAMutualAuthParmsList - Gets the mutual authentication parameters list for the specified authentication method for the specified LHBA

Synopsis

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

IMA_STATUS IMA_GetLHBAMutualAuthParmsList(
/* in */     IMA_OID oid,
/* in */     IMA_AUTHMETHOD method,
/* out */    IMA_TARGET_AUTHPARMS_LIST **ppParmsList,
);

Parameters

oid

The object ID of a logical host bus adapter (LHBA) whose authentication parameters are to be retrieved.

method

The authentication method of the object ID whose authentication parameters are to be retrieved.

ppParmsList

A pointer to a pointer to an IMA_TARGET_AUTHPARMS_LIST data structure. If successfully returned, this argument contains a list of the mutual authentication parameters for the specified authentication method on the specified object ID.

Description

The IMA_GetLHBAMutualAuthParmsList() API gets the mutual authentication parameters list for the specified authentication method for the LHBA specified by its object ID.

Return Values

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 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

IMA_ERROR_NOT_SUPPORTED

Returned if the LHBA does not support the mutual authentication parameters list

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the oid argument does not specify an LHBA 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_AddLHBAMutualAuthParms(3IMA), IMA_RemoveLHBAMutualAuthParms(3IMA)