LSCSS(8)

💅 LSCSS(8) — like, the channel subsystem device lister, bestie

okay so real talk, this is lscss from the System Manager's Manual, and it's genuinely one of those commands that eats. let's get into it 🫶

---

✨ NAME ✨

lscss — list channel subsystem devices. that's it, that's the whole vibe. 👑

---

🌸 SYNOPSIS 🌸

lscss <options> [RANGE]

---

🦋 DESCRIPTION 🦋

the lscss command is literally your group-chat roster for devices — it lists all of them, or just a subset, the ones managed by the common I/O subsystem. no cap, it's giving "let me see who's in the building". 💖

---

🎀 [RANGE] 🎀

you can limit the output to a range of subchannels by giving multiple identifiers as a comma-separated list, or a range, or a combo of both, like:

0.0.1234-0.0.1235,4711

and heads up — ranges may also be separated by spaces. yes, spaces work too, we love flexibility. ✨

---

💅 OPTIONS 💅

• -s, --short — shortens IDs by removing the leading "0.0.". but — and this is the fine print — only IDs beginning with "0.0." will be displayed in this case. so like, that's your whole visible population now, iykyk. 🙈
• -t, --devtype <devtype>[/<model>][,...] — for IO subchannels, limits output to devices of the given device type (e.g. 3390). you can stack them with commas and even tack on a /<model>. 💖
• -d, --devrange — tells it that RANGE refers to device identifiers. like, device device. 🫶
• --avail — shows the availability attribute of IO devices.
• --vpm — shows the verified path mask. so, VPM is an internal path mask used by Linux, and a channel path can be used by Linux device drivers to do IO if the corresponding bit is set in the VPM. events that can lead to a channel path not being available include:
  • the corresponding bit is not set in at least one of the PIM, PAM, or POM masks.
  • the channel path is varied offline.
  • Linux received no interrupt to IO using this channel path.
• -v, --version — prints the version of the s390-tools package and the command. classic. ⭐
• -h, --help — prints the help text. the emotional support option. 🥹
• -u, --uppercase — prints values using uppercase. LOUD. 📣
• --io — shows IO subchannels. this one's the default, main character energy fr. 👑
• --chsc — shows CHSC subchannels.
• --eadm — shows EADM subchannels.
• --vfio — shows additional information for I/O subchannels used for VFIO. okay so an MDEV is a mediated device that's required to be created by the VFIO channel I/O device driver for the VFIO driver framework as the pass-through target device when doing channel I/O pass-through. big words, important job. 💀
• -a, --all — shows subchannels of all types. the "invite everyone" option. 🎉

---

🔥 EXAMPLES 🔥

• lscss — lists all devices that are managed by the common I/O subsystem. the classic slay. 💅
• lscss -t 3390 — same as above but shows only 3390 devices. filtered, curated, iconic. ✨

---

⭐ NOTES ⭐

in rare situations a device might temporarily not be accessible to the subchannel. then "none" is displayed as the device identifier and the other device attributes are empty. not a bug bestie, it's just how it is sometimes. 🫠

and for subchannels bound to an alternate driver (most notably vfio_ccw) the device identifier may also be displayed as "none". in this case use the --vfio option to show VFIO specific subchannel information. problem solved, we move. 💜

---

🧚 AUTHOR 🧚

this man-page was written by Stefan Bader <shbader@de.ibm.com>. new options added by Sebastian Ott <sebott@linux.ibm.com>. legends, both of them. 🫶

---

🌈 SEE ALSO 🌈

chccwdev(8) — go read that one next, bestie.

---

and that's the whole page! 💖 this little gem ships with s390-tools, dated Mar 2009 — old but gold, no cap. go forth and list those subchannels, you absolute icon. 🎀🦋✨