mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-11-23 12:14:10 +08:00
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
Martin K. Petersen
parent
62e3bfa4a1
commit
f22978400e
92
Documentation/scsi/dpti.rst
Normal file
92
Documentation/scsi/dpti.rst
Normal 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.
|
||||
@ -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.
|
||||
*
|
||||
*/
|
||||
|
||||
@ -18,5 +18,6 @@ Linux SCSI Subsystem
|
||||
BusLogic
|
||||
cxgb3i
|
||||
dc395x
|
||||
dpti
|
||||
|
||||
scsi_transport_srp/figures
|
||||
|
||||
@ -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.
|
||||
|
||||
@ -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
|
||||
***************************************************************************/
|
||||
|
||||
|
||||
@ -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
|
||||
***************************************************************************/
|
||||
|
||||
|
||||
@ -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
|
||||
***************************************************************************/
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user