mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-27 04:47:05 +00:00
scsi: docs: convert NinjaSCSI.txt to ReST
Link: https://lore.kernel.org/r/6385a411d000dad005b78647629e43700580ecf0.1583136624.git.mchehab+huawei@kernel.org Acked-by: GOTO Masanori <gotom@debian.or.jp> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org> Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
This commit is contained in:
parent
8dca37d259
commit
dbfa1bceed
5 changed files with 168 additions and 131 deletions
164
Documentation/scsi/NinjaSCSI.rst
Normal file
164
Documentation/scsi/NinjaSCSI.rst
Normal file
|
@ -0,0 +1,164 @@
|
||||||
|
.. SPDX-License-Identifier: GPL-2.0
|
||||||
|
|
||||||
|
=========================================
|
||||||
|
WorkBiT NinjaSCSI-3/32Bi driver for Linux
|
||||||
|
=========================================
|
||||||
|
|
||||||
|
1. Comment
|
||||||
|
==========
|
||||||
|
|
||||||
|
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)
|
||||||
|
|
||||||
|
3. Install
|
||||||
|
==========
|
||||||
|
|
||||||
|
(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"
|
||||||
|
|
||||||
|
|
||||||
|
(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
|
||||||
|
...
|
||||||
|
|
||||||
|
(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
|
||||||
|
...
|
||||||
|
|
||||||
|
(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 .
|
||||||
|
|
||||||
|
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"
|
||||||
|
|
||||||
|
(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
|
||||||
|
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
|
||||||
|
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
|
||||||
|
high level SCSI driver.
|
||||||
|
|
||||||
|
7. Testing
|
||||||
|
==========
|
||||||
|
|
||||||
|
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...)
|
||||||
|
|
||||||
|
8. Copyright
|
||||||
|
============
|
||||||
|
|
||||||
|
See GPL.
|
||||||
|
|
||||||
|
|
||||||
|
2001/08/08 yokota@netlab.is.tsukuba.ac.jp <YOKOTA Hiroshi>
|
|
@ -1,128 +0,0 @@
|
||||||
|
|
||||||
WorkBiT NinjaSCSI-3/32Bi driver for Linux
|
|
||||||
|
|
||||||
1. Comment
|
|
||||||
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)
|
|
||||||
|
|
||||||
3. Install
|
|
||||||
[1] 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"
|
|
||||||
|
|
||||||
|
|
||||||
[2] 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
|
|
||||||
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/ .
|
|
||||||
|
|
||||||
[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)
|
|
||||||
|
|
||||||
|
|
||||||
4. History
|
|
||||||
See README.nin_cs .
|
|
||||||
|
|
||||||
5. Caution
|
|
||||||
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
|
|
||||||
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
|
|
||||||
high level SCSI driver.
|
|
||||||
|
|
||||||
7. Testing
|
|
||||||
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...)
|
|
||||||
|
|
||||||
8. Copyright
|
|
||||||
See GPL.
|
|
||||||
|
|
||||||
|
|
||||||
2001/08/08 yokota@netlab.is.tsukuba.ac.jp <YOKOTA Hiroshi>
|
|
|
@ -28,5 +28,6 @@ Linux SCSI Subsystem
|
||||||
lpfc
|
lpfc
|
||||||
megaraid
|
megaraid
|
||||||
ncr53c8xx
|
ncr53c8xx
|
||||||
|
NinjaSCSI
|
||||||
|
|
||||||
scsi_transport_srp/figures
|
scsi_transport_srp/figures
|
||||||
|
|
|
@ -11801,7 +11801,7 @@ NINJA SCSI-3 / NINJA SCSI-32Bi (16bit/CardBus) PCMCIA SCSI HOST ADAPTER DRIVER
|
||||||
M: YOKOTA Hiroshi <yokota@netlab.is.tsukuba.ac.jp>
|
M: YOKOTA Hiroshi <yokota@netlab.is.tsukuba.ac.jp>
|
||||||
W: http://www.netlab.is.tsukuba.ac.jp/~yokota/izumi/ninja/
|
W: http://www.netlab.is.tsukuba.ac.jp/~yokota/izumi/ninja/
|
||||||
S: Maintained
|
S: Maintained
|
||||||
F: Documentation/scsi/NinjaSCSI.txt
|
F: Documentation/scsi/NinjaSCSI.rst
|
||||||
F: drivers/scsi/pcmcia/nsp_*
|
F: drivers/scsi/pcmcia/nsp_*
|
||||||
|
|
||||||
NINJA SCSI-32Bi/UDE PCI/CARDBUS SCSI HOST ADAPTER DRIVER
|
NINJA SCSI-32Bi/UDE PCI/CARDBUS SCSI HOST ADAPTER DRIVER
|
||||||
|
@ -11809,7 +11809,7 @@ M: GOTO Masanori <gotom@debian.or.jp>
|
||||||
M: YOKOTA Hiroshi <yokota@netlab.is.tsukuba.ac.jp>
|
M: YOKOTA Hiroshi <yokota@netlab.is.tsukuba.ac.jp>
|
||||||
W: http://www.netlab.is.tsukuba.ac.jp/~yokota/izumi/ninja/
|
W: http://www.netlab.is.tsukuba.ac.jp/~yokota/izumi/ninja/
|
||||||
S: Maintained
|
S: Maintained
|
||||||
F: Documentation/scsi/NinjaSCSI.txt
|
F: Documentation/scsi/NinjaSCSI.rst
|
||||||
F: drivers/scsi/nsp32*
|
F: drivers/scsi/nsp32*
|
||||||
|
|
||||||
NIOS2 ARCHITECTURE
|
NIOS2 ARCHITECTURE
|
||||||
|
|
|
@ -36,7 +36,7 @@ config PCMCIA_NINJA_SCSI
|
||||||
help
|
help
|
||||||
If you intend to attach this type of PCMCIA SCSI host adapter to
|
If you intend to attach this type of PCMCIA SCSI host adapter to
|
||||||
your computer, say Y here and read
|
your computer, say Y here and read
|
||||||
<file:Documentation/scsi/NinjaSCSI.txt>.
|
<file:Documentation/scsi/NinjaSCSI.rst>.
|
||||||
|
|
||||||
Supported cards:
|
Supported cards:
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue