updates from Farrell Woods
[ppp.git] / README.osf
1 This file (README.osf) contains instructions for installing ppp-2.3 on a
2 Digital Alpha-based system running Digital UNIX (aka DEC OSF/1)
3 version 2.0 through version 3.2F.  Digial UNIX version 3.2G and beyond
4 are not supported by this package, since PPP is an integral component
5 of those releases.  (Although it *is* possible to install this software
6 on V3.2G and later of Digital UNIX, I would discourage this activity
7 because it's likely to break the "update install" feature of Digital
8 UNIX.  You were warned...)
9
10 If you encounter bugs in this using this PPP package under Digital
11 UNIX then please let me (ftw@zk3.dec.com) know.  I can't promise
12 quick turnaround but I should be able to address issues eventually.
13
14 Below are the steps for installing PPP on Digital UNIX.
15 You must do all of the following as "root".
16
17 1.  Make the kernel sources, daemon, chat, and pppstat program by typing 
18
19         ./configure
20         make install
21
22     in the directory that this file unpacked into.  This installs the
23     binaries for the PPP daemon and the statistics program in 
24     /usr/local/etc/ppp.  If you want them somewhere else, just change 
25     the definition of BINDIR in the top level Makefile.osf.
26
27 2.  This step differs depending on whether you are running OSF/1 V3.0
28     or later.
29
30     FOR DEC OSF/1 V2.0 THROUGH V2.1:
31
32     | Add the following lines to the file /sys/conf/files:
33     |
34     | streamsm/if_ppp.c         optional ppp Notbinary optimize -g3
35     | streamsm/ppp_comp.c       optional ppp Notbinary optimize -g3
36     | streamsm/ppp_init.c       optional ppp Notbinary optimize -g3
37     | streamsm/vjcompress.c     optional ppp Notbinary optimize -g3
38     | streamsm/bsd-comp.c       optional ppp Notbinary optimize -g3
39     | streamsm/deflate.c        optional ppp Notbinary optimize -g3
40     | streamsm/ppp.c            optional ppp Notbinary optimize -g3
41     | streamsm/ppp_ahdlc.c      optional ppp Notbinary optimize -g3
42     | streamsm/zlib.c           optional ppp Notbinary optimize -g3
43     |
44     | Edit the file /sys/streams/str_config.c --- at the end there will be a
45     | comment to the effect of "add new configurations above this comment".
46     | Add the following lines above this comment:
47     |
48     |      bzero((caddr_t)&sb, sizeof(sb));
49     |      sb.sc_version = OSF_STREAMS_CONFIG_10;
50     |
51     |      retval = ppp_configure(SYSCONFIG_CONFIGURE,
52     |                             &sb, sc_size, &sc, sc_size);
53
54     FOR DEC OSF/1 V3.0 THROUGH Digital UNIX V3.2F:
55
56     | Add the following lines to the file /sys/conf/files:
57     |
58     | streamsm/if_ppp.c         optional ppp if_dynamic ppp Notbinary optimize -g3
59     | streamsm/ppp_comp.c       optional ppp if_dynamic ppp Notbinary optimize -g3
60     | streamsm/ppp_init.c       optional ppp if_dynamic ppp Notbinary optimize -g3
61     | streamsm/vjcompress.c     optional ppp if_dynamic ppp Notbinary optimize -g3
62     | streamsm/bsd-comp.c       optional ppp if_dynamic ppp Notbinary optimize -g3
63     | streamsm/deflate.c        optional ppp if_dynamic ppp Notbinary optimize -g3
64     | streamsm/ppp.c            optional ppp if_dynamic ppp Notbinary optimize -g3
65     | streamsm/ppp_ahdlc.c      optional ppp if_dynamic ppp Notbinary optimize -g3
66     | streamsm/zlib.c           optional ppp if_dynamic ppp Notbinary optimize -g3
67
68     FOR Digital UNIX V3.2G AND V4.0 AND BEYOND
69
70     This package does not support these versions of Digital UNIX.
71     PPP is an integral part of the OS.  Please see the Guide to
72     Network Administration for details on configuring PPP.
73
74 4.  Find your system's configuration file.  This should be called
75     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
76     host.  For example, on my machine (zaphod.csci.unt.edu) it it called
77     /sys/conf/ZAPHOD.  I will refer to this file from now on as 
78     /sys/conf/SYSNAME.
79
80 5.  Add the following line at the end of /sys/conf/SYSNAME:
81
82         options         PPP
83
84 6.  Build a new kernel by using the command
85
86         doconfig -c SYSNAME
87
88     (say "n" to "Do you want to edit...").
89
90 7.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
91     writing over a perfectly good kernel with one that I'm not sure
92     about, so I will usually "mv /vmunix /vmunix.old" first.  To put
93     the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".
94
95 8.  Make sure your system is set up so that it can act like a gateway
96     for messages to your new connection.  In particular, check the file
97     /etc/rc.config for the line define ROUTER, and make sure it is
98     defined as "yes".
99
100 9.  Reboot and you're ready to go!
101
102 Hopefully, that should work with no hitches.  If you find any bugs, or
103 errors in these instructions, contact Farrell Woods <ftw@zk3.dec.com>.
104