man pages section 9: DDI and DKI Kernel Functions

Exit Print View

Updated: July 2014
 
 

scsi_hba_pkt_comp(9F)

Name

scsi_hba_pkt_comp - scsi_pkt completion routine

Synopsis

#include <sys/scsi/scsi.h>

void scsi_hba_pkt_comp(struct scsi_pkt *pkt);

Parameters

pkt

Pointer to a scsi_pkt(9S) structure.

Interface Level

Solaris DDI specific (Solaris DDI).

Description

After filling in scsi_pkt(9S) fields with packet completion information, an HBA driver should call the scsi_hba_pkt_comp() function. This function is the recommended way for an HBA driver to signal completion of a scsi_pkt structure. Use is mandatory for HBA drivers that use tran_setup_pkt (9E).

Calling the scsi_hba_pkt_comp() function allows SCSA to observe, and possibly react to, the completion of a scsi_pkt request.

A call to the scsi_hba_pkt_comp() function will always result in a call to the pkt_comp() callback function defined in scsi_pkt(9S) . This pkt_comp() callback may, however, occur after return from scsi_hba_pkt_comp(), and may occur from a different thread executing on a different CPU.

Context

The scsi_hba_pkt_comp() function can be called from user, interrupt, or kernel context.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed

See Also

attributes(5), tran_setup_pkt(9E) , scsi_pkt(9S)

Notes

HBA driver calls scsi_hba_pkt_comp() instead of calling scsi_pkt(9S) pkt_comp directly.