TECHNICAL INFORMATION DOCUMENT

TITLE:  PTF264 - PPP and CS Upgrade
DATE:  13OCT95
README FOR:  PTF264
PRODUCT and VERSION:

UnixWare 1.1


*************************************************************************
*
* NOTE:  This ptf must be removed before applying Update 1.1.3 or 1.1.4 *
*
*************************************************************************

Installation Instructions:  

DATATYPE: datastream

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

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

Title
-----

PTF264 - PPP and CS Upgrade


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

UnixWare 1.1, UnixWare 1.1.1, UnixWare 1.1.2, UnixWare 1.1.3, UnixWare 1.1.4

Abstract
--------

Dynamic PPP address negotiation, CHAP authentication, packet filtering,
and Proxy ARP. CS retry count and chat script character counting.


Symptom
--------

The PPP did not have the capability to:
	- Allocate/negotiate IP addresses
	- Authenticate using CHAP
	- Filter packets for PPP links
	- Create proxy ARP entries for PPP connections

IP did not remove PPP routes when then PPP interface was brought down.

CS retried a system twice before going to the next entry.  Calls
into certain X.25 PADs could not be completed.


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

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

The following features of PPP are implemented:
	- IP address pooling to assign IP addresses dynamically(server side)
	- Negotiate IP addresses 
	- Create PPP interfaces dynamically
	- Authenticate using CHAP 
	- Packet filtering
	- Ability to create Proxy ARP entries

The following features of CS are implemented:
	- User defined system entry retry count
	- chat script feature to count bytes in an expect string.


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

All the items in the "General Description" are new.

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

This PTF can be installed on UnixWare 1.1 thru UnixWare 1.1.4 systems
which have the Internet Utilities (inet) package installed.

This PTF CANNOT be used on UnixWare 2.X systems.

If PTF653 and/or PTF261 is currently installed on the system, they
must be removed before PTF264 can successfully be installed.

NOTE: PTF653 or PTF261 should not be installed after PTF264 is
installed, PTF264 superceeds any maintenance patches installed by
these previously released PTFs.  If PTF653 or PTF261 is installed
after PTF264, unknown system behavior will occur.

The new configuration files are installed as: 
	/etc/inet/ppphosts.samp
	/etc/inet/pppauth.samp
	/etc/inet/pppfilter.samp
	/etc/addrpool.samp

Please copy these files into /etc/inet or /etc directory without the
".samp" extension.

Please read the comment sections of the files /etc/inet/ppphosts.samp, 
/etc/inet/pppauth.samp, /etc/inet/pppfilter.samp, and
/etc/addrpool.samp for the new format of these files.

If your system is already configured to use PPP:

  - move and convert the information from the old /etc/inet/ppphosts.ptf264 
    and /etc/inet/pppauth.ptf264 files to the new ones.

  - remove any PPP entries that are in /etc/confnet.d/inet/interface. 
    These entries must be converted to the new format and placed in
    /etc/inet/ppphosts file.

This PTF DOES NOT include a new /usr/sbin/pppconf. You MUST edit the 
configuration files manually.

The following directories are updated for the Fingertip Librarian
or initially created for the manpages listed below:
	/usr/flib/books/man/cat1
	/usr/flib/books/man/cat4
	/usr/flib/books/man/cat7

These man pages are installed in the appropriate directories:
	ppp.1m
	pppattach.1m
	pppd.1m
	pppstat.1m
	packfilt.4
	pppauth.4
	ppphosts.4
	addrpool.4
	asyhdlc.7
	ipf.7
	ppp.7

To use the CS retry feature, edit /etc/uucp/Config and add a line
such as TRYCALLS=1 to the end of the file.  The character count chat
feature is tied to the timeout feature.  A 'C' is added after the time
out value followed by an integer.  To use it now you need to enter
some 'expect string' even if it isn't really expected. So the string
JUNK~10C8 would look for 'JUNK' for up to 10 seconds.  The match
would succeed if either 'JUNK' was received or 8 characters was
received.


The CS fixes are delivered in this PTF only.  They will NOT be
available in future upgrades of UNIXWARE 1.1 or 2.0.

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.