sdi_timeout(D3sdi)

sdi_timeout -- call the appropriate kernel timeout routine

Synopsis

   #include <sys/types.h>
   #include <sys/sdi.h>
   #include <sys/ddi.h>

   toid_t sdi_timeout(void (*fn)(), void *arg, long ticks,
                      pl_t pl, struct scsi_ad *scsi_adp);

Description

sdi_timeout( ) calls the appropriate kernel DDI timeout routine for the selected HBA.

Arguments

The first 4 arguments to sdi_timeout( ) are comparable to the arguments for the itimeout(D3) and dtimeout(D3) functions.

fn: function to execute when the time increment expires
arg: argument to the function
ticks: number of clock ticks to wait before the function is called
pl: the interrupt priority level at which the function will be called
scsi_adp: pointer to the SCSI address

Return values

The sdi_timeout return value is the value returned by itimeout, which is a non-zero identifier that can be passed to untimeout(D3) to cancel the request, if the function specified by fn can be scheduled. If the function could not be scheduled, 0 is returned.

Usage

sdi_timeout( ) is used by the target drivers in place of the itimeout(D3) function if the fn function calls any of the HBA interface routines. Because the HBA might be required to run on a particular processor, sdi_timeout( ) insures that the function runs on the correct processor.

Context and synchronization

Non-blockable context.

Applicable hardware

x86/Pentium compatible architectures

Version applicability

sdi: 2, 3, 4 target drivers.

References

dtimeout(D3), itimeout(D3), untimeout(D3)

``Timeouts'' in HDK Technical Reference
``SDI bus timeout/reset recovery'' in HDK Technical Reference