RESCAN-SCSI-BUS.SH(8)

📦 version 0.12, in ubuntu jammy

👑 rescan-scsi-bus.sh — the manual, but make it cute 💅

okay bestie, welcome to RESCAN-SCSI-BUS.SH(8), straight out of the System Manager's Manual section. yes we're doing manpage lore today. sit down, grab a strawberry 🍓, and let's get into it.

✨ NAME ✨

rescan-scsi-bus.sh — rescan the SCSI bus. that's it. that's the whole vibe. it rescans the SCSI bus. iconic behavior honestly 🦋

🌸 SYNOPSIS 🌸

rescan-scsi-bus.sh [ -l ] [ -w ] [ -c ] [ -r ] [ host...  ]

💖 DESCRIPTION 💖

so rescan-scsi-bus.sh is a program (a whole entire program, we love her) that rescans the SCSI bus. and the way she does it?? she uses the SCSI add-single-device feature of the Linux SCSI layer. no cap. that's the mechanism, that's the tea, that's the whole plot 🫶

🎀 OPTIONS 🎀

the way that there are SO many flags and every single one of them matters. let's go one by one, no skipping, periodt 💅

  • -l — turns on scanning for LUNs 0 .. 7 (default is just 0). she's expanding her horizons 💫
  • -L NUM — turns on scanning for LUNs 0 .. LUN (default: 0). you give her the number, she gives you the LUNs.
  • --luns=LIST — scan only the LUNs in LIST. selective queen 👑
  • -w — enables scanning for device IDs 0 .. 15 (default: 0 .. 7). more IDs, more drama.
  • --ids=LIST — scan only the device IDs in LIST.
  • -i, --issue-lip — issue a FibreChannel LIP reset (default: disabled). big move. very main character. she's not doing this unless you ask ✨
  • -r, --remove — enables removing of devices (default: disabled). breaking up is hard but sometimes necessary 😭
  • --forceremove — remove and readd every device. > ⚠️ this one is dangerous. like, for real dangerous. do not just vibe into this one, bestie. she said what she said 💀
  • -c — enables scanning of channels 0 1 (default: 0).
  • --channels=LIST — scan only the channels in LIST.
  • host, --hosts=LIST — if host adapters are given, only these are scanned (default: all). pick your faves 🎀
  • --nooptscan — don't stop looking for LUNs if 0 is not found. she does NOT quit early, she keeps searching, she's committed 🫡
  • --color — use coloured prefixes OLD/NEW/DEL. aesthetic AND functional, we love to see it 🌈

one more thing, and this one's important so i'm putting it on its own line like the queen it is:

LIST is a comma separated list of single values and ranges — no spaces allowed — for example:

0,2-3,8,10-15

🦋 AUTHOR 🦋

rescan-scsi-bus.sh was written by Kurt Garloff <garloff@suse.de>. absolute legend behavior, we thank him for his service 🙏✨

this program is free software 💚 you can use it under the terms of the GNU GPL (General Public License) Version 2 — or any later version, at your option, because she's flexible like that.

⚠️ note that the GNU GPL implies that there is NO WARRANTY at all. like none. zero. nada. don't come for her if something breaks 😭

the full text of the GPL can be found in the /usr/share/common-licenses/GPL file. go read it if you're feeling scholarly 📖

💜 AVAILABILITY 💜

rescan-scsi-bus.sh is available from:

http://www.garloff.de/kurt/linux/scsidev/

and that's the whole page, bestie!! 🎉 this one's dated March 1998, from the System Manager's Manual, and it lives at RESCAN-SCSI-BUS.SH(8). go forth and rescan your bus responsibly 💅🦋✨

📦 where this page comes from