Generate a slightly more informative error msg for bad HZ
[linux-2.6] / Documentation / scsi / dpti.txt
1  /* TERMS AND CONDITIONS OF USE
2  * 
3  * Redistribution and use in source form, with or without modification, are
4  * permitted provided that redistributions of source code must retain the
5  * above copyright notice, this list of conditions and the following disclaimer.
6  * 
7  * This software is provided `as is' by Adaptec and
8  * any express or implied warranties, including, but not limited to, the
9  * implied warranties of merchantability and fitness for a particular purpose,
10  * are disclaimed. In no event shall Adaptec be
11  * liable for any direct, indirect, incidental, special, exemplary or
12  * consequential damages (including, but not limited to, procurement of
13  * substitute goods or services; loss of use, data, or profits; or business
14  * interruptions) however caused and on any theory of liability, whether in
15  * contract, strict liability, or tort (including negligence or otherwise)
16  * arising in any way out of the use of this driver software, even if advised
17  * of the possibility of such damage.
18  * 
19  ****************************************************************
20  * This driver supports the Adaptec I2O RAID and DPT SmartRAID V I2O boards.
21  *
22  * CREDITS:
23  * The original linux driver was ported to Linux by Karen White while at 
24  * Dell Computer.  It was ported from Bob Pasteur's (of DPT) original 
25  * non-Linux driver.  Mark Salyzyn and Bob Pasteur consulted on the original
26  * driver. 
27  * 
28  * 2.0 version of the driver by Deanna Bonds and Mark Salyzyn.
29  *
30  * HISTORY:
31  * The driver was originally ported to linux version 2.0.34 
32  *
33  * V2.0 Rewrite of driver.  Re-architectured based on i2o subsystem.
34  *   This was the first full GPL version since the last version used
35  *   i2osig headers which were not GPL.  Developer Testing version.
36  * V2.1 Internal testing
37  * V2.2 First released version
38  *
39  * V2.3 
40  *   Changes:
41  *      Added Raptor Support
42  *      Fixed bug causing system to hang under extreme load with 
43  *         management utilities running (removed GFP_DMA from kmalloc flags)
44  *
45  *
46  * V2.4 First version ready to be submitted to be embedded in the kernel
47  *   Changes: 
48  *      Implemented suggestions from Alan Cox
49  *      Added calculation of resid for sg layer
50  *      Better error handling
51  *         Added checking underflow conditions 
52  *         Added DATAPROTECT checking
53  *         Changed error return codes
54  *         Fixed pointer bug in bus reset routine
55  *      Enabled hba reset from ioctls (allows a FW flash to reboot and use the new
56  *         FW without having to reboot)
57  *      Changed proc output
58  *
59  * TODO:
60  *      Add 64 bit Scatter Gather when compiled on 64 bit architectures
61  *      Add sparse lun scanning 
62  *      Add code that checks if a device that had been taken offline is
63  *         now online (at the FW level) when test unit ready or inquiry 
64  *         command from scsi-core
65  *      Add proc read interface
66  *         busrescan command
67  *         rescan command
68  *      Add code to rescan routine that notifies scsi-core about new devices
69  *      Add support for C-PCI (hotplug stuff)
70  *      Add ioctl passthru error recovery
71  *
72  * NOTES:
73  * The DPT card optimizes the order of processing commands.  Consequently,
74  * a command may take up to 6 minutes to complete after it has been sent
75  * to the board.  
76  *
77  * The files dpti_ioctl.h dptsig.h osd_defs.h osd_util.h sys_info.h are part of the
78  * interface files for Adaptec's management routines.  These define the structures used
79  * in the ioctls.  They are written to be portable.  They are hard to read, but I need
80  * to use them 'as is' or I can miss changes in the interface.
81  *
82  */
83