lscss - List subchannels
Use the lscss command to gather subchannel information from sysfs and display it in a summary format.
lscss syntax
Where:
- -s or --short
- strips the bus ID in the command output down to the four-digit device number.
- -u or --uppercase
- displays the output with uppercase letters. The default is lowercase. Changed default: Earlier versions of lscss printed the command output in uppercase. Specify this option to obtain the former output style.
- --avail
- includes the availability attribute of I/O devices.
- --vpm
- shows verified paths in a mask. Channel paths listed in this mask are available to Linux® device drivers for I/O. Reasons for a channel path being unavailable 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 I/O using this channel path.
- --io
- limits the output to I/O subchannels and corresponding devices. This option is the default.
- --chsc
- limits the output to CHSC subchannels.
- --eadm
- limits the output to EADM subchannels.
- --vfio
- For KVM hosts: shows information for subchannels that are used for VFIO CCW mediated devices, see Assigning DASDs to vfio_ccw.
- -a or --all
- does not limit the output.
- -t or --devtype
- limits the output to information about the specified device types and, if provided, the specified model.
- <devicetype>
- specifies a device type.
- <model>
- is a specific model of the specified device type.
- -d or --devrange
- interprets bus IDs as specifications of devices. By default, bus IDs are interpreted as specifications of subchannels.
- <bus_id>
- specifies an individual subchannel; if used with -d specifies
an individual device. If you omit the leading 0.<subchannel
set ID>., 0.0. is assumed.
If you specify subchannels or devices, the command output is limited to these subchannels or devices.
- <from_bus_id>-<to_bus_id>
- specifies a range of subchannels; if used with -d specifies
a range of devices. If you omit the leading 0.<subchannel
set ID>., 0.0. is assumed.
If you specify subchannels or devices, the command output is limited to these subchannels or devices.
- -v or --version
- displays the version number of lscss and exits.
- -h or --help
- displays a short help text, then exits. To view the man page enter man lscss.
Examples
- This command lists all subchannels, including subchannels that
do not correspond to I/O devices:
# lscss -a IO Subchannels and Devices: Device Subchan. DevType CU Type Use PIM PAM POM CHPIDs ---------------------------------------------------------------------- 0.0.f500 0.0.05cf 1732/01 1731/01 yes 80 80 ff 76000000 00000000 0.0.f501 0.0.05d0 1732/01 1731/01 yes 80 80 ff 76000000 00000000 0.0.f502 0.0.05d1 1732/01 1731/01 yes 80 80 ff 76000000 00000000 0.0.6194 0.0.36e0 3390/0c 3990/e9 yes fc fc ff 32333435 40410000 0.0.6195 0.0.36e1 3390/0c 3990/e9 yes fc fc ff 32333435 40410000 0.0.6196 0.0.36e2 3390/0c 3990/e9 yes fc fc ff 32333435 40410000 CHSC Subchannels: Device Subchan. ----------------- n/a 0.0.ff40 EADM Subchannels: Device Subchan. ----------------- n/a 0.0.ff00 n/a 0.0.ff01 n/a 0.0.ff02 n/a 0.0.ff03 n/a 0.0.ff04 n/a 0.0.ff05 n/a 0.0.ff06 n/a 0.0.ff07 - This command lists subchannels with an attached 3480 model 04
or 3590 tape device and strips the bus ID and the subchannel ID in
the command output down to the four-digit IDs:
# lscss -s -t 3480/04,3590 Device Subchan. DevType CU Type Use PIM PAM POM CHPIDs ---------------------------------------------------------------------- 0480 000e 3480/04 3480/01 80 80 ff 10000000 00000000 0a38 000f 3590/11 3590/50 80 80 ff 10000000 00000000
- This command limits the output to subchannels with attached DASD
model 3390 type 0a:
# lscss -t 3390/0a Device Subchan. DevType CU Type Use PIM PAM POM CHPIDs ---------------------------------------------------------------------- 0.0.2f08 0.0.0a78 3390/0a 3990/e9 yes c0 c0 ff 34400000 00000000 0.0.2fe5 0.0.0b55 3390/0a 3990/e9 c0 c0 bf 34400000 00000000 0.0.2fe6 0.0.0b56 3390/0a 3990/e9 c0 c0 bf 34400000 00000000 0.0.2fe7 0.0.0b57 3390/0a 3990/e9 yes c0 c0 ff 34400000 00000000 - This command limits the output to the subchannel range 0.0.0b00-0.0.0bff:
# lscss 0.0.0b00-0.0.0bff Device Subchan. DevType CU Type Use PIM PAM POM CHPIDs ---------------------------------------------------------------------- 0.0.2fe5 0.0.0b55 3390/0a 3990/e9 c0 c0 bf 34400000 00000000 0.0.2fe6 0.0.0b56 3390/0a 3990/e9 c0 c0 bf 34400000 00000000 0.0.2fe7 0.0.0b57 3390/0a 3990/e9 yes c0 c0 ff 34400000 00000000 - This command limits the output to subchannels 0.0.0a78 and 0.0.0b57
and shows the availability:
# lscss --avail 0a78,0b57 Device Subchan. DevType CU Type Use PIM PAM POM CHPIDs Avail. ----------------------------------------------------------------------------- 0.0.2f08 0.0.0a78 3390/0a 3990/e9 yes c0 c0 ff 34400000 00000000 good 0.0.2fe7 0.0.0b57 3390/0a 3990/e9 yes c0 c0 ff 34400000 00000000 good - This command limits the output to subchannel 0.0.0a78 and displays
uppercase output:
# lscss -u 0a78 Device Subchan. DevType CU Type Use PIM PAM POM CHPIDs ---------------------------------------------------------------------- 0.0.2F08 0.0.0A78 3390/0A 3990/E9 YES C0 C0 FF 34400000 00000000 - This command limits the output to subchannels that correspond
to I/O device 0.0.7e10 and the device range 0.0.2f00-0.0.2fff:
# lscss -d 2f00-2fff,0.0.7e10 Device Subchan. DevType CU Type Use PIM PAM POM CHPIDs ---------------------------------------------------------------------- 0.0.2f08 0.0.0a78 3390/0a 3990/e9 yes c0 c0 ff 34400000 00000000 0.0.2fe5 0.0.0b55 3390/0a 3990/e9 c0 c0 bf 34400000 00000000 0.0.2fe6 0.0.0b56 3390/0a 3990/e9 c0 c0 bf 34400000 00000000 0.0.2fe7 0.0.0b57 3390/0a 3990/e9 yes c0 c0 ff 34400000 00000000 0.0.7e10 0.0.1828 3390/0c 3990/e9 yes f0 f0 ef 34403541 00000000 - This example shows a CHPID with PIM, PAM, and POM
masks that are OK, but the entry in the VPM column indicates
that one of the paths, 0x41, is not usable for I/O.
# lscss --vpm Device Subchan. DevType CU Type Use PIM PAM POM VPM CHPIDs ------------------------------------------------------------------------- 0.0.f500 0.0.05cf 1732/01 1731/01 yes 80 80 ff 80 76000000 00000000 0.0.f501 0.0.05d0 1732/01 1731/01 yes 80 80 ff 80 76000000 00000000 0.0.f502 0.0.05d1 1732/01 1731/01 yes 80 80 ff 80 76000000 00000000 0.0.6194 0.0.3700 3390/0c 3990/e9 yes fc fc ff f8 32333435 40410000 0.0.6195 0.0.3701 3390/0c 3990/e9 yes fc fc ff f8 32333435 40410000 0.0.6196 0.0.3702 3390/0c 3990/e9 yes fc fc ff f8 32333435 40410000 0.0.6197 0.0.3703 3390/0c 3990/e9 fc fc ff 00 32333435 40410000 0.2.5600 0.2.0040 1732/03 1731/03 80 80 ff 00 5d000000 00000000