allow ipcp-accept-remote option with demand
[ppp.git] / README.bsd
1 Installation instructions for installing ppp-2.3 on FreeBSD and
2 NetBSD systems.
3
4 This package supports NetBSD-current, NetBSD-1.2, NetBSD-1.1,
5 FreeBSD-2.1, and FreeBSD-2.0.  Modloading is not supported.  I have
6 code which may work on earlier systems; contact me if you need it.
7
8 To install PPP, you need to rebuild your kernel to include the latest
9 version of the PPP driver, as well as compiling and installing the
10 user-level applications: pppd, pppstats and chat.  The user-level
11 applications can be compiled and installed either before or after you
12 reboot with the new kernel (you'll have to reboot with the new kernel
13 before you can run them, of course).
14
15 The following commands should compile and install the user-level
16 applications (in the ppp-2.3 directory):
17
18         ./configure
19         make
20         make install            (you need to be root for this)
21
22 The process of updating the kernel source files is now largely
23 automated.  In the ppp-2.3 directory, issue the command:
24
25         make kernel
26
27 (you probably need to be root for this).  This will copy new versions
28 of several files into /sys, patch other files, and finally give you
29 instructions about modifying your kernel configuration file (if
30 necessary), rebuilding the kernel and rebooting.
31
32 If you want to do the process by hand, read the next section.
33
34
35 Updating the kernel ppp code.
36 *****************************
37
38 You need to update several files in the /sys/net directory, and patch
39 some other files under /sys.  The details depend on which operating
40 system you're running.
41
42
43 NetBSD.
44 =======
45
46 Copy the following files to /sys/net:
47
48         net/if_ppp.h
49         net/ppp-comp.h
50         net/ppp_defs.h
51         netbsd-1.1/bsd-comp.c
52         netbsd-1.1/if_ppp.c
53         netbsd-1.1/if_pppvar.h
54         netbsd-1.1/ppp-deflate.c
55         netbsd-1.1/ppp_tty.c
56         netbsd-1.1/slcompress.c
57         netbsd-1.1/slcompress.h
58         common/zlib.c
59         common/zlib.h
60
61 You may need to edit /sys/conf/files to make sure it contains entries
62 for if_ppp.c, ppp_tty.c, bsd-comp.c, ppp-deflate.c and zlib.c.
63 Depending on whether your port uses the old-style or new-style config
64 files, these entries will look like this (new-style):
65
66         file net/if_ppp.c               ppp             needs-count
67         file net/ppp_tty.c              ppp
68         file net/bsd-comp.c             ppp
69         file net/ppp-deflate.c          ppp
70         file net/zlib.c                 ppp
71
72 or this (old-style):
73
74         net/if_ppp.c            optional ppp device-driver
75         net/ppp_tty.c           optional ppp
76         net/bsd-comp.c          optional ppp
77         net/ppp-deflate.c       optional ppp
78         net/zlib.c              optional ppp
79
80 If you use config.old or config.new, you will need to edit
81 /sys/conf/files.oldconf or /sys/conf/files.newconf respectively.
82
83
84 FreeBSD.
85 ========
86
87 Copy the following files to /sys/net:
88
89         net/if_ppp.h
90         net/ppp-comp.h
91         net/ppp_defs.h
92         freebsd-2.0/bsd-comp.c
93         freebsd-2.0/if_ppp.c
94         freebsd-2.0/if_pppvar.h
95         freebsd-2.0/ppp-deflate.c
96         freebsd-2.0/ppp_tty.c
97         freebsd-2.0/pppcompress.c
98         freebsd-2.0/pppcompress.h
99         common/zlib.c
100         common/zlib.h
101
102 You then need to edit /sys/conf/files to make sure it contains entries
103 for if_ppp.c, ppp_tty.c, bsd-comp.c, ppp-deflate.c and zlib.c.  These
104 entries should look like this:
105
106         net/if_ppp.c            optional ppp device-driver
107         net/ppp_tty.c           optional ppp
108         net/bsd-comp.c          optional ppp
109         net/ppp-deflate.c       optional ppp
110         net/zlib.c              optional ppp
111
112
113 Configuring and making the new kernel.
114 **************************************
115
116 First, make sure that the configuration file you are using includes a
117 line something like
118
119         pseudo-device ppp 2
120
121 If it doesn't, add one.  The `2' is the number of ppp interfaces to
122 configure, that is, the maximum number of simultaneous ppp connections
123 you will be able to have; change it as required.
124
125 Next, run config (or config.old or config.new) in the directory
126 containing the configuration file, giving the configuration file name
127 as an argument.  Then cd to the compilation directory and make the
128 kernel.  For the i386 port of NetBSD, with a configuration file called
129 CONF, this involves the following commands:
130
131         cd /sys/arch/i386/conf
132         /usr/sbin/config CONF
133         cd ../compile/CONF
134         make
135
136 For FreeBSD, the commands are similar except for different
137 directories:
138
139         cd /sys/i386/conf
140         /usr/sbin/config CONF
141         cd ../../compile/CONF
142         make
143
144 The result should be a new kernel image (usually called `netbsd' under
145 NetBSD, `kernel' under FreeBSD).  Save a copy of the kernel image
146 you're currently using, copy the new kernel image file to /, and
147 reboot.