remove extraneous NOTSUSER def
[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.
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 DEC OSF/1 V2.0 THROUGH V2.1:
36
37     | Add the following lines to the file /sys/conf/files:
38     |
39     | streamsm/if_ppp.c         optional ppp Notbinary optimize -g3
40     | streamsm/ppp_comp.c       optional ppp Notbinary optimize -g3
41     | streamsm/ppp_init.c       optional ppp Notbinary optimize -g3
42     | streamsm/vjcompress.c     optional ppp Notbinary optimize -g3
43     | streamsm/bsd-comp.c       optional ppp Notbinary optimize -g3
44     | streamsm/deflate.c        optional ppp Notbinary optimize -g3
45     | streamsm/ppp.c            optional ppp Notbinary optimize -g3
46     | streamsm/ppp_ahdlc.c      optional ppp Notbinary optimize -g3
47     | streamsm/zlib.c           optional ppp Notbinary optimize -g3
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 V3.0 THROUGH Digital UNIX V3.2F:
60
61     | Add the following lines to the file /sys/conf/files:
62     |
63     | streamsm/if_ppp.c         optional ppp if_dynamic ppp Notbinary optimize -g3
64     | streamsm/ppp_comp.c       optional ppp if_dynamic ppp Notbinary optimize -g3
65     | streamsm/ppp_init.c       optional ppp if_dynamic ppp Notbinary optimize -g3
66     | streamsm/vjcompress.c     optional ppp if_dynamic ppp Notbinary optimize -g3
67     | streamsm/bsd-comp.c       optional ppp if_dynamic ppp Notbinary optimize -g3
68     | streamsm/deflate.c        optional ppp if_dynamic ppp Notbinary optimize -g3
69     | streamsm/ppp.c            optional ppp if_dynamic ppp Notbinary optimize -g3
70     | streamsm/ppp_ahdlc.c      optional ppp if_dynamic ppp Notbinary optimize -g3
71     | streamsm/zlib.c           optional ppp if_dynamic ppp Notbinary optimize -g3
72
73     FOR Digital UNIX V3.2G AND V4.0 AND BEYOND
74
75     This package does not support these versions of Digital UNIX.
76     PPP is an integral part of the OS.  Please see the Guide to
77     Network Administration for details on configuring PPP.
78
79 4.  Find your system's configuration file.  This should be called
80     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
81     host.  For example, on my machine (zaphod.csci.unt.edu) it it called
82     /sys/conf/ZAPHOD.  I will refer to this file from now on as 
83     /sys/conf/SYSNAME.
84
85 5.  Add the following line at the end of /sys/conf/SYSNAME:
86
87         options         PPP
88
89 6.  Build a new kernel by using the command
90
91         doconfig -c SYSNAME
92
93     (say "n" to "Do you want to edit...").
94
95 7.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
96     writing over a perfectly good kernel with one that I'm not sure
97     about, so I will usually "mv /vmunix /vmunix.old" first.  To put
98     the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".
99
100 8.  Make sure your system is set up so that it can act like a gateway
101     for messages to your new connection.  In particular, check the file
102     /etc/rc.config for the line define ROUTER, and make sure it is
103     defined as "yes".
104
105 9.  Reboot and you're ready to go!
106
107 Hopefully, that should work with no hitches.  If there are problems, or
108 if I have made a mistake in these instructions, please let me know.
109
110 Steve Tate
111 University of North Texas
112 srt@cs.unt.edu
113