man pages section 3: Extended Library Functions, Volume 2

IMA_SetInitiatorAuthMethods (3IMA)

Name

IMA_SetInitiatorAuthMethods - Sets the authentication methods for the specified LHBA when used as an initiator

Synopsis

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

IMA_STATUS IMA_SetInitiatorAuthMethods(
      /* in */     IMA_OID lhbaOid,
      /* in */     IMA_UINT methodCount,
      /* in */     const IMA_AUTHMETHOD *pMethodList
);

Parameters

lhbaOid

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

methodCount

The number of authentication methods in the pMethodList argument. There is at least one entry in the list.

pMethodList

A list of one or more authentication methods that the LHBA will use for all targets with which the LHBA communicates.

Description

The IMA_SetInitiatorAuthMethods() API sets the authentication methods for the specified LHBA when used as an initiator.

Return Values

IMA_STATUS_REBOOT_NECESSARY

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

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

IMA_ERROR_INVALID_PARAMETER

• Returned if the method argumentCount is zero

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

• Returned if the pMethodList argument contains duplicate authentication methods

• Returned if the pMethodList argument contains an unsupported authentication method

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_GetSupportedAuthMethods(3IMA), IMA_GetInUseInitiatorAuthMethods(3IMA)