updated for 2.3
authorPaul Mackerras <paulus@samba.org>
Wed, 28 Aug 1996 06:30:33 +0000 (06:30 +0000)
committerPaul Mackerras <paulus@samba.org>
Wed, 28 Aug 1996 06:30:33 +0000 (06:30 +0000)
FAQ
README
README.osf
TODO
ppp.texi

diff --git a/FAQ b/FAQ
index 6996296b4d65be035a4dbc1b1786992b6a039e47..9a1675a3eab5147145a3dc0d87dd8ccdcb75e59f 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -482,6 +482,20 @@ message (since your pppd doesn't recognize the protocol number
 either.)
 
 
+------------------------------------------------------------------------
+
+Q: I get a message saying something like "ioctl(TIOCSETD): Operation
+not permitted".  How do I fix this?
+
+A: This is because pppd is not running as root.  If you have not
+installed pppd setuid-root, you will have to be root to run it.  If
+you have installed pppd setuid-root and you still get this message, it
+is probably because your shell is using some other copy of pppd than
+the installed one - for example, if you are in the pppd directory
+where you've just built pppd and your $PATH has . before /usr/sbin (or
+wherever pppd gets installed).
+
+
 ------------------------------------------------------------------------
 
 Q: Has your package been ported to HP/UX or IRIX or AIX?
diff --git a/README b/README
index 8dd7db04d4534acaf215ab38a517eac4ef691206..d5e8421a16caa7fb61df1efafcd6a35c7c5bbec4 100644 (file)
--- a/README
+++ b/README
@@ -4,10 +4,11 @@ serial lines.
 
 In this first beta release, the ports for SunOS, Solaris, NetBSD and
 Digital Unix (OSF/1) are believed to be working correctly.  The Linux
-port mostly works, but still has some known bugs.  The remaining ports
-haven't been tested extensively.  The NeXTStep port is not included
-here since it hasn't been updated from 2.2 yet.  For information on
-its current status, see http://www.thoughtport.com:8080/PPP/.
+port mostly works, but still has some known bugs (demand dialling
+doesn't work correctly).  The remaining ports haven't been tested
+extensively.  The NeXTStep port is not included here since it hasn't
+been updated from 2.2 yet.  For information on its current status, see
+http://www.thoughtport.com:8080/PPP/.
 
 
 Introduction.
@@ -16,7 +17,7 @@ Introduction.
 The Point-to-Point Protocol (PPP) provides a standard way to establish
 a network connection over a serial link.  At present, this package
 supports IP and the protocols layered above IP, such as TCP and UDP.
-The Linux port of this package also supports IPX.
+The Linux port of this package also has support for IPX.
 
 This software consists of two parts:
 
@@ -50,6 +51,9 @@ files, are:
        System V Release 4              README.svr4
        Ultrix 4.x                      README.ultrix
 
+(Unfortunately, AIX 4 is no longer supported, since I don't have a
+maintainer for the AIX 4 port.  If you want to volunteer, contact me.)
+
 In each case you start by running the ./configure script.  This works
 out which operating system you are using and creates symbolic links to
 the appropriate makefiles.  You then run `make' to compile the
@@ -62,32 +66,31 @@ kernel using a `modload' facility.  On others, the kernel image has to
 be recompiled and the system rebooted.  See the README.* files for
 details.
 
-(Unfortunately, AIX 4 is no longer supported, since I don't have a
-maintainer for the AIX 4 port.  If you want to volunteer, contact me.)
-
 
 What's new in ppp-2.3.
 **********************
 
 * Demand-dialling.  Pppd now has a mode where it will establish the
 network interface immediately when it starts, but not actually bring
-the link up until it sees some data to be sent.
+the link up until it sees some data to be sent.  Look for the demand
+option description in the pppd man page.
 
 * Idle timeout.  Pppd will optionally terminate the link if no data
 packets are sent or received within a certain time interval.
 
 * Pppd now runs the /etc/ppp/auth-up script, if it exists, when the
 peer successfully authenticates itself, and /etc/ppp/auth-down when
-the connection is subsequently terminated.
+the connection is subsequently terminated.  This can be useful for
+accounting purposes.
 
 * A new packet compression scheme, Deflate, has been implemented.
 This uses the same compression method as `gzip'.  This method is free
 of patent or copyright restrictions, and it achieves better
 compression than BSD-Compress.  It does consume more CPU cycles for
-compression than BSD-Compress, but this won't be a problem for links
-running at 100kbit/s or less.
+compression than BSD-Compress, but this shouldn't be a problem for
+links running at 100kbit/s or less.
 
-* There is now no code in this distribution which is covered by Brad
+* There is no code in this distribution which is covered by Brad
 Clements' restrictive copyright notice.  The STREAMS modules for SunOS
 and OSF/1 have been rewritten, based on the Solaris 2 modules, which
 were written from scratch without any Clements code.
@@ -100,6 +103,15 @@ those columns which would normally display bytes.
 became noip, +chap became require-chap, etc.  The old options are
 still accepted for compatibility but may be removed in future.
 
+* Pppd now has some options (such as the new `noauth' option) which
+can only be specified if it is being run by root, or in an
+"privileged" options file: /etc/ppp/options or an options file in the
+/etc/ppp/peers directory.  There is a new "call" option to read
+options from a file in /etc/ppp/peers, making it possible for non-root
+users to make unauthenticated connections, but only to certain trusted
+peers.  My intention is to make the `auth' option the default in a
+future release.
+
 * Several minor new features have been added to pppd, including the
 maxconnect and welcome options.  Pppd will now terminate the
 connection when there are no network control protocols running.  The
@@ -167,4 +179,4 @@ The primary site for releases of this software is:
        ftp://cs.anu.edu.au/pub/software/ppp/
 
 
-($Id: README,v 1.6 1996/07/03 06:47:29 paulus Exp $)
+($Id: README,v 1.7 1996/08/28 06:30:32 paulus Exp $)
index e2afc7a4617e65135cec2d4f25f8f52e26ec4236..ab6919c32919bac1b55ef142b99d9bd5f06d751e 100644 (file)
@@ -1,8 +1,8 @@
-
-This file (README.osf) contains instructions for installing ppp-2.2 on a
-DEC Alpha running OSF/1 version 2.0 or 3.0.  The original STREAMS
-module code is by (and copyrighted by) Brad Clements.  See the source 
-files and the general README file for full credits and copyright notices.
+This file (README.osf) contains instructions for installing ppp-2.3 on a
+Digital Alpha-based system running Digital UNIX (aka DEC OSF/1)
+version 2.0 through version 3.2F.  Digial UNIX version 3.2G and beyond
+are not supported by this package, since PPP is an integral component
+of those releases.
 
 If you would like to be on a mailing list concerning the ppp package,
 send mail to srt@cs.unt.edu and let me know.  This mailing list should
@@ -16,9 +16,7 @@ version 2.1.2 with a hardware serial port, then you probably used the
 You don't need this any more, and will have a more efficient connection
 if you get rid of this old work-around.
 
-Below are the steps for installing PPP on a Digital Equipment Corp.
-Alpha system running Digital UNIX (formerly known as DEC OSF/1.)
-
+Below are the steps for installing PPP on a DEC AXP system running OSF/1.
 You must do all of the following as "root".
 
 1.  Make the kernel sources, daemon, chat, and pppstat program by typing 
@@ -34,17 +32,19 @@ You must do all of the following as "root".
 2.  This step differs depending on whether you are running OSF/1 V3.0
     or later.
 
-    FOR DEC OSF/1 VERSIONS PRIOR TO V3.0:
+    FOR DEC OSF/1 V2.0 THROUGH V2.1:
 
     | Add the following lines to the file /sys/conf/files:
     |
-    |      streamsm/ppp_if.c                    optional ppp Notbinary
-    |      streamsm/ppp_async.c                 optional ppp Notbinary
-    |      streamsm/ppp_init.c                  optional ppp Notbinary
-    |      streamsm/vjcompress.c                optional ppp Notbinary
-    |      streamsm/bsd-comp.c                  optional ppp Notbinary
-    |      streamsm/ppp_comp.c                  optional ppp Notbinary
-    |
+    | streamsm/if_ppp.c                optional ppp Notbinary optimize -g3
+    | streamsm/ppp_comp.c      optional ppp Notbinary optimize -g3
+    | streamsm/ppp_init.c      optional ppp Notbinary optimize -g3
+    | streamsm/vjcompress.c    optional ppp Notbinary optimize -g3
+    | streamsm/bsd-comp.c      optional ppp Notbinary optimize -g3
+    | streamsm/deflate.c       optional ppp Notbinary optimize -g3
+    | streamsm/ppp.c           optional ppp Notbinary optimize -g3
+    | streamsm/ppp_ahdlc.c     optional ppp Notbinary optimize -g3
+    | streamsm/zlib.c          optional ppp Notbinary optimize -g3
     |
     | Edit the file /sys/streams/str_config.c --- at the end there will be a
     | comment to the effect of "add new configurations above this comment".
@@ -56,16 +56,25 @@ You must do all of the following as "root".
     |      retval = ppp_configure(SYSCONFIG_CONFIGURE,
     |                             &sb, sc_size, &sc, sc_size);
 
-    FOR DEC OSF/1 VERSIONS V3.0 AND LATER, INCLUDING DIGITAL UNIX:
+    FOR DEC OSF/1 V3.0 THROUGH Digital UNIX V3.2F:
 
     | Add the following lines to the file /sys/conf/files:
     |
-    |      streamsm/ppp_if.c          optional ppp if_dynamic ppp Notbinary
-    |      streamsm/ppp_async.c       optional ppp if_dynamic ppp Notbinary
-    |      streamsm/ppp_init.c        optional ppp if_dynamic ppp Notbinary
-    |      streamsm/vjcompress.c      optional ppp if_dynamic ppp Notbinary
-    |      streamsm/bsd-comp.c        optional ppp if_dynamic ppp Notbinary
-    |      streamsm/ppp_comp.c        optional ppp if_dynamic ppp Notbinary
+    | streamsm/if_ppp.c                optional ppp if_dynamic ppp Notbinary optimize -g3
+    | streamsm/ppp_comp.c      optional ppp if_dynamic ppp Notbinary optimize -g3
+    | streamsm/ppp_init.c      optional ppp if_dynamic ppp Notbinary optimize -g3
+    | streamsm/vjcompress.c    optional ppp if_dynamic ppp Notbinary optimize -g3
+    | streamsm/bsd-comp.c      optional ppp if_dynamic ppp Notbinary optimize -g3
+    | streamsm/deflate.c       optional ppp if_dynamic ppp Notbinary optimize -g3
+    | streamsm/ppp.c           optional ppp if_dynamic ppp Notbinary optimize -g3
+    | streamsm/ppp_ahdlc.c     optional ppp if_dynamic ppp Notbinary optimize -g3
+    | streamsm/zlib.c          optional ppp if_dynamic ppp Notbinary optimize -g3
+
+    FOR Digital UNIX V3.2G AND V4.0 AND BEYOND
+
+    This package does not support these versions of Digital UNIX.
+    PPP is an integral part of the OS.  Please see the Guide to
+    Network Administration for details on configuring PPP.
 
 4.  Find your system's configuration file.  This should be called
     /sys/conf/SYSNAME, where SYSNAME is replaced by the name of your
@@ -73,7 +82,7 @@ You must do all of the following as "root".
     /sys/conf/ZAPHOD.  I will refer to this file from now on as 
     /sys/conf/SYSNAME.
 
-5.  Add the following line among the other options in /sys/conf/SYSNAME:
+5.  Add the following line at the end of /sys/conf/SYSNAME:
 
        options         PPP
 
diff --git a/TODO b/TODO
index 14110dfe4f0895ffeb8074288bb057e014242fd1..1b3f793cde1fd1221871238ffb8d1c51ebf14ca0 100644 (file)
--- a/TODO
+++ b/TODO
@@ -1,7 +1,5 @@
 * Things to do *
 
-1. Support dial-on-demand in PPP
+1. Implement link quality monitoring
 
-2. Implement link quality monitoring
-
-3. Implement other network control protocols
+2. Implement other network control protocols
index d4f6fe84f94c826eeb61d90b17d5fe8c8e619da7..d5678c55b01aa6cd431e1b0f69ac57fd1a989da4 100644 (file)
--- a/ppp.texi
+++ b/ppp.texi
@@ -44,19 +44,13 @@ The Point-to-Point Protocol (PPP) is the protocol of choice for
 establishing network links over serial lines.  This package (ppp-2.x)
 provides an implementation of PPP which supports the Internet Protocols
 (TCP/IP, UDP/IP, etc.) and which runs on a range of Unix workstations.
-The protocols in the PPP family are produced by the Point-to-Point
-Working Group of the Internet Engineering Task Force, and are specified
-in RFC (Request for Comments) documents, available by anonymous FTP from
-several sites.
 
-A typical use of PPP is to provide a network connection, via a pair of
-modems and a telephone connection, from one system to a second system
-which has a permanent link to the Internet.  When this network
-connection is established, the first system is then also connected to
-the Internet.  It can establish connections with any other Internet
-host.  Users can then use a wide range of network-based applications on
-the first system, such as telnet, ftp, rlogin, email, WWW browsers, sup,
-or X clients and servers.
+A typical use of PPP is to provide a network connection, via a modem,
+between a workstation and an Internet Service Provider (ISP).  When this
+connection is established, the workstation is connected to the internet,
+and applications running on the workstation can then make connections to
+other hosts anywhere on the internet.  This package can be used at
+either or both ends of such a link.
 
 Features of PPP include:
 @itemize @bullet
@@ -201,7 +195,12 @@ example, when a modem loses carrier and hangs up.
 
 @end enumerate
 
-PPP is defined in several RFC (Request For Comments) documents, in
+The protocols in the PPP family are produced by the Point-to-Point
+Working Group of the Internet Engineering Task Force, and are specified
+in RFC (Request for Comments) documents, available by anonymous FTP from
+several sites.
+
+PPP is defined in several RFCs, in
 particular RFCs 1661, 1662, and 1334.  IPCP is defined in RFC 1332.
 Other RFCs describe the control protocols for other network protocols
 (e.g., DECnet, OSI, Appletalk).  RFCs are available by anonymous FTP
@@ -365,9 +364,9 @@ system-dependent.  In addition, you will require super-user privileges
 
 Some systems provide a ``modload'' facility, which allows you to load
 new code into a running kernel without relinking the kernel or
-rebooting.  Under Solaris 2, SunOS 4.x, Linux, AIX 4.1, OSF/1 and
-NextStep, this is the recommended (or only) way to install the kernel
-portion of the ppp-2.x package.
+rebooting.  Under Solaris 2, SunOS 4.x, Linux, OSF/1 and NextStep, this
+is the recommended (or only) way to install the kernel portion of the
+ppp-2.x package.
 
 Under the remaining supported operating systems (NetBSD, FreeBSD,
 Ultrix), it is necessary to go through the process of creating a new