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.