rewrite the pid file when using updetach
[ppp.git] / README.linux
index 569d05fe905b8d5b6f971444e28f2841a6e0502a..32d22fc40e300a3aa50897968e29e2e8052e6e10 100644 (file)
@@ -1,16 +1,15 @@
-PPP for Linux                                             Version 2.2.0
+PPP for Linux                                             Version 2.3.3
 =============                                                  based on
-                                                              ppp-2.2.0
-                                                               Mar 1995
+                                                              ppp-2.3.3
+                                                               Dec 1997
 
 Michael Callahan    callahan@maths.ox.ac.uk
 Al Longyear         longyear@netcom.com
+Paul Mackerras      Paul.Mackerras@cs.anu.edu.au
 
   Contents:
     INTRODUCTION
     CREDITS
-    CHANGES FROM THE PREVIOUS VERSION
-    FUTURE PLANS
     INSTALLATION
     PROBLEMS WHICH MAY OCCUR WHILE BUILDING THE KERNEL
        A REFERENCE TO UNDEFINED _mod_use_count_
@@ -33,8 +32,9 @@ INTRODUCTION
 This file is substantially derived from the previous version for the
 pppd process 2.2.0, which itself was derived from earlier works by
 Michael Callahan. This particular version was written, modified,
-hacked, changed, whatever, by Al Longyear. If you find errors in this
-document, they are probably mine and not Michael's.
+hacked, changed, whatever, by Al Longyear and Paul Mackerras. If you
+find errors in this document, they are probably ours and not
+Michael's.
 
 This is a PPP driver for Linux.  It has been used by many people and
 seems to be quite stable.  It is capable of being used either as a
@@ -91,46 +91,12 @@ of '16 channel' support obsolete.
 
 
 
-CHANGES FROM THE PREVIOUS VERSION
-
-- The kernel debug value has changed. Previously it was a level. It is now
-  a bit map with various bits meaning certain types of debug information.
-
-     0 - No debug information is generated
-     1 - Debug messages
-     2 - Log incoming packets
-     4 - Log outgoing packets
-     8 - Log tty output buffers
-    16 - Log tty input buffers
-
-  If you wish to use any combination, add the values together. For example,
-  '7' will log debug messages and incoming packages and outgoing packets.
-
-  The default setting is 0.
-
-  The simple IP trace which ppp.c performed when 'kdebug' was greater than
-  127 has been removed. You should use tcpdump for this type of trace
-  actions.
-
-- Support is added for compression control protocol. At the present time
-  the BSD-Compress and 'deflate' compression protocols are supported. A
-  testing version of the predictor-1 compression protocol was developed but
-  it is not included in this package due to unfortunate Motorola patent
-  considerations.
-
-
-FUTURE PLANS
-
-These are to be determined.
-
-
-
 INSTALLATION
 
-This version of PPP has been tested on kernel version 1.3.100. It will
-probably not work on kernels much earlier than this due to earlier problems
-with the kernels. If you have an earlier kernel, please upgrade to the 2.0
-kernel (when it is available).
+This version of PPP has been tested on various Linux kernel versions
+(most recently 2.0.30 and 2.1.24). It will probably not work on
+kernels before 2.0.0. If you have an earlier kernel, please upgrade to
+the latest 2.0 kernel.
 
 joining the PPP channel of linux-activists:
 
@@ -262,15 +228,10 @@ not work with the older kernel driver. If you don't know how to build
 a kernel, then you should read the README file in the kernel source
 directory.
 
-If you wish module support then you need to have the 'modules-1.1.87'
+If you wish module support then you need to have the 'modules-2.0.0'
 package installed as the minimum version. Earlier versions of the module
 support will not work properly. All of the later ones will.
 
-As of this time, the current version for the modules package is
-1.2.0. Even 1.1.87 is old. However, if you only have 1.1.87 then it
-will do as it permits the symbol table references. Please consider
-upgrading the module package however.
-
 Instructions on building the kernel with modules are given in the
 README.modules in the kernel source directory.
 
@@ -336,14 +297,10 @@ regard to any order with the BSD one. The idea is that the ppp.o code must
 be loaded to use the compressor and the VJ header compression code must be
 loaded to use ppp.o.
 
-You may elect not to load the BSD compression module if you desire. There
-is a controversy regarding a Motorola software patent and while it is
-believed that this code does not infringe upon the patent, it is however
-an optional component.
-
-The deflate compressor has been stated by Morotola to not infringe upon
-their patent. However, it is also new. You may not find many systems which
-use this compressor.
+You may elect not to load the BSD compression module if you desire.
+The LZW compression algorithm (as used by BSD-Compress and the
+`compress' command) is claimed to be covered by a patent held by
+Unisys in the USA and other countries.
 
 In addition, if memory is a premium, do not run the compressors. It
 may take large amounts of memory (up to 2.6 meg) for high compression
@@ -362,8 +319,7 @@ be loaded. BOTH systems must support the same compression protocols.
 
 PROBLEMS WHICH MAY OCCUR WHILE BUILDING THE KERNEL
 
-At this time with the 1.3.100 and pre-2.0 series kernels, soon to have the
-2.0 series kernel, there should not be a problem with the compilation of the
+At this time there should not be a problem with the complication of the
 drivers.
 
 
@@ -575,7 +531,7 @@ lo        Link encap Local Loopback
           TX packets 0 errors 0 dropped 0 overrun 0
 
 ppp0      Link encap Point-to-Point Protocol
-          inet addr 192.76.32.2  P-t-P 129.67.1.165  Mask 255.255.255.0
+          inet addr 192.76.32.3  P-t-P 129.67.1.165  Mask 255.255.255.0
           UP POINTOPOINT RUNNING  MTU 1500  Metric 1
           RX packets 33 errors 0 dropped 0 overrun 0
           TX packets 42 errors 0 dropped 0 overrun 0
@@ -739,9 +695,9 @@ pieces of information:
 modem
 crtscts
 lock
-:192.1.2.23
+:192.1.2.33
 
-Here we will insist that the remote machine use IP address 192.1.2.23,
+Here we will insist that the remote machine use IP address 192.1.2.33,
 while the local PPP interface will use the IP address associated with
 this machine's hostname in /etc/hosts.  The '-detach' option is required
 for a server. It tells the pppd process not to terminate until the modem
@@ -775,7 +731,7 @@ to be on the local Ethernet segment and you should give the 'proxyarp'
 option to pppd on the server.  Suppose, for example, we have this
 setup:
 
- 192.1.2.23                        192.1.2.17
+ 192.1.2.33                        192.1.2.17
 +-----------+      PPP link       +----------+
 | chelseapc | ------------------- |  billpc  |
 +-----------+                    +----------+
@@ -796,14 +752,14 @@ piece of information:
 modem
 crtscts
 lock
-192.1.2.17:192.1.2.23
+192.1.2.17:192.1.2.33
 proxyarp
 
 When the link comes up, pppd will enter a "proxy arp" entry for
 chelseapc into the arp table on billpc.  What this means effectively
 is that billpc will pretend to the other machines on the 192.1.2.x
 Ethernet that its Ethernet interface is ALSO the interface for
-chelseapc (192.1.2.23) as well as billpc (192.1.2.17).  In practice
+chelseapc (192.1.2.33) as well as billpc (192.1.2.17).  In practice
 this means that chelseapc can communicate just as if it was directly
 connected to the Ethernet.