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

Stefan Richter
2007-09-14T21:06:44Z

On 14 Sep, Lennart Sorensen wrote:
> On Fri, Sep 14, 2007 at 10:14:16PM +0200, Stefan Richter wrote:
>> - If you want to use a SCSI or FireWire CD-ROM under Linux,
>> + If you want to use a SCSI, SATA, USB or FireWire CD-ROM or DVD-ROM,
>> 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.
>
> How about that one for libata driven PATA CDROM drives? Could replace
> SATA with libata, or something similar.

From: Stefan Richter <stefanr@s5r6.in-berlin.de>
Subject: SCSI: update Kconfig help text to indicate SCSI core's widespread usage

Signed-off-by: Stefan Richter <stefanr@s5r6.in-berlin.de>
---
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,
+ 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 accessed via this driver, choose Y instead of
+ 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
-=====-=-=== =--= -===-