[PATCH update] SCSI: update Kconfig help text to indicate SCSI core's widespread usage

!MAILaRCHIVE_VOTE_RePLACE
Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]
To: Lennart Sorensen <lsorense@...>
Cc: James Bottomley <james.bottomley@...>, <linux-scsi@...>, Jeff Garzik <jeff@...>, Andi Kleen <andi@...>, Folkert van Heusden <folkert@...>, Adrian Bunk <bunk@...>, <linux-kernel@...>
Date: Friday, September 14, 2007 - 5:14 pm

Signed-off-by: Stefan Richter <stefanr@s5r6.in-berlin.de>
---

And one more update:
There is SAS too, and I forgot 'is' in "on a disk which __ accessed via".

 drivers/scsi/Kconfig |   67 ++++++++++++++++++++++---------------------
 1 file changed, 35 insertions(+), 32 deletions(-)

Index: linux-2.6.23-rc6/drivers/scsi/Kconfig
===================================================================
--- linux-2.6.23-rc6.orig/drivers/scsi/Kconfig
+++ linux-2.6.23-rc6/drivers/scsi/Kconfig
@@ -12,23 +12,31 @@ config SCSI
 	depends on BLOCK
 	select SCSI_DMA if HAS_DMA
 	---help---
-	  If you want to use a SCSI hard disk, SCSI tape drive, SCSI CD-ROM or
-	  any other SCSI device under Linux, say Y and make sure that you know
-	  the name of your SCSI host adapter (the card inside your computer
-	  that "speaks" the SCSI protocol, also called SCSI controller),
-	  because you will be asked for it.
-
-	  You also need to say Y here if you have a device which speaks
-	  the SCSI protocol.  Examples of this include the parallel port
-	  version of the IOMEGA ZIP drive, USB storage devices, Fibre
-	  Channel, FireWire storage and the IDE-SCSI emulation driver.
+	  This option enables core support for SCSI protocols.
+	  You need it
+	  - for classic parallel SCSI hardware,
+	  - for newer SCSI transports such as Fibre Channel, FireWire storage,
+	    SAS, or iSCSI,
+	  - for non-SCSI hardware which speaks SCSI protocols, such as USB
+	    storage devices or the parallel port version of Iomega Zip drive,
+	  - for non-SCSI hardware whose drivers translate from and to SCSI
+	    protocols, most notably all Serial ATA drivers, and Parallel ATA
+	    via the ATA configuration option.
 
 	  To compile this driver as a module, choose M here and read
 	  <file:Documentation/scsi/scsi.txt>.
 	  The module will be called scsi_mod.
 
 	  However, do not compile this as a module if your root file system
-	  (the one containing the directory /) is located on a SCSI device.
+	  (the one containing the directory /) is located on a SCSI device
+	  or on a device whose driver represents it as SCSI device, as
+	  indicated above.  Choose Y in this case, or set up an initrd.
+
+	  Subsequent options in this menu enable specific SCSI command set
+	  support for harddisks, CD/DVD-ROM/R/W, tapes etc..  This menu also
+	  presents options for specific SCSI controllers, while options for
+	  some other SCSI transports and all non-SCSI controllers are located
+	  in other menus (SATA, USB, FireWire etc.).
 
 config SCSI_DMA
 	bool
@@ -57,32 +65,27 @@ config SCSI_PROC_FS
 
 	  If unsure say Y.
 
-comment "SCSI support type (disk, tape, CD-ROM)"
+comment "SCSI command set drivers (disk, tape, CD-ROM)"
 	depends on SCSI
 
 config BLK_DEV_SD
-	tristate "SCSI disk support"
+	tristate "Harddisks and other Direct access devices"
 	depends on SCSI
 	---help---
-	  If you want to use SCSI hard disks, Fibre Channel disks,
-	  Serial ATA (SATA) or Parallel ATA (PATA) hard disks,
-	  USB storage or the SCSI or parallel port version of
-	  the IOMEGA ZIP drive, say Y and read the SCSI-HOWTO,
-	  the Disk-HOWTO and the Multi-Disk-HOWTO, available from
-	  <http://www.tldp.org/docs.html#howto>. This is NOT for SCSI
-	  CD-ROMs.
+	  Say Y if you want to use harddisks and similar block-oriented devices
+	  via SCSI or via drivers which use SCSI command sets (e.g. the Serial
+	  and Parallel ATA kernel subsystem, USB, and more).
 
 	  To compile this driver as a module, choose M here and read
 	  <file:Documentation/scsi/scsi.txt>.
 	  The module will be called sd_mod.
 
-	  Do not compile this driver as a module if your root file system
-	  (the one containing the directory /) is located on a SCSI disk.
-	  In this case, do not compile the driver for your SCSI host adapter
-	  (below) as a module either.
+	  If your root file system (the one containing the directory /) is
+	  located on a disk which is accessed via this driver, choose Y rather
+	  than M or set up a suitable initrd.
 
 config CHR_DEV_ST
-	tristate "SCSI tape support"
+	tristate "Tape drives"
 	depends on SCSI
 	---help---
 	  If you want to use a SCSI tape drive under Linux, say Y and read the
@@ -95,7 +98,7 @@ config CHR_DEV_ST
 	  <file:Documentation/scsi/scsi.txt>. The module will be called st.
 
 config CHR_DEV_OSST
-	tristate "SCSI OnStream SC-x0 tape support"
+	tristate "SCSI OnStream SC-x0 tape drives"
 	depends on SCSI
 	---help---
 	  The OnStream SC-x0 SCSI tape drives cannot be driven by the
@@ -117,13 +120,13 @@ config CHR_DEV_OSST
 	  <file:Documentation/scsi/scsi.txt>. The module will be called osst.
 
 config BLK_DEV_SR
-	tristate "SCSI CDROM support"
+	tristate "CD-ROMs, DVD-ROMs"
 	depends on SCSI
 	---help---
-	  If you want to use a SCSI or FireWire CD-ROM under Linux,
-	  say Y and read the SCSI-HOWTO and the CDROM-HOWTO at
-	  <http://www.tldp.org/docs.html#howto>. Also make sure to say
-	  Y or M to "ISO 9660 CD-ROM file system support" later.
+	  Say Y if you want to use CD-ROMs or DVD-ROMs via SCSI or via drivers
+	  which use SCSI command sets (e.g. the Serial and Parallel ATA kernel
+	  subsystem, USB, and more). Also make sure to say Y or M to "ISO 9660
+	  CD-ROM file system support" later.
 
 	  To compile this driver as a module, choose M here and read
 	  <file:Documentation/scsi/scsi.txt>.
@@ -164,7 +167,7 @@ config CHR_DEV_SG
 	  If unsure, say N.
 
 config CHR_DEV_SCH
-	tristate "SCSI media changer support"
+	tristate "SCSI media changers"
 	depends on SCSI
 	---help---
 	  This is a driver for SCSI media changers.  Most common devices are

-- 
Stefan Richter
-=====-=-=== =--= -===-
http://arcgraph.de/sr/

-
Previous message: [thread] [date] [author]
Next message: [thread] [date] [author]

Messages in current thread:
sata &amp; scsi suggestion for make menuconfig, Folkert van Heusden, (Fri Sep 7, 8:48 am)
Re: sata &amp; scsi suggestion for make menuconfig, Andi Kleen, (Sat Sep 8, 12:07 pm)
Re: sata &amp; scsi suggestion for make menuconfig, James Bottomley, (Sun Sep 9, 5:00 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Andi Kleen, (Sun Sep 9, 5:03 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Jeff Garzik, (Sun Sep 9, 5:11 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Adrian Bunk, (Wed Sep 12, 6:46 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Fri Sep 14, 10:54 am)
Re: sata &amp; scsi suggestion for make menuconfig, Adrian Bunk, (Fri Sep 14, 11:15 am)
Re: sata &amp; scsi suggestion for make menuconfig, Paul Rolland, (Sat Sep 15, 4:04 am)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Sat Sep 15, 4:25 am)
Re: sata &amp; scsi suggestion for make menuconfig, Paul Rolland, (Sat Sep 15, 9:00 am)
[PATCH] x86_64: configure HPET_EMULATE_RTC automatically, Stefan Richter, (Sat Sep 15, 1:13 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Fri Sep 14, 11:37 am)
Re: sata &amp; scsi suggestion for make menuconfig, Adrian Bunk, (Fri Sep 14, 12:16 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Fri Sep 14, 12:50 pm)
[PATCH update] SCSI: update Kconfig help text to indicate SC..., Stefan Richter, (Fri Sep 14, 5:14 pm)
[RFC PATCH] SCSI: split Kconfig menu into two, Stefan Richter, (Fri Sep 14, 2:02 pm)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Stefan Richter, (Fri Sep 14, 4:20 pm)
[PATCH update] SCSI: split Kconfig menu into two, Stefan Richter, (Fri Sep 14, 5:22 pm)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Sam Ravnborg, (Fri Sep 14, 3:00 pm)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Adrian Bunk, (Fri Sep 14, 3:06 pm)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Stefan Richter, (Fri Sep 14, 4:01 pm)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Adrian Bunk, (Sat Sep 15, 7:40 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Stefan Richter, (Sat Sep 15, 8:24 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Maciej W. Rozycki, (Mon Sep 17, 7:29 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Stefan Richter, (Mon Sep 17, 10:46 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Adrian Bunk, (Sat Sep 15, 8:50 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Stefan Richter, (Sat Sep 15, 9:20 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Adrian Bunk, (Sat Sep 15, 9:53 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Stefan Richter, (Sat Sep 15, 10:11 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Adrian Bunk, (Sat Sep 15, 10:43 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Stefan Richter, (Sat Sep 15, 11:27 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Adrian Bunk, (Sat Sep 15, 12:42 pm)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Jeff Garzik, (Sat Sep 15, 11:44 am)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Adrian Bunk, (Sat Sep 15, 12:23 pm)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Bartlomiej Zolnierkiewicz..., (Sat Sep 15, 12:52 pm)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Jeff Garzik, (Sat Sep 15, 3:17 pm)
Re: [RFC PATCH] SCSI: split Kconfig menu into two, Bartlomiej Zolnierkiewicz..., (Sat Sep 15, 4:54 pm)
[PATCH] SCSI: trailing whitespace in Kconfig, Stefan Richter, (Fri Sep 14, 2:04 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Andi Kleen, (Sun Sep 9, 5:22 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Bauke Jan Douma, (Tue Sep 11, 4:16 pm)
Re: sata &amp; scsi suggestion for make menuconfig, James Bottomley, (Sun Sep 9, 5:39 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Mon Sep 10, 2:38 am)
Re: sata &amp; scsi suggestion for make menuconfig, Rene Herman, (Mon Sep 10, 8:43 am)
Re: sata &amp; scsi suggestion for make menuconfig, Randy Dunlap, (Sat Sep 8, 12:50 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Andi Kleen, (Sat Sep 8, 2:13 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Sat Sep 8, 2:30 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Andi Kleen, (Sat Sep 8, 3:14 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Sat Sep 8, 3:32 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Matthew Wilcox, (Sat Sep 8, 12:53 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Randy Dunlap, (Fri Sep 7, 11:35 am)
Re: sata &amp; scsi suggestion for make menuconfig, Helge Hafting, (Thu Sep 13, 4:50 am)
Re: sata &amp; scsi suggestion for make menuconfig, Goswin von Brederlow, (Fri Sep 14, 12:42 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Fri Sep 14, 2:44 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Sam Ravnborg, (Sat Sep 8, 4:43 am)
Re: sata &amp; scsi suggestion for make menuconfig, Folkert van Heusden, (Fri Sep 7, 11:59 am)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Fri Sep 7, 12:21 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Folkert van Heusden, (Fri Sep 7, 7:05 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Sat Sep 8, 3:05 am)
Re: sata &amp; scsi suggestion for make menuconfig, Randy Dunlap, (Sat Sep 8, 12:31 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Sat Sep 8, 12:44 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Randy Dunlap, (Sat Sep 8, 12:48 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Sat Sep 8, 3:45 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Jan Engelhardt, (Sat Sep 8, 3:29 am)
Re: sata &amp; scsi suggestion for make menuconfig, Stefan Richter, (Sat Sep 8, 3:56 am)
Re: sata &amp; scsi suggestion for make menuconfig, Jan Engelhardt, (Fri Sep 7, 10:40 am)
Re: sata &amp; scsi suggestion for make menuconfig, Folkert van Heusden, (Fri Sep 7, 10:58 am)
Re: sata &amp; scsi suggestion for make menuconfig, Krzysztof Halasa, (Fri Sep 7, 3:38 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Jan Engelhardt, (Fri Sep 7, 7:02 pm)
Re: sata &amp; scsi suggestion for make menuconfig, Jan Engelhardt, (Sat Sep 8, 3:27 am)