readme.ultrix

unix and linux net driver

Installing PPP on an Ultrix system requires rebuilding the kernel and
rebooting, in addition to making and installing the pppd and chat
programs.  These instructions apply to RISC (MIPS) systems.  This
software should work under Ultrix 4.2, 4.3 or 4.4 (this release has
not been tested yet).


Kernel installation procedure.
******************************

If you have not previously had an earlier version of this package
installed in the kernel, follow these steps:

1. Become root.

2. Apply the patches in the file ultrix/patches using the command:

	patch -p -N <ultrix/patches

This will edit the following files, saving the original versions in a
file with `.orig' appended to the name:

	/usr/sys/h/ioctl.h
	/usr/sys/net/net/if.h
	/usr/sys/net/net/netisr.h
	/usr/sys/net/net/conf_net.c
	/usr/sys/data/pseudo_data.c
	/usr/sys/data/tty_conf_data.c
	/usr/sys/conf/mips/files.mips

Alternatively, edit these files according to the differences shown in
ultrix/patches.

3. Copy the following files to /usr/sys/io/netif:

	net/ppp-comp.h
	net/ppp_defs.h
	ultrix/bsd-comp.c
	ultrix/ppp-deflate.c
	ultrix/if_ppp.c
	ultrix/if_ppp.h
	ultrix/if_pppvar.h
	ultrix/ppp_tty.c
	ultrix/slcompress.c
	ultrix/slcompress.h
	common/zlib.c
	common/zlib.h

4. Add a line like this to the configuration file for your kernel:

	pseudo-device ppp	2

The `2' indicates the number of interfaces desired.  The configuration
file should be in /usr/sys/conf/mips.

5. Rebuild your kernel.  The simplest way to do this is with the
`doconfig' command, like this:

	/etc/doconfig -c kernel-name

where `kernel-name' should be replaced by the name of your kernel
configuration file.  Alternatively, run config, cd to the compilation
directory, and run make.

6. Copy the new /vmunix to /.  It would be a good idea to keep a copy
of your old /vmunix in / under a different name.

7. Reboot the system.

********

If you have ppp-2.2 already installed in your kernel, most files will
already have been modified as required.  You will need to add some
entries to /usr/sys/conf/mips/files.mips.  You can do this with a
command like this (as root):

	patch -p -N <ultrix/upgrade

Alternatively, edit /usr/sys/conf/mips/files.mips according to the
differences shown in ultrix/upgrade.

Then, proceed with steps 3, 5, 6, 7 above (step 4 should have been
done already).


Installing pppd and chat.
*************************

1. cd to the ppp-2.2 directory and do:

	./configure
	make

2. Become root, and do:

	make install


Credits.
********

The original port to Ultrix was done by:

	Per Sundstrom 
	DEC, Sweden
	email: [e-mail]

and

	Robert Olsson 
	Swedish University of Agricultural Sciences
	and also RO Komm. & Konsult
	email: [e-mail]

It was updated to ppp-2.3 by

	Paul Mackerras
	Dept. of Computer Science
	Australian National University
	[e-mail]