SAS_DISCOVER(1)

📦
version 0.6.1 · 2 versions
, in epel 10, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

💖 SAS_DISCOVER 💖

okay bestie, welcome to sas_discover, a lil tool from the sasutils collection, and no cap it is SO good at what it does. it's a section 1 command, iykyk. 🦋

✨ NAME ✨

sas_discover — display Serial Attached SCSI (SAS) topology. that's it, that's the job, and she eats every time 💅

🌸 SYNOPSIS 🌸

sas_discover [-h] [--verbose] [--addr] [--devices] [--counters]

🎀 DESCRIPTION 🎀

so here's the vibe: sas_discover shows you your SAS topology, starting from the host initiator(s), going through any SAS expanders, all the way up to the SAS targets. it's giving ✨family tree but make it storage✨.

every link usually represents one SAS port connection, whether that port is using one PHY or a whole squad of them. if there's more than one PHY per port, the count is shown explicitly — like "--4x--" for a 4-PHY wide port. slay.

heads up bestie: by default, sas_discover tries to fold common devices (like disks), so you don't get absolutely spammed. example:
-- 60 x end_device -- disk
       60 x 1-PHY links, each connected to a SAS end_device target of
       SCSI type disk

see? 60 disks, one line. iconic. 🍓

Host initiators, expanders and end devices are all labelled with the same name used in sysfs. if you throw -v at it, you get more descriptive info, but the topology will stay folded whenever possible. also, sas_discover -v prints SES-2 subenclosure nicknames, which are genuinely so useful for identifying JBODs/SIMs and external SAS switches hanging off the topology. obsessed. 😭

use -vv to unfold the topology and get more info (eg. model, size, bay identifier in enclosure). 🔥

use -vvv to get extra low-level information for each SAS end device. deep dive energy, no crumbs. 💀

and add --addr if you also want the SAS address printed for each SAS component in the topology. 🫶

👑 OPTIONS 👑

optional arguments:

  • -h, --help — show this help message and exit. the classic, the icon, the "wait what does this do again" button. 🌈
  • --verbose, -v — Verbosity level, repeat multiple times! stack it up like a combo, bestie. ⭐
  • --addr — Print SAS addresses. 🎀
  • --devices — Print associated devices. 🦋
  • --counters — Print I/O counters. 📊

💜 EXIT STATUS 💜

an exit status of zero means the command succeeded, and failure otherwise. simple as that, periodt.

🔍 SEE ALSO 🔍

go read those too, they're the friend group. 💖

🙈 BUG REPORTS 🙈

found a bug? got feedback? don't suffer in silence, bestie — use this URL to submit a bug report or feedback:

https://github.com/stanford-rc/sasutils/issues

🌟 AUTHOR 🌟

Stephane Thiell <sthiell@stanford.edu>

Apache License Version 2.0

and that's the whole page, angel 💅 this one came from sasutils version 0.6.1, dated 2024-11-11. go forth and map some topology, you've got this 💖✨🦋

📦 where this page comes from