man5/proc_scsi.5

   1 .\" Copyright (C) 1994, 1995, Daniel Quinlan <quinlan@yggdrasil.com>
   2 .\" Copyright (C) 2002-2008, 2017, Michael Kerrisk <mtk.manpages@gmail.com>
   3 .\" Copyright (C) , Michael Neuffer <neuffer@mail.uni-mainz.de>
   4 .\" Copyright (C) 2023, Alejandro Colomar <alx@kernel.org>
   5 .\"
   6 .\" SPDX-License-Identifier: GPL-3.0-or-later
   7 .\"
   8 .TH proc_scsi 5 (date) "Linux man-pages (unreleased)"
   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 \fIadd\-single\-device\fP command which
  30 allows root to add a hotplugged device to the list of known devices.
  31 .IP
  32 The command
  33 .IP
  34 .in +4n
  35 .EX
  36 echo \[aq]scsi add\-single\-device 1 0 5 0\[aq] > /proc/scsi/scsi
  37 .EE
  38 .in
  39 .IP
  40 will cause
  41 host scsi1 to scan on SCSI channel 0 for a device on ID 5 LUN 0.
  42 If there
  43 is already a device known on this address or the address is invalid, an
  44 error will be returned.
  45 .TP
  46 .IR /proc/scsi/ drivername /
  47 \fIdrivername\fP can currently be NCR53c7xx, aha152x, aha1542, aha1740,
  48 aic7xxx, buslogic, eata_dma, eata_pio, fdomain, in2000, pas16, qlogic,
  49 scsi_debug, seagate, t128, u15\-24f, ultrastore, or wd7000.
  50 These directories show up for all drivers that registered at least one
  51 SCSI HBA.
  52 Every directory contains one file per registered host.
  53 Every host-file is named after the number the host was assigned during
  54 initialization.
  55 .IP
  56 Reading these files will usually show driver and host configuration,
  57 statistics, and so on.
  58 .IP
  59 Writing to these files allows different things on different hosts.
  60 For example, with the \fIlatency\fP and \fInolatency\fP commands,
  61 root can switch on and off command latency measurement code in the
  62 eata_dma driver.
  63 With the \fIlockup\fP and \fIunlock\fP commands,
  64 root can control bus lockups simulated by the scsi_debug driver.
  65 .SH SEE ALSO
  66 .BR proc (5)