Dear SCO Customer,

The enclosed Support Level Supplement (SLS) PTF3254B, the SCO UnixWare
OSMP/PCI Supplement, offers improved support for PCI hardware on 
multiprocessor systems, improved support for particular PCI 2.1 devices
(notably PCI bridge cards and cards that support 64-bit memory
addressing), and corrects problems associated with locating the boot
Host Bus Adapter (HBA) in the event of a system reconfiguration. 

Symptoms
--------

        1. PCI bridge cards are not detected and added to the resmgr database. 

        2. Secondary functions of multi-function PCI cards are not detected
           and added to the resmgr database.
    
        3. PCI devices that support 64-bit memory addressing are detected,
           but not configured into the system. These cards will be rejected 
           with the following message:

            NOTICE: PCI board XXX, YYY: no support for 64 bit memory space.

        4. Incorrect interrupt handling for PCI devices on MP systems
           incorporating a PCI-to-PCI bridge device.

        5. The boot HBA is lost after reconfiguration of the system and
           system startup fails because the root filesystem cannot be
           mounted.

        6. On a multiprocessor system with multiple I/O APICs, certain
           interface cards may cease functioning after the installation
           of OSMP. Disabling all but the primary APIC allows the interface
           cards to function again. This problem does not exist on UnixWare
           2.1.0.

        7. NMIs are not seen on some machines (for example, on systems with 
           SMI).

        8. A system hang can occur after a panic on a multiprocessor system.
           The system will not be rebooted.

        9. There was a hard-coded timing loop in the xcall() function that
           could cause timeouts as faster processors become available.


SOLUTION SPECIFICS
------------------

General Description

        1. PCI bridge cards can now be added to the resmgr database.

        2. All functions of multi-function PCI cards will now be added
           to the resmgr database.

        3. PCI cards that support 64-bit memory addressing can still be
           assigned a 32-bit address for use with the current version of
           UnixWare. The check for 64-bit memory addressing has been
           removed, allowing cards of this type to be supported.

        4. Full routing of interrupts through PCI-to-PCI bridges is now
           implemented according to the PCI 2.1 specification.

        5. Additional information available to the kernel is now used when
           trying to locate a new boot HBA, namely slot number, device number
           and function number. This corrects the problem with the boot HBA 
           being lost after system reconfiguration.
           
           NOTE: The boot HBA *must* be left in the same PCI expansion slot 
           in order for it to be found.

        6. Multiprocessor interrupt information provided by the BIOS is now 
           interpreted correctly.

        7. NMIs are now seen on systems with SMI.

        8. The boot CPU was solely responsible for rebooting the system. If 
           this CPU does not respond after a panic, the reboot will now be 
           performed by another CPU.

        9. The timing loop in the xcall() function was increased by a factor 
           of 4 to accommodate faster processors in the future.  Also, a new 
           variable, xcall_timeout, was introduced to count the number of 
           timeouts.  This is initialized to zero and can be examined with 
           kdb(1M) or crash(1M).


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

SLS PTF3254B should only be installed on these releases:       

        SCO UnixWare Application Server Release 2.1.1, 2.1.2
        SCO UnixWare Personal Edition Release 2.1.1, 2.1.2

It is required that PTF3131 be installed before PTF3254B.

Testing of the modified software contained in this package has
been conducted only to the extent necessary to confirm that it
resolves the problem(s) stated above ("Symptom").  Such testing
consists of re-creating the problem conditions (typically in a
SCO test laboratory) and verifying that the problem no longer
occurs.  No other testing of this software has been done.


Hardware Notes and Recommendations.
----------------------------------

This PTF is targeted for the i386, i486 and Pentium CPUs.


Installation Instructions.
-------------------------

1. Become root and create a new directory by typing the following:

        $ su
        Password: <type your root password>
        # mkdir /tmp/pkg
        # chmod 700 /tmp/pkg
        # cd /tmp/pkg

2. Download the ptf3254b and ptf3254b.txt files to the newly created 
   /tmp/pkg directory on your machine. 

3. Read the Release Notes contained in the ptf3254b.txt file.

4. As root, add the package to your system using these commands:

        $ su
        # pkgadd -d /tmp/pkg/ptf3254b

   Note: A system reboot is REQUIRED following installation of ptf3254b
        in order for the changes to take effect.

5. On some PCI systems, two identical IDE adapters will be listed after
   the system has been rebooted. This should be rectified by entering
   the DCU and disabling the standard IDE entry, leaving the "PCI IDE"
   entry enabled.

   The HBA unit number for the remaining IDE interface can also be
   adjusted at this time to match the original system configuration.
   The unit number setting may be found in the Advanced Parameters
   menu of the DCU for the relevant adapter.


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

1. Become root and remove the package by typing these commands:

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


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

We appreciate your business.

SCO Support Services