VServer 1.9.2 (patch-2.6.8.1-vs1.9.2.diff)
[linux-2.6.git] / Documentation / scsi / scsi_mid_low_api.txt
index eda7ce5..463dfc7 100644 (file)
@@ -40,7 +40,7 @@ This version of the document roughly matches linux kernel version 2.6.0-test4.
 Documentation
 =============
 There is a SCSI documentation directory within the kernel source tree, 
-typically /usr/src/linux/Documentation/scsi . Most documents are in plain
+typically Documentation/scsi . Most documents are in plain
 (i.e. ASCII) text. This file is named scsi_mid_low_api.txt and can be 
 found in that directory. A more recent copy of this document may be found
 at http://www.torque.net/scsi/scsi_mid_low_api.txt.gz . 
@@ -827,6 +827,7 @@ The interface functions are listed below in alphabetical order.
 Summary:
    bios_param - fetch head, sector, cylinder info for a disk
    detect - detects HBAs this driver wants to control
+   eh_timed_out - notify the host that a command timer expired
    eh_abort_handler - abort given command
    eh_bus_reset_handler - issue SCSI bus reset
    eh_device_reset_handler - issue SCSI device reset
@@ -894,6 +895,32 @@ Details:
     int detect(struct scsi_host_template * shtp)
 
 
+/**
+ *      eh_timed_out - The timer for the command has just fired
+ *      @scp: identifies command timing out
+ *
+ *      Returns:
+ *
+ *     EH_HANDLED:             I fixed the error, please complete the command
+ *     EH_RESET_TIMER:         I need more time, reset the timer and
+ *                             begin counting again
+ *     EH_NOT_HANDLED          Begin normal error recovery
+
+ *
+ *      Locks: None held
+ *
+ *      Calling context: interrupt
+ *
+ *     Notes: This is to give the LLD an opportunity to do local recovery.
+ *     This recovery is limited to determining if the outstanding command
+ *     will ever complete.  You may not abort and restart the command from
+ *     this callback.
+ *
+ *      Optionally defined in: LLD
+ **/
+     int eh_timed_out(struct scsi_cmnd * scp)
+
+
 /**
  *      eh_abort_handler - abort command associated with scp
  *      @scp: identifies command to be aborted