NAME

       rescan-scsi-bus.sh - script to add and remove SCSI devices without rebooting

SYNOPSIS

       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).

SEE ALSO

       There is a  brief  descripion  here:  https://fibrevillage.com/storage/585-rescan-scsi-bus-sh-script-for-
       adding-and-removing-scsi-devices-without-rebooting

       sg3_utils Homepage: https://sg.danny.cz/sg

rescan-scsi-bus.sh                                December 2022                            RESCAN-SCSI-BUS.SH(8)