dpti.rst 3.4 KB

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