man page — script to add and remove SCSI devices without rebooting

Synopsis [--alltargets] [--attachpq3] [-c] [--color] [---channels=CLIST] [-d] [--flush] [--forceremove] [--forcerescan] [--help] [--hosts=HLIST] [--ids=TLIST] [--issue-lip] [-l] [-L NUM] [--luns=LLIST] [--multipath] [--nooptscan] [--remove] [--removelun2] [--resize] [--sparselun] [--sync] [--update] [--version] [--wide] [HOST1 [HOST2 ...]]


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


use coloured prefixes OLD/NEW/DEL


scan only channel(s) in CLIST


enable debug                       [default: 0]

-f, --flush

flush failed multipath devices     [default: disabled]


remove and readd every device (DANGEROUS)


rescan existing devices

-h, --help

print usage message then exit


scan only host(s) in HLIST


scan only target ID(s) in TLIST

-i, --issue-lip

issue a FibreChannel LIP reset     [default: disabled]


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


activates scanning for LUNs 0--NUM [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

-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

--sync, --nosync

issue a sync / no 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 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 Homepage:

sg3_utils Homepage:

Referenced By

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

January 2016 User Commands