readme.osf

unix and linux net driver

This file (README.osf) contains instructions for installing ppp-2.3 on a
Compaq Alpha-based system running Tru64 Unix (formerly Digital UNIX aka
DEC OSF/1) version 4.0. Please note that  PPP is an integral
component of Tru64 UNIX version 3.2G and beyond (documented in the
Guide to Network Administration),  and though it *is* possible to install 
this software on V3.2G and later of Tru64 UNIX, you are likely
to have problems with the "update install" feature of Tru64
UNIX and while installing some OS patches. (See the note on 
de-installation below). 

Tru64 Unix versions Version 3.X and earlier are no longer supported
in this package.  Please use ppp-2.3.5 on these systems.

INSTALLATION.

If you encounter bugs while using this PPP package under Tru64
UNIX then please let me ([e-mail]) know.  I can't promise
quick turnaround but I should be able to address issues eventually.

Below are the steps for installing PPP on Tru64 UNIX.
You must do all of the following as "root".

1.  back up /usr/sys/BINARY, /usr/sys/include/net,
    /usr/sys/conf/files, /sys/kern/lockinfo.c  and /sys/BINARY/ppp.mod
	# mkdir -p /usr/tmp/ppp
	# cd /usr/sys
	# tar cvf /usr/tmp/ppp/BINARY.tar ./BINARY
        # cd /usr/sys/include
	# tar cvf /usr/tmp/ppp/usr_sys_include_net.tar  ./net
	# cp /usr/sys/conf/files /usr/tmp/ppp/files
	# cp /sys/kern/lockinfo.c /usr/tmp/ppp/lockinfo.c
	# cp /sys/BINARY/ppp.mod /usr/tmp/ppp/ppp.mod

2.  Edit /usr/sys/conf/files- search for the string: "MODULE/STATIC/ppp"
comment out the existing entries, and change it to look like:

MODULE/STATIC/ppp               optional ppp Binary
#streamsm/ppp_init.c            module ppp
#streamsm/ppp_if.c              module ppp
#streamsm/ppp_async.c           module ppp
#streamsm/ppp_comp.c            module ppp
#streamsm/vjcompress.c          module ppp
#streamsm/bsd_comp.c            module ppp
streamsm/if_ppp.c         module ppp
streamsm/ppp_comp.c       module ppp
streamsm/ppp_init.c       module ppp
streamsm/vjcompress.c     module ppp
streamsm/bsd-comp.c       module ppp
streamsm/deflate.c        module ppp
streamsm/ppp.c            module ppp
streamsm/ppp_ahdlc.c      module ppp
streamsm/zlib.c           module ppp

3.  Make the kernel sources, daemon, chat, and pppstat program by typing 

        ./configure
        make install

    in the directory that this file unpacked into.  This installs the
    binaries for the PPP daemon and the statistics program in 
    /usr/local/etc/ppp.  If you want them somewhere else, just change 
    the definition of BINDIR in the top level Makefile.osf. If you plan
    to over-write exisiting pppd executables in /usr/sbin/, it's advisable
    that you create back-up copies of these first, before doing the
    'make install'

    Note that BINDIR and MANDIR/man8 must exist before you do a 
    'make install'


4.  Edit /sys/kern/lockinfo.c, and conditionally compile out the lines:

#if PPP
        SLI("ppp_if_table_lock", ppp_if_table_lock_info, SPLNONE, DEFAULT);
        SLI("ppp_if_info.ppp_if_element_lock", ppp_if_element_lock_info, SPLNONE
, DEFAULT);
        SLI("ppp_comp_table_lock", ppp_comp_table_lock_info, SPLNONE, DEFAULT);
        SLI("ppp_comp_info.ppp_comp_element_lock", ppp_comp_element_lock_info, S
PLNONE, DEFAULT);
        SLI("ppp_async_table_lock", ppp_async_table_lock_info, SPLNONE, DEFAULT)
;
        SLI("ppp_async_info.ppp_async_element_lock", ppp_async_element_lock_info
, SPLNONE, DEFAULT);
#endif  /* PPP */

by changing the line

#if PPP 

to be

#if 0 

5.  Find your system's configuration file.  This should be called
    /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
    host.  For example, on my machine (zaphod.csci.unt.edu) it it called
    /sys/conf/ZAPHOD.  I will refer to this file from now on as 
    /sys/conf/SYSNAME.

6.  Add the following line at the end of /sys/conf/SYSNAME:

	options		PPP

7.  Build a new kernel by using the command

	doconfig -c SYSNAME

    (say "n" to "Do you want to edit...").

8.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
    writing over a perfectly good kernel with one that I'm not sure
    about, so I will usually "mv /vmunix /vmunix.old" first.  To put
    the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".

9.  Make sure your system is set up so that it can act like a gateway
    for messages to your new connection.  In particular, check the file
    /etc/rc.config for the line define ROUTER, and make sure it is
    defined as "yes".

10.  Reboot and you're ready to go!

Hopefully, that should work with no hitches.  If you find any bugs, or
errors in these instructions, contact Sowmini Varadhan<[e-mail]>.


DEINSTALLATION

It is advisable to retrace your steps and restore the system
to its normal state before installing patches or running update_install.
Here's how you can retrace..

1. Restore /usr/sys/BINARY, /usr/sys/include/net, /usr/sys/conf/files
   and /sys/kern/lockinfo.c and /sys/BINARY/ppp.mod. For example,
   if you followed the instructions in step 1 verbatim, you would do

	# cd /usr/sys/
	# rm -rf ./BINARY
	# tar xvf /usr/tmp/ppp/BINARY.tar
        # cd /usr/sys/include
        # rm -rf ./net
	# tar xvf /usr/tmp/ppp/usr_sys_include_net.tar
	# cp  /usr/tmp/ppp/files /usr/sys/conf/files
	# cp /usr/tmp/ppp/lockinfo.c /sys/kern/lockinfo.c
	# cp /usr/tmp/ppp/ppp.mod /sys/BINARY/ppp.mod

Now redo steps 5-10 and install the patch after you have rebooted.