Run ntlm_auth as the user that invoked pppd.
[ppp.git] / README.osf
1 This file (README.osf) contains instructions for installing ppp-2.3 on a
2 Compaq Alpha-based system running Tru64 Unix (formerly Digital UNIX aka
3 DEC OSF/1) version 4.0. Please note that  PPP is an integral
4 component of Tru64 UNIX version 3.2G and beyond (documented in the
5 Guide to Network Administration),  and though it *is* possible to install 
6 this software on V3.2G and later of Tru64 UNIX, you are likely
7 to have problems with the "update install" feature of Tru64
8 UNIX and while installing some OS patches. (See the note on 
9 de-installation below). 
10
11 Tru64 Unix versions Version 3.X and earlier are no longer supported
12 in this package.  Please use ppp-2.3.5 on these systems.
13
14 INSTALLATION.
15
16 If you encounter bugs while using this PPP package under Tru64
17 UNIX then please let me (varadhan@zk3.dec.com) know.  I can't promise
18 quick turnaround but I should be able to address issues eventually.
19
20 Below are the steps for installing PPP on Tru64 UNIX.
21 You must do all of the following as "root".
22
23 1.  back up /usr/sys/BINARY, /usr/sys/include/net,
24     /usr/sys/conf/files, /sys/kern/lockinfo.c  and /sys/BINARY/ppp.mod
25         # mkdir -p /usr/tmp/ppp
26         # cd /usr/sys
27         # tar cvf /usr/tmp/ppp/BINARY.tar ./BINARY
28         # cd /usr/sys/include
29         # tar cvf /usr/tmp/ppp/usr_sys_include_net.tar  ./net
30         # cp /usr/sys/conf/files /usr/tmp/ppp/files
31         # cp /sys/kern/lockinfo.c /usr/tmp/ppp/lockinfo.c
32         # cp /sys/BINARY/ppp.mod /usr/tmp/ppp/ppp.mod
33
34 2.  Edit /usr/sys/conf/files- search for the string: "MODULE/STATIC/ppp"
35 comment out the existing entries, and change it to look like:
36
37 MODULE/STATIC/ppp               optional ppp Binary
38 #streamsm/ppp_init.c            module ppp
39 #streamsm/ppp_if.c              module ppp
40 #streamsm/ppp_async.c           module ppp
41 #streamsm/ppp_comp.c            module ppp
42 #streamsm/vjcompress.c          module ppp
43 #streamsm/bsd_comp.c            module ppp
44 streamsm/if_ppp.c         module ppp
45 streamsm/ppp_comp.c       module ppp
46 streamsm/ppp_init.c       module ppp
47 streamsm/vjcompress.c     module ppp
48 streamsm/bsd-comp.c       module ppp
49 streamsm/deflate.c        module ppp
50 streamsm/ppp.c            module ppp
51 streamsm/ppp_ahdlc.c      module ppp
52 streamsm/zlib.c           module ppp
53
54 3.  Make the kernel sources, daemon, chat, and pppstat program by typing 
55
56         ./configure
57         make install
58
59     in the directory that this file unpacked into.  This installs the
60     binaries for the PPP daemon and the statistics program in 
61     /usr/local/etc/ppp.  If you want them somewhere else, just change 
62     the definition of BINDIR in the top level Makefile.osf. If you plan
63     to over-write exisiting pppd executables in /usr/sbin/, it's advisable
64     that you create back-up copies of these first, before doing the
65     'make install'
66
67     Note that BINDIR and MANDIR/man8 must exist before you do a 
68     'make install'
69
70
71 4.  Edit /sys/kern/lockinfo.c, and conditionally compile out the lines:
72
73 #if PPP
74         SLI("ppp_if_table_lock", ppp_if_table_lock_info, SPLNONE, DEFAULT);
75         SLI("ppp_if_info.ppp_if_element_lock", ppp_if_element_lock_info, SPLNONE
76 , DEFAULT);
77         SLI("ppp_comp_table_lock", ppp_comp_table_lock_info, SPLNONE, DEFAULT);
78         SLI("ppp_comp_info.ppp_comp_element_lock", ppp_comp_element_lock_info, S
79 PLNONE, DEFAULT);
80         SLI("ppp_async_table_lock", ppp_async_table_lock_info, SPLNONE, DEFAULT)
81 ;
82         SLI("ppp_async_info.ppp_async_element_lock", ppp_async_element_lock_info
83 , SPLNONE, DEFAULT);
84 #endif  /* PPP */
85
86 by changing the line
87
88 #if PPP 
89
90 to be
91
92 #if 0 
93
94 5.  Find your system's configuration file.  This should be called
95     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
96     host.  For example, on my machine (zaphod.csci.unt.edu) it it called
97     /sys/conf/ZAPHOD.  I will refer to this file from now on as 
98     /sys/conf/SYSNAME.
99
100 6.  Add the following line at the end of /sys/conf/SYSNAME:
101
102         options         PPP
103
104 7.  Build a new kernel by using the command
105
106         doconfig -c SYSNAME
107
108     (say "n" to "Do you want to edit...").
109
110 8.  Copy the new kernel to /vmunix --- I'm usually pretty nervous about
111     writing over a perfectly good kernel with one that I'm not sure
112     about, so I will usually "mv /vmunix /vmunix.old" first.  To put
113     the new kernel in place, do a "cp /sys/SYSNAME/vmunix /vmunix".
114
115 9.  Make sure your system is set up so that it can act like a gateway
116     for messages to your new connection.  In particular, check the file
117     /etc/rc.config for the line define ROUTER, and make sure it is
118     defined as "yes".
119
120 10.  Reboot and you're ready to go!
121
122 Hopefully, that should work with no hitches.  If you find any bugs, or
123 errors in these instructions, contact Sowmini Varadhan<varadhan@zk3.dec.com>.
124
125
126 DEINSTALLATION
127
128 It is advisable to retrace your steps and restore the system
129 to its normal state before installing patches or running update_install.
130 Here's how you can retrace..
131
132 1. Restore /usr/sys/BINARY, /usr/sys/include/net, /usr/sys/conf/files
133    and /sys/kern/lockinfo.c and /sys/BINARY/ppp.mod. For example,
134    if you followed the instructions in step 1 verbatim, you would do
135
136         # cd /usr/sys/
137         # rm -rf ./BINARY
138         # tar xvf /usr/tmp/ppp/BINARY.tar
139         # cd /usr/sys/include
140         # rm -rf ./net
141         # tar xvf /usr/tmp/ppp/usr_sys_include_net.tar
142         # cp  /usr/tmp/ppp/files /usr/sys/conf/files
143         # cp /usr/tmp/ppp/lockinfo.c /sys/kern/lockinfo.c
144         # cp /usr/tmp/ppp/ppp.mod /sys/BINARY/ppp.mod
145
146 Now redo steps 5-10 and install the patch after you have rebooted.