s390-tools overview

Overview of s390-tools

The following table lists the available s390-tools in alphabetical order showing:

  • Name of the tool and any major features added to it. The first s390-tools release which introduced the tool or feature is indicated in parentheses.
  • Short functional description of the tool.
Tool/feature Description
chccwdev (v1.3.0)
  • Use /proc/cio_settle (v1.9.0)
  • Add -s/--safeoffline feature (v1.21.0)
Script to modify generic attributes of channel attached devices; from zconf.
chchp (v1.6.2) Script to modify channel-path state; from zconf.
chcpumf (v1.25.0) Use the chcpumf tool to control the sampling facility support.
chmem (v1.9.0)
  • Try to online memory to zone movable (v1.38.0)
  • Removed from s390-tools (v2.2.0). This tool was moved to util-linux >= 2.30
Set hotplug memory online or offline; from zconf.
chreipl (v1.8.0)
  • Support virtio_ccw based devices (v1.29.0)
  • Introduce --force option for devices on cio_ignore list (v1.33.0)
  • Allow virtio devices as node targets (v1.34.0)
Change reipl device settings; from ipl_tools.
chshut (v1.8.0) Change actions which should be done in case of halt, poff, reboot or panic; from ipl_tools.
chzcrypt (v1.8.0)
  • Add multi domain support for zcrypt device driver (v1.37.0)
  • Reimplement in C (v1.37.0)
Script to modify zcrypt configuration; from zconf.
chzdev (v1.33.0)
  • Add support for resolving iSCSI block devices (v1.35.0)
  • Add device resolution for vlan and bonding devices (v1.36.0)
  • Add support for reading firmware configuration files (v2.5.0)
Tool to modify the persistent configuration of devices and device drivers which are specific to the s390 platform.
cio_ignore (v1.8.2)
  • Use /proc/cio_settle (v1.9.0)
  • Add new option -i / --is-ignored (v1.12.0)
Query and modify the contents of the CIO device driver blacklist; from zconf.
cmsfs-fuse (v1.9.0)
  • Add support to add, delete, and modify CMS files (v1.11.0)
  • Add a configuration file for automatic translation from EBCIDC to ASCII based on the file type (v1.12.0)
  • Remove the dasd info ioctls (v1.20.0)
Use the cmsfs-fuse command to read, add, delete, and modify files stored on a z/VM CMS disk. It is possible to mount a CMS disk and use common Linux tools to work with the files on the disk.
cpacfstats (v1.29.0) The cpacfstats tools provide a client/server application set to monitor and maintain CPACF activity counters
cpuplugd (v1.6.3)
  • Improved control of the cmm memory balloon and access to previous data (v1.15.0)
  • Improve default config file (v1.20.0)
  • Make default config file location more distribution agnostic (v1.35.0)
  • Add systemd service unit to start/stop the cpuplug daemon (v1.35.0)
Daemon that manages CPU- and memory-resources based on a set of rules. Depending on the workload CPUs can be enabled or disabled. The amount of memory can be increased or decreased exploiting the Cooperative Memory Management (CMM1) feature.
dasdfmt (v1.0.0)
  • DASD tool harmonization (v1.5.0)
  • Add "Large Volume Support" (v1.8.1)
  • Add "--norecordzero" option (v1.8.1)
  • Add "--percentage" option (v1.8.1)
  • Increase formatting speed (v1.23.0)
  • Remove "devfs support -n" option (v1.24.0)
  • Add quick format support (v1.36.0)
  • Add query host access to volume support (v1.36.0)
  • Remove deprecated option -f/--device (v1.37.1)
Low-level format ECKD DASDs with the classic Linux disk layout or the z/OS-compatible disk layout.
dasdinfo (v1.6.0) Display unique DASD ID, either uid or volser.
dasdstat (v1.16.0) Configure and format the debugfs based DASD statistics data.
dasdview (v1.0.3)
  • DASD tool harmonization (v1.5.0)
  • Add "Large Volume Support" (v1.8.1)
  • Add "--characteristic" option (v1.8.1)
  • Add solid state device support. (v1.8.2)
  • Remove "devfs support -n" option (v1.24.0)
  • Remove deprecated option -f/--device (v1.37.1)
Display DASD and VTOC information or dump the contents of a DASD to the console.
dbginfo (v1.1.0)
  • adaptions for linux kernel 2.6 (v1.3.0)
  • Add man page (v1.17.0)
  • Script execution in syslog (v1.24.0)
  • Allow to specify a directory for data collection (v1.26.0)
  • Add /etc/network/ (v1.34.0)
  • Add collection of domain xml files (v1.34.0)
  • Add Docker debug data (v1.37.1)
Shell script collecting useful information about the current system for debugging purposes.
dumpconf (v1.6.0)
  • VMCMD support (v1.7.0)
  • Add support for "Automatic IPL after dump" (v1.8.1)
  • Prevent re-IPL loop for dump on panic (v1.8.4)
  • Add PSW restart support (v1.17.0)
Allows to configure the dump device used for system dump in case a kernel panic occurs. This tool can also be used as an init script for etc/init.d. Prerequisite for dumpconf is a Linux kernel with the "dump on panic" feature.
dump2tar (v1.37.0) Sysfs collection helper for dbginfo.sh.
fdasd (v1.0.0)
  • DASD tool harmonization (v1.5.0)
  • Add 'Large Volume Support' (v1.8.1)
  • New partition types "Linux raid" and "Linux LVM" (v1.14.0)
  • Add -f/--force option to support non DASD devices (v1.20.0)
  • Add 'gpfs' as new partition type (v1.26.0)
  • Allow to specify GiB unit for partition size (v1.27.0)
  • Add query host access to volume support (v1.36.0)
  • Add new command action 'l' to list known partition types (v1.38.0)
Create or modify partitions on ECKD DASDs formatted with the z/OS compatible disk layout.
hmcdrvfs (v1.28.0) File system for remote access to media in the HMC media drive.
hyptop (v1.12.0)
  • Remove "minimum weight" attribute for z/VM (v1.25.0)
  • Add new field "Number of operation CPUs" (v1.25.0)
  • Introduce per-CPU view for "sys" window (v1.25.0)
  • Add multithreading support (v1.30.0)
  • Add support for diag 0c management time (v1.30.0)
Provides a dynamic real-time view of a System z hypervisor environment, z/VM or LPAR, showing for example CPU and memory consumption of active LPARs or z/VM guests.
[ipl_tools] (v1.8.0) Set of tools to configure and list reipl and shutdown actions.
  • chreipl: Change reipl device settings.
  • chshut: Change actions which should be done in case of halt, poff, reboot or panic.
  • lsreipl: List information of reipl device.
  • lsshut: List actions which will be done in case of halt, poff, reboot or panic.
ip_watcher (v1.2.2)
  • Adapt to support changes in the qeth driver with kernel 2.6.26 (v1.8.0)
Provides HiperSockets Network Concentrator functionality. It looks for addresses in the HiperSockets and sets them as Proxy ARP on the OSA cards. It also adds routing entries for all IP addresses configured on active HiperSockets devices. Use start_hsnc.sh to start HiperSockets Network Concentrator.
iucvterm (v1.8.1)
  • chiucvallow: Introduce wildcard filter entries (v1.30.0)
z/VM IUCV terminal applications: A set of applications to provide terminal access via the z/VM Inter-User Communication Vehicle (IUCV). The terminal access does not require an active TCP/IP connection between two Linux guest operating systems.
  • iucvconn: Application to establish a terminal connection via z/VM IUCV.
  • iucvtty: Application to provide terminal access via z/VM IUCV.
  • ts-shell: Terminal server shell to authorize and control IUCV terminal connections for individual Linux users.
lschp (v1.6.2) Script to list information about available channel-paths; from zconf.
lscpumf (v1.25.0)
  • Add hardware counters for z13 and z13s (v1.39.0)
  • Add support for IBM z14 hardware counters (v2.3.0)
Use the lscpumf tool to display information about the CPU-measurement counter and sampling facilities.
lscss (v1.3.0)
  • Show non I/O subchannels (v1.8.0)
  • Also show devices on the defunct subchannel.(v1.8.2)
  • Add support for EADM subchannels.(v1.20.0)
  • Add --vpm option(v1.22.0)
  • Reimplement lscss script in C (v1.39.0)
Script to list channel subsystem devices; from zconf.
lsdasd (v1.3.0)
  • Add path information (v1.28.0)
  • Add query host access to volume support (v1.36.0)
  • Add channel path aware erp (v1.37.0)
Script to list channel attached direct access
lsluns (v1.8.0)
  • Add "--active" option (v1.8.1)
Script to list available SCSI LUNs depending on adapter or port; from zconf.
Note: For executing the lsluns script the sg_luns command must be available. The sg_luns executable is part of the SCSI generic device driver package (sg3 utils/sg utils).
lsmem (v1.9.0)
  • Removed from s390-tools (v2.2.0). This tool was moved to util-linux >= 2.30
Display the online status of the available memory; from zconf.
lsqeth (v1.4.0)
  • Introduce "lay'2" column for "lsqeth -p" and new qeth attribute "isolation" (v1.8.4)
  • Add new qeth attribute "sniffer" (v1.9.0)
  • Provide more detailed output for virtual NICs (v1.18.0)
  • Add support for new card type value (v1.20.0)
  • Support bridgeport related attributes (v1.25.0)
  • Support new priority queueing modes (v1.26.0)
  • Add support for switch port attributes (v1.27.0)
  • Support bridge_reflect_promisc sysattr (v1.32.0)
  • Reimplement lsqeth script in C (v1.39.0)
Script to list all qeth-based network devices with their corresponding settings; from zconf.
lsreipl (v1.8.0)
  • Add stand-alone kdump support (v1.18.0)
List information of reipl device; from ipl_tools.
lsscm (v1.20.0) List information about available storage-class memory increments.
lsshut (v1.8.0)
  • Add kdump and PSW restart support (v1.17.0)
List actions which will be done in case of halt, poff, reboot or panic; from ipl_tools.
lstape (v1.3.0)
  • Show FCP-attached tape devices (v1.8.0)
Script to list tape devices, both channel-attached and FCP-attached; from zconf.
lszcrypt (v1.8.0)
  • Add support for CEX4 crypto Cards (v1.20.0)
  • Add support for EP11 coprocessor cards (v1.25.0)
  • Add support for CEX5S adapters (v1.30.0)
  • Add multi domain support for zcrypt device driver (v1.37.0)
  • Reimplement in C (v1.37.0)
  • Add support for CEX6S adapters (v2.2.0)
  • Add support for alternative zcrypt device drivers (v2.7.0)
Script to show information about zcrypt devices and configuration; from zconf.
lszdev (v1.33.0)
  • Add support for resolving iSCSI block devices (v1.35.0)
  • Add device resolution for vlan and bonding devices (v1.36.0)
Tool to display the persistent configuration of devices and device drivers which are specific to the s390 platform.
lszfcp (v1.5.2/3) Script to show information contained in sysfs about zfcp adapters, ports and units that are online; from zconf.
mon_statd (v1.5.6) Starts Linux-z/VM monitoring daemons.
  • Daemon that writes filesystem utilization data to the z/VM monitor stream.
  • Daemon that writes process information data to the z/VM monitor stream.
netboot (v2.1.0)
  • Add add BOOTIF support (v2.6.0)
Scripts for building a PXE-style netboot image for KVM.
osasnmpd (v1.1.0)
  • Adapt to support changes in the qeth driver with kernel 2.6.26 (v1.8.0)
  • Remove support for deprecated UCD-SNMP package (v1.33.0)
NET-SNMP subagent implementing MIBs provided by OSA-Express features Fast Ethernet, Gigabit Ethernet, and 10 Gigabit Ethernet.
Note: You need at least the UCD-SNMP 4.2.3 package installed, before building the osasnmpd subagent.
For more information on NET-SNMP refer to: http://net-snmp.sourceforge.net/
qetharp (v1.1.0)
  • Static arp support (v1.2.0)
  • Add IPv6 support for HiperSockets (v1.13.0)
Read and flush the ARP cache on OSA Express network cards.
qethconf (v1.2.0) bash shell script simplifying the usage of qeth IPA (IP address takeover), VIPA (Virtual IP address) and Proxy ARP for layer 3.
qethqoat (v1.18.0)
  • Add support for VEPA mode (v1.22.0)
  • Add support for OSA-Express5S adatpters (v1.26.0)
  • Add support for OSA-Express7S adatpters (v2.7.0)
Query the OSA address table (OAT) and display physical and logical device information
scsi_logging_level (v1.5.2/3) Create, get or set the logging level for the SCSI logging facility.
systemd units
  • iucvtty-login@.service: Instance unit to manage iucvtty instances (v1.25.0)
  • ttyrun-getty@.service: Instance unit to manage ttyrun (v1.25.0)
  • cpi.service: Unit to apply CPI settings (v1.38.0)
  • dumpconf.service: Unit to configure dump on panic for System z (v1.38.0)
  • mon_fsstatd.service: Unit for mon_fsstatd (v1.38.0)
  • mon_procd.service: Unit for mon_procd (v1.38.0)
s390 specific units for systemd.
tape390_crypt (v1.5.6) Control and query crypto settings for 3592 tape devices.
tape390_display (v1.1.0)
  • New tape load option and new message types (v1.2.0)
Display information on the message display facility of a tape device.
ttyrun (v1.9.0)
  • Introduce --verbose option (v1.17.0)
The ttyrun tool safely starts getty programs and prevents respawns through the init program, if a terminal is not available.
tunedasd (v1.3.0)
  • Normalize profile data (v1.8.1)
  • Add new option -Q / --query_reserve to determine the reservation status of a device (v1.12.0)
  • Add channel path aware erp (v1.37.0)
Adjust tunable parameters on DASD devices.
udev rules
  • 59-dasd.rules: Rules for unique DASD device nodes created in /dev/disk/ (v1.6.0)
  • 57-osasnmpd.rules: Rules for osasnmpd. (v1.8.0)
  • 60-readahead.rules: Rules to set increased 'default max readahead' (v1.8.4)
  • 40-z90crypt.rules: Rules for z90crypt driver(v1.17.1)
  • 90-cpi.rules: Udev Rules to update CPI when KVM is used (v2.1.0)
s390 specific udev rules.
vmconvert (v1.3.2)
  • 64bit support (v1.5.0)
  • Add CPU lowcore pointers to asm dump header (v1.9.0)
  • Improve checking of valid VMDUMPs (v1.26.0)
Convert system dumps created by the z/VM VMDUMP command into dumps with LKCD format.
These LKCD dumps can then be analyzed with the dump analysis tools lcrash or crash.
vmcp (v1.5.0) Allows Linux users to send commands to the z/VM control program (CP). The normal usage is to invoke vmcp with the command you want to execute. The response of z/VM is written to the standard output.
vmur (v1.6.2)
  • Add "--convert" option (v1.8.1)
  • Introduce ur device session management to manipulate spool options (v1.31.0)
Allows to work with z/VM spool file queues (reader, punch, printer).
[zconf] Set of scripts to configure and list status information of Linux on System z devices.
  • chccwdev: Modify generic attributes of channel attached devices.
  • chchp: Modify channel-path state.
  • chmem: Set hotplug memory online or offline.
  • chzcrypt: Modify zcrypt configuration.
  • cio_ignore: Query and modify the contents of the CIO device driver blacklist.
  • lschp: List information about available channel-paths.
  • lscss: List channel subsystem devices.
  • lsdasd: List channel attached direct access storage devices (DASD).
  • lsluns: List available SCSI LUNs depending on adapter or port.
    Note: For executing the lsluns script the sg_luns command must be available. The sg_luns executable is part of the SCSI generic device driver package (sg3 utils/sg utils).
  • lsmem: Display the online status of the available memory.
  • lsqeth: List all qeth-based network devices with their corresponding settings.
  • lsscm: List information about available Storage Class Memory Increments.
  • lstape: List tape devices, both channel-attached and FCP-attached.
  • lszcrypt: Show information about zcrypt devices and configuration.
  • lszfcp: Shows information contained in sysfs about zfcp adapters, ports and units that are online.
  • znetconf: List and configure network devices for System z network adapters.
zcryptctl (v2.7.0) Tool to manage multiple zcrypt nodes.
zdsfs (v1.24.0)
  • Add query host access to volume support (v1.36.0)
  • Add online VTOC refresh (v2.8.0)
Use the zdsfs command to mount a z/OS DASD as Linux file system.
zfcpdbf (v1.5.0)
  • Adjust to 2.6.38 zfcp driver changes (v1.13.0)
Display debug data of zfcp. zfcp provides traces via the s390 debug feature. Those traces are filtered with the zfcpdbf script, i.e. merge several traces, make it more readable etc.
zfcpdump (v1.2.0)
  • Update to kernel 2.6.12 (v1.5.0)
  • No more XML in zfcpdump (v1.5.6)
  • Upstream zfcpdump v2 (v1.6.2)
  • Add support for "Automatic IPL after dump" (v1.8.1)
  • Add CPU lowcore pointers to asm dump header (v1.9.0)
  • Add support for SCSI partition dump (zipl -d option) (v1.24.0)
  • Remove support for SCSI file system dump (zipl -D option) (v1.24.0)
Dump tool to create system dumps on fibre channel attached SCSI disks. It is installed using the zipl command.
zfcpdump v2 is the second version of the zfcpdump tool which was first integrated into upstream kernel 2.6.23.
zgetdump (v1.0.0)
  • New -d option (v1.5.6)
  • Add dump conversion and mount support (v1.9.0)
  • Remove multi-volume tape dump support (v1.9.0)
  • Add kdump support for --info option (v1.12.0)
  • Add kdump and vmcoreinfo support (v1.17.0)
  • Add stand-alone kdump support (v1.18.0)
  • Add live dump support (v1.19.0)
  • Improve text for --help option (v1.20.0)
  • Enhance --select option handling (v1.23.1)
  • Change default target dump format from s390 to ELF (v1.23.1)
  • Print progress messages every 10 seconds (v1.27.0)
  • Add vector register support (v1.28.0)
  • Enable DASD multi-volume dump for
    ssid != 0 (v1.33.0)
  • Add verbose option (v2.4.0)
Retrieve system dumps from either tapes or DASDs.
ziomon tools (v1.8.0)
  • Add report utilities for performance data report generation (v1.8.1)
Set of tools to collect data for zfcp performance analysis.
Report utilities (ziorep_config, ziorep_traffic, ziorep_utilization) for performance data report generation.
zipl (v1.0.0)
  • SCSI IPL/dump support (v1.2.0)
  • Multi boot, IPL from tape, custom dump size limit (v1.3.0)
  • FBA dump support (v1.3.2)
  • Add "--dry-run" option (v1.4.0)
  • Dump support for memory holes (v1.4.0)
  • SCLP console support for dump tools (v1.5.6)
  • IPL-retry support on IFCC. (v1.7.0)
  • Boot menu can be used to replace the kernel parameter string (v1.7.0)
  • Add "Large Volume Support" in zipl and zipl dump tools (v1.8.1)
  • Add support for "Automatic IPL after dump" (v1.8.1)
  • Add device mapper support (v1.8.3)
  • Improve I/O error recovery during IPL (v1.8.4)
  • Automatically calculate the ramdisk address dependent on the kernel image size (v1.8.4)
  • Add support for automatic menus (v1.11.0)
  • Add stand-alone kdump support (v1.18.0)
  • Flexible IPL record and addl. virtblock support (v1.20.0)
  • Rewrite boot loaders in C (v1.24.0)
  • Add vector register support for dump (v1.28.0)
  • Implement ECKD track I/O for more performance during dump (v1.28.0)
  • Add MT dump support (v1.30.0)
  • Enable DASD multi-volume dump for
    ssid != 0 (v1.33.0)
  • Always build and link without PIE (v2.3.0)
  • Extend DASD stand-alone dumpers to drop zero pages (v2.4.0)
  • Add BootLoaderSpec support (v2.5.0)
  • Make zipl work with XFS by using the FIEMAP mapping ioctl (v2.7.0)
Make DASDs or tapes bootable for system IPL or system dump.
zkey (v1.39.0)
  • Add build dependency to OpenSSL (libcrypto) (v2.4.0)
  • Add keystore implementation (v2.4.0)
Use the zkey tool to generate secure AES keys that are enciphered with a master key of an IBM cryptographic adapter in CCA coprocessor mode. You can also use the zkey tool to validate and re-encipher secure AES keys.
zkey-cryptsetup (v2.6.0) Manage secure AES volume keys of volumes encrypted with LUKS2 and the paes cipher.
znetconf (v1.8.2)
  • Add support for new CHPIDs OSX and OSM (v1.10.0)
  • Allow uppercase character in device bus-IDs (v1.23.1)
  • Remove claw-driver related entries (v1.31.0)
  • Remove LCS p390 device (v1.32.0)
  • Remove OSN-support (v1.37.0)
List and configure network devices for System z network adapters; from zconf.
zpcictl (v2.7.0) Tool for reporting defective PCI devices.