Debian Codegraph @

upstream/debian-unstable/man5/proc_scsi.5

raw
1 .\" Copyright 1994-1995, Daniel Quinlan <[email protected]>
2 .\" Copyright 2002-2017, Michael Kerrisk <[email protected]>
3 .\" Copyright, Michael Neuffer <[email protected]>
4 .\" Copyright, the authors of the Linux man-pages project
5 .\"
6 .\" SPDX-License-Identifier: GPL-3.0-or-later
7 .\"
8 .TH proc_scsi 5 2026-02-08 "Linux man-pages 6.18"
9 .SH NAME
10 /proc/scsi/ \- SCSI
11 .SH DESCRIPTION
12 .TP
13 .I /proc/scsi/
14 A directory with the
15 .I scsi
16 mid-level pseudo-file and various SCSI low-level
17 driver directories,
18 which contain a file for each SCSI host in this system, all of
19 which give the status of some part of the SCSI IO subsystem.
20 These files contain ASCII structures and are, therefore, readable with
21 .BR cat (1).
22 .IP
23 You can also write to some of the files to reconfigure the subsystem or
24 switch certain features on or off.
25 .TP
26 .I /proc/scsi/scsi
27 This is a listing of all SCSI devices known to the kernel.
28 The listing is similar to the one seen during bootup.
29 scsi currently supports only the
30 .I add\-single\-device
31 command which
32 allows root to add a hotplugged device to the list of known devices.
33 .IP
34 The command
35 .IP
36 .in +4n
37 .EX
38 echo \[aq]scsi add\-single\-device 1 0 5 0\[aq] > /proc/scsi/scsi
39 .EE
40 .in
41 .IP
42 will cause
43 host scsi1 to scan on SCSI channel 0 for a device on ID 5 LUN 0.
44 If there
45 is already a device known on this address or the address is invalid, an
46 error will be returned.
47 .TP
48 .IR /proc/scsi/ drivername /
49 .I drivername
50 can currently be NCR53c7xx, aha152x, aha1542, aha1740,
51 aic7xxx, buslogic, eata_dma, eata_pio, fdomain, in2000, pas16, qlogic,
52 scsi_debug, seagate, t128, u15\-24f, ultrastore, or wd7000.
53 These directories show up for all drivers that registered at least one
54 SCSI HBA.
55 Every directory contains one file per registered host.
56 Every host-file is named after the number the host was assigned during
57 initialization.
58 .IP
59 Reading these files will usually show driver and host configuration,
60 statistics, and so on.
61 .IP
62 Writing to these files allows different things on different hosts.
63 For example, with the
64 .I latency
65 and
66 .I nolatency
67 commands,
68 root can switch on and off command latency measurement code in the
69 eata_dma driver.
70 With the
71 .I lockup
72 and
73 .I unlock
74 commands,
75 root can control bus lockups simulated by the scsi_debug driver.
76 .SH SEE ALSO
77 .BR proc (5)