Technical Reference: Base Operating System and Extensions, Volume 1

HBA_SendReadCapacity Subroutine

Purpose

Sends a SCSI READ CAPACITY command to a Fibre Channel port.

Library

Common Host Bus Adapter Library (libHBAAPI.a)

Syntax

#include <hbaapi.h>

HBA_STATUS HBA_SendReadCapacity (handle, portWWN, fcLUN, pRspBuffer, RspBufferSize, pSenseBuffer,
SenseBufferSize)
HBA_HANDLE handle;
HBA_WWN portWWN;
HBA_UINT64 fcLUN;
void *pRspBuffer;
HBA_UINT32 RspBufferSize;
void *pSenseBuffer;
HBA_UINT32 SenseBufferSize;

Description

The HBA_SendReadCapacity subroutine sends a SCSI READ CAPACITY command to the Fibre Channel port connected to the handle parameter and specified by the portWWN and fcLUN parameters.

Parameters

handle	HBA_HANDLE to an open adapter.
portWWN	Port world-wide name of an adapter.
fcLUN	Fibre Channel LUN to send the SCSI READ CAPACITY command to.
pRspBuffer	Pointer to a buffer that receives the response of the command.
RspBufferSize	Size of the response buffer.
pSenseBuffer	Pointer to a buffer that receives sense information.
SenseBufferSize	Size of the sense buffer.

Return Values

If successful, HBA_STATUS_OK is returned and the pRspBuffer parameter points to the response to the READ CAPACITY command. If an error occurs, HBA_STATUS_ERROR is returned.

Error Codes

If the portWWN value is not a valid world-wide name connected to the specified handle, HBA_STATUS_ERROR_ILLEGAL_WWN is returned. On any other types of failures, HBA_STATUS_ERROR is returned.

Related Information

The HBA_SendScsiInquiry Subroutine.

Special Files in AIX 5L Version 5.2 Files Reference describes specific qualities of the files that define devices.