TECHNICAL INFORMATION DOCUMENT

TITLE:  TF2029 - Kernel Hooks to Support ISV Applications
DATE:  25OCT95
README FOR:  TF2029
PRODUCT and VERSION:

UnixWare 2.01

Installation Instructions:  

DATATYPE: datastream

1.  Download the tf2029.Z and tf2029.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/tf2029.Z
        # pkgadd -d /tmp/tf2029

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

Title
-----

PTF2029 - Kernel Hooks to Support ISV Applications

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

UnixWare 2.02

Abstract
--------

Kernel hooks are added for fork(), exit(), and IPC message queues.
These hooks are intended to facilitate the port of ISV's applications to
UnixWare and to make the ongoing support of these applications easier.

Symptom
--------

This PTF is an enhancement which adds functionality to the kernel for
exit(), fork(), and IPC messages.  This added functionality allows ISVs
to more easily port applications that need to insert code in the kernel
and have it execute at certain times, or under certain conditions.


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

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

Applications may have capabilities which require some amount of code to
be resident in the kernel, to get executed at a specific time.  The
kernel hooks added for exit(), fork(), and IPC messages allow such
functionality, and allow applications to be more easily ported to
UnixWare.

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

The exit() hook allows the application to insert a block of kernel code
that will execute whenever a process exits.  The fork() hook similarly
allows the application to know when a process is starting, or more
precisely, when the process is ready to be executed (but before it
actually starts).

The hook related to IPC message queues allows an application which makes
use of IPC message queues for passing data, to send and receive messages
from within kernel space.

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

This PTF should be installed on a UnixWare 2.02 system.  If the system
is then upgraded to UnixWare 2.03, the PTF does NOT need to be
re-installed, since the enhancements are included in UnixWare 2.03.

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.

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

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