Commit 94b5530f authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab Committed by Martin K. Petersen
Browse files

scsi: docs: convert aha152x.txt to ReST 

Link: https://lore.kernel.org/r/097cfcc7f25343676a1fedcefed7e3b91b41b4df.1583136624.git.mchehab+huawei@kernel.org


Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: default avatarMartin K. Petersen <martin.petersen@oracle.com>
parent cb322408

Documentation/scsi/aha152x.txt→Documentation/scsi/aha152x.rst

+47 −26
Original line number Diff line number Diff line 
$Id: README.aha152x,v 1.2 1999/12/25 15:32:30 fischer Exp fischer $

.. SPDX-License-Identifier: GPL-2.0

.. include:: <isonum.txt>



=====================================================

Adaptec AHA-1520/1522 SCSI driver for Linux (aha152x)

=====================================================



Copyright |copy| 1993-1999 Jürgen Fischer <fischer@norbit.de>



Copyright 1993-1999 Jürgen Fischer <fischer@norbit.de>

TC1550 patches by Luuk van Dijk (ldz@xs4all.nl)
@@ -14,8 +19,10 @@ less polling loops), has slightly higher throughput (at 
least on my ancient test box; a i486/33Mhz/20MB).





CONFIGURATION ARGUMENTS:

Configuration Arguments

=======================



============  ========================================  ======================

IOPORT        base io address                           (0x340/0x140)

IRQ           interrupt level                           (9-12; default 11)

SCSI_ID       scsi id of controller                     (0-7; default 7)
@@ -25,8 +32,12 @@ SYNCHRONOUS enable synchronous transfers (0/1; default 1 [on]) 
DELAY:        bus reset delay                           (default 100)

EXT_TRANS:    enable extended translation               (0/1: default 0 [off])

              (see NOTES)

============  ========================================  ======================



COMPILE TIME CONFIGURATION (go into AHA152X in drivers/scsi/Makefile):

Compile Time Configuration

==========================



(go into AHA152X in drivers/scsi/Makefile):



- DAUTOCONF

    use configuration the controller reports (AHA-152x only)
@@ -47,7 +58,10 @@ COMPILE TIME CONFIGURATION (go into AHA152X in drivers/scsi/Makefile): 
    enable some statistics





LILO COMMAND LINE OPTIONS:

LILO Command Line Options

=========================



 ::



    aha152x=<IOPORT>[,<IRQ>[,<SCSI-ID>[,<RECONNECT>[,<PARITY>[,<SYNCHRONOUS>[,<DELAY> [,<EXT_TRANS]]]]]]]
@@ -58,17 +72,21 @@ aha152x=<IOPORT>[,<IRQ>[,<SCSI-ID>[,<RECONNECT>[,<PARITY>[,<SYNCHRONOUS>[,<DELAY 
 For two controllers use the aha152x statement twice.





SYMBOLS FOR MODULE CONFIGURATION:

Symbols for Module Configuration

================================



Choose from 2 alternatives:



1. specify everything (old)

1. specify everything (old)::



    aha152x=IOPORT,IRQ,SCSI_ID,RECONNECT,PARITY,SYNCHRONOUS,DELAY,EXT_TRANS



  configuration override for first controller



  ::



    aha152x1=IOPORT,IRQ,SCSI_ID,RECONNECT,PARITY,SYNCHRONOUS,DELAY,EXT_TRANS



  configuration override for second controller



2. specify only what you need to (irq or io is required; new)
@@ -101,7 +119,8 @@ exttrans=EXTTRANS0[,EXTTRANS1] 
If you use both alternatives the first will be taken.





NOTES ON EXT_TRANS: 

Notes on EXT_TRANS

==================



SCSI uses block numbers to address blocks/sectors on a device.

The BIOS uses a cylinder/head/sector addressing scheme (C/H/S)
@@ -150,8 +169,9 @@ geometry right in most cases: 
- for disks<1GB: use default translation (C/32/64)



- for disks>1GB:



  - take current geometry from the partition table

    (using scsicam_bios_param and accept only `valid' geometries,

    (using scsicam_bios_param and accept only 'valid' geometries,

    ie. either (C/32/64) or (C/63/255)).  This can be extended translation

    even if it's not enabled in the driver.
@@ -161,7 +181,8 @@ geometry right in most cases: 
    disks.





REFERENCES USED:

References Used

===============



 "AIC-6260 SCSI Chip Specification", Adaptec Corporation.

Documentation/scsi/index.rst

+1 −0
Original line number Diff line number Diff line
@@ -10,5 +10,6 @@ Linux SCSI Subsystem 
   53c700

   aacraid

   advansys

   aha152x



   scsi_transport_srp/figures

Documentation/scsi/scsi-parameters.txt

+1 −1
Original line number Diff line number Diff line
@@ -16,7 +16,7 @@ parameters may be changed at runtime by the command 
			See header of drivers/scsi/advansys.c.



	aha152x=	[HW,SCSI]

			See Documentation/scsi/aha152x.txt.

			See Documentation/scsi/aha152x.rst.



	aha1542=	[HW,SCSI]

			Format: <portbase>[,<buson>,<busoff>[,<dmaspeed>]]

drivers/scsi/Kconfig

+1 −1
Original line number Diff line number Diff line
@@ -383,7 +383,7 @@ config SCSI_AHA152X 


	  It is explained in section 3.3 of the SCSI-HOWTO, available from

	  <http://www.tldp.org/docs.html#howto>. You might also want to

	  read the file <file:Documentation/scsi/aha152x.txt>.

	  read the file <file:Documentation/scsi/aha152x.rst>.



	  To compile this driver as a module, choose M here: the

	  module will be called aha152x.

drivers/scsi/aha152x.c

+2 −2
Original line number Diff line number Diff line
@@ -220,7 +220,7 @@ 
 *

 **************************************************************************



 see Documentation/scsi/aha152x.txt for configuration details

 see Documentation/scsi/aha152x.rst for configuration details



 **************************************************************************/
@@ -1249,7 +1249,7 @@ static int aha152x_biosparam(struct scsi_device *sdev, struct block_device *bdev 
				       "aha152x: unable to verify geometry for disk with >1GB.\n"

				       "         Using default translation. Please verify yourself.\n"

				       "         Perhaps you need to enable extended translation in the driver.\n"

				       "         See Documentation/scsi/aha152x.txt for details.\n");

				       "         See Documentation/scsi/aha152x.rst for details.\n");

			}

		} else {

			info_array[0] = info[0];