From: Finn Thain <fthain@telegraphics.com.au> To: "James E.J. Bottomley" <James.Bottomley@HansenPartnership.com>, "Martin K. Petersen" <martin.petersen@oracle.com>, Michael Schmitz <schmitzmic@gmail.com>, <linux-m68k@vger.kernel.org>, <linux-scsi@vger.kernel.org>, <linux-kernel@vger.kernel.org>, Jonathan Corbet <corbet@lwn.net>, linux-doc@vger.kernel.org Cc: Ondrej Zary <linux@rainbow-software.org>, Sam Creasey <sammy@sammy.net> Subject: [PATCH 19/22] ncr5380: Update usage documentation Date: Mon, 14 Mar 2016 15:27:19 +1100 [thread overview] Message-ID: <20160314042705.596042088@telegraphics.com.au> (raw) In-Reply-To: 20160314042700.596192247@telegraphics.com.au [-- Attachment #1: ncr5380-update-documentation --] [-- Type: text/plain, Size: 5549 bytes --] Update kernel parameter documentation for atari_scsi, mac_scsi and g_NCR5380 drivers. Remove duplication. Signed-off-by: Finn Thain <fthain@telegraphics.com.au> --- Documentation/scsi/g_NCR5380.txt | 17 ++++++--------- Documentation/scsi/scsi-parameters.txt | 11 +++++++--- drivers/scsi/g_NCR5380.c | 36 --------------------------------- 3 files changed, 16 insertions(+), 48 deletions(-) Index: linux/Documentation/scsi/scsi-parameters.txt =================================================================== --- linux.orig/Documentation/scsi/scsi-parameters.txt 2016-03-14 15:17:24.000000000 +1100 +++ linux/Documentation/scsi/scsi-parameters.txt 2016-03-14 15:26:54.000000000 +1100 @@ -27,13 +27,15 @@ parameters may be changed at runtime by aic79xx= [HW,SCSI] See Documentation/scsi/aic79xx.txt. - atascsi= [HW,SCSI] Atari SCSI + atascsi= [HW,SCSI] + See drivers/scsi/atari_scsi.c. BusLogic= [HW,SCSI] See drivers/scsi/BusLogic.c, comment before function BusLogic_ParseDriverOptions(). dtc3181e= [HW,SCSI] + See Documentation/scsi/g_NCR5380.txt. eata= [HW,SCSI] @@ -51,8 +53,8 @@ parameters may be changed at runtime by ips= [HW,SCSI] Adaptec / IBM ServeRAID controller See header of drivers/scsi/ips.c. - mac5380= [HW,SCSI] Format: - <can_queue>,<cmd_per_lun>,<sg_tablesize>,<hostid>,<use_tags> + mac5380= [HW,SCSI] + See drivers/scsi/mac_scsi.c. max_luns= [SCSI] Maximum number of LUNs to probe. Should be between 1 and 2^32-1. @@ -65,10 +67,13 @@ parameters may be changed at runtime by See header of drivers/scsi/NCR_D700.c. ncr5380= [HW,SCSI] + See Documentation/scsi/g_NCR5380.txt. ncr53c400= [HW,SCSI] + See Documentation/scsi/g_NCR5380.txt. ncr53c400a= [HW,SCSI] + See Documentation/scsi/g_NCR5380.txt. ncr53c406a= [HW,SCSI] Index: linux/Documentation/scsi/g_NCR5380.txt =================================================================== --- linux.orig/Documentation/scsi/g_NCR5380.txt 2016-03-14 15:17:24.000000000 +1100 +++ linux/Documentation/scsi/g_NCR5380.txt 2016-03-14 15:26:54.000000000 +1100 @@ -23,11 +23,10 @@ supported by the driver. If the default configuration does not work for you, you can use the kernel command lines (eg using the lilo append command): - ncr5380=port,irq,dma - ncr53c400=port,irq -or - ncr5380=base,irq,dma - ncr53c400=base,irq + ncr5380=addr,irq + ncr53c400=addr,irq + ncr53c400a=addr,irq + dtc3181e=addr,irq The driver does not probe for any addresses or ports other than those in the OVERRIDE or given to the kernel as above. @@ -36,19 +35,17 @@ This driver provides some information on /proc/scsi/g_NCR5380/x where x is the scsi card number as detected at boot time. More info to come in the future. -When NCR53c400 support is compiled in, BIOS parameters will be returned by -the driver (the raw 5380 driver does not and I don't plan to fiddle with -it!). - This driver works as a module. When included as a module, parameters can be passed on the insmod/modprobe command line: ncr_irq=xx the interrupt ncr_addr=xx the port or base address (for port or memory mapped, resp.) - ncr_dma=xx the DMA ncr_5380=1 to set up for a NCR5380 board ncr_53c400=1 to set up for a NCR53C400 board + ncr_53c400a=1 to set up for a NCR53C400A board + dtc_3181e=1 to set up for a Domex Technology Corp 3181E board + hp_c2502=1 to set up for a Hewlett Packard C2502 board e.g. modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_5380=1 for a port mapped NCR5380 board or Index: linux/drivers/scsi/g_NCR5380.c =================================================================== --- linux.orig/drivers/scsi/g_NCR5380.c 2016-03-14 15:26:52.000000000 +1100 +++ linux/drivers/scsi/g_NCR5380.c 2016-03-14 15:26:54.000000000 +1100 @@ -18,42 +18,8 @@ * * Added ISAPNP support for DTC436 adapters, * Thomas Sailer, sailer@ife.ee.ethz.ch - */ - -/* - * TODO : flesh out DMA support, find some one actually using this (I have - * a memory mapped Trantor board that works fine) - */ - -/* - * The card is detected and initialized in one of several ways : - * 1. With command line overrides - NCR5380=port,irq may be - * used on the LILO command line to override the defaults. - * - * 2. With the GENERIC_NCR5380_OVERRIDE compile time define. This is - * specified as an array of address, irq, dma, board tuples. Ie, for - * one board at 0x350, IRQ5, no dma, I could say - * -DGENERIC_NCR5380_OVERRIDE={{0xcc000, 5, DMA_NONE, BOARD_NCR5380}} - * - * -1 should be specified for no or DMA interrupt, -2 to autoprobe for an - * IRQ line if overridden on the command line. * - * 3. When included as a module, with arguments passed on the command line: - * ncr_irq=xx the interrupt - * ncr_addr=xx the port or base address (for port or memory - * mapped, resp.) - * ncr_dma=xx the DMA - * ncr_5380=1 to set up for a NCR5380 board - * ncr_53c400=1 to set up for a NCR53C400 board - * e.g. - * modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_5380=1 - * for a port mapped NCR5380 board or - * modprobe g_NCR5380 ncr_irq=255 ncr_addr=0xc8000 ncr_53c400=1 - * for a memory mapped NCR53C400 board with interrupts disabled. - * - * 255 should be specified for no or DMA interrupt, 254 to autoprobe for an - * IRQ line if overridden on the command line. - * + * See Documentation/scsi/g_NCR5380.txt for more info. */ #include <asm/io.h>
WARNING: multiple messages have this Message-ID (diff)
From: Finn Thain <fthain@telegraphics.com.au> To: "James E.J. Bottomley" <James.Bottomley@HansenPartnership.com>, "Martin K. Petersen" <martin.petersen@oracle.com>, Michael Schmitz <schmitzmic@gmail.com>, linux-m68k@vger.kernel.org, linux-scsi@vger.kernel.org, linux-kernel@vger.kernel.org, Jonathan Corbet <corbet@lwn.net>, linux-doc@vger.kernel.org Cc: Ondrej Zary <linux@rainbow-software.org>, Sam Creasey <sammy@sammy.net> Subject: [PATCH 19/22] ncr5380: Update usage documentation Date: Mon, 14 Mar 2016 15:27:19 +1100 [thread overview] Message-ID: <20160314042705.596042088@telegraphics.com.au> (raw) In-Reply-To: 20160314042700.596192247@telegraphics.com.au [-- Attachment #1: ncr5380-update-documentation --] [-- Type: text/plain, Size: 5549 bytes --] Update kernel parameter documentation for atari_scsi, mac_scsi and g_NCR5380 drivers. Remove duplication. Signed-off-by: Finn Thain <fthain@telegraphics.com.au> --- Documentation/scsi/g_NCR5380.txt | 17 ++++++--------- Documentation/scsi/scsi-parameters.txt | 11 +++++++--- drivers/scsi/g_NCR5380.c | 36 --------------------------------- 3 files changed, 16 insertions(+), 48 deletions(-) Index: linux/Documentation/scsi/scsi-parameters.txt =================================================================== --- linux.orig/Documentation/scsi/scsi-parameters.txt 2016-03-14 15:17:24.000000000 +1100 +++ linux/Documentation/scsi/scsi-parameters.txt 2016-03-14 15:26:54.000000000 +1100 @@ -27,13 +27,15 @@ parameters may be changed at runtime by aic79xx= [HW,SCSI] See Documentation/scsi/aic79xx.txt. - atascsi= [HW,SCSI] Atari SCSI + atascsi= [HW,SCSI] + See drivers/scsi/atari_scsi.c. BusLogic= [HW,SCSI] See drivers/scsi/BusLogic.c, comment before function BusLogic_ParseDriverOptions(). dtc3181e= [HW,SCSI] + See Documentation/scsi/g_NCR5380.txt. eata= [HW,SCSI] @@ -51,8 +53,8 @@ parameters may be changed at runtime by ips= [HW,SCSI] Adaptec / IBM ServeRAID controller See header of drivers/scsi/ips.c. - mac5380= [HW,SCSI] Format: - <can_queue>,<cmd_per_lun>,<sg_tablesize>,<hostid>,<use_tags> + mac5380= [HW,SCSI] + See drivers/scsi/mac_scsi.c. max_luns= [SCSI] Maximum number of LUNs to probe. Should be between 1 and 2^32-1. @@ -65,10 +67,13 @@ parameters may be changed at runtime by See header of drivers/scsi/NCR_D700.c. ncr5380= [HW,SCSI] + See Documentation/scsi/g_NCR5380.txt. ncr53c400= [HW,SCSI] + See Documentation/scsi/g_NCR5380.txt. ncr53c400a= [HW,SCSI] + See Documentation/scsi/g_NCR5380.txt. ncr53c406a= [HW,SCSI] Index: linux/Documentation/scsi/g_NCR5380.txt =================================================================== --- linux.orig/Documentation/scsi/g_NCR5380.txt 2016-03-14 15:17:24.000000000 +1100 +++ linux/Documentation/scsi/g_NCR5380.txt 2016-03-14 15:26:54.000000000 +1100 @@ -23,11 +23,10 @@ supported by the driver. If the default configuration does not work for you, you can use the kernel command lines (eg using the lilo append command): - ncr5380=port,irq,dma - ncr53c400=port,irq -or - ncr5380=base,irq,dma - ncr53c400=base,irq + ncr5380=addr,irq + ncr53c400=addr,irq + ncr53c400a=addr,irq + dtc3181e=addr,irq The driver does not probe for any addresses or ports other than those in the OVERRIDE or given to the kernel as above. @@ -36,19 +35,17 @@ This driver provides some information on /proc/scsi/g_NCR5380/x where x is the scsi card number as detected at boot time. More info to come in the future. -When NCR53c400 support is compiled in, BIOS parameters will be returned by -the driver (the raw 5380 driver does not and I don't plan to fiddle with -it!). - This driver works as a module. When included as a module, parameters can be passed on the insmod/modprobe command line: ncr_irq=xx the interrupt ncr_addr=xx the port or base address (for port or memory mapped, resp.) - ncr_dma=xx the DMA ncr_5380=1 to set up for a NCR5380 board ncr_53c400=1 to set up for a NCR53C400 board + ncr_53c400a=1 to set up for a NCR53C400A board + dtc_3181e=1 to set up for a Domex Technology Corp 3181E board + hp_c2502=1 to set up for a Hewlett Packard C2502 board e.g. modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_5380=1 for a port mapped NCR5380 board or Index: linux/drivers/scsi/g_NCR5380.c =================================================================== --- linux.orig/drivers/scsi/g_NCR5380.c 2016-03-14 15:26:52.000000000 +1100 +++ linux/drivers/scsi/g_NCR5380.c 2016-03-14 15:26:54.000000000 +1100 @@ -18,42 +18,8 @@ * * Added ISAPNP support for DTC436 adapters, * Thomas Sailer, sailer@ife.ee.ethz.ch - */ - -/* - * TODO : flesh out DMA support, find some one actually using this (I have - * a memory mapped Trantor board that works fine) - */ - -/* - * The card is detected and initialized in one of several ways : - * 1. With command line overrides - NCR5380=port,irq may be - * used on the LILO command line to override the defaults. - * - * 2. With the GENERIC_NCR5380_OVERRIDE compile time define. This is - * specified as an array of address, irq, dma, board tuples. Ie, for - * one board at 0x350, IRQ5, no dma, I could say - * -DGENERIC_NCR5380_OVERRIDE={{0xcc000, 5, DMA_NONE, BOARD_NCR5380}} - * - * -1 should be specified for no or DMA interrupt, -2 to autoprobe for an - * IRQ line if overridden on the command line. * - * 3. When included as a module, with arguments passed on the command line: - * ncr_irq=xx the interrupt - * ncr_addr=xx the port or base address (for port or memory - * mapped, resp.) - * ncr_dma=xx the DMA - * ncr_5380=1 to set up for a NCR5380 board - * ncr_53c400=1 to set up for a NCR53C400 board - * e.g. - * modprobe g_NCR5380 ncr_irq=5 ncr_addr=0x350 ncr_5380=1 - * for a port mapped NCR5380 board or - * modprobe g_NCR5380 ncr_irq=255 ncr_addr=0xc8000 ncr_53c400=1 - * for a memory mapped NCR53C400 board with interrupts disabled. - * - * 255 should be specified for no or DMA interrupt, 254 to autoprobe for an - * IRQ line if overridden on the command line. - * + * See Documentation/scsi/g_NCR5380.txt for more info. */ #include <asm/io.h>
next prev parent reply other threads:[~2016-03-14 4:43 UTC|newest] Thread overview: 100+ messages / expand[flat|nested] mbox.gz Atom feed top 2016-03-14 4:27 [PATCH 00/22] ncr5380: Eliminate macros, reduce code duplication, fix bugs etc Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 4:27 ` [PATCH 01/22] g_ncr5380: Remove CONFIG_SCSI_GENERIC_NCR53C400 Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:21 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 02/22] ncr5380: Remove FLAG_NO_PSEUDO_DMA where possible Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:21 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 03/22] ncr5380: Remove REAL_DMA and REAL_DMA_POLL macros Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:23 ` Hannes Reinecke 2016-03-14 7:23 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 04/22] atari_NCR5380: Remove DMA_MIN_SIZE macro Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:25 ` Hannes Reinecke 2016-03-14 7:25 ` Hannes Reinecke 2016-03-15 3:18 ` Finn Thain 2016-03-14 4:27 ` [PATCH 05/22] ncr5380: Disable the DMA errata workaround flag by default Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:26 ` Hannes Reinecke 2016-03-14 7:26 ` Hannes Reinecke 2016-03-14 7:26 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 06/22] ncr5380: Remove PSEUDO_DMA macro Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:28 ` Hannes Reinecke 2016-03-14 7:28 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 07/22] ncr5380: Remove BOARD_REQUIRES_NO_DELAY macro Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:33 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 08/22] ncr5380: Use DMA hooks for PDMA Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:34 ` Hannes Reinecke 2016-03-14 7:34 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 09/22] ncr5380: Adopt uniform DMA setup convention Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:36 ` Hannes Reinecke 2016-03-14 7:36 ` Hannes Reinecke 2016-03-15 3:19 ` Finn Thain 2016-03-15 3:19 ` Finn Thain 2016-03-15 6:49 ` Hannes Reinecke 2016-03-15 6:49 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 10/22] ncr5380: Merge DMA implementation from atari_NCR5380 core driver Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:38 ` Hannes Reinecke 2016-03-14 7:38 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 11/22] atari_scsi: Adopt NCR5380.c " Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:39 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 12/22] sun3_scsi: " Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:40 ` Hannes Reinecke 2016-03-14 7:40 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 13/22] ncr5380: Remove disused atari_NCR5380.c " Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:42 ` Hannes Reinecke 2016-03-14 7:42 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 14/22] ncr5380: Add MAX_LUN limit Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:43 ` Hannes Reinecke 2016-03-14 7:51 ` Christoph Hellwig 2016-03-15 3:20 ` Finn Thain 2016-03-15 8:26 ` Christoph Hellwig 2016-03-14 4:27 ` [PATCH 15/22] dmx3191d: Drop max_sectors limit Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:43 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 16/22] ncr5380: Fix register decoding for debugging Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:46 ` Hannes Reinecke 2016-03-15 3:21 ` Finn Thain 2016-03-14 4:27 ` [PATCH 17/22] ncr5380: Remove remaining register storage qualifiers Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:46 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 18/22] ncr5380: Remove DONT_USE_INTR and AUTOPROBE_IRQ macros Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:47 ` Hannes Reinecke 2016-03-14 7:47 ` Hannes Reinecke 2016-03-14 4:27 ` Finn Thain [this message] 2016-03-14 4:27 ` [PATCH 19/22] ncr5380: Update usage documentation Finn Thain 2016-03-14 7:47 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 20/22] atari_scsi: Set a reasonable default for cmd_per_lun Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:49 ` Hannes Reinecke 2016-03-15 3:27 ` Finn Thain 2016-03-15 6:53 ` Hannes Reinecke 2016-03-15 8:27 ` Finn Thain 2016-03-15 14:34 ` James Bottomley 2016-03-14 4:27 ` [PATCH 21/22] atari_scsi: Allow can_queue to be increased for Falcon Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:58 ` Hannes Reinecke 2016-03-14 7:58 ` Hannes Reinecke 2016-03-14 4:27 ` [PATCH 22/22] mac_scsi: Fix pseudo DMA implementation Finn Thain 2016-03-14 4:27 ` Finn Thain 2016-03-14 7:59 ` Hannes Reinecke 2016-03-18 7:03 ` [PATCH 00/22] ncr5380: Eliminate macros, reduce code duplication, fix bugs etc Michael Schmitz
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=20160314042705.596042088@telegraphics.com.au \ --to=fthain@telegraphics.com.au \ --cc=James.Bottomley@HansenPartnership.com \ --cc=corbet@lwn.net \ --cc=linux-doc@vger.kernel.org \ --cc=linux-kernel@vger.kernel.org \ --cc=linux-m68k@vger.kernel.org \ --cc=linux-scsi@vger.kernel.org \ --cc=linux@rainbow-software.org \ --cc=martin.petersen@oracle.com \ --cc=sammy@sammy.net \ --cc=schmitzmic@gmail.com \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.