2 Category operating system. Contains the source tree of a set of
3 user space utilities that should to be used together with the
4 zSeries (s390) Linux kernel and device drivers.
9 Low-level format ECKD DASDs with the classical Linux disk layout or the new
10 z/OS compatible disk layout.
13 Create or modify partitions on ECKD DASDs formatted with the z/OS
14 compatible disk layout.
17 Display DASD and VTOC information or dump the contents of a DASD to the
21 Display unique DASD ID, either UID or volser.
24 - 59-dasd.rules: rules for unique DASD device nodes created in /dev/disk/.
25 - 57-osasnmpd.rules: udev rules for osasnmpd.
26 - 60-readahead.rules: udev rules to set increased "default max readahead".
29 Make DASDs or tapes bootable for system IPL or system dump.
32 Retrieve system dumps from either tapes or DASDs.
35 Read and flush the ARP cache on OSA Express network cards.
38 Display information on the message display facility of a zSeries tape
42 Control and query crypto settings for 3592 zSeries tape devices.
45 UCD-SNMP/NET-SNMP subagent implementing MIBs provided by OSA-Express
46 features Fast Ethernet, Gigabit Ethernet, High Speed Token Ring and
47 ATM Ethernet LAN Emulation in QDIO mode.
50 bash shell script simplifying the usage of qeth IPA (IP address
51 takeover), VIPA (Virtual IP address) and Proxy ARP.
54 Shell script collecting useful information about the current system for
58 Dump tool to create system dumps on fibre channel attached SCSI disks.
59 It is installed using the zipl command.
62 Version 2 of the zfcpdump tool. Now based on the upstream 2.6.26 Linux
66 Provides HiperSockets Network Concentrator functionality.
67 It looks for addresses in the HiperSockets and sets them as Proxy ARP
68 on the OSA cards. It also adds routing entries for all IP addresses
69 configured on active HiperSockets devices.
70 Use start_hsnc.sh to start HiperSockets Network Concentrator.
73 Adjust tunable parameters on DASD devices.
76 Convert system dumps created by the z/VM VMDUMP command into dumps with
77 LKCD format. These LKCD dumps can then be analyzed with the dump analysis
81 Allows Linux users to send commands to the z/VM control program (CP).
82 The normal usage is to invoke vmcp with the command you want to
83 execute. The response of z/VM is written to the standard output.
86 Allows to work with z/VM spool file queues (reader, punch, printer).
89 Display debug data of zfcp. zfcp provides traces via the s390 debug
90 feature. Those traces are filtered with the zfcpdbf script, i.e. merge
91 several traces, make it more readable etc.
94 Create, get or set the logging level for the SCSI logging facility.
97 Set of scripts to configure and list status information of Linux for
99 - chccwdev: Modify generic attributes of channel attached devices.
100 - lscss: List channel subsystem devices.
101 - lsdasd: List channel attached direct access storage devices (DASD).
102 - lsqeth: List all qeth-based network devices with their corresponding
104 - lstape: List tape devices, both channel and FCP attached.
105 - lszfcp: Shows information contained in sysfs about zfcp adapters,
106 ports and units that are online.
107 - lschp: List information about available channel-paths.
108 - chchp: Modify channel-path state.
109 - lsluns: List available SCSI LUNs depending on adapter or port.
110 - lszcrypt: Show Information about zcrypt devices and configuration.
111 - chzcrypt: Modify zcrypt configuration.
112 - znetconf: List and configure network devices for System z network
114 - cio_ignore: Query and modify the contents of the CIO device driver
118 Allows to configure the dump device used for system dump in case a kernel
119 panic occurs. This tool can also be used as an init script for etc/init.d.
120 Prerequisite for dumpconf is a Linux kernel with the "dump on panic"
124 Linux - z/VM monitoring daemons.
126 - mon_fsstatd: Daemon that writes file system utilization data to the
129 - mon_procd: Daemon that writes process information data to the z/VM
133 Daemon that manages CPU and memory resources based on a set of rules.
134 Depending on the workload CPUs can be enabled or disabled. The amount of
135 memory can be increased or decreased exploiting the CMM1 feature.
138 Tool set to configure and list reipl and shutdown actions.
139 - lsreipl: List information of reipl device.
140 - chreipl: Change reipl device settings.
141 - lsshut: List actions which will be done in case of halt, poff, reboot
143 - chshut: Change actions which should be done in case of halt, poff,
147 Tool set to collect data for zfcp performance analysis and report.
150 z/VM IUCV terminal applications.
152 A set of applications to provide terminal access via the z/VM Inter-User
153 Communication Vehicle (IUCV). The terminal access does not require an
154 active TCP/IP connection between two Linux guest operating systems.
156 - iucvconn: Application to establish a terminal connection via z/VM IUCV.
157 - iucvtty: Application to provide terminal access via z/VM IUCV.
158 - ts-shell: Terminal server shell to authorize and control IUCV terminal
159 connections for individual Linux users.
162 For more information refer to the following publications:
163 * "Device Drivers, Features, and Commands" chapter "Useful Linux commands"
164 * "Using the dump tools"
169 You need at least the UCD-SNMP 4.2.3 package installed, before
170 building the osasnmpd subagent.
171 For more information on UCD-SNMP/NET-SNMP refer to:
172 http://net-snmp.sourceforge.net/
175 For executing the lsluns script the sg_luns command must be available.
176 The sg_luns executable is part of the SCSI generic device driver package
177 (sg3 utils/sg utils).
180 For executing the ziomon tools an installed blktrace package is required.
181 See: git://git.kernel.dk/blktrace.git
187 - 60-readahead.rules: udev rules to set increased "default max readahead"
188 The current "default max readahead" defined by the kernel is too
189 small for s390. Add udev rule to set a better default value. This
190 will increase sequential read performance up to 40%.
192 Changes of existing tools:
193 - zipl: Improve I/O error recovery during IPL
194 Change the boot loader code to handle temporary path errors and link
197 - zipl: Remove DEFAULT_RAMDISK_ADDRESS
198 Using the default value has been replaced by calculating the address
199 dependent on the image size.
201 - lsqeth: Introduce "lay'2" column for "lsqeth -p"
202 Add new qeth attribute "isolation".
204 - qethconf: Indicate command failure and show message list
205 When qethconf detects a bad exit status of its issued echo
206 command, an error message is presented to the user.
207 In addition possible reasons for command failure can be
208 listed with "qethconf list_msg".
210 - dumpconf: Prevent reipl loop for dump on panic
211 A new DELAY_MINUTES keyword is introduced in the dumpconf
212 configuration file. The keyword delays the activation of dumpconf to
213 prevent potential re-IPL loops.
215 - dbginfo: Add new attributes
218 - cpuplugd: Fix file handling in get_cmmpages_size()
220 - fdasd, dasdinfo, tunedasd: Fix handling of read-only devices
221 A as long as a tool does not require write access do a block device,
222 it should open the device in read-only mode. Otherwise opening the
223 device may fail, and usability of the tool on read-only devices is
224 unnecessarily restricted.
226 - fdasd: Fix auto mode behavior
227 Fix the misbehavior of fdasd in case the -a or -i option is specified
228 and the label block is broken. Previously it asked interactively for
229 a new label. Now it exits with an error message.
231 - dasdview, fdasd: Fix floating point error for unformatted devices
232 When executed on an unformatted device the tools dasdview and fdasd
233 will end with an floating point exception error.
234 The reason for the error lies in the fact that we cannot rely on the
235 HDIO_GETGEO ioctl to report a correct number of cylinders and so we
236 compute the number of cylinders from the device size. However,
237 for unformatted devices the device size is zero and thus our
238 computation ends with a floating point exception.
239 To solve this issue read the correct number of cylinders from
240 the DASD device characteristics, which can be found in the data
241 returned by the BIODASDINFO ioctl.
243 - libvtoc: Fix string overflow in vtoc_volume_label_init()
244 Originally it tries to copy a 84B string into 4B field and reset also
245 the other fields through the overflow. This doesn't work with recent
248 - mon_statd: Improve init script
249 * stop: Do not print error messages if a daemon is not configured.
250 * start: Do not load module if no daemon is configured.
251 * Remove useless newlines.
253 - lscss: Fix uppercase conversion (appeared with -u option)
255 - lstape: Help function returns 1, although it was successful
256 Changed exit status of "lstape --help" from 1 to 0.
258 - znetconf: Index into chpidtype lookup table must be hex
259 Network subchannels with CHPID type containing non-decimal digits,
260 i.e. a-f, cause lsznet.raw errors. The value of the sysfs attribute
261 "type" of a CHPID is hex, but the lookup table index in the bash
262 script must be decimal. To solve the problem, we now
263 interpret "type" as hex number when used as lookup table index.
265 - chreipl: Fix SIGSEGV in "chreipl node"
266 When calling "chreipl node /dev/dasdxy" chreipl crashes with SIGSEGV.
267 The problem is a missing check in get_ccw_devno_old_sysfs(). Besides
268 of that at two places strncpy() was called with the wrong size.
270 - chshut: Disable panic action
271 The panic action should be configured using the dumpconf service.
272 Therefore we disable the possibility to configure it with chshut in
273 order to avoid conflicts.
275 - lsreipl: Add missing NSS support
277 - vmconvert: Ensure null termination of progress bar string
278 The progress bar shows control characters at end of line, because
279 one variable responsible for the progress bar has not been
280 initialized. We now initialize this variable correctly.
282 - vmconvert, zfcpdump_v2: Set correct LKCD end marker flag
284 - zfcpdump_v2: Ignore failure of modprobe
285 It is possible that all modules are built-in the zfcpdump kernel.
286 Therefore modprobe of those modules will fail and we must not
287 check the return value.
289 - ziomon: ziorep_traffic/utilization return 1 when called with -h & -v
290 These two tools return 1 when -h or -v are used as arguments. Changed
291 the return code in these cases to 0.
293 - zipl: zfcp dump partition error
294 The info structure was used after it was freed. This leads to wrong
295 partition information on the zfcp dump device. Therefore SCSI
296 dumps may fail. To fix this, we free the info structure after last
300 Changes of existing tools:
301 - zipl: Add support for device mapper devices.
302 Allow installation of and booting from a boot record on logical
303 devices, i.e. devices managed by device mapper (or similar products),
304 e.g. multipath devices.
311 Changes of existing tools:
312 - dasdview: Add solid state device support.
313 Extend the -c option to show if a disk is a solid state device or not.
315 - lscss: Also show devices on the defunct subchannel.
317 - all: Reworked s390-tools build process.
320 - dumpconf: Validate DEVICE keyword, enhance error handling.
321 The DEVICE keyword is accepted in both devno and bus-ID syntax.
322 In case of invalid keywords the corresponding error messages are more
325 - zipl: Ensure that zipl is built with non-executable stack.
326 The ".note.GNU-stack" section is lost when the boot loaders in zipl
327 are built. The reason is that objcopy removes all sections except
328 of the text section: $(OBJCOPY) -O binary --only-section=.text $< $@
329 When the linker finds a object file without the .note.GNU-stack
330 section, it forces the binary to have executable stack.
331 To fix the problem, the noexecstack option is used in the link step.
333 - zipl: "zipl --help" does not mention "--force".
334 Add information on the "--force" option introduced together with
337 - zipl: Don't use "Error" if user answered zipl confirmation prompt with no
338 For several operations zipl issues a confirmation prompt such as
339 "Do you want to continue creating a dump partition (y/n)".
340 If the user disagrees, there should be no error indication in the
341 "Operation canceled by user." message.
344 * Exit when trying to run zipl on an unknown device type.
345 * Skip check for invalid geometry on FBA devices.
346 * Fix use after free error when installing a multi-volume dump.
348 - vmur, ziomon tools: Install tools under "/usr/sbin" instead of "/sbin".
349 Because vmur and ziomon use libstdc++ that normally is installed under
350 "/usr/lib", we have to install the tools under "/usr/sbin".
352 - cpuplugd: Fix cmm_pages allocation.
353 Fix cmm_pages allocation outside min and max limitation.
356 * Strip trailing spaces from volume serials with less then 6
358 * Read volume serials also from CMS formatted disks.
361 Fixed disk encryption check that is performed when the new "--active"
362 command line switch is used.
365 * Fix reading of recovery trace.
366 * Fix tag checks in reading of hba trace.
367 * Fix output of els requests in san trace.
368 * Remove color output that only works on some terminal types.
369 * Remove output of no longer existing driver flags.
370 * Remove outdated code for support of 2.4.x kernels.
372 - ipl_tools (lsshut):
373 Fix printing of vmcmd shutdown action: Also print CP commands that
374 have more than one word.
377 Fixed a lot of build warnings and minor bugs.
383 Changes of existing tools:
384 - dump tools: Add support for "Automatic IPL after dump"
385 Kernels supporting the new shutdown action "dump_reipl" allow to
386 specify a re-IPL device that should be used after dump. To
387 exploit this feature the following tools have been updated:
389 Trigger IPL after dump, if specified.
391 Trigger IPL after dump, if specified.
393 Allow to specify "dump_reipl" in case a kernel panic occurs.
395 - DASD related tools: Add Large Volume Support for ECKD DASDs
396 The DASD device driver with "Large Volume Support" allows to access
397 ECKD DASD devices with more than 65520 cylinders. To exploit this
398 feature the following tools have been updated:
405 - ziomon: Add report utilities
406 New tools ziorep_config, ziorep_traffic and ziorep_utilization
407 for performance data report generation are added.
409 - vmur: Add "--convert" option
410 With this option a VMDUMP file can be converted into the LKCD dump
411 format while receiving it from the z/VM reader. LKCD dumps
412 can be processed by the Linux dump analysis tools lcrash and crash.
414 - lsluns: Add "--active" option
415 With this option all activated LUNs are shown. In addition LUN
416 encryption information is provided.
418 - dasdview: Add "--characteristic" option
419 With this option a list of hardware specific DASD characteristics is
420 shown. Currently only the encryption status is shown, this may
421 be extended for future releases.
423 - tunedasd: Normalize profile data
424 Change the scaling of DASD profile data from binary to decimal
425 shifting. Also print the scaling factor.
427 - qetharp, qethconf, osasnmpd and lsqeth:
428 removed 2.4 supporting code
430 - dasdfmt: Add "--norecordzero" option
431 With this option the permission for the subsystem to format record
434 - dasdfmt: Add "--percentage" option
435 With this option one line for each formatted cylinder is printed
436 showing the number of the cylinder and percentage of formatting
441 The 31-bit dump tools did not update the address portion of the
442 disabled wait psw with the error code. This omission has been fixed.
445 FBA dump tool can only dump up to 4GB. When dumping a Linux system
446 with more than 4GB on a FBA disk, a corrupt dump is generated, where
447 the first 4GB of memory are repeatedly dumped. The problem is that
448 the dumper code uses two 32 bit instructions, where 64 bit
449 instructions are required. To fix the problem 64 bit instructions are
452 - Remove -s option from install sections in Makefiles
453 Because the binaries have been stripped in the install step, the
454 debug info was not available for rpmbuild. Therefore the -s option
455 has been removed now.
457 - Improve LSB (Linux Standard Base) compliance of init scripts
460 The command "tape390_display <message1> <message2> <node>" can cause
461 message "stack smashing detected" if <message2> contains exactly
462 eight characters. This stack overwrite has been fixed.
465 Don't print newline for availability attributes containing blanks.
468 Suppress bash error message, if device is gone between test and
469 read of online attribute. Exit with error if no device was found
472 - chccwdev, lscss, lstape:
473 Add missing "-v" and "-V" (lstape) options.
476 Improve value checking.
479 Fix handling of new sysfs layout. Due to changes in the sysfs
480 dasdinfo did not find a block device to a given busid. Changed
481 dasdinfo to accept the new and the old sysfs layout.
485 - ipl_tools (lsreipl, chreipl, lsshut, chshut)
491 Changes of existing tools:
492 - zfcpdump_v2: Add support for memory holes
493 zfcpdump was not prepared to deal with multiple, non-contiguous
494 storage extents. This shortcoming has been fixed by introducing
495 a new debugfs file zcore/memmap which contains information on
496 start address and length of memory chunks.
498 - zfcpdump_v2: Update to latest e2fsprogs (1.41.3) and kernel (2.6.27)
501 - zipl: Support for virtio devices
502 This feature allows zipl to prepare virtio devices for ipl and dump.
504 - zipl dump tools: Add multi volume support
505 This feature adds the ability to dump on multiple ECKD DASD devices,
506 which can be necessary, if the system memory size is larger than
507 the size of a single DASD device.
509 - lscss: Support for non I/O subchannels
510 lscss now shows non I/O subchannels. New options to limit the output
511 to ranges of subchannels or devices have been added.
513 - lstape: Add SCSI tape support
514 With this feature it is now possible to list installed SCSI tapes
515 besides channel attached tapes.
517 - ip_watcher: New qeth driver support
518 Adapt ip_watcher to support sysfs interface of the qeth driver.
519 This is necessary to support the new implementation of the qeth driver
522 - osasnmpd: New qeth driver support
523 Adapt osasnmpd to new implementation of qeth driver (kernel 2.6.26),
524 which does no longer offer the sysfs attribute notifier_register.
525 Notification of added or removed OSA-cards now has to be done in
526 user space (udev). The udev rule file '57-osasnmpd.rules' is
527 provided now in the s390-tools package.
530 Collect additional system information.
534 The tape dump tool provided incorrect input for the progress message.
535 For memory sizes larger than 4G the progress message display stopped
536 at 3584M thus leaving the user in doubt, whether the dump tool is
537 still dumping or not.
540 With kernels 2.6.26 or above, the port_add attribute has been
541 removed which caused "Dump to SCSI disk" to fail with following
543 ERROR: Could not open /sys/bus/ccw/drivers/zfcp/<bus_id>/port_add
544 No such file or directory
545 This has now been fixed.
548 - correct presentation of DASD HPAV alias devices
549 - improve performance of script
550 - correct bug with non-privileged users
551 - adaption to sysfs rules
554 - cpuplugd/mon_statd:
555 Fix "Required Start/Stop" dependencies.
558 A bug which prevented CPUs from being set online again after
559 /etc/init.d/cpuplugd reload and restart has been fixed.
562 Changes of existing tools:
563 - zipl: IPL-retry on IFCC.
564 This feature causes the hardware to retry a CCW IPL operation on an
565 alternate channel-path if an interface-control check is detected
566 during execution of the CCW IPL operation.
568 - zipl: Boot menu can be used to replace kernel parameter string
569 zipl's boot menu for DASD devices has been changed to allow replacing
570 the complete kernel parameter string with user input when the first
571 character of user input is an equal sign ('=').
573 - cpuplugd: Enhanced configuration file parser
574 The parser of cpuplugd has been enhanced to provide more hints to
575 the user at which entry in the configuration file a configuration
578 - dumpconf: Add VMCMD support
579 The dumpconf init script now exploits the new "shutdown actions
580 interface" introduced with vanilla Linux kernel 2.6.25. Up to
581 five VM commands can be specified to be triggered in case of
584 - mon_fsstatd: Remove init script and sysconfig file
585 mon_fsstatd init script and sysconfig file are replaced by
586 mon_statd, which controls both monitor daemons mon_fsstatd and
589 - lszfcp: Source code cleanup
595 Changes of existing tools:
596 - dasdinfo: New -x/--extended-uid option.
597 With the PTF for APAR VM64273 installed, z/VM provides a unique
598 identifier that allows to distinguish between virtual disks which
599 are defined on the same real device. This identifier will be part
600 of the UID. To allow for an easier upgrade, the original -u/--uid
601 option will print the UID without this token and the
602 -x/--extended-uid will return the full UID.
610 - mon_procd (with new mon_statd init script and sysconfig file)
612 Changes of existing tools:
613 - Use "-O3" compile option for all tools.
614 - Update zipl to enable zfcpdump_v2.
624 Changes of existing tools:
625 - DASD/Tape dump tools:
626 SCLP console support to show dump progress on the operator console.
629 New -d option to check if DASD is a valid dump device.
631 - No more XML in zfcpdump:
632 Because XML is going to be obsolete, we now use the binary parameter
633 block provided by the hardware to find out on which scsi disk the dump
637 Collect additional system information.
639 - No libsysfs in DASD tools:
640 It turned out that using libsysfs is less stable than using the sysfs
641 attributes directly. Therefore the libsysfs dependency has been removed.
643 - Removed '-c' option of lsqeth.
645 - Unification of 'invalid option' error messages, Makefiles and "-v" output
655 - vmcp: tool for accessing the control program of z/VM using the
656 kernel module 'vmcp'.
658 - zfcpdbf: perl script to filter ZFCP debug (DBF) data.
660 Added new features for existing tools:
661 - vmconvert: 64bit support.
662 Enhance vmconvert that it can convert the new 64bit format
663 z/VM dumps in addition to the old format dumps.
665 - osasnmpd: implement long options
666 For for all options now also long options have been implemented
667 using the "getopt_long" function.
669 - dasdxxxx: DASD tool harmonization
670 Some changes are applied to dasdfmt, fdasd and dasdview either to
671 make the syntax more common to other Linux tools or to introduce
672 small enhancements to get better usability.
674 - zfcpdump: Update SCSI System Dumper
675 Replaced the old Linux 2.4.19 kernel with Linux 2.6.12 and
676 e2fsprogs version 1.32 with version 1.37.
677 The busybox will be removed completely, since the functionality
678 provided by busybox will be implemented manually.
680 - dbginfo.sh: collect additional debug output.
681 fixed collection of s390dbf files which moved to debugfs.
682 Changed behavior when trying to detect the kernel version.
686 - zconf/lsqeth: shell script to list all QETH based networking devices
688 Added new features for existing tools:
689 - dbginfo.sh: collect additional debug output,
690 corrected/changed command line handling
692 - zipl: added --dry-run function
693 This function can be used to simulate a zipl run without modifying
694 an existing IPL record.
696 - zipl: dump support for memory holes. Enables dumping for z/VM guests
697 with fragmented storage (defined with z/VM command
698 'define storage config').
700 - dasd tools: minor enhancements, rework and harmonization of the
703 1.3.2: Added new tool:
705 Added new features for existing tools:
706 - zipl: FBA dump support
708 1.3: Added new tools:
709 - zconf (chccwdev,lscss,lsdasd,lstape)
712 Added new features for existing tools:
713 - zipl: multi boot, IPL from tape, custom dump size limit
714 - dbginfo.sh: adaptions for Linux 2.6
716 1.2.2: Added new tool:
717 - ip_watcher/start_hsnc
719 1.2: Added new tools:
723 Added new features for existing tools:
724 - zipl: zfcp scsi ipl and dump support
725 - qetharp: static ARP support
726 - tape390_display: new tape load option and new message types
728 1.1: Added new tools:
734 1.0: Initial s390-tools release containing: