Dear SCO Customer,

The enclosed Support Level Supplement (SLS) PTF3382, the SCO UnixWare
Sysdump Supplement, provides fixes for the following issues:

    1.  A system panic dump may be very large, but most of the
        pages dumped are almost never relevant to panic analysis.
        On a system with more than 2GB of memory, a full panic
        dump would usually exceed the 2GB file size limit, and
        so cannot be analyzed at all.

        If SYSDUMP_SELECTIVE is tuned to 1 (its default), the ptf3382
        sysdump driver dumps only those pages mapped by the kernel,
        reducing the size of the dump.  Even on a system with 4GB of 
        memory, the selective dump size cannot exceed 1GB.

        When crash(1M) is applied to such a dump, it shows the missing 
        user process pages and free pages as zero-filled.  The ptf3052 
        crash has its own "reduce" command; this remains useful, to 
        append symbols to the dump, or for option "-s" to omit the 
        seldom-useful segmap pages.

    2.  If the disk interrupt vector is shared with another device,
        such as a network card, generation of a system panic dump may
        fail to complete due to interference from that other device.

        If SYSDUMP_POLL is tuned to 1 (its default), the ptf3382
        sysdump driver disables the dumpdev interrupt, and polls for
        write completion instead, allowing the dump to complete.

    3.  When a system panic dump is generated, the user is prompted to
        "Press any key to abort dump", but this does not work, nor is
        the dump aborted when a write failure occurs.

        The ptf3382 sysdump driver corrects a simple coding error,
        aborting the dump on keystroke or failure.


Contents
--------

        /etc/conf/dtune.d/sysdump
        /etc/conf/mtune.d/sysdump
        /etc/conf/pack.d/sysdump/Driver_atup.o
        /etc/conf/pack.d/sysdump/Driver_mp.o
        /etc/conf/pack.d/sysdump/space.c


Software Notes and Recommendations
----------------------------------

        PTF3382 may be installed on any of these releases:

        SCO UnixWare Application Server Release 2.01, 2.02, 2.03
        SCO UnixWare Personal Edition   Release 2.01, 2.02, 2.03
        SCO UnixWare Application Server Release 2.1.0, 2.1.1, 2.1.2
        SCO UnixWare Personal Edition   Release 2.1.0, 2.1.1, 2.1.2

        If PTF3190, the 4GB Boot Supplement, is to be installed on SCO 
        UnixWare Release 2.1.1 or 2.1.2, then it should be installed 
        before PTF3382. If PTF3190 is installed after PTF3382, the sysdump
        driver is replaced by an old version without the above fixes,
        and PTF3382 should be reinstalled.

        If you find that useful information has been omitted from a 
        selective system panic dump, choose a full dump by: 

             # /etc/conf/bin/idtune -f SYSDUMP_SELECTIVE 0
             # /etc/conf/bin/idbuild

        and reboot the system. Then try to reproduce the panic.

        If you find that polling for write completion fails to complete 
        a system panic dump, choose interrupt mode by:

             # /etc/conf/bin/idtune -f SYSDUMP_POLL 0
             # /etc/conf/bin/idbuild

        and reboot the system. Then try to reproduce the panic.

        If memory size exceeds 2GB, or if it exceeds dump device size,
        selective dumping is forced on despite SYSDUMP_SELECTIVE tuning.
        If selection itself causes a double panic, selective dumping is
        forced off.  If the dumpdev completion handler cannot be located
        (not on sd01), polling is forced off despite SYSDUMP_POLL tuning.


Installation Instructions
-------------------------

1. Download the ptf3382.Z file to the /tmp directory on your machine.

2. As root, uncompress the file and add the package to your system
   using these commands:

        $ su
        Password: <type your root password>
        # uncompress /tmp/ptf3382.Z
        # pkgadd -d /tmp/ptf3382
        # rm /tmp/ptf3382

3. Reboot the system after installing this package.

   The release notes displayed prior to installation can be found in:

   /var/sadm/pkg/ptf3382/install/ptf3382.txt


Removal Instructions
--------------------

1. As root, remove the package using these commands:

        $ su
        Password: <type your root password>
        # pkgrm ptf3382

2. Reboot the system after removing this package.


If you have questions regarding this SLS, or the product on which it is 
installed, please contact your software supplier.

We appreciate your business.

SCO Support Services