man pages section 3: Extended Library Functions, Volume 2

IMA_GetLuOid (3IMA)

Name

IMA_GetLuOid - Gets a logical unit object ID for the specified LUN connected to the specified target

Synopsis

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

IMA_STATUS IMA_GetLuOid(
     /* in */     IMA_OID targetOid,
     /* in */     IMA_BYTE lun[8],
     /* out */    IMA_OID *pluOid
);

Parameters

targetOid

The object ID of the target that controls the logical unit whose object ID is being retrieved.

lun

The logical unit number (LUN) specifying the logical unit of the target whose object ID is being retrieved.

pluOid

A pointer to an IMA_OID data structure allocated by the caller. If returned successfully, this argument contains the object ID of the logical unit for the specified LUN connected to the specified target.

Description

The IMA_GetLuOid() API gets a logical unit object ID for the specified LUN connected to the specified target.

Return Values

IMA_ERROR_INVALID_PARAMETER

Returned if the pluOid argument is NULL, or specifies a memory area to which data cannot be written

IMA_ERROR_INVALID_OBJECT_TYPE

Returned if the targetOid argument does not specify a valid object type

IMA_ERROR_INCORRECT_OBJECT_TYPE

Returned if the targetOid argument does not specify a target object

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the targetOid argument does not specify a target 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_GetLuOidList(3IMA), IMA_GetLuProperties(3IMA), IMA_LuReportLuns(3IMA)