scsi: docs: convert dpti.txt to ReST

Link: https://lore.kernel.org/r/212fd7961c134c5bd73d87cd818bcddc30270804.1583136624.git.mchehab+huawei@kernel.org
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
This commit is contained in:
Mauro Carvalho Chehab 2020-03-02 09:15:47 +01:00 committed by Martin K. Petersen
parent 62e3bfa4a1
commit f22978400e
7 changed files with 97 additions and 87 deletions

View File

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

View File

@ -1,83 +0,0 @@
/* TERMS AND CONDITIONS OF USE
*
* Redistribution and use in source form, with or without modification, are
* permitted provided that redistributions of source code must retain the
* above copyright notice, this list of conditions and the following disclaimer.
*
* This software is provided `as is' by Adaptec and
* any express or implied warranties, including, but not limited to, the
* implied warranties of merchantability and fitness for a particular purpose,
* are disclaimed. In no event shall Adaptec be
* liable for any direct, indirect, incidental, special, exemplary or
* consequential damages (including, but not limited to, procurement of
* substitute goods or services; loss of use, data, or profits; or business
* interruptions) however caused and on any theory of liability, whether in
* contract, strict liability, or tort (including negligence or otherwise)
* arising in any way out of the use of this driver software, even if advised
* of the possibility of such damage.
*
****************************************************************
* This driver supports the Adaptec I2O RAID and DPT SmartRAID V I2O boards.
*
* CREDITS:
* The original linux driver was ported to Linux by Karen White while at
* Dell Computer. It was ported from Bob Pasteur's (of DPT) original
* non-Linux driver. Mark Salyzyn and Bob Pasteur consulted on the original
* driver.
*
* 2.0 version of the driver by Deanna Bonds and Mark Salyzyn.
*
* HISTORY:
* The driver was originally ported to linux version 2.0.34
*
* V2.0 Rewrite of driver. Re-architectured based on i2o subsystem.
* This was the first full GPL version since the last version used
* i2osig headers which were not GPL. Developer Testing version.
* V2.1 Internal testing
* V2.2 First released version
*
* V2.3
* Changes:
* Added Raptor Support
* Fixed bug causing system to hang under extreme load with
* management utilities running (removed GFP_DMA from kmalloc flags)
*
*
* V2.4 First version ready to be submitted to be embedded in the kernel
* Changes:
* Implemented suggestions from Alan Cox
* Added calculation of resid for sg layer
* Better error handling
* Added checking underflow conditions
* Added DATAPROTECT checking
* Changed error return codes
* Fixed pointer bug in bus reset routine
* Enabled hba reset from ioctls (allows a FW flash to reboot and use the new
* FW without having to reboot)
* Changed proc output
*
* TODO:
* Add 64 bit Scatter Gather when compiled on 64 bit architectures
* Add sparse lun scanning
* Add code that checks if a device that had been taken offline is
* now online (at the FW level) when test unit ready or inquiry
* command from scsi-core
* Add proc read interface
* busrescan command
* rescan command
* Add code to rescan routine that notifies scsi-core about new devices
* Add support for C-PCI (hotplug stuff)
* Add ioctl passthru error recovery
*
* NOTES:
* The DPT card optimizes the order of processing commands. Consequently,
* a command may take up to 6 minutes to complete after it has been sent
* to the board.
*
* The files dpti_ioctl.h dptsig.h osd_defs.h osd_util.h sys_info.h are part of the
* interface files for Adaptec's management routines. These define the structures used
* in the ioctls. They are written to be portable. They are hard to read, but I need
* to use them 'as is' or I can miss changes in the interface.
*
*/

View File

@ -18,5 +18,6 @@ Linux SCSI Subsystem
BusLogic
cxgb3i
dc395x
dpti
scsi_transport_srp/figures

View File

@ -448,7 +448,7 @@ config SCSI_DPT_I2O
help
This driver supports all of Adaptec's I2O based RAID controllers as
well as the DPT SmartRaid V cards. This is an Adaptec maintained
driver by Deanna Bonds. See <file:Documentation/scsi/dpti.txt>.
driver by Deanna Bonds. See <file:Documentation/scsi/dpti.rst>.
To compile this driver as a module, choose M here: the
module will be called dpt_i2o.

View File

@ -5,7 +5,7 @@
begin : Thu Sep 7 2000
copyright : (C) 2001 by Adaptec
See Documentation/scsi/dpti.txt for history, notes, license info
See Documentation/scsi/dpti.rst for history, notes, license info
and credits
***************************************************************************/

View File

@ -8,7 +8,7 @@
July 30, 2001 First version being submitted
for inclusion in the kernel. V2.4
See Documentation/scsi/dpti.txt for history, notes, license info
See Documentation/scsi/dpti.rst for history, notes, license info
and credits
***************************************************************************/

View File

@ -5,7 +5,7 @@
begin : Thu Sep 7 2000
copyright : (C) 2001 by Adaptec
See Documentation/scsi/dpti.txt for history, notes, license info
See Documentation/scsi/dpti.rst for history, notes, license info
and credits
***************************************************************************/