DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

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


19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005