man pages section 3: Extended Library Functions, Volume 2

IMA_SetInitiatorAuthParms (3IMA)

Name

IMA_SetInitiatorAuthParms - Sets the parameters for the authentication method specified for a specified LHBA

Synopsis

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

IMA_STATUS IMA_SetInitiatorAuthParms(
    /* in */     IMA_OID lhbaOid,
        [in[         IMA_AUTHMETHOD method,
    /* in */     const IMA_INITIATOR_AUTHPARMS *pParms
);

Parameters

lhbaOid

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

method

The authentication method of the LHBA whose authentication parameters are to be retrieved

pParms

A pointer to an IMA_INITIATOR_AUTHPARMS data structure that contains the parameters to be associated with the specified authentication method

Description

The IMA_SetInitiatorAuthParms() API sets the parameters for the authentication method specified for a specified LHBA.

Return Values

IMA_STATUS_REBOOT_NECESSARY

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

IMA_ERROR_NOT_SUPPORTED

Returned if the setting of authentication parameters is not supported by the specified LHBA. In this case, it is likely that LHBA does not support any authentication methods.

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 lhbaOid argument does not specify a valid object type

IMA_ERROR_INCORRECT_OBJECT_TYPE

Returned if the lhbaOid argument does not specify an LHBA

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the lhbaOid 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_GetInitiatorAuthParms(3IMA)