[PATCH 2.6][TRIVIAL] Update ide.txt documentation to current ide.c

[PATCH 2.6][TRIVIAL] Update ide.txt documentation to current ide.c

[Maciej Soltysiak]

Hi,

this patches updates Documentation/ide.txt to reflect more options that
really are supported by the IDE driver (drivers/ide.c)

The patch despite the dirnames is versus 2.6.0-test3-bk8.

Please review and luckily apply.
Regards,
Maciej

diff -u linux-2.6.0-test2/Documentation/ide.txt linux-2.6.0-test3/Documentation/ide.txt
--- linux-2.6.0-test2/Documentation/ide.txt	2003-07-27 19:04:55.000000000 +0200
+++ linux-2.6.0-test3/Documentation/ide.txt	2003-08-21 12:28:09.000000000 +0200
@@ -1,5 +1,5 @@

-	Information regarding the Enhanced IDE drive in Linux 2.5
+	Information regarding the Enhanced IDE drive in Linux 2.6

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

@@ -242,8 +242,23 @@
 			  and quite likely to cause trouble with
 			  older/odd IDE drives.

+ "hdx=biostimings"	: driver will NOT attempt to tune interface speed
+ 			  (DMA/PIO) but always honour BIOS timings.
+
  "hdx=slow"		: insert a huge pause after each access to the data
 			  port. Should be used only as a last resort.
+
+ "hdx=swapdata"		: when the drive is a disk, byte swap all data
+
+ "hdx=bswap"		: same as above..........
+
+ "hdx=flash"		: allows for more than one ata_flash disk to be
+ 			  registered. In most cases, only one device
+ 			  will be present.
+
+ "hdx=scsi"		: the return of the ide-scsi flag, this is useful for
+ 			  allowwing ide-floppy, ide-tape, and ide-cdrom|writers
+ 			  to use ide-scsi emulation on a device specific option.

  "hdxlun=xx"		: set the drive last logical unit

@@ -277,27 +292,41 @@
  "idex=noautotune"	: driver will NOT attempt to tune interface speed
 			  This is the default for most chipsets,
 			  except the cmd640.
+
+ "idex=biostimings"	: driver will NOT attempt to tune interface speed
+			  (DMA/PIO) but always honour BIOS timings.

  "idex=serialize"	: do not overlap operations on idex. Please note
 			  that you will have to specify this option for
 			  both the respecitve primary and secondary channel
 			  to take effect.
+
+ "idex=four"		: four drives on idex and ide(x^1) share same ports

  "idex=reset"		: reset interface after probe

  "idex=dma"		: automatically configure/use DMA if possible.

-The following are valid ONLY on ide0, which usually corresponds to the first
-ATA interface found on the particular host, and the defaults for the base,ctl
-ports must not be altered.
+ "idex=ata66"		: informs the interface that it has an 80c cable
+			  for chipsets that are ATA-66 capable, but the
+			  ability to bit test for detection is currently
+			  unknown.
+
+ "ide=reverse"		: formerly called to pci sub-system, but now local.
+
+The following are valid ONLY on ide0 (except dc4030), which usually corresponds
+to the first ATA interface found on the particular host, and the defaults for
+the base,ctl ports must not be altered.

  "ide0=dtc2278"		: probe/support DTC2278 interface
  "ide0=ht6560b"		: probe/support HT6560B interface
  "ide0=cmd640_vlb"	: *REQUIRED* for VLB cards with the CMD640 chip
 			  (not for PCI -- automatically detected)
  "ide0=qd65xx"		: probe/support qd65xx interface
- "ide0=ali14xx"		: probe/support ali14xx chipsets (ALI M1439/M1445)
+ "ide0=ali14xx"		: probe/support ali14xx chipsets (ALI M1439/M1443/M1445)
  "ide0=umc8672"		: probe/support umc8672 chipsets
+ "idex=dc4030"		: probe/support Promise DC4030VL interface
+ "ide=doubler"		: probe/support IDE doublers on Amiga

 There may be more options than shown -- use the source, Luke!

@@ -375,3 +404,6 @@

 Wed Apr 17 22:52:44 CEST 2002 edited by Marcin Dalecki, the current
 maintainer.
+
+Wed Aug 20 22:31:29 CEST 2003 updated ide boot uptions to current ide.c
+comments @ 2.6.0-test-bk8 time. Maciej Soltysiak <solt@dns.toxicfilms.tv>

Re: [PATCH 2.6][TRIVIAL] Update ide.txt documentation to current ide.c

[Martin Zwickel]

[-- Attachment #1: Type: text/plain, Size: 350 bytes --]

> + "hdx=scsi"		: the return of the ide-scsi flag, this is useful for
> + 			  allowwing ide-floppy, ide-tape, and ide-cdrom|writers
                              ^^ typo ...
-- 
MyExcuse:
We've picked COBOL as the language of choice.

Martin Zwickel <martin.zwickel@technotrend.de>
Research & Development

TechnoTrend AG <http://www.technotrend.de>

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [PATCH 2.6][TRIVIAL] Update ide.txt documentation to current ide.c

[Maciej Soltysiak]

> > + "hdx=scsi"		: the return of the ide-scsi flag, this is useful for
> > + 			  allowwing ide-floppy, ide-tape, and ide-cdrom|writers

:) I kind of copy/pasted it from drivers/ide/ide.c so also apply to
drivers/ide/ide.c this:

diff -u linux-2.6.0-test2/drivers/ide/ide.c linux-2.6.0-test3/drivers/ide/ide.c
--- linux-2.6.0-test2/drivers/ide/ide.c	2003-08-19 17:30:07.000000000 +0200
+++ linux-2.6.0-test3/drivers/ide/ide.c	2003-08-21 12:56:40.000000000 +0200
@@ -1880,7 +1880,7 @@
  *				registered. In most cases, only one device
  *				will be present.
  * "hdx=scsi"		: the return of the ide-scsi flag, this is useful for
- *				allowwing ide-floppy, ide-tape, and ide-cdrom|writers
+ *				allowing ide-floppy, ide-tape, and ide-cdrom|writers
  *				to use ide-scsi emulation on a device specific option.
  * "idebus=xx"		: inform IDE driver of VESA/PCI bus speed in MHz,
  *				where "xx" is between 20 and 66 inclusive,

Re: [PATCH 2.6][TRIVIAL] Update ide.txt documentation to current ide.c

[bill davidsen]

In article <20030821124807.700db5d3.martin.zwickel@technotrend.de>,
Martin Zwickel  <martin.zwickel@technotrend.de> wrote:
	[... snip ...]
| -- 
| MyExcuse:
| We've picked COBOL as the language of choice.
| 
| Martin Zwickel <martin.zwickel@technotrend.de>
| Research & Development
| 
| TechnoTrend AG <http://www.technotrend.de>

Programming COBOL is like having sex with your sister... you may do it
well and enjpy it greatly, but you don't want your mother to know.
-- 
bill davidsen <davidsen@tmr.com>
  CTO, TMR Associates, Inc
Doing interesting things with little computers since 1979.

Re: [PATCH 2.6][TRIVIAL] Update ide.txt documentation to current ide.c

[Alan Cox]

On Iau, 2003-08-21 at 11:30, Maciej Soltysiak wrote:
> + "hdx=biostimings"	: driver will NOT attempt to tune interface speed
> + 			  (DMA/PIO) but always honour BIOS timings.
> +

Please don't document this option except maybe as "Selecting this on
most systems will destroy all your data"

>   "hdx=slow"		: insert a huge pause after each access to the data
>  			  port. Should be used only as a last resort.

Should go - isnt supported any more

> + "hdx=flash"		: allows for more than one ata_flash disk to be
> + 			  registered. In most cases, only one device
> + 			  will be present.

Fixed properly in 2.4, dunno about 2.6

> +
> + "idex=biostimings"	: driver will NOT attempt to tune interface speed
> +			  (DMA/PIO) but always honour BIOS timings.

Replace with "generally randomizes your disk contents, do not ever use"

> + "ide=reverse"		: formerly called to pci sub-system, but now local.
> +

Better if it said what it did ?


Rest looks ok

Re: [PATCH 2.6][TRIVIAL] Update ide.txt documentation to current ide.c

[Maciej Soltysiak]

> >   "hdx=slow"		: insert a huge pause after each access to the data
> >  			  port. Should be used only as a last resort.
>
> Should go - isnt supported any more
So drivers/ide/ide.c should be updated too.

> > + "ide=reverse"		: formerly called to pci sub-system, but now local.
> > +
>
> Better if it said what it did ?
drivers/ide/ide.c says only this.

Maciej

Re: [PATCH 2.6][TRIVIAL] Update ide.txt documentation to current ide.c

[Alan Cox]

On Mer, 2003-08-27 at 17:41, Maciej Soltysiak wrote:
> > >   "hdx=slow"		: insert a huge pause after each access to the data
> > >  			  port. Should be used only as a last resort.
> >
> > Should go - isnt supported any more
> So drivers/ide/ide.c should be updated too.

Yes

> > > + "ide=reverse"		: formerly called to pci sub-system, but now local.
> > > +
> >
> > Better if it said what it did ?
> drivers/ide/ide.c says only this.

It reverses the order that interfaces are detected (and thus assigned
ide*). Or it used to. The hotplug changes may actually mean it doesn't 
do anything any more but that is easy to test.

ie if you had

ide0: AMD74xx 
ide1: PDC202xx

you'd get

ide0: PDC202xx
ide1: AMD74xx

with =reverse