第 1 章. 引言

本文档描述了 Linux 内核进入 2.4 生产系列时的 SCSI 子系统。

SCSI 子系统的外部视图是主要主题。包含材料是为了帮助 Linux SCSI 子系统的系统管理。此外，还简要描述了 ioctl() 和接口，它们可能与编写使用此子系统的应用程序的人员有关。但是，未涉及内部数据结构和设计问题 [请参阅参考 W2]。为了使演示文稿简洁明了，编译选项和系统调用（包括 ioctl()）已放置在 附录 E 中。虽然原始设备并不完全是 SCSI 子系统的一部分，但在 第 11 章中也对其进行了描述。

对于那些对 SCSI 子系统不感兴趣，只想让他们的 ATAPI cd 刻录机正常工作的人，请参阅 第 9.2.4 节。浏览 第 2 章 也可能很有用。

本文档是 Drew Eckhardt 五年前编写的 SCSI-HOWTO [请参阅参考 W7] 的后续文档。该文档描述了 Linux 内核 1.2 和 1.3 系列中的 SCSI 子系统。它仍然可以在 Linux 文档项目 [LDP，请参阅参考 W8] 的“未维护”部分中找到。这两份文档具有大致相似的结构，尽管 Drew 的文档包含大量关于适配器驱动程序的信息。

本文档可以以电子形式在 www.tldp.org/HOWTO/SCSI-2.4-HOWTO 找到。本文档的主站点以及可能最新的版本可以在 www.torque.net/scsi/SCSI-2.4-HOWTO 找到（这是多页 html 版本）。在该位置，本文档以 txt、pdf、ps、单页（长）html 以及多页 html 呈现。例如，pdf 版本位于 www.torque.net/scsi/SCSI-2.4-HOWTO.pdf）。

本文档最后修改于 2004 年 8 月 24 日。

第 2 章. 架构概述

SCSI 子系统具有 3 级架构，“上”层最接近用户/内核接口，而“下”层最接近硬件。上层驱动程序通常以简洁的两个字母的缩写形式表示（例如，“sd”表示 SCSI 磁盘驱动程序）。对应的模块驱动程序的名称（由于历史原因，有时与内置驱动程序的名称不同）在下图中用括号显示。

上层支持用户-内核接口。对于 sd 和 sr，这是一个块设备接口，而对于 st 和 sg，这是一个字符设备接口。使用 SCSI 子系统的任何操作（例如，从磁盘读取扇区）都涉及 3 个级别中的每个级别的一个驱动程序（例如，sd、SCSI 中间层和 aic7xxx 驱动程序）。

从图中可以看出，SCSI 中间层对于所有操作都是通用的。SCSI 中间层定义内部接口并为上层和下层驱动程序提供常用服务。中间层提供的 Ioctl 可用于属于 4 个上层驱动程序中任何一个的文件描述符。

对块设备最常见的操作是“挂载”文件系统。对于 sd 设备，通常会挂载一个分区（例如，mount -t ext2 /dev/sda6 /home）。对于 sr 设备，通常会挂载整个设备（例如，mount -t iso9660 /dev/sr0 /mnt/cdrom）。 dd 命令可用于从块设备读取或写入。在这种情况下，块大小参数 ("bs") 需要设置为设备的块大小（例如，大多数磁盘为 512 字节）或该设备块大小的整数倍（例如，8192 字节）。块子系统最近添加了一个功能，允许设备（或分区）多次挂载在不同的挂载点上。

Sd 是通用磁盘系列的一员，hd 设备也是 IDE 子系统的一员。除了挂载 sd 设备之外，还可以使用 fdisk 命令来查看或修改磁盘的分区表。虽然 hdparm 命令主要用于 ATA 磁盘（也称为 IDE 或 EIDE 磁盘），但某些选项也可用于 SCSI 磁盘。

Sr 是 CD-ROM 子系统的一员。除了挂载文件系统（例如，iso9660）之外，还可以读取音频 CD。后者的动作不涉及挂载文件系统，而是通常通过调用一些 ioctl 来完成。通用 Linux 命令（例如 dd）不能用于音频 CD。

St 是用于读取和写入磁带的字符设备。通常，mt 命令用于执行数据传输和其他控制功能。

Sg 是一个 SCSI 命令传递设备，它使用字符设备接口。通用 Linux 命令不应在 sg 设备上使用。 SANE（用于扫描仪）、cdrecord 和 cdrdao（用于 CD 刻录机）以及 cdparanoia（用于以数字方式读取音频 CD）等应用程序使用 sg。

第 3 章. 名称和地址

本节介绍 Linux 和 SCSI 世界中存在的各种命名方案以及它们如何交互。

<scsi(_adapter_number), channel, id, lun>

<host, bus, target, lun>

[b,8,0]    /dev/sda
[b,8,1]    /dev/sda1
....
[b,8,15]   /dev/sda15
[b,8,16]   /dev/sdb
[b,8,17]   /dev/sdb1
....
[b,8,255]  /dev/sdp15

[b,65,0]   /dev/sdq
[b,65,1]   /dev/sdq1
....
[b,65,159] /dev/sdz15
[b,65,160] /dev/sdaa
[b,65,161] /dev/sdaa1
....
[b,65,255] /dev/sdaf15
[b,66,0]   /dev/sdag
[b,66,1]   /dev/sdag1
....
[b,66,255] /dev/sdav15
....
[b,71,255] /dev/sddx15

[b,11,0]   /dev/scd0          [or /dev/sr0]
[b,11,255] /dev/scd255        [or /dev/sr255]

[c,9,0]    /dev/st0     [tape 0, mode 0, rewind]
[c,9,1]    /dev/st1     [tape 1, mode 0, rewind]
....
[c,9,31]   /dev/st31    [tape 31, mode 0, rewind]
[c,9,32]   /dev/st0l    [tape 0, mode 1, rewind]
....
[c,9,63]   /dev/st31l   [tape 31, mode 1, rewind]
[c,9,64]   /dev/st0m    [tape 0, mode 2, rewind]
....
[c,9,96]   /dev/st0a    [tape 0, mode 3, rewind]
....
[c,9,127]  /dev/st31a   [tape 31, mode 3, rewind]
[c,9,128]  /dev/nst0    [tape 0, mode 0, no rewind]
....
[c,9,160]  /dev/nst0l   [tape 0, mode 1, no rewind]
....
[c,9,192]  /dev/nst0m   [tape 0, mode 2, no rewind]
....
[c,9,224]  /dev/nst0a   [tape 0, mode 3, no rewind]
....
[c,9,255]  /dev/nst31a  [tape 31, mode 3, no rewind]

[c,21,0]   /dev/sg0
[c,21,1]   /dev/sg1
....
[c,21,255] /dev/sg255

/dev/scsi/host0/bus0/target1/lun0/disc    [whole disk]
/dev/scsi/host0/bus0/target1/lun0/part6   [partition 6]
/dev/scsi/host0/bus0/target1/lun0/generic [sg device for disk]

/dev/scsi/host1/bus0/target2/lun0/cd      [CD reader or writer]
/dev/scsi/host1/bus0/target2/lun0/generic [sg device for cd]

/dev/scsi/host2/bus0/target0/lun0/mt      [tape mode 0 rewind]
/dev/scsi/host2/bus0/target0/lun0/mtan    [tape mode 3 no rewind]
/dev/scsi/host2/bus0/target0/lun0/generic [sg device for tape]

$ ls -l /dev/scsi/   # abridged
total 0
brw-------  8,   0 Sep  2 11:56 sdh0-0c0i0l0
brw-------  8,   1 Sep  2 11:56 sdh0-0c0i0l0p1
...
brw-------  8,   8 Sep  2 11:56 sdh0-0c0i0l0p8
brw-------  8,  16 Sep  2 11:56 sdh0-0c0i1l0
brw-------  8,  17 Sep  2 11:56 sdh0-0c0i1l0p1
...
brw-------  8,  24 Sep  2 11:56 sdh0-0c0i1l0p8
crw------- 21,   0 Sep  2 11:56 sgh0-0c0i0l0
crw------- 21,   1 Sep  2 11:56 sgh0-0c0i1l0
crw------- 21,   2 Sep  2 11:56 sgh1-0c0i2l0
crw------- 21,   3 Sep  2 11:56 sgh1-0c0i5l0
crw------- 21,   4 Sep  2 11:56 sgh1-0c0i6l0
br-------- 11,   0 Sep  2 11:56 srh1-0c0i2l0
br-------- 11,   1 Sep  2 11:56 srh1-0c0i6l0

第4章 内核配置

Linux内核配置通常可以在内核源代码中的文件/usr/src/linux/.config中找到。不建议直接编辑此文件，而是使用以下配置选项之一

• make config - 启动基于字符的问题和答案会话

• make menuconfig - 启动面向终端的配置工具（使用ncurses）

• make xconfig - 启动基于X的配置工具

可以通过相关的帮助按钮显示这些选项的描述，这些描述可以在纯ASCII文件中找到/usr/src/linux/Documentation/Configure.help

最终，这些配置工具会编辑.config文件。一个选项将指示某些驱动程序内置到内核中（“= y”），或者将构建为模块（“= m”），或者未被选择。未选择的状态可以通过以“＃”开头的行（例如“＃CONFIG_SCSI is not set”）或通过从.config文件中缺少相关行来表示。

以下是SCSI子系统（实际上选择了SCSI中间层驱动程序）的主要选择选项的3种状态。只有其中一种应出现在实际.config文件中

CONFIG_SCSI=y
CONFIG_SCSI=m
# CONFIG_SCSI is not set

一些其他常见的SCSI配置选项是

CONFIG_BLK_DEV_SD        [disk (sd) driver]
CONFIG_SD_EXTRA_DEVS     [extra slots for disks added later]
CONFIG_BLK_DEV_SR        [SCSI cdrom (sr) driver]
CONFIG_BLK_DEV_SR_VENDOR [allow vendor specific cdrom commands]
CONFIG_SR_EXTRA_DEVS     [extra slots for cdroms added later]
CONFIG_CHR_DEV_ST        [tape (st) driver]
CONFIG_CHR_DEV_OSST	 [OnSteam tape (osst) driver]
CONFIG_CHR_DEV_SG        [SCSI generic (sg) driver]
CONFIG_DEBUG_QUEUES      [for debugging multiple queues]
CONFIG_SCSI_MULTI_LUN    [allow probes above lun 0]
CONFIG_SCSI_CONSTANTS    [symbolic decode of SCSI errors]
CONFIG_SCSI_LOGGING      [allow logging to be runtime selected]

CONFIG_SCSI_<ll_driver>  [numerous lower level adapter drivers]
CONFIG_SCSI_DEBUG        [lower level driver for debugging]

CONFIG_SCSI_PPA          [older parallel port zip drives]
CONFIG_SCSI_IMM          [newer parallel port zip drives]

CONFIG_BLK_DEV_IDESCSI   [ide-scsi pseudo adapter]
CONFIG_I2O_SCSI		 [scsi command set over i2o bus]
CONFIG_SCSI_PCMCIA       [for SCSI HBAs on PCMCIA bus]
CONFIG_USB_STORAGE       [usb "mass storage" type]

CONFIG_MAGIC_SYSRQ       [Alt+SysRq+S for emergency sync]
                         [Alt+SyrRq+U for emergency remount ro]

如果根文件系统位于SCSI磁盘上，则将SCSI中间层，sd驱动程序以及磁盘连接到的主机适配器驱动程序构建到内核中是有意义的。在大多数情况下，通常可以安全地将sr，st和sg驱动程序构建为模块，以便根据需要加载它们。如果像扫描仪这样的设备位于单独的适配器上，则其驱动程序很可能被构建为模块。在这种情况下，需要先加载该适配器驱动程序，然后才能识别扫描仪。

Linux发行版具有许多内置为模块的SCSI子系统驱动程序，因为将所有驱动程序都构建在其中将导致内核非常大，从而超出引导加载程序的功能。这导致了一个“鸡和蛋”的问题，即需要SCSI驱动程序来加载根文件系统，反之亦然。initrd设备使用的两阶段加载解决了这个问题（有关更多详细信息，请参见第6章）。

第5章 启动参数

在PC上，主板的BIOS以及大多数SCSI主机适配器提供的SCSI BIOS负责将引导加载程序的映像从SCSI磁盘加载到内存中并执行它。这可能需要更改主板BIOS中的一些设置。当涉及多个SCSI适配器时，可能需要更改SCSI BIOS设置，以指示哪个适配器包含具有引导映像的磁盘。引导映像也可以来自ATA（IDE）磁盘，可引导的CD-ROM或软盘。

lilo和grub都是常用的Linux引导加载程序。它们的配置文件位于/etc/lilo.conf和/etc/grub.conf [3]中。一个区别是，在更改lilo的配置后，必须执行lilo命令才能使更改生效（grub没有等效的要求）。有关用法信息，请参见其“man”页面。有关lilo和Linux启动顺序的优秀论文可以在 ftp://icaftp.epfl.ch/pub/people/almesber/booting/bootinglinux-0.ps.gz中找到。有关grub的更多信息，请参见 www.gnu.org/software/grub。

一些与SCSI子系统相关的启动参数

 single         [enter single user mode]
 <n>            [enter run level <n> {0..6}]
 root=/dev/sda6 [*]
 root=/dev/scsi/host0/bus0/target0/lun0/part6 [*]
 root=/dev/sd/c0b0t0u0p6   [*]
 devfs=mount    [overrides CONFIG_DEVFS_MOUNT=n]
 devfs=nomount  [overrides CONFIG_DEVFS_MOUNT=y]
 init=<command> [executes <command> rather than init]
 quiet          [reduce output to console during boot]
 debug          [increase output to console during boot]
 nmi_watchdog=0 [turn off NMI watchdog on a SMP machine]
 max_scsi_luns=1  [limits SCSI bus scans to lun==0]
 scsi_allow_ghost_devices=<n>

“root=”参数也可以是十六进制数。例如，如果根分区位于/dev/sda3那么“root=803”就是合适的。最后两位数字是在前面章节讨论过的次设备号。

“init”参数的默认值是/sbin/init（参见 man (8) init）。如果像/etc/fstab这样的文件有不正确的条目，直接进入 shell 可能会很有用，使用“init=/bin/bash”。然而，如果共享库文件或其路径不合适，这也可能失败。这样就只剩下“init=/sbin/sash”了，它是一个静态链接的 shell，内置了许多有用的命令（用于修复系统）（参见 man (8) sash）。

当 Linux 报告类似以下的消息后启动失败时：

  VFS: Cannot open root device 08:02

Lilo 的配置文件/etc/lilo.conf可以通过两种方式使用“root=”选项。通常的方式是一行代码，例如：“root=/dev/sda2”。在这种情况下，/dev/sda2会基于执行 lilo 命令时系统的状态转换为主设备号和次设备号。这可能是一个麻烦，尤其是在硬件要重新排列的情况下。另一种方式是以下形式的一行代码：“append="root=/dev/sda2"”。在这种情况下，/dev/sda2会在下次启动时传递给内核。这与在内核启动时提示符处给出“root=/dev/sda2”字符串相同。它在启动时由内核解释（一旦 HBA 及其连接的设备被识别），因此更灵活。

第 6 章：模块及其参数

有很多与 SCSI 相关的模块。中间层和上层模块如下所示：

• scsi_mod.o

• sd_mod.o

• sr_mod.o

• st.o [osst.o]

• sg.o

请注意，前 3 个模块的名称都附加了“_mod”到其正常的驱动程序名称。较低级别的驱动程序倾向于使用 HBA 制造商的名称（或缩写）（例如 advansys），还可以选择主要控制器芯片的芯片编号（例如，sym53c8xx 用于基于 NCR 53c8?? 系列芯片的 symbios 控制器）。

所有 SCSI 模块都依赖于中间层。这意味着如果 SCSI 中间层没有构建到内核中，并且如果scsi_mod.o尚未加载，那么像 modprobe st 这样的命令将导致scsi_mod.o模块被加载。可能还有其他依赖项，例如，modprobe sr_mod 也会导致 cdrom 模块被加载（如果它还没有被加载）。此外，如果 SCSI 中间层是一个模块，那么所有其他 SCSI 子系统驱动程序都必须是模块（这是由内核构建配置工具强制执行的）。

可以使用 modprobe <module_name> 命令加载模块，该命令将尝试加载任何指定的 <module_name> 所依赖的模块。此外，<module_name> 不需要尾随的“.o”扩展名，如果未给出，则假定该扩展名存在。 insmod <module_name> 命令也将尝试加载 <module_name>，但不会首先加载它所依赖的模块。有关模块如何导致加载其他模块（并附加适当的参数）的规则通常放置在文件中/etc/modules.conf. [请注意，在早期的 Linux 内核中，该文件通常称为/etc/conf.modules。] 有关此文件格式的更多信息，请尝试 man modules.conf。

可以使用以下命令查询任何模块的可允许命令行参数：modinfo -p <module_name>。

当初始化上层驱动程序时，如果没有活动主机，那么中间层将尝试加载一个名为“scsi_hostadapter”的模块。然后可以使用“alias”将“scsi_hostadapter”与较低级别（适配器）驱动程序的实际名称相关联。例如，文件中的一行代码，如“alias scsi_hostadapter aic7xxx”，/etc/modules.conf将导致加载 aic7xxx 模块（如果没有较低级别的驱动程序已处于活动状态）。[4]

模块参数“scsi_hostadapter”和 initrd 文件系统之间存在特殊关系。有关更多信息，请参见 man initrd 和 man mkinitrd。[5]

第 7 章：Proc 伪文件系统

proc 伪文件系统提供了一些关于 SCSI 子系统的有用信息。选择“proc_fs”的内核配置选项是 CONFIG_PROC_FS，在几乎所有情况下都应该选择它。 SCSI 特定信息位于目录/proc/scsi下。可能最常访问的条目是 cat /proc/scsi/scsi，它列出了连接的 SCSI 设备。 有关更多详细信息，请参见第 8.3 节。

较低级别的驱动程序被分配了以下形式的 proc_fs 条目：

    /proc/scsi/<driver_name>/<scsi_adapter_number>

cdrom 驱动程序在/proc/sys/dev/cdrom目录下提供有关连接的 cdrom 设备的信息。这将包括 SCSI 设备（即由 sr 驱动程序控制的设备）和 IDE 设备（即由 ide-cd 驱动程序控制的设备）。请参见第 9.2.3 节。

sg 驱动程序在/proc/scsi/sg目录下提供有关其状态以及连接的主机和设备的信息。请参见第 9.4.3 节。

有关 proc 伪文件系统的更多一般信息，可以在内核源文件中找到/usr/src/linux/Documentation/filesystems/proc.txt.

第 8 章：中间层，统一层

SCSI 中间层对于 SCSI 子系统的所有用法都是通用的。可能它最重要的作用是定义所有其他 SCSI 驱动程序使用的内部接口和服务。本文档未讨论这些内部机制[参见参考文献：W2]。

主要的内核配置参数“CONFIG_SCSI”决定了中间层是构建在内核中（当“=y”时）还是作为模块（当“=m”时）。如果“CONFIG_SCSI=m”，那么所有其他 SCSI 子系统驱动程序也必须是模块。

当中间层构建为模块时，可能永远不需要显式加载它，因为使用“modprobe”加载任何其他 SCSI 子系统模块都会导致首先加载中间层（如果它尚未加载）。

如果该驱动程序没有要控制的设备，则一些上层和下层驱动程序不会（完全）加载。 有时报告声音很大，例如对于 imm 驱动程序，该驱动程序控制连接到并行端口的 zip 驱动器

$ modprobe imm                                 
   imm.o: init_module: No such device

scsi_logging=<n>
    where <n> is 0 to turn logging off
    where <n> is non-zero to turn logging on

max_scsi_luns=<n>
    where <n> is a number between 1 and 8 (< lk 2.4.7),
    	>= lk 2.4.7 the upper limit can be much larger

scsi_allow_ghost_devices=<n>
    where (<n> - 1) is the maximum lu number to ghost if the
        the corresponding device is offline. When <n>==0
        (default) then don't ghost any devices (in lk 2.4.26
        and later)

scsihosts=host0:hosts1::host3 

scsi: host order: advansys:imm::ide-scsi

scsi_logging_level=<n>
    where <n> is the logging level mask (0 for logging off)
max_scsi_luns=<n>
scsihosts=host0::host2
scsi_allow_ghost_devices=<n>

---

8.3. proc 接口

要显示当前由 SCSI 子系统连接（并识别）的 SCSI 设备，请使用 cat /proc/scsi/scsi。

输出如下所示

Attached devices: Host: scsi0 Channel: 00 Id: 02 Lun: 00 Vendor: PIONEER Model: DVD-ROM DVD-303 Rev: 1.10 Type: CD-ROM ANSI SCSI revision: 02 Host: scsi1 Channel: 00 Id: 00 Lun: 00 Vendor: IBM Model: DNES-309170W Rev: SA30 Type: Direct-Access ANSI SCSI revision: 03

在“Attached devices:”行之后，每个已识别的设备都有 3 行。 这些行中的第一行是第 3.1 节中讨论的 SCSI 地址信息。 以下 2 行数据是从设备连接时对其执行的 INQUIRY 命令获得的。有关这些设备的排序与 sg 驱动程序的排序之间的关系，请参见第 9.4 节（在大多数情况下是相同的）。

可以使用 echo "scsi remove-single-device <h> <b> <t> <l>" > /proc/scsi/scsi 删除现有设备，其中变量是主机、总线（通道）、目标（scsi id）和 lun。 可以通过发送随后的 cat /proc/scsi/scsi 命令来确定此命令的成功与否。 如果设备繁忙（例如，如果设备上的文件系统已挂载），则删除将失败。

可以使用 echo "scsi add-single-device <h> <b> <t> <l>" > /proc/scsi/scsi 添加新设备，其中变量是主机、总线（通道）、目标（scsi id）和 lun。 可以通过发送随后的 cat /proc/scsi/scsi 命令来确定此命令的成功与否。 [9]

SCSI 子系统不支持 SCSI 设备的热插拔（关联的 SCSI 并行总线上可能还存在电气问题）。 建议使用 add+remove-single-device 的人确保如果将要重新插入，则该 SCSI 总线上的其他设备处于非活动状态。

要输出内部 SCSI 命令块的列表，请使用 echo "scsi dump <n>" > /proc/scsi/scsi，其中 <n> 的数值无关紧要。 这可能只对在 SCSI 子系统中追查错误的人员感兴趣。

要启动（或停止）将信息发送到控制台/日志，请使用 echo "scsi log <token> <n>" > /proc/scsi/scsi ，其中 <token> 是以下之一：{all, none, error, timeout, scan, mlqueue, mlcomplete, llqueue, llcomplete, hlqueue, hlcomplete, ioctl}，<n> 是一个介于 0 和 7 之间的数字。 令牌“all”和“none”不接受 <n> 参数。 前缀含义

hl upper level drivers [exception: sg uses "timeout"] ml mid level ll lower level drivers [adapter drivers often have there own flags]

值“0”关闭日志记录，而“7”使输出量最大化。 只有在内核构建中选择了 CONFIG_SCSI_LOGGING 时，才会输出日志记录信息。

警告：“scsi log all”（以及其他几个变体）如果日志文件（通常为/var/log/messages）位于 SCSI 磁盘上，则会导致日志记录无限循环。 关闭内核日志记录守护程序或将其输出定向到非 SCSI 设备。

第 9 章. 高层驱动程序

高层驱动程序维护内核侧的操作系统接口，以支持它们所代表的设备逻辑类别（例如磁盘）。 它们还负责管理某些内核和 SCSI 子系统资源，例如内核内存和 SCSI 命令结构。 用户空间中的应用程序通过打开一个特殊文件（块或字符）来访问这些驱动程序，这些文件通常位于/dev目录树中。

    xa_test=<0|1>

 /proc/sys/dev/cdrom/autoclose
 /proc/sys/dev/cdrom/autoeject
 /proc/sys/dev/cdrom/check_media
 /proc/sys/dev/cdrom/debug
 /proc/sys/dev/cdrom/info
 /proc/sys/dev/cdrom/lock

modprobe ide-cd ignore='hdc hdd'

$ cat /proc/sys/dev/cdrom/info 
CD-ROM information, Id: cdrom.c 3.12 2000/10/18

drive name:             sr1     sr0
drive speed:            16      0
drive # of slots:       1       1
Can close tray:         1       1
Can open tray:          1       1
Can lock tray:          1       1
Can change speed:       1       1
Can select disk:        0       0
Can read multisession:  1       1
Can read MCN:           1       1
Reports media changed:  1       1
Can play audio:         1       1
Can write CD-R:         1       0
Can write CD-RW:        1       0
Can read DVD:           0       1
Can write DVD-R:        0       0
Can write DVD-RAM:      0       0

st=xxx[,yyy] where xxx is one of the following:
buffer_kbs:<n>
write_threshold_kbs:<n>
max_buffers:<n>
max_sg_segs:<n>

(The old boot parameters st=aa[,bb[,cc[,dd]]] supported but deprecated)

buffer_kbs=<n>
write_threshold_kbs=<n>
max_buffers=<n>
max_sg_segs=<n>

$ cat /proc/scsi/scsi 
Attached devices: 
Host: scsi0 Channel: 00 Id: 00 Lun: 00
  Vendor: IBM      Model: DNES-309170W     Rev: SA30
  Type:   Direct-Access            ANSI SCSI revision: 03
Host: scsi1 Channel: 00 Id: 02 Lun: 00
  Vendor: PIONEER  Model: DVD-ROM DVD-303  Rev: 1.10
  Type:   CD-ROM                   ANSI SCSI revision: 02
Host: scsi1 Channel: 00 Id: 06 Lun: 00
  Vendor: YAMAHA   Model: CRW4416S         Rev: 1.0g
  Type:   CD-ROM                   ANSI SCSI revision: 02

$ cat /proc/scsi/sg/device_strs 
IBM             DNES-309170W            SA30
PIONEER         DVD-ROM DVD-303         1.10
YAMAHA          CRW4416S                1.0g

$ echo "scsi remove-single-device 1 0 2 0" > /proc/scsi/scsi

$ cat /proc/scsi/scsi 
Attached devices: 
Host: scsi0 Channel: 00 Id: 00 Lun: 00
  Vendor: IBM      Model: DNES-309170W     Rev: SA30
  Type:   Direct-Access            ANSI SCSI revision: 03
Host: scsi1 Channel: 00 Id: 06 Lun: 00
  Vendor: YAMAHA   Model: CRW4416S         Rev: 1.0g
  Type:   CD-ROM                   ANSI SCSI revision: 02

$ cat /proc/scsi/sg/device_strs 
IBM             DNES-309170W            SA30
<no active device>
YAMAHA          CRW4416S                1.0g

    sg_def_reserved_size=<n>

    def_reserved_size=<n>

/proc/scsi/sg/debug       [internal state of sg driver]
/proc/scsi/sg/def_reserved_size
                          [like boot/module load parameter]
/proc/scsi/sg/devices     [table of numeric device data]
/proc/scsi/sg/device_hdr  [column headers for sg/devices]
/proc/scsi/sg/device_strs [table of strings from INQUIRY]
/proc/scsi/sg/hosts       [table of numeric host data]
/proc/scsi/sg/host_hdr    [column headers for sg/hosts]
/proc/scsi/sg/host_strs   [table of string ids for hosts]
/proc/scsi/sg/version     [sg version number and date]

第 10 章。低级驱动程序

SCSI 低级驱动程序太多，无法在此文档中详细说明。 作为对任何表面概述的替代方案，本文档向读者提供了一些查找更多信息的地方的建议。

Linux 内核中 SCSI 子系统的源代码目录是一个很好的起点/usr/src/linux/drivers/scsi。 几个驱动程序在 "readme" 文件中有信息README.<driver_name>。 其他驱动程序在其 ".c" 文件的顶部有大量信息。 此信息通常包括版本号、更改日志以及内核启动时间和模块加载时间选项。 通常，可以在各种 Linux 发行版的安装指南中找到后一种信息。 有时，驱动程序维护人员会有一个包含最新错误修复信息的网站。 官方维护人员列在/usr/src/linux/MAINTAINERS文件中。 如果那里没有任何内容，请查看 SCSI 子系统目录中的相关 ".c" 文件。 一些旧的驱动程序没有活跃的维护人员。 在这种情况下，发布到 linux-scsi 新闻组可能会有所帮助 [参见 N1 ]。

要了解内核源代码树提供的驱动程序的概述，请使用内核配置程序之一（例如 cd /usr/src/linux; make menuconfig）。 与每个选择关联的帮助信息可以在一个（大）平面文件中一起找到，位于/usr/src/linux/Documentation/Configure.help。 可以从其他地方获得驱动程序。 为 lk 2.2 系列（或之前）制作的 SCSI 驱动程序不太可能在 lk 2.4 系列中成功构建或运行。 [从编程的角度来看，没有很多需要更改的内容。] 驱动程序甚至可能仅以二进制形式提供，在这种情况下，请确保您信任提供商并严格按照他们的说明进行操作。

低级驱动程序可以支持 2 种错误处理策略中的任何一种。 较旧的一种被认为是过时的，而较新的一种通常称为 "new_eh"。 "new_eh" 的优势在于它为每个主机使用一个单独的内核线程（名为 "scsi_eh_<n>"，其中 <n> 是主机号）来促进错误恢复。 两种错误处理策略在 lk 2.2 系列中也可用，其中极少有适配器驱动程序使用 "new_eh"。 在 lk 2.4 系列中，更多驱动程序正在使用它，并且即将到来的 lk 2.5 开发系列的计划是删除对较旧的过时错误策略的中间层支持。

Drew Eckhardt 的 SCSI-HOWTO 文档 [参见参考文献 W7 ] 比本文档更详细地介绍了低级（适配器）驱动程序。 由于该 SCSI-HOWTO 已有 5 年的历史，因此许多事情发生了变化，并且添加了更多驱动程序。

有一个名为 scsi_debug 的低级驱动程序，它使用计算机的内存模拟一个或多个“直接访问”设备（即磁盘）。 从 lk 2.4.17 开始，它充当“ram 磁盘”。 虽然 Linux 中有很多 ram 磁盘实现可用（例如 ramfs），但 scsi_debug 可能有助于隔离问题安装中存在问题的 scsi 驱动程序。 见scsi_debug.c了解更多信息。

        hdparm -d1 /dev/hdx

        echo "log:1" > /proc/ide/hdx/settings

        echo "using_dma:0" > /proc/ide/hdx/settings

第 11 章. 原始设备

原始设备可以绑定到现有的块设备（例如磁盘），并用于对该现有块设备执行“原始”IO。 这种“原始”IO 绕过了通常与块设备关联的缓存。 因此，原始设备提供了通往物理设备的更“直接”的途径，并允许应用程序更好地控制对该物理设备进行 IO 的时序。 这使得原始设备适用于复杂的应用程序，例如通常进行自己的缓存的数据库管理系统。

原始设备是字符设备（主设备号为 162）。 第一个次设备号（即 0）保留作为控制接口，通常位于/dev/rawctl。 可以使用名为 raw 的实用程序（参见 man raw）将原始设备绑定到现有块设备。 这些“现有块设备”可以是磁盘或 cdrom/dvd，它们的基础接口可以是 Linux 支持的任何东西（例如 IDE/ATA 或 SCSI）。

以下命令序列列出了原始设备，然后绑定了 SCSI 磁盘分区，然后绑定了整个磁盘：

$ ls -lR /dev/raw*
crw-r--r--    1 root     root     162,   0 Dec  6 06:54 /dev/rawctl

/dev/raw:
total 0
crw-r--r--    1 root     root     162,   1 Dec  6 06:54 raw1
crw-r--r--    1 root     root     162,   2 Dec  6 06:54 raw2
crw-r--r--    1 root     root     162,   3 Dec  6 06:54 raw3
crw-r--r--    1 root     root     162,   4 Dec  6 06:54 raw4
$
$ raw -qa
$
$ raw /dev/raw/raw1 /dev/sda3
/dev/raw/raw1:  bound to major 8, minor 3
$ raw /dev/raw/raw2 /dev/sda
/dev/raw/raw2:  bound to major 8, minor 0
$ raw -qa
/dev/raw/raw1:  bound to major 8, minor 3
/dev/raw/raw2:  bound to major 8, minor 0

用于字符设备的常用系统调用阵列可用于原始设备。 read(2) 和 write(2) 的传输大小必须是物理设备块大小的整数倍。 对于磁盘，这将是其扇区大小，通常为 512 字节。 提供给 read() 和 write() 系统调用的数据缓冲区必须与块大小对齐。 lseek(2) 调用还需要将其文件读取/写入偏移量与块边界对齐。 pread(3) 调用（参见 man pread）结合了 read() 和 lseek()，并且对原始设备可能很有用（pwrite() 也是如此）。 在 32 位架构上，如果 "off_t" 类型为 32 位长，则应注意大于 2 GB（或可能为 4 GB）的偏移量。 一种解决方案是使用 _llseek() 调用（参见 man llseek）。

诸如最新版本的 dd 和 lmdd（来自 lmbench 程序套件）之类的 Unix 实用程序可用于将数据移动到“原始”设备和从“原始”设备移动数据，因为它们满足上述块对齐要求。 sg_utils 包中的 sg_dd 命令的最新版本可以访问原始设备和 sg 设备。

另请注意，如果物理设备的扇区数为奇数（如 blockdev --getsize /dev/raw/raw* 所示），则无法使用原始 IO 访问最后一个扇区。

如果通过绑定的原始设备以及通过其正常块接口访问块设备，则两种访问机制之间没有缓存一致性。 例如，如果/dev/sda1既已挂载又通过绑定的原始设备进行访问，则可能存在数据不一致的情况。

第 12 章. Devfs 伪文件系统

devfs 的主要文档可以在以下位置找到：参考 W5。 SCSI 子系统的 devfs 命名约定在 第 3.3 节中概述。 Devfs 通过内核构建选项 CONFIG_DEVFS_FS 选择，以及是否在启动时挂载它（如/dev）由内核构建选项 CONFIG_DEVFS_MOUNT 控制。 后一个选项可以被内核启动时选项“devfs=mount”或“devfs=nomount”覆盖，以合适者为准。

带有其默认权限的 devfs SCSI 节点名称是

disc        rw-------   whole disk including mbr
part1       rw-------   first partition {...p1}
...
part15      rw-------   15th partition {...p15}
cd          rw-rw-rw-   cd or dvd devices
mt          rw-rw-rw-   tape mode 0 with rewind {...m0}
mtl         rw-rw-rw-   tape mode 1 with rewind {...m1}
mtm         rw-rw-rw-   tape mode 2 with rewind {...m2}
mta         rw-rw-rw-   tape mode 3 with rewind {...m3}
mtn         rw-rw-rw-   tape mode 0 with no rewind {...m0n}
mtln        rw-rw-rw-   tape mode 1 with no rewind {...m1n}
mtmn        rw-rw-rw-   tape mode 2 with no rewind {...m2n}
mtan        rw-rw-rw-   tape mode 3 with no rewind {...m3n}
generic     rw-r-----

只有在相应的设备（或设备的子实体（例如分区））和驱动程序存在时，这些节点名称才会存在。 例如，如果没有 sg 驱动程序，则没有“通用”设备名称。 上面括号中出现的字符串将根据需要在下面概述的缩写“c0b0t0u0”符号中附加。

作为块或字符特殊文件的 devfs 文件名将在此描述中称为主要设备名称。 devfs 守护程序（称为 devfsd）引入了许多指向这些主要设备名称的符号链接。 这是为了向后兼容性和方便性而完成的。 这些符号链接将被称为辅助设备名称。

辅助设备名称由 devfsd 配置文件控制，该文件通常位于/etc/devfsd.conf。 以下是使用默认 devfsd.conf 文件时的辅助设备名称列表：

Secondary name       slink to this primary device name
--------------------------------------------------------------
/dev/sda             /dev/scsi/host0/bus0/target2/lun0/disc
/dev/sda1            /dev/scsi/host0/bus0/target2/lun0/part1
/dev/sd/c0b0t2u0     /dev/scsi/host0/bus0/target2/lun0/disc
/dev/sd/c0b0t2u0p1   /dev/scsi/host0/bus0/target2/lun0/part1
/dev/sr0             /dev/scsi/host0/bus0/target4/lun0/cd
/dev/sr/c0b0t4u0     /dev/scsi/host0/bus0/target4/lun0/cd
/dev/st0             /dev/scsi/host1/bus0/target0/lun0/mt
/dev/nst0a           /dev/scsi/host1/bus0/target0/lun0/mtan
/dev/st/c1b0t0u0m0   /dev/scsi/host1/bus0/target0/lun0/mt
/dev/st/c1b0t0u0m3n  /dev/scsi/host1/bus0/target0/lun0/mtan
/dev/sg0             /dev/scsi/host0/bus0/target2/lun0/generic
/dev/sg1             /dev/scsi/host0/bus0/target4/lun0/generic
/dev/sg2             /dev/scsi/host1/bus0/target0/lun0/generic
/dev/sg/c0b0t2u0     /dev/scsi/host0/bus0/target2/lun0/generic
/dev/sg/c0b0t4u0     /dev/scsi/host0/bus0/target4/lun0/generic
/dev/sg/c1b0t0u0     /dev/scsi/host1/bus0/target0/lun0/generic

请注意，更常见的/dev/scd0不支持 SCSI cdrom 的变体。 还有/dev/discs, /dev/cdroms和/dev/tapes包含指向属于该类别的所有设备（即不仅是 SCSI 设备）的符号链接的目录。

Secondary name       slink to this primary device
------------------------------------------------------------
/dev/discs/disc0     /dev/ide/host0/bus0/target0/lun0      *
/dev/discs/disc1     /dev/scsi/host0/bus0/target2/lun0     *
/dev/cdroms/cdrom0   /dev/ide/host0/bus1/target1/lun0/cd
/dev/cdroms/cdrom1   /dev/scsi/host0/bus0/target4/lun0/cd
/dev/tapes/tape0     /dev/scsi/host1/bus0/target0/lun0     *

标有“*”的条目是包含主要设备的目录。 请注意，IDE/ATA 设备在 SCSI 设备之前列出。 这些辅助设备名称模仿与主要设备名称相同的持久性规则。 因此，当删除 SCSI 设备 (?) 或其较低级别的驱动程序或其较高级别的驱动程序时，与它关联的主要和辅助设备名称也会被删除。

当 devfs 挂载为/dev时，旧的“/dev/sda6”类型仍然可以在某些上下文中使用。 如果需要在内核启动时提示输入，这可能很方便。 例如，如果用户想要更改“devfs”计算机上的根分区，则可以使用以下任何示例作为内核启动时选项：

   root=/dev/sda6
   root=/dev/scsi/host0/bus0/target0/lun0/part6
   root=/dev/sd/c0b0t0u0p6

有许多设备扫描程序希望看到预 devfs 设备名称存在，并且需要一些时间才能使它们意识到 devfs。 此外，某些程序依赖于打开/dev/sg0（例如）来加载 sg 驱动程序（假设它是一个模块并且尚未加载）。 这可以通过/etc/devfsd.conf文件中的条目进行安排，以及以下内容

        LOOKUP          sg.*            MODLOAD

        probeall        /dev/sg         scsi-hosts sg
        alias           /dev/sg*        /dev/sg

可以使用此条目更改 sg 设备的权限，在/etc/devfsd.conf文件中

  REGISTER scsi/host.*/bus.*/target.*/lun.*/generic
                              PERMISSIONS 0.0 rw-rw-rw-

应用程序可以通过文件/dev/.devfsd.

是否存在来确定 devfs 是否处于活动状态。 基于持久文件系统（例如 ext2）的 /dev 目录的一个功能是能够将权限与设备文件名关联，并将其从一次启动保持到下一次启动。 如上所述，devfs 的默认操作是在每次启动计算机时重新分配设备文件名权限。/etc/devfsd.conf中的 PERMISSIONS 操作可用于断言权限，但这可能被认为有点笨拙。 devfs 文档 (W5) 描述了一种获得两全其美的方法。 此技术依赖于 lk 2.4 中最近添加的功能，以在多个点挂载相同的文件系统。