Ignore NAK'd options we don't recognize.
[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 DEC AXP system running OSF/1.
20 You must do all of the following as "root".
21
22 1.  Make the kernel sources, daemon, chat, and pppstat program by typing 
23
24         ./configure
25         make install
26
27     in the directory that this file unpacked into.  This installs the
28     binaries for the PPP daemon and the statistics program in 
29     /usr/local/etc/ppp.  If you want them somewhere else, just change 
30     the definition of BINDIR in the top level Makefile.osf.
31
32 2.  This step differs depending on whether you are running OSF/1 V3.0
33     or later.
34
35     FOR OSF/1 VERSIONS PRIOR TO V3.0:
36
37     | Add the following lines to the file /sys/conf/files:
38     |
39     |      streamsm/ppp_if.c                    optional ppp Notbinary
40     |      streamsm/ppp_async.c                 optional ppp Notbinary
41     |      streamsm/ppp_init.c                  optional ppp Notbinary
42     |      streamsm/vjcompress.c                optional ppp Notbinary
43     |      streamsm/bsd-comp.c                  optional ppp Notbinary
44     |      streamsm/ppp_comp.c                  optional ppp Notbinary
45     |
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 OSF/1 VERSIONS V3.0 AND LATER:
58
59     | Add the following lines to the file /sys/conf/files:
60     |
61     |      streamsm/ppp_if.c          optional ppp if_dynamic ppp Notbinary
62     |      streamsm/ppp_async.c       optional ppp if_dynamic ppp Notbinary
63     |      streamsm/ppp_init.c        optional ppp if_dynamic ppp Notbinary
64     |      streamsm/vjcompress.c      optional ppp if_dynamic ppp Notbinary
65     |      streamsm/bsd-comp.c        optional ppp if_dynamic ppp Notbinary
66     |      streamsm/ppp_comp.c        optional ppp if_dynamic ppp Notbinary
67
68 4.  Find your system's configuration file.  This should be called
69     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
70     host.  For example, on my machine (zaphod.csci.unt.edu) it it called
71     /sys/conf/ZAPHOD.  I will refer to this file from now on as 
72     /sys/conf/SYSNAME.
73
74 5.  Add the following line at the end of /sys/conf/SYSNAME:
75
76         pseudo-device   ppp     2
77
78 6.  Build a new kernel by using the command
79
80         doconfig -c SYSNAME
81
82     (say "n" to "Do you want to edit...").
83
84 7.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
85     writing over a perfectly good kernel with one that I'm not sure
86     about, so I will usually "mv /vmunix /vmunix.old" first.  To put
87     the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".
88
89 8.  Make sure your system is set up so that it can act like a gateway
90     for messages to your new connection.  In particular, check the file
91     /etc/rc.config for the line define ROUTER, and make sure it is
92     defined as "yes".
93
94 9.  Reboot and you're ready to go!
95
96 Hopefully, that should work with no hitches.  If there are problems, or
97 if I have made a mistake in these instructions, please let me know.
98
99 Steve Tate
100 University of North Texas
101 srt@cs.unt.edu
102