- Man Page

script to add and remove SCSI devices without rebooting

Synopsis [--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] [--nooptscan] [--nosync] [--remove] [--removelun2] [--resize] [--sparselun] [--sync] [--update] [--version] [--wide] [HOST1 [HOST2 ...]]


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]


tell kernel to attach sg to LUN 0 that reports PQ=3


enables scanning of channels 0 1   [default: 0 / all detected ones]


scan only channel(s) in CLIST


use coloured prefixes OLD/NEW/DEL


enable debug                       [default: 0]

-f,  --flush

flush failed multipath devices     [default: disabled]


remove stale devices (DANGEROUS)


remove and readd existing devices (DANGEROUS)

-h,  --help

print usage message then exit


scan only host(s) in HLIST


scan only target ID(s) in TLIST


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.


activates scanning for LUNs 0--NUM [default: 0]


activates scanning for LUNs 0--7   [default: 0]


tell kernel to support LUNs > 7 even on SCSI2 devs


scan only lun(s) in NLIST

-m,  --multipath

update multipath devices           [default: disabled]


don't stop looking for LUNs is 0 is not found


do not issue a sync [default: sync if remove]

-r,  --remove

enables removing of devices        [default: disabled]


tell kernel to try REPORT_LUN even on SCSI2 devices

-s,  --resize

look for resized disks and reload associated multipath devices, if applicable


tell kernel to support sparse LUN numbering


issue a sync [default: sync if remove]

-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:
which is a comma separated list of single values and/or ranges (no spaces allowed).

See Also

There is a brief descripion here:

sg3_utils Homepage:

Referenced By

The man page scsi-rescan(8) is an alias of

July 2018