SCSI_HBA_PKT_COMP(9F) Kernel Functions for Drivers 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

illumos DDI specific (illumos 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(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Committed |
+--------------------+-----------------+

SEE ALSO

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

NOTES

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

January 29, 2009 SCSI_HBA_PKT_COMP(9F)