X-Git-Url: http://git.ozlabs.org/?p=ppp.git;a=blobdiff_plain;f=README.osf;h=74d74ab343c61cd7a62f7023c71aa422cf44abe3;hp=5fd84aee37aa6a1821faca27de300a3f2b7087b7;hb=da44517ffef30eb2c170bb97cd6435f6d4e61a0e;hpb=bbe9c77aafc5d183eb3c29879563e4c9b95bc1b6 diff --git a/README.osf b/README.osf index 5fd84ae..74d74ab 100644 --- a/README.osf +++ b/README.osf @@ -1,25 +1,57 @@ - -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 DEC AXP system running 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 @@ -27,76 +59,88 @@ You must do all of the following as "root". 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 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 OSF/1 VERSIONS V3.0 AND LATER: - - | 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 at the end of /sys/conf/SYSNAME: +6. Add the following line at the end of /sys/conf/SYSNAME: - pseudo-device ppp 2 + 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. + + +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.