rescan-scsi-bus.sh8
Script to add and remove scsi devices without rebooting
Usage
rescan-scsi-bus.sh [--alltargets]
[--attachpq3]
[-c]
[--channels=CLIST]
[--color]
[-d]
[--flush]
[-f]
[--forceremove]
[--forcerescan]
[--help]
[--hosts=HLIST]
[--ids=TLIST]
[--ignore-rev]
[--issue-lip]
[-i]
[--issue-lip-wait=SECS]
[-I
SECS]
[-l]
[-L
NUM]
[--largelun]
[--luns=LLIST]
[-m]
[--multipath]
[--no-lip-scan]
[--nooptscan]
[--nosync]
[--remove]
[--removelun2]
[--resize]
[--sparselun]
[--sync]
[--timeout=SECS]
[--update]
[--version]
[--wide]
[HOST1
[HOST2 ...]]
Options
Option are ordered by their long name. Those without a long name are ordered as if their single letter was a long name.
-
-a, --alltargets -
scan all targets, not just currently existing [default: disabled]
-
--attachpq3 -
tell kernel to attach sg to LUN 0 that reports PQ=3
-
-c -
enables scanning of channels 0 1 [default: 0 / all detected ones]
-
--channels=CLIST -
scan only channel(s) in CLIST
-
--color -
use coloured prefixes OLD/NEW/DEL
-
-d -
enable debug [default: 0]
-
-f, --flush -
flush failed multipath devices [default: disabled]
-
--forceremove -
remove stale devices (DANGEROUS)
-
--forcerescan -
remove and re-add existing devices (DANGEROUS)
-
-h, --help -
print usage message then exit
-
--hosts=HLIST -
scan only host(s) in HLIST
-
--ids=TLIST -
scan only target ID(s) in TLIST
-
--ignore-rev -
ignore (firmware) revision change. This is the third text field (4 bytes long) in a standard INQUIRY response.
-
-i, --issue-lip -
issue a FibreChannel LIP reset [default: disabled]
-
-I SECS, --issue-lip-wait=SECS -
issue a FibreChannel LIP reset and then wait SECS seconds.
-
-L NUM -
activates scanning for LUNs 0--NUM [default: 0]
-
-l -
activates scanning for LUNs 0--7 [default: 0]
-
--largelun -
tell kernel to support LUNs > 7 even on SCSI2 devs
-
--luns=NLIST -
scan only lun(s) in NLIST
-
-m, --multipath -
update multipath devices [default: disabled]
-
--no-lip-scan -
don't scan FC Host when the --issue-lip option is also given.
-
--nooptscan -
don't stop looking for LUNs is 0 is not found
-
--nosync -
do not issue a sync [default: sync if remove]
-
-r, --remove -
enables removing of devices [default: disabled]
-
--reportlun2 -
tell kernel to try REPORT_LUN even on SCSI2 devices
-
-s, --resize -
look for resized disks and reload associated multipath devices, if applicable
-
--sparselun -
tell kernel to support sparse LUN numbering
-
--sync -
issue a sync [default: sync if remove]
-
-t, --timeout=SECS -
timeout for testing if device is online. Test is skipped if 0 [default: 30 (seconds)]
-
-u, --update -
look for existing disks that have been remapped
-
-V, --version -
shows version string then exits. The version string is a numeric datestamp of the form YYYYMMDD.
-
-w, --wide -
scan for target device IDs 0--15 [default: 0--7]
-
Host numbers may thus be specified either directly on cmd line (deprecated) or with the
--hosts=LIST parameter (recommended).
Arguments to options that end in LIST (e.g. TLIST) can have this form:
A[-B][,C[-D]]...
which is a comma separated list of single values and/or ranges (no spaces allowed).
Releases
12 releases since Debian 3.0 (Woody); the text changed 8 times.
--alltargets since Debian 8 (Jessie);
--attachpq3 since Debian 8 (Jessie);
--channels since Debian 4.0 (Etch);
--color since Debian 4.0 (Etch);
--flush since Debian 8 (Jessie);
--forceremove since Debian 4.0 (Etch);
--forcerescan since Debian 8 (Jessie);
--help since Debian 9 (Stretch);
--hosts since Debian 8 (Jessie);
--ids since Debian 4.0 (Etch);
--ignore-rev since Debian 10 (Buster);
--issue-lip since Debian 5.0 (Lenny);
--issue-lip-wait since Debian 10 (Buster);
--largelun since Debian 8 (Jessie);
--luns since Debian 4.0 (Etch);
--multipath since Debian 9 (Stretch);
--no-lip-scan since Debian 13 (Trixie);
--nooptscan since Debian 4.0 (Etch);
--nosync since Debian 8 (Jessie);
--remove since Debian 4.0 (Etch);
--reportlun2 since Debian 8 (Jessie);
--resize since Debian 8 (Jessie);
--sparselun since Debian 8 (Jessie);
--sync since Debian 8 (Jessie);
--timeout since Debian 13 (Trixie);
--update since Debian 8 (Jessie);
--version since Debian 9 (Stretch);
--wide since Debian 8 (Jessie);
-I since Debian 10 (Buster);
-L since Debian 5.0 (Lenny);
-V since Debian 9 (Stretch);
-a since Debian 8 (Jessie);
-d since Debian 8 (Jessie);
-f since Debian 8 (Jessie);
-h since Debian 9 (Stretch);
-i since Debian 5.0 (Lenny);
-m since Debian 9 (Stretch);
-s since Debian 8 (Jessie);
-t since Debian 13 (Trixie);
-u since Debian 8 (Jessie).