TECHNICAL INFORMATION DOCUMENT

TITLE: PTF268 - PPP and CS Upgrade
DATE:  29JUN95
README FOR:  PTF268
PRODUCT and VERSION:

UnixWare 1.1


Installation Instructions:  

DATATYPE: datastream

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

ENGINEERING REALEASE NOTES
--------------------------

Title
-----

PTF268 - 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.  The new Connection Server checks for an existing lock
file before opening the tty device to keep from hanging an established
PPP connection.


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.

A PPP connection hangs after an attempt is made to open the same
tty device via a cu command.  The connection server was allowed
to open this tty device again and the streams modules required
by cu were pushed onto the stream head, thereby trashing the PPP
connection.

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 connection server now checks to see if a lock file exist before
attempting to open the tty device.  If one exist, the attempted
operation is aborted.

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, use PTF2038.

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

NOTE: PTF653 or PTF261 should not be installed after PTF268 is
installed, PTF268 superceeds any maintenance upgrades installed by
these previously released PTFs.  If PTF653 or PTF261 is installed
after PTF268, 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 their current directory, /etc/inet or /etc,
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.ptf268 
    and /etc/inet/pppauth.ptf268 files to the new ones.

  - PPP entries in /etc/confnet.d/inet/interface have been commented
    out by this PTF installation.  These entries are no longer needed
    and must be converted to the new format and placed in the
    /etc/inet/ppphosts file instead.

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
	packetfilter.4
	pppauth.4
	ppphosts.4
	addrpool.4
	asyhdlc.7
	ipf.7
	ppp.7

NOTE: The configuration of modems using the Dialup_Setup icon under
the System_Setup folder creates the UUCP entry in /etc/uucp/Devices
using the software flow control tty device, tty[0-9][0-9]s.  The PPP
documentation recommends using the hardware flow control tty device,
tty[0-9][0-9]h.  If this configuration is used, the problem described
in the "Symptom" section will not occur for the connection server.

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.