s390-tools (1.5.3)
   Category operating system. Contains the source tree of a set of
   user space utilities that should to be used together with the
   zSeries (s390) Linux kernel and device drivers.
   The package contains:
   * dasdfmt, which is used to low-level format eckd-dasds with
     the classic linux disk layout or the new z/OS compatible disk layout.
   * fdasd, which is used to create or modify partitions on
     eckd-dasds formatted with the z/OS compatible disk layout.
   * dasdview, which is used to display DASD and VTOC information
     or to dump the content of a DASD to the console.
   * zipl, which is used to make dasds or tapes bootable for system IPL
     or system dump.
   * zgetdump, which is used to retrieve system dumps from either
     tapes or dasds.
   * qetharp, which is a tool to read and flush the ARP cache on the
     OSA Express network cards.
   * tape390_display, which is used to display messages on the display
     unit of a zSeries tape device.
   * osasnmpd, which is an ucd-snmp/net-snmp subagent implementing MIBs provided
     by OSA-Express features Fast Ethernet, Gigabit Ethernet, High Speed Token
     Ring and ATM Ethernet LAN Emulation in QDIO mode.
     Note: You need at least the ucd-snmp 4.2.3 package installed, before
     building the osasnmpd subagent.
     For more information on ucd-snmp/net-snmp go to:
     http://net-snmp.sourceforge.net/
   * qethconf, which is a bash shell script, that simplifies the usage of
     qeth IPA (IP address takeover), VIPA (Virtual IP address) and Proxy ARP.
   * dbginfo.sh, a shell script which collects useful information about
     the current system for debugging purposes.
   * zfcpdump, which is a dump tool to create system dumps on fibre channel
     attached SCSI disks. It is installed using the zipl command.
   * ip_watcher, 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.
   * zconf, which consists out of a set of scripts to configure and list
     status information of Linux for zSeries IO devices.
   * tunedasd, which is used to adjust tunable parameters on DASD devices.
   * vmconvert, which is used to convert system dumps created by the z/VM
     VMDUMP tool into dumps with lkcd format. These lkcd dumps can then be
     analyzed with the dumpanalysis tool lcrash.
   * vmcp, which allows Linux users to send commands to the control program of
     z/VM. 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.
   * zfcpdbf, which is used to 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.
   * scsi_logging_level, which is used to create, get or set the logging level
     for the scsi logging facility.
   * lszfcp, which shows information contained in sysfs about zfcp
     adapters, ports and units that are online



History of bug fixes:
=====================

1.5.3
    - scsi_logging_level:
          Description: scsi_logging_level -v does not work
          Symptom:     scsi_logging_level -v does not show version of
                       s390-tools.
          Problem:     Placeholder for s390-tools version was not replaced
                       during installation.
          Solution:    Adapt Makefile to replace the placeholder with
                       s390-tools version.
          Problem-ID:  22613

    - dasdview:
          Description: dasdview: Validate characteristics and confdata before
                       printing.
          Symptom:     Device characteristics and configuration data are always
                       reported	by dasdview, even if they are undefined.
	  Problem:     The constant size of the buffer is used for checking
                       valid data amount.
          Solution:    Use 'characteristics_size' and 'confdata_size' to check
                       amount of data to be reported.
          Problem-ID:  22533

    - zconf/lszfcp:
          Description: lszfcp: directory of block device not printed.
          Symptom:     "lszfcp -D -V" does not show the directory of the block
                       device.
          Problem:     Symbolic link from scsi device to its block device was
                       renamed with kernel version 2.6.16.
          Solution:    Adapt lszfcp to work with old and new symlink names for
                       the link from a scsi_device to its block device.
          Problem-ID:  -

    - zconf/lsdasd
          Description: lsdasd: lsdasd shows internal errors to user.
          Symptom:     When the blockdev command issues error messages they
                       will go to the screen.
          Problem:     stderr is not suppressed for the blockdev call.
          Solution:    Re-direct stderr to /dev/null.
          Problem-ID:  22501

    - zconf/chccwdev:
          Description: Generic attributes are only set on first device of a
                       range.
          Symptom:     When using generic attributes with more than one device,
                       only the first device will be set correctly.
          Problem:     The attribute values are deleted to handle pre- and
                       post-online attributes but not restored for the next
                       device.
          Solution:    Remember the values of the generic attributes and
                       restore them before working on the next device.
          Problem-ID:  22498

    - zconf/chccwdev:
          Description: s390-tools(zconf): Various problems with chccwdev.
          Symptom:     1. The first devno that doesn't exist in a range will
                          cause an error.
                       2. Using more than two generic attributes causes the
                          command to hang.
                       3. Use of a devno with more than 4 digits was not
                          detected as error.
                       4. Upper-case character in devnos were not accepted.
          Problem:     1. Ranges expanded to full list of devices.
                       2. Missing increment of an internal counter.
                       3. Missing check for number of digits.
                       4. Missing conversion of input string.
          Solution:    1. Range is expanded to list of existing devices in 
                          range.
                       2. Added increment.
                       3. Check for number of digits in devno.
                       4. Convert busid strings to lowercase.
          Problem-ID:  22070

    - zfcpdump:
          Description: zfcpdump: SCSI dump does not work if too many I/O devices
                       are attached to the system.
          Symptom:     System seems to hang after the two MLO-Machine-Loader
                       messages. No zfcpdump message at all and the CPU is
                       looping.
          Problem:     zfcp dump runs out of memory in case there are too
                       many I/O devices present, because all of them will be
                       probed and memory will be allocated.
                       zfcpdump is restricted to 32MB memory.
          Solution:    Probe only the IPL device and nothing else.
          Problem-ID:  22563

    - zfcpdump:
          Description: zfcpdump: Make zfcpdump kernel compile with gcc 4.1
          Symptom:     Compile error in uaccess.h __get_user()
          Problem:     Imperfect definition of __get_user() according to gcc 4.1
          Solution:    Change __get_user() primitive.
          Problem-ID:  22564

    - osasnmpd:
          Description: osasnmpd: improve handling of interface changes
          Symptom:     OSA-interfaces not shown when added while osasnmpd is running
          Problem:     netsnmp updates its "number of interfaces" counter within
                       60 seconds after a change in the number of networking interfaces.
                       But osasnmpd tries to update its interfaces immediately after
                       adding or removing a qeth-interface. That means snmpd and osasnmpd
                       are no longer in sync regarding the number of interfaces.
          Solution:    Schedule a second invocation of update_mib_info() 70 seconds
                       after the first invocation.
          Problem-ID:  15130



1.5.2:
    - New tool: zconf/lszfcp
          Description: shell script to display information on zfcp
                       adapters, ports and units

    - New tool: scripts/scsi_logging_level
          Description: shell script to create, get, set the scsi logging level

    - zconf/lsdasd:
          Description: lsdasd: shows incorrect information.
          Symptom:     lsdasd shows some device as not-formatted with invalid
                       major and minor numbers.
          Problem:     Latest changes to the sysfs layout broke the internal
                       query.
          Solution:    Change query to work with all sysfs versions.
          Problem-ID:  20903

    - zconf/ldasd, lstape, lscss, chccwdev:
          Description: ldasd, lstape, lscss, chccwdev: Sysfs mountpoint 
                       hardcoded to /sys for various tools.
          Symptom:     The tools lsdasd, lstape, lscss and chccwdev may fail
                       if sysfs is not mounted to /sys.
          Problem:     The path to sysfs was hardcoded.
          Solution:    Dynamically check where sysfs is mounted.
          Problem-ID:  21499

    - zconf/chccwdev:
          Description: chccwdev: Cannot set generic attributes with
                       chccwdev.
          Symptom:     The chccwdev command does not support other attributes
                       than online.
          Problem:     Generic attribute support was not available.
          Solution:    Added support.
          Problem-ID:  21498

     - zipl:
          Description: zipl: missing check for overlapping boot components
          Symptom:     Booting a system initialized by zipl may fail without
                       warning in case kernel image gets too large.
          Problem:     In the standard configuration, large kernel images
                       (> 8 MB) may overlap the initial ramdisk component
                       during IPL. zipl does not check for this type of
                       misconfiguration.
          Solution:    Add a check to zipl that aborts with an error message
                       when it identifies overlapping components.
          Problem-ID:  -

     - zipl:
          Description: zipl: zipl fails when /tmp is mounted with option 'nodev'
          Symptom:     When trying to run zipl on a system which has /tmp
                       mounted with option 'nodev', it will fail with the
                       non-descriptive error message 'Permission denied'.
          Problem:     zipl tries to create temporary device nodes in /tmp
                       which may be configured not to allow device nodes.
                       In addition the fallback logic implemented in zipl
                       that should try different paths for temporary device
                       nodes if one path fails does not cover this error case.
          Solution:    Try to create temporary device nodes in /dev first.
                       Also fix fallback logic to cover 'nodev'-mounted
                       filesystems.
          Problem-ID:  -

     - tunedasd:
          Description: tunedasd: Misleading tunedasd message after profile
                       reset.
          Symptom:     Message 'Profiling seems to be inactive' when profile
                       info is read directly after profile-reset.
          Problem:     The IOCTL BIODASDPRRD had no return code for 'profiling
                       is inactive' and therefore tunedasd wrote this message
                       for request-counter = 0.
                       But this is also true for active profiling when read
                       prior to first request processing.
          Solution:    Introduced return-code EIO for inactive profiling and
                       check against EIO.
          Problem-ID:  20026

     - vmconvert:
          Description: vmconvert: compile error in dump.h
          Symptom:     Compile of vmconvert with a new gcc fails with messages
                       error: extra qualification 'ProgressBar::' on member
                       'initProgress'
          Problem:     In the definition of class ProgressBar the method
                       initProgress is explicitly qualified as
                       'ProgressBar::initProgress'.
                       Looks like older gcc versions tolerate this, but newer
                       versions do not. The file compiled with
                       'gcc (GCC) 4.0.3 20051013 (prerelease)' but failed
                       with 'gcc (GCC) 4.1.0 20051205 (prerelease)'.
          Solution:    Remove extra qualification from class definition.
          Problem-ID:  20666

     - vmcp:
          Description: vmcp: rearrange error messages and return codes to
                       cover all possible cases with useful information
          Symptom:     some error cases missed detailed information
          Problem:     misleading error messages
          Solution:    rearrange the error codes and messages, other cleanups
          Problem-ID:  19648


1.5.1:

     - vmcp:
          Description: Rearrange error messages and return codes to cover all
                       possible cases with useful information.
          Symptom:     Some error cases missed detailed information.
          Problem:     Misleading error messages.
          Solution:    Rearrange the error codes and messages, other cleanups.
          Problem-ID:  19648

     - zipl:
          Description: Compilation failure when using binutils 2.16.
          Symptom:     Any attempt to compile the zipl tool with
                       binutils 2.16 (and above) will fail with an error.
          Problem:     Some of the assembler .macro statements contained in
                       zipl are malformed. Newer versions of the GNU assembler
                       will report these Occurrences as errors and abort
                       compilation.
          Solution:    Fix the .macro statements.
          Problem-ID:  19415

     - zfcp:
          Description: zfcpdbf script does not check command line parameters
                       for validity.
          Symptom:     zfcpdbf script accepts 0 as 'switch off' and all other
                       values as 'switch on'.
          Problem:     zfcpdbf does not check command line parameters for
                       validity.
          Solution:    Check all command line parameters, if any is wrong
                       show help message and quit.
          Problem-ID:  19281

     - lsdasd:
          Description: lsdasd man page and online help inconsistent.
          Symptom:     "lsdasd -v" and "man lsdasd" show slightly different
                       information.
          Problem:     See symptom.
          Solution:    Adapt files to be consistent.
          Problem-ID:  19110



Release History:
================

1.5.0:
     Added new tool:
     - vmcp: tool for accessing the control program of z/VM using the
          kernel module 'vmcp'.

     - zfcpdbf: perl script to filter ZFCP debug (DBF) data.

     Added new features for existing tools:
     - vmconvert: 64bit support.
          Enhance vmconvert that it can convert the new 64bit format
          z/VM dumps in addition to the old format dumps.

     - osasnmpd: implement long options
          For for all options now also long options have been implemented
          using the "getopt_long" function.

     - dasdxxxx: DASD tool harmonization
          Some changes are applied to dasdfmt, fdasd and dasdview either to
          make the syntax more common to other Linux tools or to introduce
          small enhancements to get better usability.

     - zfcpdump: Update SCSI System Dumper
          Replaced the old Linux 2.4.19 kernel with Linux 2.6.12 and
          e2fsprogs version 1.32 with version 1.37.
          The busybox will be removed completely, since the functionality
          provided by busybox will be implemented manually.

     - dbginfo.sh: collect additional debug output.
          fixed collection of s390dbf files which moved to debugfs.
          Changed behaviour when trying to detect kernelversion.

1.4.0:
     Added new tool:
     - zconf/lsqeth: shell script to list all QETH based networking devices

     Added new features for existing tools:
     - dbginfo.sh: collect additional debug output,
          corrected/changed command line handling

     - zipl: added --dry-run function
          This function can be used to simulate a zipl run without modifying
          an existing IPL record.

     - zipl: dump support for memory holes. Enables dumping for z/VM guests
          with fragmented storage (defined with z/VM command
          'define storage config').

     - dasd tools: minor enhancements, rework and harmonization of the
          commandline options

1.3.2: Added new tool:
     - vmconvert
     Added new features for existing tools:
     - zipl: FBA dump support

1.3: Added new tools:
     - zconf (chccwdev,lscss,lsdasd,lstape)
     - tunedasd

     Added new features for existing tools:
     - zipl: multi boot, IPL from tape, custom dump size limit
     - dbginfo.sh: adaptions for linux 2.6

1.2.2: Added new tool:
     - ip_watcher/start_hsnc

1.2: Added new tools:
     - qethconf
     - zfcpdump

     Added new features for existing tools:
     - zipl: zfcp scsi ipl and dump support
     - qetharp: static arp support
     - tape390_display: new tape load option and new message types

1.1: Added new tools:
     - dbginfo.sh
     - osasnmpd
     - qetharp
     - tape390_display

1.0: Initial s390-tools release containing:
     - dasdfmt
     - dasdview
     - fdasd
     - zgetdump
     - zipl
