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 0.0. from the device bus-IDs in the command output. Note: This option limits the output to bus IDs that begin with 0.0.
- -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 that are listed in this mask are available to Linux® device drivers for I/O. Reasons for a channel path to be
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 when 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 Setting up VFIO pass-through DASDs.
- -a or --all
- does not limit the output.
- -t or --devtype
- limits the output to subchannels that correspond to devices of 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.
- -h or --help
- displays help information for the command. To view the man page, enter man lscss.
- -v or --version
- displays version information for the command.
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 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 prints 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. However, 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