Fixed uninitialized 'pw' variable in HAS_SHADOW logic in session.c due
[ppp.git] / NeXT / INSTALL
index db657cb2c7aba79fa5d6712ae2d8c591ae042d7e..bd00b615e77bb916f81177269049f783ac72b519 100644 (file)
@@ -1,14 +1,29 @@
-Installation Instructions
-=========================
+               PPP-2.3 for systems running NeXTSTEP
+                ====================================
+
+
+Authoritative information can be found at:
+
+  WWW site:     http://www.peak.org/next/ppp/
+  WWW mirror:   http://www.thoughtport.com:8080/PPP/
+
+  FTP site:     ftp://next-ftp.peak.org/pub/next/apps/internet/ppp/dev
+  FTP Mirror:   ftp://ftp.NMR.EMBL-Heidelberg.DE/pub/next/ppp/
+
+If you have questions or problems, please visit the WWW site
+for FAQ and mailing list information.
+
+NEW: If you want to submit a bug report, please
+     use the bug submission form on the WWW site.
+
+If you use this software and are pleased with its performance, you are
+encouraged to make a donation to support continued development.  50%
+of all donations go to charity.  For more information, please see:
+  http://www.thoughtport.com:8080/cgi-bin/PPP/donation
 
-Files, information, and an FAQ are available from:
-  http://www.thoughtport.com:8080/PPP/ 
-Full source and an MAB installer package are available.  If you don't
-currently have access to a WWW viewer, you may get the files from
-ftp.thoughtport.com (199.171.224.105) in the directory /pub/next/ppp/.
 
-If you have questions or problems, please mail
-nextppp@listproc.thoughtport.com _before_ you go to usenet.
+NeXT Specific Installation Instructions
+=======================================
 
 The procedure for an initial installation and for an upgrade are very
 similar. However, if this is the first time you are installing PPP,
@@ -18,32 +33,29 @@ They will be described later in this document.
 Making the source files
 =========================
 
-To install on a NeXT:
+To install on a computer running NeXTSTEP:
 
  1) Read this file completely through before you start.
 
  2) If you are on an HP-PA system, read the file
     ./NeXT/hppa/README.hppa and install the serial
     driver patch.  Successfull installation of this
-    patch will require a reboot of your machine.
+    patch will require a reboot of your machine.  HPPA
+    is no longer supported.
 
  3) If you have previously installed a SLIP package, comment out
     the slip configuration code in /etc/rc.local and reboot your
     machine.  SLIP and PPP _should_ interoperate but for initial
     testing it is best to remove SLIP.
 
- 4) If you plan in using tcpdump to monitor packets, you must
-    enable the Berkley Packet Filter code.  Edit ./NeXT/Makefile
-    and make sure the '-DNBPFILTER' option is defined in DFLAGS.
-    WARNING: If you choose to use BPF, you must make sure that you
-    compile _AND LOAD_ the bpf_reloc LKS _BEFORE_ you load the
-    ppp_reloc LKS.  See the ./NeXT/bpf directory for more information.
-
-    If you don't want to compile in this code, please make sure that
-    '-DBPFILTER' is _not_ defined in the ./NeXT/Makefile DFLAGS.
-
-    Also, make sure you read the installation file in ./NeXT/bpf.  You
-    will need to create a few special device files in /dev/.
+ 4) If you are using Intel OS version 3.3, you _must_ get the latest
+    NeXT serial drivers from NeXTAnswers.  You need both the serial
+    and ttyport drivers (version 3.33 or later).  Install these
+    according to the directions.  PPP-2.3 is optimized to work with 
+    the NeXT drivers.   It will work with the Mux driver (especially
+    beneficial for OS versions prior to 3.3), but that driver has been
+    known to cause panics with PPP.  If you use OS 4.x you can use the
+    drivers that came with the system.
 
  5) Type ./configure in the top level PPP directory.  This will set
     up some necessary links.
@@ -59,26 +71,30 @@ To install on a NeXT:
     pppd/pathnames.h. I recommend keeping it set to /etc/ppp. 
     If you don't specifically like that directory, you may
     also change the Makefile directory and put a link in /etc/ppp
-    that points to the proper place.
+    that points to the proper place. 
 
     You will also want to set the -arch flags to the appropriate
-    architectures. 
+    architectures.  Leaving it blank will default to your current
+    architecture. 
 
-
- 8) Do a:
+ 9) Do a:
       make 
 
9) If you are satisfied with the results, then as root, type:
10) If you are satisfied with the results, then as root, type:
       make install
 
 
 If you are performing an upgrade, you are done after successfully
 making and installing the latest release.  All you need to do is to
 reboot your machine so that the new loadable kernel server (LKS) is
-loaded. Make sure you remember to edit /etc/rc.local and add the code
-to load the bpf_reloc LKS (if you enabled BPF support).  You should be
-able to start the upgraded PPP just like normal.  If this doesn't
-work, see the "Troubleshooting" section later on.
+loaded.  You should be able to start the upgraded PPP just like
+normal.  If this doesn't work, see the "Troubleshooting" section later
+on.
+
+Also, you might want to compare the ip-up and ip-down scripts in 
+the ./NeXT/Examples directory with those you have installed in
+/etc/ppp/ip-up and /etc/ppp/ip-down.  Most things included in the
+examples should be in any installation.
 
 
 Extra Steps for Initial Configuration 
@@ -106,20 +122,8 @@ done once.  These steps do not need to be re-performed for an upgrade.
    separators ;) somewhere near the end of the file /etc/rc.local:
  
 ======================================================================
-#
-# Load the Berkley Packet Filter LKS
-# This must be done before PPP.  Comment this out
-# if you disabled BPF. If you use BPF, you _must_ 
-# load it before the PPP LKS.  If you chaged pathnames
-# in the Makefile, make sure the appropriate paths are
-# used below.
-#
-if [ -f /usr/local/bpf/reloc/bpf_reloc ]; then
-       /usr/etc/kl_util -a /usr/local/bpf/reloc/bpf_reloc
-fi
-
 # 
-# Load the selected version of the PPP-2.2 loadable
+# Load the selected version of the PPP-2.3 loadable
 # kernel server (LKS).
 #     
 if [ -f /usr/local/ppp/reloc/ppp_reloc ]; then
@@ -128,11 +132,10 @@ if [ -f /usr/local/ppp/reloc/ppp_reloc ]; then
 fi
 ======================================================================
 
-  This code will now be executed next time you reboot your
-  machine.  You can verify that this was executed by checking
-  the output of /usr/adm/messages upon a successful reboot.  There
-  should be a section of output that says the PPP-2.2 LKS was 
-  successfully loaded.
+  This code will now be executed next time you reboot your machine.
+  You can verify that this was executed by checking the output of
+  /usr/adm/messages upon a successful reboot.  There should be a
+  section of output that says the PPP-2.3 LKS was successfully loaded.
 
 
 2) The default Makefile paths place PPP files  in a directory called
@@ -154,12 +157,10 @@ fi
    ln -s /usr/local/ppp/bin/* /usr/local/bin
    ln -s /usr/local/ppp/man/man8/* /usr/local/man/man8
 
-   Some or all of the 'mkdir' commands may fail if the directories
-   already exists.  This is OK.  Futher, to get the man program to
-   understand that you have added some pages to the /usr/local/man 
-   directory, you need to make sure that the environment variable
-   MANPATH includes the /usr/local/man entry.  In my .cshrc file
-   I have an entry that looks like:
+   To get the man program to understand that you have added some pages
+   to the /usr/local/man directory, you need to make sure that the
+   environment variable MANPATH includes the /usr/local/man entry.  In
+   my .cshrc file (in my home directory) I have an entry that looks like:
       setenv MANPATH "/usr/local/man:/usr/man:.:.."
    See 'man man' for more information.
 
@@ -168,7 +169,6 @@ fi
    to you from the command line.  However, before you can immediately
    see them, you may need to log out and log back in.
  
-
 3) Once you start trying to make PPP connections, it is important
    to have access to the logging information that PPP generates. This
    will allow you to follow the progress of PPP and will aid in
@@ -187,11 +187,11 @@ fi
    Now, as root, use vi or your favorite editor to edit the file
    /etc/syslog.conf.  You need to add the line:
 
-       local2.debug            /usr/adm/ppp2.2.log
+       local2.debug            /usr/adm/pppd.log
 
    It is _imperative_ that you place a <tab> character
    between the level "local2.debug" and the file name
-   "/usr/adm/ppp2.2.log.  Do _not_ use spaces. If your
+   "/usr/adm/pppd.log.  Do _not_ use spaces. If your
    editor converts tab characters to spaces, you need to
    use a different editor.  Also beware of cutting and pasting
    between buffers.  Sometimes a tab will be converted to spaces
@@ -199,7 +199,7 @@ fi
    my /etc/syslog.conf:
 
 ======================================================================
-local2.debug                                   /usr/adm/ppp2.2.log
+local2.debug                                   /usr/adm/pppd.log
 *.err;kern.debug;auth.notice                   /dev/console
 kern.debug;daemon,auth.notice;*.err;mail.crit  /usr/adm/messages
 mark.debug,daemon.info                         /usr/adm/messages
@@ -217,94 +217,30 @@ mail.info                                 /usr/spool/mqueue/syslog
    This step is necessary because if syslog does not see the file, it
    will not create it.  So, removing the file is a handy way to turn
    off the logging.  To create an empty logging file, as root execute:
-        touch /usr/adm/ppp2.2.log
+        touch /usr/adm/pppd.log
 
    Upon a successful reboot, logging will be enabled for pppd
    (remember to specify the 'debug' option to pppd to get reasonable 
    information sent to the logging file).
 
 
-4) If you have a standalone machine, it is necessary for you to make
-   sure your system is configured to correctly support a network.  The
-   following steps will help in correctly configuring your machine.
-   Please note, if you do not have a standalone machine (i.e. you are
-   on a local network), you need to speak with your system
-   administrator to determine the proper configuration for your
-   machine.  The following only applies to standalone machines.
-
-   It is suggested that you reboot your machine _before_ you start 
-   these procedures.  This is to verify that you successfully
-   completed the previous steps and that your machine does indeed
-   reboot.  If it doesn't, you should replace /etc/rc.local with the
-   backup copy and reboot.  Then, determine why your modifications
-   failed.  After successfully rebooting, you are ready to move on to 
-   these steps.
-
-   As root, make a backup copy of /etc/iftab.  You might name it
-   /etc/iftab.prePPP.  Then, modify this file by adding the line:
-  
-    lo0     inet    127.0.0.1 netmask 0xff000000 -trailers up
-
-   right before the -1- entry that already exists in the file.  The
-   finished file should look similar to (minus the ---- separators):
-   ----------------------------------------------------------------------
-
-   lo0     inet    127.0.0.1 netmask 0xff000000 -trailers up
-   -1-    inet    -HOSTCONFIG-
-   *      inet    -AUTOMATIC- netmask -AUTOMATIC- -trailers up
-
-   ----------------------------------------------------------------------
-   Please note that the file  probably has a bunch of comments
-   at the top (lines that start with #).   I left those out in the
-   example above so I could save space.  They of course, can remain
-   in your copy.
-  
-   As root, make a backup copy of /etc/hostconfig.  You might
-   name it /etc/hostconfig.prePPP.  If, after the following steps, you
-   run into problems booting your machine, you may replace
-   /etc/hostconfig with the backup and you should be able to
-   successfully reboot.
-
-   Start up the HostManager.app (under /NextAdmin).  After
-   successfully entering the root password, you should get the
-   HostManager Menu.  Select the "Local..." menu option to get the
-   main window.  Modify it as follows: 
-
-          For "NetInfo Binding", select "use local domain only"
-           and make sure the box for "Readable only by local net" 
-           is checked.
-
-           For "Hostname", fill in your host name as appropriate.  Do
-           _not_ add the domain name.  For example, use "sidney"
-           rather than "sidney.cps.msu.edu". 
-
-           For "NIS Domain Name", select "None"
-
-           For "Internet Address", use the provided IP address
-           (probably 127.0.0.1) unless your system administrator has
-           assigned you your own unique IP address.  In this case,
-           reverify that you are a standalone machine.
-
-           For "Broadcast Address", select "Default"
-       
-          For "Time Standard", select "Ignore Network Time"
-
-           For "Netmask", select "Default"
-
-           For "Router", select "None"
+4) You should copy a few files to a new directory.  Part of the
+   installation process creates a new directory (or link)
+   called /etc/ppp/. Further, it creates an empty file called
+   /etc/ppp/options. An empty options file is the bare minimum of what
+   is necessary. However, the directory ./NeXT/Examples contains
+   several files that are useful in almost any setup.  It is
+   recommended that you perform the following steps to place better
+   files in the directory /etc/ppp.  As user root, perform the
+   following commands.  It assumes you are in the PPP distribution
+   directory:
 
-  When this is complete, click the "Set" button.   You will then have
-  the option to reboot or to skip the reboot.  Choose the appropriate 
-  action.  It is suggested that you reboot immediately and verify that
-  your system does indeed reboot (and behave as normal).  If it
-  doesn't, replace /etc/hostconfig with the backup copy and then
-  reboot.  Once you are back up, determine the problem with your
-  configuration. 
-
-  Please note that this description is generic and will work in most
-  cases.  There are lots of variations that people can and will need 
-  to make. Your network administrator will be able to provide you with
-  the correct details for your particular site.
+     cp NeXT/Examples/options.example /etc/ppp/options
+     cp NeXT/Examples/ip-up.example /etc/ppp/ip-up
+     cp NeXT/Examples/ip-down.example /etc/ppp/ip-down
+     /usr/etc/chown root.wheel /etc/ppp/options /etc/ppp/ip-up /etc/ppp/ip-down
+     chmod 644 /etc/ppp/options
+     chmod  511 /etc/ppp/ip-up /etc/ppp/ip-down
 
 
 Congratulations!  You have successfully installed PPP and are now
@@ -319,7 +255,11 @@ One of the most notoriously difficult portions of getting PPP links up
 and running involves writing the script that automatically dials your
 modem, connects to the peer, and starts the remote ppp process.  Once
 you are connected to the peer, each PPP process will start
-communications and things become much easier.
+communications and things become much easier.  Several frontends are
+available that help ease this problem.  See:
+  http://www.peak.org/next/ppp/NeXT_PPP_Frontends.html
+for more information on those.  If you want or need to go the
+scripting route, then please read on.
 
 Before you dive into script writing, there is a simpler solution that
 will allow you to test the ppp portion.  Once this works, getting the
@@ -338,13 +278,10 @@ perform.  Once you _know_ ppp works, you can spend time on the dial
 scripts.
 
 Please note, you _must_ exit from your communications program before
-you start your local pppd.  For example if you are in kermit and you
-start the peer pppd process by hand, you must completely exit kermit
-before you start pppd.  If you don't, the connection will not form.
-Further, if you find that when you exit, your modem immediately hangs
-up, you need to instruct the modem to ignore DTR.  There is an AT
-command that will do this (AT&D on Supra), but you will need to check
-your modem manual to determine the correct command.
+you start your local pppd.  If you find that when you exit, your modem
+immediately hangs up, you need to instruct the modem to ignore DTR.
+There is an AT command that will do this (AT&D on Supra), but you will
+need to check your modem manual to determine the correct command.
 
 If you are planning on using kermit, Stephane I. Matis
 <petergun@vectrex.login.qc.ca>, has supplied this excellent definition
@@ -357,11 +294,12 @@ define pppd -
         !pppd < \v(line) > \v(line) defaultroute
 ----------------------------------------------------------------------
 
-To use this, add the above to your ~/.kermrc file (minus the '---...---'
-separators).  Then start kermit.  After you have started the remote PPP
-server by hand, return back to your local kermit prompt and execute
-the command 'do pppd'.  In this particular circumstance, you will not
-need to exit from kermit.
+To use this, add the above to your ~/.kermrc file (minus the
+'---...---' separators).  Then start kermit.  After you have started
+the remote PPP server by hand and you see garbage being printed on the
+screen, return back to your local kermit prompt and execute the
+command 'do pppd'.  In this particular circumstance, you will not need
+to exit completely from kermit.
 
 Before you start initial testing, you may want to read the pppd man
 page.  This will allow you to familiarize yourself with the some of
@@ -380,7 +318,7 @@ There are several ways to determine if the link has actaully been
 established.  I will go through some of them.
 
 1) You may look at the pppd log file (typically
-   /usr/adm/ppp2.2.log).  If you see lines that look similar to:
+   /usr/adm/pppd.log).  If you see lines that look similar to:
 
     Jan 11 23:13:38 sidney2b pppd[2141]: local  IP address 35.9.12.55
     Jan 11 23:13:38 sidney2b pppd[2141]: remote IP address 35.9.10.13
@@ -404,15 +342,16 @@ established.  I will go through some of them.
    is an example of what you might see:
 
        Routing tables
-       Destination      Gateway            Flags     Refs     Use  Interface
-       127.0.0.1        127.0.0.1          UH          2      558  lo0
-       35.9.10.14       35.9.12.104        UH          0        0  ppp0
-       default          35.9.10.14         UG          2       25  ppp0
-       192.42.172       192.42.172.1       U           6     1939  en0
+        Destination      Gateway            Flags     Refs     Use  Interface
+        35.9.10.32       35.9.15.107        UH          0        0  ppp0
+        127.0.0.1        127.0.0.1          UH         12     2636  lo0
+        35.9.15.107      127.0.0.1          UH          0        0  lo0
+        default          35.9.10.32         UG          2        6  ppp0
+        192.42.172       192.42.172.1       U          15     8872  en0
 
 
-  In the above case, the peer is 35.9.10.14 and my local machine has
-  been assigned 35.9.12.104.  All foreign traffic goes through the
+  In the above case, the peer is 35.9.10.32 and my local machine has
+  been assigned 35.9.15.107.  All foreign traffic goes through the
   default route to the peer.
 
   If you don't have an ethernet card installed on your system, you
@@ -433,7 +372,11 @@ PPP will negotiate the address with the peer.  This is the preferred
 mechanism of operation.  Probably the only time you should specify an
 IP address as an argument to pppd is if you are assigned your own IP
 address by your system administrator.  Otherwise, sit back and let PPP
-do the work for you.
+do the work for you.  If you are assigned an address by your PPP
+provider, that address does _NOT_ go in the hostconfig.app or netinfo.
+Instead, you provide that IP address as a command line option to pppd
+when you start it up.  See the pppd man page for details on specifying
+a fixed IP address.
 
 
 A Typical PPP Session
@@ -446,7 +389,8 @@ the scripts icon.  This will start the chat process that will dial the
 modem and log into the remote system.  It will then turn control over
 to pppd.  If your script is successful (as described in the
 "Determining if the link is actually up" section), you will be all
-set.  All your apps, OmniWeb, FTP, telnet, etc should work.
+set.  All your apps, OmniWeb, FTP, telnet, etc should work.  Please
+note that pppd itself will not appear to do anything but sit there.
 
 Once you are through using the connection, you can close down the PPP
 link by executing the ppp down script.  Again, this can be done by
@@ -456,10 +400,11 @@ point, ppp will terminate the phone connection and pppd will die off.
 
 You may start and kill the ppp session as many times as you like while
 you are logged on.  However, if you do not kill the PPP session, it
-will not die once you log out.  Thus your telephone will remain off
-the hook and your computer will remain connected to the net until you
-log back in and shut down the connection.  Turning off the computer
-will obviously close the connection.
+will not die once you log out (unless you use the idle timer option to
+pppd).  Thus your telephone will remain off the hook and your computer
+will remain connected to the net until you log back in and shut down
+the connection.  Turning off the computer will obviously close the
+connection.
 
 
 Name Resolution
@@ -480,9 +425,8 @@ the command line).
 
 The second thing is a list of name servers.  These should be local to
 your ppp provider.  Your network administrator will be able to provide
-you with the appropriate addresses. There are default name servers to
-use in case the local provider is not responding.  An example file
-might look like:
+you with the appropriate addresses and you should use those, not the
+ones listed below.  An example file might look like:
 
 ----------------------------------------------------------------------
 domain cps.msu.edu
@@ -499,12 +443,6 @@ nameserver 35.8.2.41
 nameserver 35.8.2.41
 nameserver 128.247.160.56
 
-#
-# Other servers -- hopefully something will work if needed
-#shadooby.cc.umich.edu
-nameserver 35.1.1.91
-#ns.nasa.gov
-nameserver 128.102.16.10
 ----------------------------------------------------------------------
 
 You will need to reboot your computer for the new nameservers to take
@@ -561,136 +499,36 @@ place it in the /etc/ppp/options file).
 Troubleshooting
 ===============
 
-The NeXT port of ppp-2.2 is stable. However, the PD ppp-2.2 is
-considered to be in alpha release.  If you have problem, please mail
-me <perkins@cps.msu.edu> before you go to usenet.  I'm especially
-interested in hearing your suggestions and comments about the package
-and related documentation.
-
-Any time that you have a bug report to send, please include your
+Any time that you have a bug report, please use the included
+MailBug.app (in the NeXT directory) to submit an electronic report.
+If you don't have email capability, please see the WWW site and use
+the bug report form found there.  Please remember to include your 
 hardware type and the LKS version number in all reports.  This number
 may be found in the file /usr/adm/messages (once the LKS has been
 installed). Also, for most questions, it is best to append a copy of
-the /usr/adm/ppp2.2.log file.
-
-There are some common problems that people have.  I have listed them
-here:
-======================================================================
-1) pppd bombs out with an error similar to:
- Jan 26 14:46:25 localhost pppd[256]: Connected...
- Jan 26 14:46:26 localhost pppd[256]: ioctl(PPPIOCGUNIT): Inappropriate ioctl for device
- Jan 26 14:46:26 localhost pppd[256]: Exit.
-
-This is typically the result of using the wrong LKS with pppd.  Some
-versions of PPP installed the LKS (ppp_reloc) in
-/usr/lib/kern_loader/ppp and some in /usr/local/ppp/reloc.  The second
-is going to be the standard place for installation from now on.  Make
-sure that your /etc/rc.local is loading the correct version of the LKS
-and make sure you are really calling the correct pppd for use with the
-LKS that you loaded.
-
-======================================================================
-
-2) PPP works fine, but when the link is up, netinfo sleeps when you
-   try to print or send mail.
-
-You'll see this problem if you don't have a route from your "hostname"
-to localhost.  In essence, your host doesn't know how to "get back to
-itself".  My guess is that you didn't follow the installation
-instructions and you chose an IP address different than 127.0.0.1.
-There is a fix! ;) Do this in your rc.local:
-
-route add your_host_name localhost 0
-
-(with the appropriate substitution of your_host_name) Without it,
-netinfo will sleep when trying to connect to the local domain.  You
-will need to reboot or perform this command manually (as root) for it
-to take affect.
-
-Many thanks to:
-  Scott Bender 
-  Pete French
-  Terence Parr   
-for help on this one.
-
-======================================================================
-
-3) People who are trying to set up a NeXT as a PPP server that
-   they dial into often complain that they can make a connection, but
-   the remote machine can only ping the server.  No other packets
-   work.
+the /usr/adm/pppd.log file.
 
-Check out the 'proxyarp' option to pppd.  Servers (connected to their
-LAN) must proxyarp for the remote address (i.e. the address of the
-machine dialing in).  Further, read the file ./NeXT/README.NeXT (not
-this file) for more information on proxyarp.
-
-======================================================================
-
-4) Your pppd/chat dials the modem but you cannot get a negotiation
-   to start.  The /usr/adm/ppp2.2.log file shows something similar
-   to:
-
-  Mar 13 12:02:41 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
-  Mar 13 12:02:44 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
-  Mar 13 12:02:47 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
-  Mar 13 12:02:51 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
-  Mar 13 12:02:54 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
-  Mar 13 12:02:57 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
-  Mar 13 12:03:00 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
-  Mar 13 12:03:03 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
-  Mar 13 12:03:06 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
-  Mar 13 12:03:09 crystal pppd[243]: sent [LCP ConfReq id=0x1 <pcomp> <accomp>]
-  Mar 13 12:03:12 crystal pppd[243]: LCP: timeout sending Config-Requests
-  Mar 13 12:03:12 crystal pppd[243]: Connection terminated.
-  Mar 13 12:03:12 crystal pppd[243]: Serial link is not 8-bit clean:
-  Mar 13 12:03:12 crystal pppd[243]: All received characters had bit 7 set to 0
-
-This is a common problem.  It is typically the result of a failure to
-properly start the remote PPP process.  Make sure you add the '-v'
-option to chat (in your dial script) and then check the output of
-/usr/adm/ppp2.2.log to see why chat failed to start the remote PPP
-process.
-
-======================================================================
-
-5) Your LCP sessions get into an infinite loop while trying to
-   negotiate the magic numer.  Alternately, every LCP echo you send
-   is accompanied with a message saying that "our own echo reply was
-   received".  I'm not sure why some systems have this trouble, but
-   the solution is to turn off magic number negotiation at your end. 
-   Add the '-mn' flag to pppd.
-
-======================================================================
-
-6) NXHosting applications over PPP fails.  I don't know why this 
-   happens.  Rest assured, that I and others do have it working.
-   The most obvious things to check are that you have your system set
-   up as a public window server.  Also, make sure that you reset the
-   nmserver in /etc/ppp/ip-up (see the example ip-up file).  If it
-   still doesn't work, you might want to add your peer to your
-   /etc/hosts.equiv file.  I don't know if that has anything to do
-   with it or not, but I don't know why some people can't NXHost
-   and others can.
+If you do have troubles, please see the FAQ on:
+  http://www.peak.org/next/ppp/
 
 
 Updates
 =======
 
-You may also want to join the mailing list for PPP.  This will keep
+You may want to join the mailing list for PPP.  This will keep
 you informed of new releases and will provide an arena for discussing
 problems with the NeXT specific PPP port.  To add yourself to the list
 (or for any other administrative requests), send an email message to:
-       listproc@listproc.thoughtport.com
+       majordomo@peak.org
 with no subject and message body consisting of:
-       subscribe nextppp Stephen J. Perkins
+       subscribe nextppp 
 (please use your own name ;). To send mail to all the participants on
 the list, address your messages to:
-       nextppp@listproc.thoughtport.com
+       nextppp@peak.org
 
 If you want announcements only, there is a second "announcements only"
 list.  To subscribe to this, you may use the alternate body:
-       subscribe nextppp-announce Stephen J. Perkins
+       subscribe nextppp-announce 
 You don't need to subscribe to both.  All announcements are forwarded
 to the regular list.
 
@@ -702,17 +540,15 @@ note that the pppd file is installed suid root.  This is a potential
 security hazard.
 
 
-
 Noted bugs
 ==========
 
 There have been various problems reported when trying to install LKSs
 the way NeXT intended (i.e. placing them in /usr/lib/kern_loader/* and
-modifying /etc/kern_loader.conf). The main problem seems to be that
-after modifying /etc/iftab, /etc/rc.net (on NSFIP) will not correctly
-configure the interfaces.  This means that booting under NSFIP will
-hang. So, for the time, it is suggested that you install the package
-manually and load the LKS in /etc/rc.local.
+modifying /etc/kern_loader.conf). The main problem is that if users
+have a bad copy of the LKS, the system will panic and will be unable
+to boot. So, for the time, it is suggested that you install the package
+manually and load the LKS in /etc/rc.local as directed above.
 
 
 Modem Configuration
@@ -728,3 +564,19 @@ dropped, the modem will disconnect.  On my modem the command is
 dialins, you must read your modem manual to determine the correct
 setting.
 
+
+Obtaining the Software by Electronic Mail
+-----------------------------------------
+
+Do not send me requests for the software; they will be ignored
+(without response).  If you cannot use FTP at all, there is a service
+called "ftpmail" available from decwrl.dec.com: you can send e-mail to
+this machine and it will use FTP to retrieve files for you and send
+you the files back again via e-mail.  To find out more about the
+ftpmail service, send a message to "ftpmail@decwrl.dec.com" whose body
+consists of the single line "help".
+
+
+Thanks
+
+Stephen J. Perkins