1RESCAN-SCSI-BUS.SH(1) User Commands RESCAN-SCSI-BUS.SH(1)
2
3
4
6 rescan-scsi-bus.sh - script to add and remove SCSI devices without
7 rebooting
8
10 rescan-scsi-bus.sh [--alltargets] [--attachpq3] [-c] [---chan‐
11 nels=CLIST] [--color] [-d] [--flush] [-f] [--forceremove] [--forceres‐
12 can] [--help] [--hosts=HLIST] [--ids=TLIST] [--ignore-rev]
13 [--issue-lip] [-i] [--issue-lip-wait=SECS] [-I SECS] [-l] [-L NUM]
14 [--largelun] [--luns=LLIST] [-m] [--multipath] [--nooptscan] [--nosync]
15 [--remove] [--removelun2] [--resize] [--sparselun] [--sync] [--update]
16 [--version] [--wide] [HOST1 [HOST2 ...]]
17
19 Option are ordered by their long name. Those without a long name are
20 ordered as if their single letter was a long name.
21
22 -a, --alltargets
23 scan all targets, not just currently existing [default: dis‐
24 abled]
25
26 --attachpq3
27 tell kernel to attach sg to LUN 0 that reports PQ=3
28
29 -c enables scanning of channels 0 1 [default: 0 / all detected
30 ones]
31
32 --channels=CLIST
33 scan only channel(s) in CLIST
34
35 --color
36 use coloured prefixes OLD/NEW/DEL
37
38 -d enable debug [default: 0]
39
40 -f, --flush
41 flush failed multipath devices [default: disabled]
42
43 --forceremove
44 remove stale devices (DANGEROUS)
45
46 --forcerescan
47 remove and readd existing devices (DANGEROUS)
48
49 -h, --help
50 print usage message then exit
51
52 --hosts=HLIST
53 scan only host(s) in HLIST
54
55 --ids=TLIST
56 scan only target ID(s) in TLIST
57
58 --ignore-rev
59 ignore (firmware) revision change. This is the third text field
60 (4 bytes long) in a standard INQUIRY response.
61
62 -i, --issue-lip
63 issue a FibreChannel LIP reset [default: disabled]
64
65 -I SECS, --issue-lip-wait=SECS
66 issue a FibreChannel LIP reset and then wait SECS seconds.
67
68 -L NUM activates scanning for LUNs 0--NUM [default: 0]
69
70 -l activates scanning for LUNs 0--7 [default: 0]
71
72 --largelun
73 tell kernel to support LUNs > 7 even on SCSI2 devs
74
75 --luns=NLIST
76 scan only lun(s) in NLIST
77
78 -m, --multipath
79 update multipath devices [default: disabled]
80
81 --nooptscan
82 don't stop looking for LUNs is 0 is not found
83
84 --nosync
85 do not issue a sync [default: sync if remove]
86
87 -r, --remove
88 enables removing of devices [default: disabled]
89
90 --reportlun2
91 tell kernel to try REPORT_LUN even on SCSI2 devices
92
93 -s, --resize
94 look for resized disks and reload associated multipath devices,
95 if applicable
96
97 --sparselun
98 tell kernel to support sparse LUN numbering
99
100 --sync issue a sync [default: sync if remove]
101
102 -u, --update
103 look for existing disks that have been remapped
104
105 -V, --version
106 shows version string then exits. The version string is a numeric
107 datestamp of the form YYYYMMDD.
108
109 -w, --wide
110 scan for target device IDs 0--15 [default: 0--7]
111
112 Host numbers may thus be specified either directly on cmd line
113 (deprecated) or with the --hosts=LIST parameter (recommended).
114
115 Arguments to options that end in LIST (e.g. TLIST) can have this form:
116 A[-B][,C[-D]]...
117 which is a comma separated list of single values and/or ranges (no spa‐
118 ces allowed).
119
121 There is a brief descripion here: http://fibrevillage.com/stor‐
122 age/585-rescan-scsi-bus-sh-script-for-adding-and-removing-scsi-devices-
123 without-rebooting
124
125 sg3_utils Homepage: http://sg.danny.cz/sg
126
127
128
129rescan-scsi-bus.sh July 2018 RESCAN-SCSI-BUS.SH(1)