TECHNICAL INFORMATION DOCUMENT

TITLE:  TF2199 - Network Management Upgrade
DATE:  01NOV95
README FOR:  TF2199
PRODUCT and VERSION:

UnixWare 2.01

Installation Instructions:  

DATATYPE: datastream

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

2.  Read the release notes contained in this file and follow the
    instructions 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/tf2199.Z
        # pkgadd -d /tmp/tf2199

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


Title
-----

PTF2199 - Network Management Upgrade

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

UnixWare 2.01, UnixWare 2.02

Abstract
--------

The following problems fixed:
 1) Request Id in the SMUX PDU does not conform to Section 3.1.5 of RFC 1227.
 2) Missing assignment of **x in string_decode(OctetString **x,
 4) Sample code referenced in manual in not available.
    ObjectSyntax *value) function that causes a system crash when freed. 
 3) SMUX Get Request and SMUX Get Response should not be in the SET request

Symptom
--------

Problem 1
The request id received by the SNMP agent is changed when the single
PDU is changed to multiple PDUs in the SMUX peer.

Problem 2
The variable value is not loaded and contains whatever is on the stack.
This then cause a crash when os_free() calls free() on the random
address.

Problem 3
The behavior was noticed when the set operation is used to delete an
element (i.e. an entry in dynamic table).  This caused the Network
Management Station to get a noSuchName response.

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

General Description.
-------------------
Problem 1
Added a new variable called request_id to two internal function
called smux_get_method and smux_set_method.  These functions create
the SMUX_PDU structure for peer agent when doing gets and sets.  
The variable request_id is then passed to the SMUX_PDU structure.
These functions are used in several files.


Problem 2
The function, string_decode(OctetString **x, ObjectSyntax *value),
assigns **x to (OctetString *)value->os_value properly.


Problem 3
The function, make_response_pdu(Pdu *in_pdu_ptr), use to call
smux_get_method() which did the SMUX Get Request and SMUX Get Response
to retrieve the Varbinding List for return back to the Network
Management Console.  Now if the in_pdu_type->type is a SET_REQUEST_TYPE,
the Varbinding List is extracted from the out_pdu_ptr data area to
be returned the console.
Problem 4

The sample code in developed and included in this ptf.


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

None.

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

This PTF can be installed ONLY on UnixWare 2.01 and 2.02 systems
with the Network Management package, netmgt, installed.

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.