update
[ppp.git] / README.bsd
index 1d8988fe8553e3a17a0646368ad5c90ab6a93116..a909a4ff849cd48e655febfcfa7e8827d3120cdb 100644 (file)
@@ -1,15 +1,9 @@
-Installation instructions for installing ppp-2.2 on FreeBSD and
+Installation instructions for installing ppp-2.3 on FreeBSD and
 NetBSD systems.
 
-This package supports NetBSD-1.0 and FreeBSD-2.0.  It should work
-on later systems (it works on NetBSD-current as of this writing).
-Modloading is not yet supported.
-
-I have code which should work on earlier systems (386BSD, NetBSD-0.9,
-FreeBSD-1.1.5.1, etc.), but it is not included in this package because
-I have no way to test or support it.  If you are committed to one of
-these earlier versions and you are willing to try out some code
-without needing major hand-holding, contact me (paulus@cs.anu.edu.au).
+This package supports NetBSD-current, NetBSD-1.2, NetBSD-1.1,
+FreeBSD-2.1, and FreeBSD-2.0.  Modloading is not supported.  I have
+code which may work on earlier systems; contact me if you need it.
 
 To install PPP, you need to rebuild your kernel to include the latest
 version of the PPP driver, as well as compiling and installing the
@@ -19,14 +13,14 @@ reboot with the new kernel (you'll have to reboot with the new kernel
 before you can run them, of course).
 
 The following commands should compile and install the user-level
-applications (in the ppp-2.2 directory):
+applications (in the ppp-2.3 directory):
 
        ./configure
        make
        make install            (you need to be root for this)
 
 The process of updating the kernel source files is now largely
-automated.  In the ppp-2.2 directory, issue the command:
+automated.  In the ppp-2.3 directory, issue the command:
 
        make kernel
 
@@ -35,56 +29,62 @@ of several files into /sys, patch other files, and finally give you
 instructions about modifying your kernel configuration file (if
 necessary), rebuilding the kernel and rebooting.
 
-If you want to do the process by hand, read on...
+If you want to do the process by hand, read the next section.
 
 
 Updating the kernel ppp code.
------------------------------
+*****************************
 
 You need to update several files in the /sys/net directory, and patch
-some other files under /sys.
+some other files under /sys.  The details depend on which operating
+system you're running.
+
+
+NetBSD.
+=======
 
-For NetBSD-1.0, copy the following files to /sys/net:
+Copy the following files to /sys/net:
 
        net/if_ppp.h
        net/ppp-comp.h
        net/ppp_defs.h
-       netbsd/bsd-comp.c
-       netbsd/if_ppp.c
-       netbsd/if_pppvar.h
-       netbsd/netisr.h
-       netbsd/ppp_tty.c
-       netbsd/slcompress.c
-       netbsd/slcompress.h
+       netbsd-1.1/bsd-comp.c
+       netbsd-1.1/if_ppp.c
+       netbsd-1.1/if_pppvar.h
+       netbsd-1.1/ppp-deflate.c
+       netbsd-1.1/ppp_tty.c
+       netbsd-1.1/slcompress.c
+       netbsd-1.1/slcompress.h
+       common/zlib.c
+       common/zlib.h
 
-You then need to patch /sys/conf/files and /sys/conf/files.newconf
-using the commands:
+You may need to edit /sys/conf/files to make sure it contains entries
+for if_ppp.c, ppp_tty.c, bsd-comp.c, ppp-deflate.c and zlib.c.
+Depending on whether your port uses the old-style or new-style config
+files, these entries will look like this (new-style):
 
-       patch -p -N -d /sys/conf <netbsd/files.patch
-       patch -p -N -d /sys/conf <netbsd/files.newconf.patch
+       file net/if_ppp.c               ppp             needs-count
+       file net/ppp_tty.c              ppp
+       file net/bsd-comp.c             ppp
+       file net/ppp-deflate.c          ppp
+       file net/zlib.c                 ppp
 
-The next step is to patch the file containing the code which
-dispatches software interrupts.  Unfortunately, this code is in the
-architecture-dependent files, so the file to patch depends on which
-NetBSD port you are using:
+or this (old-style):
 
-Port   File to patch                      Patch file
-----   -------------                      ----------
-amiga  /sys/arch/amiga/amiga/machdep.c    netbsd/arch/amiga/machdep.c.patch
-hp300  /sys/arch/hp300/hp300/machdep.c    netbsd/arch/hp300/machdep.c.patch
-i386   /sys/arch/i386/isa/icu.s           netbsd/arch/i386/icu.s.patch
-mac68k /sys/arch/mac68k/mac68k/machdep.c  netbsd/arch/mac68k/machdep.c.patch
-pc532  /sys/arch/pc532/pc532/locore.s     netbsd/arch/pc532/locore.s.patch
-pmax   /sys/arch/pmax/pmax/trap.c         netbsd/arch/pmax/trap.c.patch
-sparc  /sys/arch/sparc/sparc/intr.c       netbsd/arch/sparc/intr.c.patch
-sun3   /sys/arch/sun3/sun3/isr.c          netbsd/arch/sun3/isr.c.patch
+       net/if_ppp.c            optional ppp device-driver
+       net/ppp_tty.c           optional ppp
+       net/bsd-comp.c          optional ppp
+       net/ppp-deflate.c       optional ppp
+       net/zlib.c              optional ppp
 
-To do the patch, you would use a command something like this:
+If you use config.old or config.new, you will need to edit
+/sys/conf/files.oldconf or /sys/conf/files.newconf respectively.
 
-       patch -p -d /sys/arch/i386/isa <netbsd/arch/i386/icu.s.patch
 
+FreeBSD.
+========
 
-For FreeBSD-2.0, copy the following files to /sys/net:
+Copy the following files to /sys/net:
 
        net/if_ppp.h
        net/ppp-comp.h
@@ -92,17 +92,26 @@ For FreeBSD-2.0, copy the following files to /sys/net:
        freebsd-2.0/bsd-comp.c
        freebsd-2.0/if_ppp.c
        freebsd-2.0/if_pppvar.h
+       freebsd-2.0/ppp-deflate.c
        freebsd-2.0/ppp_tty.c
        freebsd-2.0/pppcompress.c
        freebsd-2.0/pppcompress.h
+       common/zlib.c
+       common/zlib.h
 
-You then need to patch /sys/conf/files using the command:
+You then need to edit /sys/conf/files to make sure it contains entries
+for if_ppp.c, ppp_tty.c, bsd-comp.c, ppp-deflate.c and zlib.c.  These
+entries should look like this:
 
-       patch -p -N -d /sys/conf <freebsd-2.0/files.patch
+       net/if_ppp.c            optional ppp device-driver
+       net/ppp_tty.c           optional ppp
+       net/bsd-comp.c          optional ppp
+       net/ppp-deflate.c       optional ppp
+       net/zlib.c              optional ppp
 
 
 Configuring and making the new kernel.
---------------------------------------
+**************************************
 
 First, make sure that the configuration file you are using includes a
 line something like
@@ -113,11 +122,11 @@ If it doesn't, add one.  The `2' is the number of ppp interfaces to
 configure, that is, the maximum number of simultaneous ppp connections
 you will be able to have; change it as required.
 
-Next, run config or config.new in the directory containing the
-configuration file, giving the configuration file name as an argument.
-Then cd to the compilation directory and make the kernel.  For the
-i386 port of NetBSD, with a configuration file called CONF, this
-involves the following commands:
+Next, run config (or config.old or config.new) in the directory
+containing the configuration file, giving the configuration file name
+as an argument.  Then cd to the compilation directory and make the
+kernel.  For the i386 port of NetBSD, with a configuration file called
+CONF, this involves the following commands:
 
        cd /sys/arch/i386/conf
        /usr/sbin/config CONF