man pages section 3: Extended Library Functions, Volume 2

IMA_RemoveLHBAMutualAuthParms (3IMA)

Name

IMA_RemoveLHBAMutualAuthParms - Removes a mutual auth parm from the list for a specified LHBA

Synopsis

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

IMA_STATUS IMA_RemoveLHBAMutualAuthParms(
    /* 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) to which the authentication parameters are removed

method

The authentication method of the object ID whose authentication parameters are removed

pParms

An IMA_INITIATOR_AUTHPARMS data structure which contains the auth parms to be removed from the list for the specified LHBA

Description

The IMA_RemoveLHBAMutualAuthParms() API removes a mutual auth parm from the list for a specified LHBA.

Return Values

IMA_ERROR_INVALID_PARAMETER

• Returned if the method argument does not specify a valid authentication method or does not specify a 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

• Returned if the authentication parameter to be removed can not be found

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 setting of 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_GetLHBAMutualAuthParmsList(3IMA), IMA_AddLHBAMutualAuthParms(3IMA)