s390-tools (1.3.1)
   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 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 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.

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

     - osasnmpd:        
          Description: Enable osasnmpd to work under 2.6 kernels
          Symptom:     Osasnmpd did not run under kernel due to interface 
                       changes in kernel 2.6.
          Problem:     Major changes were necessary because of using
                       sysfs instead of procfs for the communication 
                       between kernel and osasnmpd.
          Solution:    We now have separate directories that contain the 
                       source files for kernel versions 2.4 and 2.6.
                       In the main directory there is a script 'osasnmpd' 
                       which selects the right executable file according 
                       to the version of the Linux kernel where osasnmpd 
                       is started.
          Problem-ID:  -

     - fdasd:
          Description: Partitioning does not work when using configuration file.
          Symptom:     "fdasd error:  Config file syntax error".
          Problem:     The variable holding partition information is not fully
                       initialized (only for first partition).
          Solution:    Fully initialize variable.
          Problem-ID:  -

     - zipl:
          Description: Build problem with updated glibc-headers.
          Symptom:     Trying to compile zipl with updated glibc-headers does
                       not work.
          Problem:     zipl includes kernel header files.
          Solution:    Remove dependencies on kernel header files.
          Problem-ID:  -

     - qethconf:
          Description: Inconsistent Proxy Arp user messages
          Symptom:     User has to specify Proxy Arp with abbreviation parp
                       but all output messages for Proxy Arp show rxip
                       as abbreviation.
          Problem:     The Proxy Arp entry within sysfs has the name rxip.
                       This is the reason why all user output showed rxip
                       instead of parp.
          Solution:    Added some code which changes rxip into parp for
                       the user output.
          Problem-ID:  -

     - qetharp:
          Description: Problems when querying ARP cache with larger number 
                       of entries
          Symptom:     If a device's ARP cache contains a large number of 
                       entries, query ARP (qetharp -nq) results in an 
                       "unknown error" and fails.
          Problem:     User space buffer to receive ARP entries is 20000 
                       bytes and can only hold 454/526 entries (for 
                       OSA/HiperSockets).
          Solution:    Each entry contains 32 bytes of "media specific 
                       information" which is not used. Added an option to 
                       strip off these unused bytes before copying to user 
                       space. This "STRIP_ENTRIES" option can be set by
                       the qetharp user tool. Now it is possible to receive
                       1666/3333 entries.
          Problem-ID:  -

          Description: Change of SIOC definitions for qetharp
          Symptom:     Definitions socket ioctls used by qetharp have 
                       changed.
          Problem:     s390-tools qetharp and qeth driver must use same 
                       SIOC definitions.
          Solution:    Adapted SIOC definitions.
          Problem-ID:  -

     - dbginfo.sh:
          Description: /sys/bus/iucw not found
          Symptom:     iucv information not saved in output file
          Problem:     Typo in script
          Solution:    Use iucv instead of iucw
          Problem-ID:  -

     - zconf/chccwdev:
          Description: Command returns success in error case.
          Symptom:     Command returns done message if there is no online 
                       attribute.
          Problem:     Check expects online attribute to be present.
          Solution:    Include check whether online attribute is present.
          Problem-ID:  -

     - zfcpdump:
          Description: Enable kernel for gcc 3.3.3
          Symptom:     Kernel built with gcc 3.3.3 crashes
          Problem:     Due to gcc 3.3.3 optimizations init and setup functions 
                       are not compiled into the kernel.
          Solution:    Define init and setup functions with 
                       __attribute__((used))
          Problem-ID:  -


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

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
