-
-This file (README.osf) contains instructions for installing ppp-2.2 on a
-DEC Alpha running OSF/1 version 2.0 or 3.0. The original STREAMS
-module code is by (and copyrighted by) Brad Clements. See the source
-files and the general README file for full credits and copyright notices.
-
-If you would like to be on a mailing list concerning the ppp package,
-send mail to srt@cs.unt.edu and let me know. This mailing list should
-not have any regular traffic --- I will use it only if bugs are reported
-to notify everyone of bug-fixes.
-
-Note for users of the ppp-2.1.2 package: I have included a fix
-for the non-STREAMS tty drivers in this release. If you were using
-version 2.1.2 with a hardware serial port, then you probably used the
-"rlogin-kludge" that I described in the README that came with 2.1.2.
-You don't need this any more, and will have a more efficient connection
-if you get rid of this old work-around.
-
-Below are the steps for installing PPP on a Digital Equipment Corp.
-Alpha system running Digital UNIX (formerly known as DEC OSF/1.)
-
+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 (varadhan@zk3.dec.com) 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. Make the kernel sources, daemon, chat, and pppstat program by typing
+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.
-
-2. This step differs depending on whether you are running OSF/1 V3.0
- or later.
-
- FOR DEC OSF/1 VERSIONS PRIOR TO V3.0:
-
- | Add the following lines to the file /sys/conf/files:
- |
- | streamsm/ppp_if.c optional ppp Notbinary
- | streamsm/ppp_async.c optional ppp Notbinary
- | streamsm/ppp_init.c optional ppp Notbinary
- | streamsm/vjcompress.c optional ppp Notbinary
- | streamsm/bsd-comp.c optional ppp Notbinary
- | streamsm/ppp_comp.c optional ppp Notbinary
- |
- |
- | Edit the file /sys/streams/str_config.c --- at the end there will be a
- | comment to the effect of "add new configurations above this comment".
- | Add the following lines above this comment:
- |
- | bzero((caddr_t)&sb, sizeof(sb));
- | sb.sc_version = OSF_STREAMS_CONFIG_10;
- |
- | retval = ppp_configure(SYSCONFIG_CONFIGURE,
- | &sb, sc_size, &sc, sc_size);
-
- FOR DEC OSF/1 VERSIONS V3.0 AND LATER, INCLUDING DIGITAL UNIX:
-
- | Add the following lines to the file /sys/conf/files:
- |
- | streamsm/ppp_if.c optional ppp if_dynamic ppp Notbinary
- | streamsm/ppp_async.c optional ppp if_dynamic ppp Notbinary
- | streamsm/ppp_init.c optional ppp if_dynamic ppp Notbinary
- | streamsm/vjcompress.c optional ppp if_dynamic ppp Notbinary
- | streamsm/bsd-comp.c optional ppp if_dynamic ppp Notbinary
- | streamsm/ppp_comp.c optional ppp if_dynamic ppp Notbinary
-
-4. Find your system's configuration file. This should be called
+ 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.
-5. Add the following line among the other options in /sys/conf/SYSNAME:
+6. Add the following line at the end of /sys/conf/SYSNAME:
options PPP
-6. Build a new kernel by using the command
+7. Build a new kernel by using the command
doconfig -c SYSNAME
(say "n" to "Do you want to edit...").
-7. Copy the new kernel to /vmunix --- I'm usually pretty nervous about
+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".
-8. Make sure your system is set up so that it can act like a gateway
+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".
-9. Reboot and you're ready to go!
+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<varadhan@zk3.dec.com>.
+
+
+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..
-Hopefully, that should work with no hitches. If there are problems, or
-if I have made a mistake in these instructions, please let me know.
+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
-Steve Tate
-University of North Texas
-srt@cs.unt.edu
+ # 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.