From: Masanori Goto <gotom@debian.or.jp>
To: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Cc: Linux Doc Mailing List <linux-doc@vger.kernel.org>,
linux-kernel@vger.kernel.org, Jonathan Corbet <corbet@lwn.net>,
YOKOTA Hiroshi <yokota@netlab.is.tsukuba.ac.jp>,
"James E.J. Bottomley" <jejb@linux.ibm.com>,
"Martin K. Petersen" <martin.petersen@oracle.com>,
linux-scsi@vger.kernel.org
Subject: Re: [PATCH 24/42] docs: scsi: convert NinjaSCSI.txt to ReST
Date: Wed, 11 Mar 2020 22:06:25 +0900 [thread overview]
Message-ID: <CALZLnaHY7rtLXHNmUv77Sj6X06MGXoR_cXBmABp_CockmMJM+A@mail.gmail.com> (raw)
In-Reply-To: <6385a411d000dad005b78647629e43700580ecf0.1583136624.git.mchehab+huawei@kernel.org>
2020年3月2日(月) 17:17 Mauro Carvalho Chehab <mchehab+huawei@kernel.org>:
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Acked-by: GOTO Masanori <gotom@debian.or.jp>
> ---
> .../scsi/{NinjaSCSI.txt => NinjaSCSI.rst} | 198 +++++++++++-------
> Documentation/scsi/index.rst | 1 +
> MAINTAINERS | 4 +-
> drivers/scsi/pcmcia/Kconfig | 2 +-
> 4 files changed, 121 insertions(+), 84 deletions(-)
> rename Documentation/scsi/{NinjaSCSI.txt => NinjaSCSI.rst} (28%)
>
> diff --git a/Documentation/scsi/NinjaSCSI.txt b/Documentation/scsi/NinjaSCSI.rst
> similarity index 28%
> rename from Documentation/scsi/NinjaSCSI.txt
> rename to Documentation/scsi/NinjaSCSI.rst
> index ac8db8ceec77..999a6ed5bf7e 100644
> --- a/Documentation/scsi/NinjaSCSI.txt
> +++ b/Documentation/scsi/NinjaSCSI.rst
> @@ -1,127 +1,163 @@
> +.. SPDX-License-Identifier: GPL-2.0
>
> - WorkBiT NinjaSCSI-3/32Bi driver for Linux
> +=========================================
> +WorkBiT NinjaSCSI-3/32Bi driver for Linux
> +=========================================
>
> 1. Comment
> - This is Workbit corp.'s(http://www.workbit.co.jp/) NinjaSCSI-3
> +==========
> +
> +This is Workbit corp.'s(http://www.workbit.co.jp/) NinjaSCSI-3
> for Linux.
>
> 2. My Linux environment
> -Linux kernel: 2.4.7 / 2.2.19
> -pcmcia-cs: 3.1.27
> -gcc: gcc-2.95.4
> -PC card: I-O data PCSC-F (NinjaSCSI-3)
> - I-O data CBSC-II in 16 bit mode (NinjaSCSI-32Bi)
> -SCSI device: I-O data CDPS-PX24 (CD-ROM drive)
> - Media Intelligent MMO-640GT (Optical disk drive)
> +=======================
> +
> +:Linux kernel: 2.4.7 / 2.2.19
> +:pcmcia-cs: 3.1.27
> +:gcc: gcc-2.95.4
> +:PC card: I-O data PCSC-F (NinjaSCSI-3),
> + I-O data CBSC-II in 16 bit mode (NinjaSCSI-32Bi)
> +:SCSI device: I-O data CDPS-PX24 (CD-ROM drive),
> + Media Intelligent MMO-640GT (Optical disk drive)
>
> 3. Install
> -[1] Check your PC card is true "NinjaSCSI-3" card.
> +==========
> +
> +(a) Check your PC card is true "NinjaSCSI-3" card.
> +
> If you installed pcmcia-cs already, pcmcia reports your card as UNKNOWN
> card, and write ["WBT", "NinjaSCSI-3", "R1.0"] or some other string to
> your console or log file.
> +
> You can also use "cardctl" program (this program is in pcmcia-cs source
> code) to get more info.
>
> -# cat /var/log/messages
> -...
> -Jan 2 03:45:06 lindberg cardmgr[78]: unsupported card in socket 1
> -Jan 2 03:45:06 lindberg cardmgr[78]: product info: "WBT", "NinjaSCSI-3", "R1.0"
> -...
> -# cardctl ident
> -Socket 0:
> - no product info available
> -Socket 1:
> - product info: "IO DATA", "CBSC16 ", "1"
> + ::
>
> + # cat /var/log/messages
> + ...
> + Jan 2 03:45:06 lindberg cardmgr[78]: unsupported card in socket 1
> + Jan 2 03:45:06 lindberg cardmgr[78]: product info: "WBT", "NinjaSCSI-3", "R1.0"
> + ...
> + # cardctl ident
> + Socket 0:
> + no product info available
> + Socket 1:
> + product info: "IO DATA", "CBSC16 ", "1"
>
> -[2] Get the Linux kernel source, and extract it to /usr/src.
> +
> +(b) Get the Linux kernel source, and extract it to /usr/src.
> Because the NinjaSCSI driver requires some SCSI header files in Linux
> kernel source, I recommend rebuilding your kernel; this eliminates
> some versioning problems.
> -$ cd /usr/src
> -$ tar -zxvf linux-x.x.x.tar.gz
> -$ cd linux
> -$ make config
> -...
>
> -[3] If you use this driver with Kernel 2.2, unpack pcmcia-cs in some directory
> + ::
> +
> + $ cd /usr/src
> + $ tar -zxvf linux-x.x.x.tar.gz
> + $ cd linux
> + $ make config
> + ...
> +
> +(c) If you use this driver with Kernel 2.2, unpack pcmcia-cs in some directory
> and make & install. This driver requires the pcmcia-cs header file.
> -$ cd /usr/src
> -$ tar zxvf cs-pcmcia-cs-3.x.x.tar.gz
> -...
>
> -[4] Extract this driver's archive somewhere, and edit Makefile, then do make.
> -$ tar -zxvf nsp_cs-x.x.tar.gz
> -$ cd nsp_cs-x.x
> -$ emacs Makefile
> -...
> -$ make
> + ::
>
> -[5] Copy nsp_cs.ko to suitable place, like /lib/modules/<Kernel version>/pcmcia/ .
> + $ cd /usr/src
> + $ tar zxvf cs-pcmcia-cs-3.x.x.tar.gz
> + ...
> +
> +(d) Extract this driver's archive somewhere, and edit Makefile, then do make::
> +
> + $ tar -zxvf nsp_cs-x.x.tar.gz
> + $ cd nsp_cs-x.x
> + $ emacs Makefile
> + ...
> + $ make
> +
> +(e) Copy nsp_cs.ko to suitable place, like /lib/modules/<Kernel version>/pcmcia/ .
> +
> +(f) Add these lines to /etc/pcmcia/config .
>
> -[6] Add these lines to /etc/pcmcia/config .
> If you use pcmcia-cs-3.1.8 or later, we can use "nsp_cs.conf" file.
> So, you don't need to edit file. Just copy to /etc/pcmcia/ .
>
> --------------------------------------
> -device "nsp_cs"
> - class "scsi" module "nsp_cs"
> -
> -card "WorkBit NinjaSCSI-3"
> - version "WBT", "NinjaSCSI-3", "R1.0"
> - bind "nsp_cs"
> -
> -card "WorkBit NinjaSCSI-32Bi (16bit)"
> - version "WORKBIT", "UltraNinja-16", "1"
> - bind "nsp_cs"
> -
> -# OEM
> -card "WorkBit NinjaSCSI-32Bi (16bit) / IO-DATA"
> - version "IO DATA", "CBSC16 ", "1"
> - bind "nsp_cs"
> -
> -# OEM
> -card "WorkBit NinjaSCSI-32Bi (16bit) / KME-1"
> - version "KME ", "SCSI-CARD-001", "1"
> - bind "nsp_cs"
> -card "WorkBit NinjaSCSI-32Bi (16bit) / KME-2"
> - version "KME ", "SCSI-CARD-002", "1"
> - bind "nsp_cs"
> -card "WorkBit NinjaSCSI-32Bi (16bit) / KME-3"
> - version "KME ", "SCSI-CARD-003", "1"
> - bind "nsp_cs"
> -card "WorkBit NinjaSCSI-32Bi (16bit) / KME-4"
> - version "KME ", "SCSI-CARD-004", "1"
> - bind "nsp_cs"
> --------------------------------------
> -
> -[7] Start (or restart) pcmcia-cs.
> -# /etc/rc.d/rc.pcmcia start (BSD style)
> -or
> -# /etc/init.d/pcmcia start (SYSV style)
> + ::
> +
> + device "nsp_cs"
> + class "scsi" module "nsp_cs"
> +
> + card "WorkBit NinjaSCSI-3"
> + version "WBT", "NinjaSCSI-3", "R1.0"
> + bind "nsp_cs"
> +
> + card "WorkBit NinjaSCSI-32Bi (16bit)"
> + version "WORKBIT", "UltraNinja-16", "1"
> + bind "nsp_cs"
> +
> + # OEM
> + card "WorkBit NinjaSCSI-32Bi (16bit) / IO-DATA"
> + version "IO DATA", "CBSC16 ", "1"
> + bind "nsp_cs"
> +
> + # OEM
> + card "WorkBit NinjaSCSI-32Bi (16bit) / KME-1"
> + version "KME ", "SCSI-CARD-001", "1"
> + bind "nsp_cs"
> + card "WorkBit NinjaSCSI-32Bi (16bit) / KME-2"
> + version "KME ", "SCSI-CARD-002", "1"
> + bind "nsp_cs"
> + card "WorkBit NinjaSCSI-32Bi (16bit) / KME-3"
> + version "KME ", "SCSI-CARD-003", "1"
> + bind "nsp_cs"
> + card "WorkBit NinjaSCSI-32Bi (16bit) / KME-4"
> + version "KME ", "SCSI-CARD-004", "1"
> + bind "nsp_cs"
> +
> +(f) Start (or restart) pcmcia-cs::
> +
> + # /etc/rc.d/rc.pcmcia start (BSD style)
> +
> + or::
> +
> + # /etc/init.d/pcmcia start (SYSV style)
>
>
> 4. History
> +==========
> +
> See README.nin_cs .
>
> 5. Caution
> - If you eject card when doing some operation for your SCSI device or suspend
> +==========
> +
> +If you eject card when doing some operation for your SCSI device or suspend
> your computer, you encount some *BAD* error like disk crash.
> - It works good when I using this driver right way. But I'm not guarantee
> +
> +It works good when I using this driver right way. But I'm not guarantee
> your data. Please backup your data when you use this driver.
>
> 6. Known Bugs
> - In 2.4 kernel, you can't use 640MB Optical disk. This error comes from
> +=============
> +
> +In 2.4 kernel, you can't use 640MB Optical disk. This error comes from
> high level SCSI driver.
>
> 7. Testing
> - Please send me some reports(bug reports etc..) of this software.
> +==========
> +
> +Please send me some reports(bug reports etc..) of this software.
> When you send report, please tell me these or more.
> - card name
> - kernel version
> - your SCSI device name(hard drive, CD-ROM, etc...)
> +
> + - card name
> + - kernel version
> + - your SCSI device name(hard drive, CD-ROM, etc...)
>
> 8. Copyright
> +============
> +
> See GPL.
>
>
> diff --git a/Documentation/scsi/index.rst b/Documentation/scsi/index.rst
> index a2545efbb407..eb2df0e0dcb7 100644
> --- a/Documentation/scsi/index.rst
> +++ b/Documentation/scsi/index.rst
> @@ -28,5 +28,6 @@ Linux SCSI Subsystem
> lpfc
> megaraid
> ncr53c8xx
> + NinjaSCSI
>
> scsi_transport_srp/figures
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 6d28bfc72259..2f441cf59b4b 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -11861,7 +11861,7 @@ NINJA SCSI-3 / NINJA SCSI-32Bi (16bit/CardBus) PCMCIA SCSI HOST ADAPTER DRIVER
> M: YOKOTA Hiroshi <yokota@netlab.is.tsukuba.ac.jp>
> W: http://www.netlab.is.tsukuba.ac.jp/~yokota/izumi/ninja/
> S: Maintained
> -F: Documentation/scsi/NinjaSCSI.txt
> +F: Documentation/scsi/NinjaSCSI.rst
> F: drivers/scsi/pcmcia/nsp_*
>
> NINJA SCSI-32Bi/UDE PCI/CARDBUS SCSI HOST ADAPTER DRIVER
> @@ -11869,7 +11869,7 @@ M: GOTO Masanori <gotom@debian.or.jp>
> M: YOKOTA Hiroshi <yokota@netlab.is.tsukuba.ac.jp>
> W: http://www.netlab.is.tsukuba.ac.jp/~yokota/izumi/ninja/
> S: Maintained
> -F: Documentation/scsi/NinjaSCSI.txt
> +F: Documentation/scsi/NinjaSCSI.rst
> F: drivers/scsi/nsp32*
>
> NIOS2 ARCHITECTURE
> diff --git a/drivers/scsi/pcmcia/Kconfig b/drivers/scsi/pcmcia/Kconfig
> index dc9b74c9348a..9696b6b5591f 100644
> --- a/drivers/scsi/pcmcia/Kconfig
> +++ b/drivers/scsi/pcmcia/Kconfig
> @@ -36,7 +36,7 @@ config PCMCIA_NINJA_SCSI
> help
> If you intend to attach this type of PCMCIA SCSI host adapter to
> your computer, say Y here and read
> - <file:Documentation/scsi/NinjaSCSI.txt>.
> + <file:Documentation/scsi/NinjaSCSI.rst>.
>
> Supported cards:
>
> --
> 2.21.1
>
next prev parent reply other threads:[~2020-03-11 13:06 UTC|newest]
Thread overview: 55+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-03-02 8:15 [PATCH 00/42] Manually convert SCSI documentation to ReST format Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 01/42] Add an empty index file for SCSI documents Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 02/42] docs: scsi: include SCSI Transport SRP diagram at the doc body Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 03/42] docs: scsi: convert 53c700.txt to ReST Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 04/42] docs: scsi: convert aacraid.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 05/42] docs: scsi: convert advansys.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 06/42] docs: scsi: convert aha152x.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 07/42] docs: scsi: convert aic79xx.txt " Mauro Carvalho Chehab
2020-03-17 13:41 ` Christoph Hellwig
2020-03-02 8:15 ` [PATCH 08/42] docs: scsi: convert aic7xxx.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 09/42] docs: scsi: convert bfa.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 10/42] docs: scsi: convert bnx2fc.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 11/42] docs: scsi: convert BusLogic.txt " Mauro Carvalho Chehab
2020-03-04 18:58 ` Khalid Aziz
2020-03-02 8:15 ` [PATCH 12/42] docs: scsi: convert cxgb3i.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 13/42] docs: scsi: convert dc395x.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 14/42] docs: scsi: convert dpti.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 15/42] docs: scsi: convert FlashPoint.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 16/42] docs: scsi: convert g_NCR5380.txt " Mauro Carvalho Chehab
2020-03-03 0:21 ` Finn Thain
2020-03-02 8:15 ` [PATCH 17/42] docs: scsi: convert hpsa.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 18/42] docs: scsi: convert hptiop.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 19/42] docs: scsi: convert libsas.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 20/42] docs: scsi: convert link_power_management_policy.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 21/42] docs: scsi: convert lpfc.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 22/42] docs: scsi: convert megaraid.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 24/42] docs: scsi: convert NinjaSCSI.txt " Mauro Carvalho Chehab
2020-03-11 13:06 ` Masanori Goto [this message]
2020-03-02 8:15 ` [PATCH 25/42] docs: scsi: convert ppa.txt " Mauro Carvalho Chehab
2020-03-02 8:15 ` [PATCH 26/42] docs: scsi: convert qlogicfas.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 27/42] docs: scsi: convert scsi-changer.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 28/42] docs: scsi: convert scsi_eh.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 29/42] docs: scsi: convert scsi_fc_transport.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 30/42] docs: scsi: convert scsi-generic.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 31/42] docs: scsi: convert scsi_mid_low_api.txt " Mauro Carvalho Chehab
2020-03-03 0:20 ` Finn Thain
2020-03-17 13:44 ` Christoph Hellwig
2020-03-02 8:16 ` [PATCH 32/42] docs: scsi: convert scsi-parameters.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 33/42] docs: scsi: convert scsi.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 34/42] docs: scsi: convert sd-parameters.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 35/42] docs: scsi: convert smartpqi.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 36/42] docs: scsi: convert st.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 37/42] docs: scsi: convert sym53c500_cs.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 38/42] docs: scsi: convert sym53c8xx_2.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 39/42] docs: scsi: convert tcm_qla2xxx.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 40/42] docs: scsi: convert ufs.txt " Mauro Carvalho Chehab
2020-03-03 7:22 ` Avri Altman
2020-03-02 8:16 ` [PATCH 41/42] docs: scsi: convert wd719x.txt " Mauro Carvalho Chehab
2020-03-02 8:16 ` [PATCH 42/42] docs: scsi: convert arcmsr_spec.txt " Mauro Carvalho Chehab
2020-03-10 17:43 ` [PATCH 00/42] Manually convert SCSI documentation to ReST format Jonathan Corbet
2020-03-10 17:50 ` Martin K. Petersen
2020-03-10 17:58 ` Jonathan Corbet
2020-03-10 23:40 ` Martin K. Petersen
2020-03-11 11:50 ` Mauro Carvalho Chehab
2020-03-12 3:05 ` Martin K. Petersen
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=CALZLnaHY7rtLXHNmUv77Sj6X06MGXoR_cXBmABp_CockmMJM+A@mail.gmail.com \
--to=gotom@debian.or.jp \
--cc=corbet@lwn.net \
--cc=jejb@linux.ibm.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-scsi@vger.kernel.org \
--cc=martin.petersen@oracle.com \
--cc=mchehab+huawei@kernel.org \
--cc=yokota@netlab.is.tsukuba.ac.jp \
/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: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).