update for 2.3.9 final
authorPaul Mackerras <paulus@samba.org>
Fri, 13 Aug 1999 01:54:02 +0000 (01:54 +0000)
committerPaul Mackerras <paulus@samba.org>
Fri, 13 Aug 1999 01:54:02 +0000 (01:54 +0000)
README
README.linux

diff --git a/README b/README
index 0ce0fa206658b49f344c07c0f0d800eb917c8c81..da1460ee5931da9eff509dbedd6dcff13d4845bb 100644 (file)
--- a/README
+++ b/README
@@ -86,6 +86,12 @@ What's new in ppp-2.3.9.
   peer.  It doesn't apply it if the link was terminated because the
   local pppd thought it was idle.
 
+* Synchronous support for Solaris has been added, thanks to John
+  Morrison, and for FreeBSD, thanks to Paul Fulghum.
+
+* IPV6 support has been merged in, from Tommi Komulainen.  At the
+  moment it only supports Linux and it is not tested by me.
+
 * The `nodefaultip' option can be used in demand mode to say that pppd
   should not suggest its local IP address to the peer.
 
@@ -97,6 +103,14 @@ What's new in ppp-2.3.9.
 * There is a new `logfile' option to send log messages to a file as
   well as syslog.
 
+* There is a new, privileged `linkname' option which sets a logical
+  name for the link.  Pppd will create a /var/run/ppp-<linkname>.pid
+  file containing its process ID.
+
+* There is a new `maxfail' option which specifies how many consecutive
+  failed connection attempts are permitted before pppd will exit.  The
+  default value is 10, and 0 means infinity. :-)
+
 * Sundry bugs fixed.
 
 
@@ -403,6 +417,19 @@ not acceptable (put a ! on the front).
 Thanks to those who reported bugs in ppp-2.2.
 
 
+Compression methods.
+********************
+
+This package supports two packet compression methods: Deflate and
+BSD-Compress.  Other compression methods which are in common use
+include Predictor, LZS, and MPPC.  These methods are not supported for
+two reasons - they are patent-encumbered, and they cause some packets
+to expand slightly, which pppd doesn't currently allow for.
+BSD-Compress is also patent-encumbered (its inclusion in this package
+can be considered a historical anomaly :-) but it doesn't ever expand
+packets.  Neither does Deflate, which uses the same algorithm as gzip.
+
+
 Patents.
 ********
 
@@ -430,7 +457,7 @@ If you find bugs in this package, please report them to the maintainer
 for the port for the operating system you are using:
 
 Linux                  Paul Mackerras <Paul.Mackerras@cs.anu.edu.au>
-Solaris 2              Paul Mackerras <Paul.Mackerras@cs.anu.edu.au>
+Solaris 2              Paul Mackerras (for want of anybody better :-)
 SunOS 4.x              Paul Mackerras (for want of anybody better :-)
 Digital Unix (OSF/1)   Sowmini Varadhan <varadhan@zk3.dec.com>
 NetBSD                 Matthew Green <mrg@eterna.com.au>
@@ -443,7 +470,9 @@ Ultrix 4.x          Paul Mackerras (for want of anybody better :-)
 Copyrights:
 ***********
 
-All of the code can be freely used and redistributed.
+All of the code can be freely used and redistributed.  The individual
+source files each have their own copyright and permission notice; some
+have a BSD-style notice and some are under the GPL.
 
 
 Distribution:
@@ -454,4 +483,4 @@ The primary site for releases of this software is:
        ftp://cs.anu.edu.au/pub/software/ppp/
 
 
-($Id: README,v 1.18 1999/07/23 07:07:33 paulus Exp $)
+($Id: README,v 1.19 1999/08/13 01:54:02 paulus Exp $)
index b0e21ca23df683a94ff92ee97dd5d9edb89c02a6..df918cfcf07b6696e0a209fb7d14171716e49f91 100644 (file)
@@ -87,12 +87,38 @@ Nick Walker added the code to pppd to query the peer for DNS server
 addresses.
 
 
+USING THE NEW PPP KERNEL DRIVER
+
+As of kernel version 2.3.13, the development series of kernels contain
+a new kernel PPP driver, rewritten from scratch by Paul Mackerras.
+This package supports the new driver, although it doesn't include the
+source for the new driver.
+
+The new driver is divided into two files: ppp_generic.c and
+ppp_async.c.  The old ppp.c is still present in the kernel sources but
+is not used.  If you compile PPP as a module, you will get two
+separate modules, called ppp_generic and ppp_async.
+
+To talk to the new driver, pppd needs to be able to open /dev/ppp,
+character device (108,0).  If the special file node /dev/ppp is not
+present, pppd will create it.  However, if you are running with /dev
+on a read-only filesystem, pppd will not be able to create /dev/ppp.
+In that instance you should manually create /dev/ppp using the command
+`mknod /dev/ppp c 108 0'.
+
+If you use module autoloading and have PPP as a module, you will need
+to add the following to /etc/conf.modules:
+
+alias tty-ldisc-3    ppp_async
+alias char-major-108 ppp_generic
+
+
 INSTALLATION
 
 This version of PPP has been tested on various Linux kernel versions
-(most recently 2.0.36 and 2.2.8). It will not work on kernels before
-2.0.0. If you have an earlier kernel, please upgrade to the latest 2.0
-or 2.2 kernel.
+(most recently 2.2.10). It will not work on kernels before 2.0.0. If
+you have an earlier kernel, please upgrade to the latest 2.2-series
+kernel.
 
 joining the PPP channel of linux-activists:
 
@@ -165,17 +191,22 @@ set of symbolic links to the makefiles. They should link 'Makefile' to
 
 2. Update the kernel sources.
 
-The 2.2.8 kernel contains the same PPP kernel driver as is in this
-release.  In fact the driver in the kernel sources is slightly
+The 2.2.8 and later kernels contains the same PPP kernel driver as is
+in this release.  In fact the driver in the kernel sources is slightly
 different from the one in this package as it doesn't include the stuff
 which enables the driver in this package to compile in either the 2.0
 or 2.2 kernel environment, but the two are functionally equivalent.
-If you are using a 2.2.8 kernel and your kernel is already configured
-for PPP, then you only need to do steps 5 and 6.  Otherwise, continue
-at step 3.
+If you are using a 2.2.8 or later kernel and your kernel is already
+configured for PPP, then you only need to do steps 5 and 6.
+Otherwise, continue at step 3.
+
+If you are using a 2.3 series kernel, use the kernel driver that is in
+the kernel sources.  For 2.3.13 and later, this is the new driver (see
+above).
 
 If you are using a kernel earlier than 2.2.8, you can either use the
-driver in this package or upgrade your kernel to 2.2.8.  If you choose
+driver in this package or upgrade your kernel to the current 2.2.x
+series kernel (2.2.11, as of the release of ppp-2.3.9).  If you choose
 to use the driver in this package, you will need a copy of the kernel
 source tree to compile the driver.  Issue the command: