mods from Farrell Woods
[ppp.git] / README.osf
1
2 This file (README.osf) contains instructions for installing ppp-2.2 on a
3 DEC Alpha running OSF/1 version 2.0 or 3.0.  The original STREAMS
4 module code is by (and copyrighted by) Brad Clements.  See the source 
5 files and the general README file for full credits and copyright notices.
6
7 If you would like to be on a mailing list concerning the ppp package,
8 send mail to srt@cs.unt.edu and let me know.  This mailing list should
9 not have any regular traffic --- I will use it only if bugs are reported
10 to notify everyone of bug-fixes.
11
12 Note for users of the ppp-2.1.2 package:  I have included a fix
13 for the non-STREAMS tty drivers in this release.  If you were using
14 version 2.1.2 with a hardware serial port, then you probably used the
15 "rlogin-kludge" that I described in the README that came with 2.1.2.
16 You don't need this any more, and will have a more efficient connection
17 if you get rid of this old work-around.
18
19 Below are the steps for installing PPP on a Digital Equipment Corp.
20 Alpha system running Digital UNIX (formerly known as DEC OSF/1.)
21
22 You must do all of the following as "root".
23
24 1.  Make the kernel sources, daemon, chat, and pppstat program by typing 
25
26         ./configure
27         make install
28
29     in the directory that this file unpacked into.  This installs the
30     binaries for the PPP daemon and the statistics program in 
31     /usr/local/etc/ppp.  If you want them somewhere else, just change 
32     the definition of BINDIR in the top level Makefile.osf.
33
34 2.  This step differs depending on whether you are running OSF/1 V3.0
35     or later.
36
37     FOR DEC OSF/1 VERSIONS PRIOR TO V3.0:
38
39     | Add the following lines to the file /sys/conf/files:
40     |
41     |      streamsm/ppp_if.c                    optional ppp Notbinary
42     |      streamsm/ppp_async.c                 optional ppp Notbinary
43     |      streamsm/ppp_init.c                  optional ppp Notbinary
44     |      streamsm/vjcompress.c                optional ppp Notbinary
45     |      streamsm/bsd-comp.c                  optional ppp Notbinary
46     |      streamsm/ppp_comp.c                  optional ppp Notbinary
47     |
48     |
49     | Edit the file /sys/streams/str_config.c --- at the end there will be a
50     | comment to the effect of "add new configurations above this comment".
51     | Add the following lines above this comment:
52     |
53     |      bzero((caddr_t)&sb, sizeof(sb));
54     |      sb.sc_version = OSF_STREAMS_CONFIG_10;
55     |
56     |      retval = ppp_configure(SYSCONFIG_CONFIGURE,
57     |                             &sb, sc_size, &sc, sc_size);
58
59     FOR DEC OSF/1 VERSIONS V3.0 AND LATER, INCLUDING DIGITAL UNIX:
60
61     | Add the following lines to the file /sys/conf/files:
62     |
63     |      streamsm/ppp_if.c          optional ppp if_dynamic ppp Notbinary
64     |      streamsm/ppp_async.c       optional ppp if_dynamic ppp Notbinary
65     |      streamsm/ppp_init.c        optional ppp if_dynamic ppp Notbinary
66     |      streamsm/vjcompress.c      optional ppp if_dynamic ppp Notbinary
67     |      streamsm/bsd-comp.c        optional ppp if_dynamic ppp Notbinary
68     |      streamsm/ppp_comp.c        optional ppp if_dynamic ppp Notbinary
69
70 4.  Find your system's configuration file.  This should be called
71     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
72     host.  For example, on my machine (zaphod.csci.unt.edu) it it called
73     /sys/conf/ZAPHOD.  I will refer to this file from now on as 
74     /sys/conf/SYSNAME.
75
76 5.  Add the following line among the other options in /sys/conf/SYSNAME:
77
78         options         PPP
79
80 6.  Build a new kernel by using the command
81
82         doconfig -c SYSNAME
83
84     (say "n" to "Do you want to edit...").
85
86 7.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
87     writing over a perfectly good kernel with one that I'm not sure
88     about, so I will usually "mv /vmunix /vmunix.old" first.  To put
89     the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".
90
91 8.  Make sure your system is set up so that it can act like a gateway
92     for messages to your new connection.  In particular, check the file
93     /etc/rc.config for the line define ROUTER, and make sure it is
94     defined as "yes".
95
96 9.  Reboot and you're ready to go!
97
98 Hopefully, that should work with no hitches.  If there are problems, or
99 if I have made a mistake in these instructions, please let me know.
100
101 Steve Tate
102 University of North Texas
103 srt@cs.unt.edu
104