| 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) |