NAME

scsi_poll −  run a polled SCSI command on behalf of a target driver

SYNOPSIS

#include <sys/scsi/scsi.h>

int scsi_poll(struct scsi_pkt ∗pkt);

INTERFACE LEVEL

Solaris DDI specific (Solaris DDI). 

ARGUMENTS

pkt Pointer to the scsi_pkt(9S) structure. 

DESCRIPTION

scsi_poll() requests the host adapter driver to run a polled command.  Unlike scsi_transport(9F) which runs commands asynchronously, scsi_poll() runs commands to completion before returning.  If the pkt_time member of pkt is 0, the value of pkt_time is defaulted to SCSI_POLL_TIMEOUT to prevent an indefinite hang of the system. 

RETURN VALUES

scsi_poll() returns:

0 command completed successfully. 

-1 command failed. 

CONTEXT

scsi_poll() can be called from user or interrupt level. 

SEE ALSO

makecom(9F), scsi_transport(9F), scsi_pkt(9S)

Writing Device Drivers SH WARNINGS

Since scsi_poll() runs commands to completion before returning, it may require more time than is desirable when called from interrupt context.  Therefore, calling scsi_poll from interrupt context is not recommended. 

SunOS 5.5/SPARC  —  Last change: 30 Aug 1995