TECHNICAL INFORMATION DOCUMENT

TITLE:  TF2188 - Remove a non-existent processor file.
DATE:  20NOV95
README FOR:  TF2188
PRODUCT and VERSION:

UnixWare 2.01

Installation Instructions:  

DATATYPE: datastream

1.  Download the tf2188.Z and tf2188.txt files to the /tmp directory
    on your machine.

2.  Read the release notes contained in this file and follow the 
    instuctions to add the package to your system.

3.  Now become root, uncompress the file and add the package to your 
    system using the following commands:

        $ su
        # uncompress /tmp/tf2188.Z
        # pkgadd -d /tmp/tf2188

ENGINEERING RELEASE NOTES
-------------------------

Title
-----

PTF2188 - patch to remove a non-existent processor file.

Product And Version
-------------------

UnixWare 2.02, UnixWare 2.03

Abstract
--------

off-by-one error creates a processor file for a non-existent processor.

Symptom
--------

An off-by-one error in the code produces an extra processor file
in /system/processor, thereby incorrectly indicating the presence
of an extra processor on the system.  The visible consequence of
this error is that one may see a file /system/processor/001 on a
machine with only one processor (#0).  The less visible consequence
is that various data structures may be over-run and data corruption
followed by a panic may occur.  A panic can sometimes be reproduced
simply by trying to read the non-existent processor file; e.g., 
cp /system/processor/001 /dev/null on a system with only one processor.


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

Corrected the off-by-one error in the code.


General Description.
-------------------

This patch eliminated the above problem by not producing the extra file. 


New Features.
------------

None

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

This PTF can be installed on UnixWare 2.02 and UnixWare 2.03 systems. 

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
recreating the problem conditions and verifying that the problem no 
longer occurs.  No other testing of this software has been done.

This PTF needs to be re-applied if the osmp package is installed or removed.

This patch installs the following updated files:

        /etc/conf/pack.d/processorfs/Driver_atup.o
        /etc/conf/pack.d/processorfs/Driver_mp.o

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

This PTF is targeted for the i386, i486 and Pentium CPU's.