update for 2.3.5
[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 (varadhan@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     Note that BINDIR and MANDIR/man8 must exist before you do a 
28     'make install'
29
30 2.  This step differs depending on whether you are running OSF/1 V3.0
31     or later.
32
33     FOR DEC OSF/1 V2.0 THROUGH V2.1:
34
35     | Add the following lines to the file /sys/conf/files:
36     |
37     | streamsm/if_ppp.c         optional ppp Notbinary optimize -g3
38     | streamsm/ppp_comp.c       optional ppp Notbinary optimize -g3
39     | streamsm/ppp_init.c       optional ppp Notbinary optimize -g3
40     | streamsm/vjcompress.c     optional ppp Notbinary optimize -g3
41     | streamsm/bsd-comp.c       optional ppp Notbinary optimize -g3
42     | streamsm/deflate.c        optional ppp Notbinary optimize -g3
43     | streamsm/ppp.c            optional ppp Notbinary optimize -g3
44     | streamsm/ppp_ahdlc.c      optional ppp Notbinary optimize -g3
45     | streamsm/zlib.c           optional ppp Notbinary optimize -g3
46     |
47     | Edit the file /sys/streams/str_config.c --- at the end there will be a
48     | comment to the effect of "add new configurations above this comment".
49     | Add the following lines above this comment:
50     |
51     |      bzero((caddr_t)&sb, sizeof(sb));
52     |      sb.sc_version = OSF_STREAMS_CONFIG_10;
53     |
54     |      retval = ppp_configure(SYSCONFIG_CONFIGURE,
55     |                             &sb, sc_size, &sc, sc_size);
56
57     FOR DEC OSF/1 V3.0 THROUGH Digital UNIX V3.2F:
58
59     | Add the following lines to the file /sys/conf/files:
60     |
61     | streamsm/if_ppp.c         optional ppp if_dynamic ppp Notbinary optimize -g3
62     | streamsm/ppp_comp.c       optional ppp if_dynamic ppp Notbinary optimize -g3
63     | streamsm/ppp_init.c       optional ppp if_dynamic ppp Notbinary optimize -g3
64     | streamsm/vjcompress.c     optional ppp if_dynamic ppp Notbinary optimize -g3
65     | streamsm/bsd-comp.c       optional ppp if_dynamic ppp Notbinary optimize -g3
66     | streamsm/deflate.c        optional ppp if_dynamic ppp Notbinary optimize -g3
67     | streamsm/ppp.c            optional ppp if_dynamic ppp Notbinary optimize -g3
68     | streamsm/ppp_ahdlc.c      optional ppp if_dynamic ppp Notbinary optimize -g3
69     | streamsm/zlib.c           optional ppp if_dynamic ppp Notbinary optimize -g3
70
71     FOR Digital UNIX V3.2G AND V4.0 AND BEYOND
72
73     This package does not support these versions of Digital UNIX.
74     PPP is an integral part of the OS.  Please see the Guide to
75     Network Administration for details on configuring PPP.
76
77 4.  Find your system's configuration file.  This should be called
78     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
79     host.  For example, on my machine (zaphod.csci.unt.edu) it it called
80     /sys/conf/ZAPHOD.  I will refer to this file from now on as 
81     /sys/conf/SYSNAME.
82
83 5.  Add the following line at the end of /sys/conf/SYSNAME:
84
85         options         PPP
86
87 6.  Build a new kernel by using the command
88
89         doconfig -c SYSNAME
90
91     (say "n" to "Do you want to edit...").
92
93 7.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
94     writing over a perfectly good kernel with one that I'm not sure
95     about, so I will usually "mv /vmunix /vmunix.old" first.  To put
96     the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".
97
98 8.  Make sure your system is set up so that it can act like a gateway
99     for messages to your new connection.  In particular, check the file
100     /etc/rc.config for the line define ROUTER, and make sure it is
101     defined as "yes".
102
103 9.  Reboot and you're ready to go!
104
105 Hopefully, that should work with no hitches.  If you find any bugs, or
106 errors in these instructions, contact Sowmini Varadhan<varadhan@zk3.dec.com>.
107