Kernel Functions for Drivers                        scsipoll(9F)



NAME
     scsipoll - run a polled SCSI command on behalf of a  target
     driver

SYNOPSIS
     #include 



     int scsipoll(struct scsipkt *pkt);


INTERFACE LEVEL
     Solaris DI specific (Solaris DI).

PARAMETERS
     pkt    Pointer to the scsipkt(9S) structure.


DESCRIPTION
     The scsipoll() function requests the host adapter driver to
     run  a  polled command. Unlike scsitransport(9F) which runs
     commands asynchronously, scsipoll() runs commands  to  com-
     pletion  before  returning. If the pkttime member of pkt is
     0, the value of  pkttime is defaulted to  SCSIPOLTIMEOUT
     to prevent an indefinite hang of the system.

RETURN VALUES
     The scsipoll() function returns:

     0     command completed successfully.


     -1    command failed.


CONTEXT
     The scsipoll() function can be called from user, interrupt,
     or  kernel  context. This function should not be called when
     the caller is executing timeout(9F)  in  the  context  of  a
     thread.

SEE ALSO
     makecom(9F), scsitransport(9F), scsipkt(9S)


     Writing Device Drivers

WARNINGS
     Since scsipoll() runs commands to completion before return-
     ing,  it may require more time than is desirable when called
     from interrupt context.  Therefore, calling  scsipoll  from



SunOS 5.11          Last change: 16 Jan 2006                    1






Kernel Functions for Drivers                        scsipoll(9F)



     interrupt context is not recommended.






















































SunOS 5.11          Last change: 16 Jan 2006                    2