s390-tools (1.3.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 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.
   * vmconvert, which is used to convert system dumps created by the zVM
     VMDUMP tool into dumps with lkcd format. These lkcd dumps can then be 
     analyzed with the dumpanalysis tool lcrash.

History of bug fixes:
=======================================
1.3.3:
     - qethconf:
          Description: Some minor changes
          Symptom:     Some misleading error messages/Layer2 not supported
          Problem:     -misleading messages for option inv4/inv6
                       -layer2 not supported
                       -check for non-existing interface not included
          Solution:    -fixed misleading messages for option inv4/inv6
                       -added layer2 support
                       -add check if interface exists
          Problem-ID:  12732

     - dasdfmt:
          Description: Should not leave a read only disk in bad state
          Symptom:     When dasdfmt is used on a read only disk it will fail 
                       and the the disk seems to be online but not usable.
                       lsdasd lists the disk as n/f This situation can be 
                       recovered by setting the disk offline and online again.
          Problem:     During the format process the disk is in a limited state
                       between offline an online. When an error occurs due to 
                       a read only disk the disk stays in that state and is 
                       not accessible.
          Solution:    Check the read only status of the disk before the disk 
                       state is modified.
          Problem-ID:  13859

1.3.2:
     added new features:

     - new tool: vmconvert
          With vmconvert it is possible to convert system dumps created by the 
          zVM VMDUMP tool into dumps with lkcd format. These lkcd dumps can then
          be analyzed with the dumpanalysis tool lcrash.
     - zipl: added FBA dump support
          With this support it is possible to prepare FBA disks for system
          dumps. 

     Bugfix:

     - dasdfmt, dasdview, fdasd:
          Description: dasd tools: Several dasd tools overwrite memory, since
                       allocated buffers are too small.
          Symptom:     Running fdasd, dasdfmt and dasdview results in
                       segmentation violations in certain error situations.
                       This was detected by the BEAM tool that does some
                       bound checking.
          Problem:     Allocated buffers that are used to write to by sprintf
                       are too small.
          Solution:    Increase buffer size and use snprintf instead of sprintf.
          Problem-ID:  10483

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.2: Added new tool:
       - vmconvert

       Added new features for existing tools:
       - zipl: added 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
