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



History of bug fixes:
=======================================
1.2.4:
      - zfcpdump:
            Description: zfcpdump: build error with ext2 ramdisk
            Symptom:     Build error when using ext2 filesystem for ramdisk
            Problem:     Mount point 'mnt' is not created automatically
            Solution:    Create mountpoint before mounting the ext2 filesystem
            Problem-ID:  5570
      
      - ip_watcher:
            Description: ip_watcher messages about parsing problems
            Symptom:     messages when IPv6-addresses are in the qetharp-result
            Problem:     message printed out, when non-IPv4 addresses are seen
            Solution:    remove message
            Problem-ID:  5690

            Description: add --check for startup script syntax check      
            Symptom:     no means to check configuration
            Problem:     no means to check configuration
            Solution:    add --check parameter to check for configuration  
                         validity
            Problem-ID:  5694 

      - zipl:
            Added segment load documentation.


1.2.3:
      - ip_watcher:
            Description: HiperSockets Network Concentrator possible stalls
            Symptom:     broadcast traffic stops flowing through the connector
            Problem:     send buffers are too small
            Solution:    increase send buffer size
            Problem-ID:  5476

      - zfcpdump:
            Description: zfcpdump: Invalid 64 bit psws
            Symptom:     64 bit psws with address >= 2GB are invalid in scsi 
                         dumps
            Problem:     zfcpdump used code 1 instead of code 2 (restore old 
                         psws) in sigp "set architecture"
            Solution:    Use code 2 in sigp "set architecture"
            Problem-ID:  5399


1.2.2:
      - Added ip_watcher
 
      - osasnmpd:
            Description: Race Conditions in qeth when more than one osasnmpd 
                         is running
            Symptom:     1. first osasnmpd is running
                         2. start second osasnmpd (or any other program using 
                         the same proc interface)
                         3. on qeth interface changes (new/shutdown qeth device)
                           a) not every waiting osasnmpd will be signaled
                           b) terminating all osasnmpd except one leads to an
                              osasnmpd working unproperly because of race
                              conditions in qeth.
            Problem:     osasnmpd opens an procfile ioctl which does nothing 
                         else than blocking the osasnmpd and return when 
                         something has happened with any qeth devices. If qeth 
                         device changes occur too fast, it's not guarranted 
                         that every osasnmpd blocked by the ioctl will have 
                         the latest device list.
            Solution:    Removed the blocking ioctl mechanism and changed 
                         interfaces. osasnmpd has to register at qeth and will 
                         be signaled when something occurs. osasnmpd has now a 
                         signal handler so that there is no need anymore for 
                         threads and fork call in osasnmpd.
            Problem-ID:  4078


      - qetharp:
            Description: qetharp delete ARP entry problem
            Symptom:     delete ARP entry request has no effect
            Problem:     OSA specs incorrect
            Solution:    adapt to OSA code
            Problem-ID:  4968

            
      - zfcpdump:
            Description: zfcpdump: Invalid 32 bit dumps because of wrong prefix 
                         registers
            Symptom:     scsi dumps of 32 bit linux systems generated with a 
                         64 bit system
                         dumper cannot be read by the dump analysis tool lcrash.
            Problem:     The 32 bit prefix registers are changed when switching 
                         to 64 bit
                         at startup of the system dumper.
            Solution:    Save prefix registers before switching to 64 bit.
            Problem-ID:  5080
            
            
1.2.1:
      - osasnmpd:
            Description: osasnmpd problems during startup
            Symptom:     osasnmpd hangs when started
            Problem:     threading problem
            Solution:    use different threading approach
            Problem-ID:  3524

      - tape390_display:
            Description: tape390_display documentation enhancements.
            Symptom:     Some message were misleading/missing.
            Problem:     Documentation could have been better.
            Solution:    Changed some messages. Added examples to man page.
            Problem-ID:  n/a

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

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 three new tools:
     - dbginfo.sh
     - osasnmpd
     - qetharp
     - tape390_display

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