Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

hba_sendreadcapacity(3hbaapi) [opensolaris man page]

HBA_SendScsiInquiry(3HBAAPI)		      Common Fibre Channel HBA Information Library Functions		      HBA_SendScsiInquiry(3HBAAPI)

NAME
HBA_SendScsiInquiry, HBA_ScsiInquiryV2, HBA_SendReportLUNs, HBA_ScsiReportLUNsV2, HBA_SendReadCapacity, HBA_ScsiReadCapacityV2 - gather SCSI information from discovered ports SYNOPSIS
cc [ flag... ] file... -lHBAAPI [ library... ] #include <hbaapi.h> HBA_STATUS HBA_SendScsiInquiry(HBA_HANDLE handle, HBA_WWN PortWWN, HBA_UINT64 fcLUN, HBA_UINT8 EVPD, HBA_UINT32 PageCode, void *pRspBuffer, HBA_UINT32 RspBufferSize, void *pSenseBuffer, HBA_UINT32 SenseBufferSize); HBA_STATUS HBA_ScsiInquiryV2(HBA_HANDLE handle, HBA_WWN hbaPortWWN, HBA_WWN discoveredPortWWN, HBA_UINT64 fcLUN, HBA_UINT8 CDB_BYTE1, HBA_UINT8 CDB_BYTE2, void *pRspBuffer, HBA_UINT32 *pRspBufferSize, HBA_UINT8 *pScsiStatus, void *pSenseBuffer, HBA_UINT32 *pSenseBufferSize); HBA_STATUS HBA_SendReportLUNs(HBA_HANDLE handle, HBA_WWN PortWWN, void *pRspBuffer, HBA_UINT32 RspBufferSize, void *pSenseBuffer, HBA_UINT32 SenseBufferSize); HBA_STATUS HBA_ScsiReportLUNsV2(HBA_HANDLE handle, HBA_WWN hbaPortWWN, HBA_WWN discoveredPortWWN, void *pRspBuffer, HBA_UINT32 *pRspBufferSize, HBA_UINT8 *pScsiStatus, void *pSenseBuffer, HBA_UINT32 *pSenseBufferSize); HBA_STATUS HBA_SendReadCapacity(HBA_HANDLE handle, HBA_WWN PortWWN, HBA_UINT64 fcLUN, void *pRspBuffer, HBA_UINT32 RspBufferSize, void *pSenseBuffer, HBA_UINT32 SenseBufferSize); HBA_STATUS HBA_ScsiReadCapacityV2(HBA_HANDLE handle HBA_WWN hbaPortWWN, HBA_WWN discoveredPortWWN, HBA_UINT64 fcLUN, void *pRspBuffer, HBA_UINT32 *pRspBufferSize, HBA_UINT8 *pScsiStatus, void *pSenseBuffer, HBA_UINT32 *pSenseBufferSize); PARAMETERS
handle an open handle returned from HBA_OpenAdapter(3HBAAPI) PortWWN the port WWN of the discovered remote device to which the command is sent hbaPortWWN HBA_ScsiInquiryV2() the Port WWN of the local HBA through which the SCSI INQUIRY command is issued HBA_ScsiReportLUNsV2() the Port WWN of the local HBA through which the SCSI REPORT LUNS command is issued HBA_ScsiReadCapacityV2() the Port WWN of a local HBA through which the SCSI READ CAPACITY command is issued discoveredPortWWN HBA_ScsiInquiryV2() the Remote Port WWN to which the SCSI INQUIRY command is being sent HBA_ScsiReportLUNsV2() the Remote Port WWN to which the SCSI REPORT LUNS command is sent HBA_ScsiReadCapacityV2() the Remote Port WWN to which the SCSI READ CAPACITY command is sent fcLUN the FCP LUN as defined in the T10 specification SAM-2 to which the command is sent EVPD If set to 0, indicates a Standard Inquiry should be returned. If set to 1, indicates Vital Product Data should be returned. PageCode If EVPD is set to 1, PageCode indicates which Vital Product Data page should be returned. CDB_Byte1 the second byte of the CDB for the SCSI INQUIRY command CDB_Byte2 the third byte of the CDB for the SCSI INQUIRY command pRspBuffer a buffer in which to store the response payload RspBufferSize the size of the response buffer pRspBufferSize a pointer to the size of the response buffer pScsiStatus a buffer to receive SCSI sense data pSenseBuffer a buffer in which to store any SCSI sense data SenseBufferSize the size of the sense buffer pSenseBufferSize a pointer to the size of the sense buffer DESCRIPTION
The HBA_SendScsiInquiry() and HBA_SendScsiInquiryV2() functions send a SCSI Inquiry command as defined in the T10 specification SPC-2 to a remote FCP port. The HBA_SendReportLUNs() and HBA_SendReportLUNsV2() functions send a SCSI Report LUNs command as defined in the T10 specification SPC-2 to a remote FCP port. The HBA_SendReadCapacity() and HBA_SendReadCapacityV2() functions end a SCSI Read Capacity command as defined in the T10 specification SBC-2 to a remote FCP port. RETURN VALUES
The HBA_SendScsiInquiry() function returns the following value: HBA_STATUS_OK The command has completed. Success or failure should be determined by verifying that the sense data does not contain a check-condition. If a check-condition is present, the content of pRspBuffer is undefined. The HBA_ScsiInquiryV2() function returns the following values: HBA_STATUS_OK The command has completed. The complete payload of the SCSI INQUIRY command is returned in pRspBuffer. HBA_STATUS_ERROR_ILLEGAL_WWN The port WWN hbaPortWWN is not a WWN contained by the HBA specified by handle. HBA_STATUS_ERROR_NOT_A_TARGET The identified remote Port does not have SCSI Target functionality. HBA_STATUS_ERROR_TARGET_BUSY The command cannot be sent due to a SCSI overlapped command condition. HBA_STATUS_ERROR An error occurred. The HBA_SendReportLUNs() function returns the following values: HBA_STATUS_OK The command has completed. Success or failure should be determined by verifying the sense data does not contain a check-condition. If a check-condition is present, the content of pRspBuffer is undefined. HBA_STATUS_SCSI_CHECK_CONDITION The HBA detected a check-condition state. Details are present in the pSenseBuffer payload. The content of pRspBuffer is undefined. Not all VSLs support this error condition. Other error values indicate the content of pRspBuffer is undefined. In some cases, the pSenseBuffer can contain sense data. The HBA_SendReportLUNsV2() function returns the following values: HBA_STATUS_OK The command has completed. Sense data must be verified to ensure that it does not contain a check-condition to determine success. If a check-condition is present, the content of pRspBuffer is undefined. HBA_STATUS_ERROR_ILLEGAL_WWN The port WWN hbaPortWWN is not a WWN contained by the HBA specified by handle. HBA_STATUS_ERROR_NOT_A_TARGET The identified remote Port does not have SCSI Target functionality. HBA_STATUS_ERROR_TARGET_BUSY The command cannot be sent due to a SCSI overlapped command condition. HBA_STATUS_ERROR An error occurred. The HBA_SendReadCapacity() function returns the following values: HBA_STATUS_OK The command has completed. Success or failure should be determined by verifying that the sense data does not contain a check-condition. If a check-condition is present, the content of pRspBuffer is undefined. HBA_STATUS_SCSI_CHECK_CONDITION The HBA detected a check-condition state. Details are present in the pSenseBuffer payload. The content of pRspBuffer is undefined. Not all VSLs support this error condition. Other error values indicate the content of pRspBuffer is undefined. In some cases, the pSenseBuffer can contain sense data. The HBA_ScsiReadCapacityV2() function returns the following values: HBA_STATUS_OK The command has completed. Sense data must be verified to ensure that it does not contain a check-condition to determine success. If a check-condition is present, the content of pRspBuffer is undefined. HBA_STATUS_ERROR_ILLEGAL_WWN The port WWN hbaPortWWN is not a WWN contained by the HBA specified by handle. HBA_STATUS_ERROR_NOT_A_TARGET The identified remote Port does not have SCSI Target functionality. HBA_STATUS_ERROR_TARGET_BUSY The command cannot be sent due to a SCSI overlapped command condition. HBA_STATUS_ERROR An error occurred. Other error values indicate the content of pRspBuffer is undefined. In some cases, the pSenseBuffer can contain sense data. ERRORS
See libhbaapi(3LIB) for general error status values. EXAMPLES
Example 1 Send a SCSI inquiry to the given discovered Target port WWN. The following example sends a SCSI inquiry to the given discovered Target port WWN. memset(&inq, 0, sizeof (inq)); memset(&sense, 0, sizeof (sense)); if ((status = HBA_SendScsiInquiry(handle, discPortAttrs.PortWWN, 0, 0, 0, &inq, sizeof (inq), &sense, sizeof (sense))) != HBA_STATUS_OK) { fprintf(stderr, "Unable to send SCSI " "inquiry, reason %d ", status); continue; } printf(" Vendor: %.*s ", 8, inq.inq_vid); printf(" Model: %.*s ", 16, inq.inq_pid); ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-------------------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-------------------------------------+ |Interface Stability |Standard: FC-MI 1.92 (API version 1) | +-----------------------------+-------------------------------------+ | |Standard: FC-HBA Version 4 (API ver- | | |sion 2) | +-----------------------------+-------------------------------------+ |MT-Level |Safe | +-----------------------------+-------------------------------------+ SEE ALSO
HBA_OpenAdapter(3HBAAPI), libhbaapi(3LIB), attributes(5) T11 FC-MI Specification BUGS
The HBA_SendScsiInquiry(), HBA_SendReportLUNs(), and HBA_SendReadCapacity() functions do not take a portindex to define through which port of a multi-ported HBA the command should be sent. The behavior on multi-ported HBAs is vendor-specific and can result in the command being sent through the first HBA port, the first HBA port the given PortWWN is connected to, or other vendor-specific behavior. SNIA version 2 defines HBA_ScsiInquiryV2(), HBA_ScsiReportLUNs(), and HBA_ScsiReadCapacity() to take a Port WWN as an argument. This fixes the bug with multi-ported HBAs in HBA_ScsiInquiry(), HBA_SendReportLUNs(), and HBA_SendReadCapacity(). SunOS 5.11 1 Sep 2003 HBA_SendScsiInquiry(3HBAAPI)
Man Page