What to do when ppp hangs at startup time.

svn path=/head/; revision=3418

FAQ/network.sgml

@@ -1,4 +1,4 @@
-<!-- $Id: network.sgml,v 1.13 1998-08-18 23:26:50 dwhite Exp $ -->
+<!-- $Id: network.sgml,v 1.14 1998-08-26 09:52:11 brian Exp $ -->
 <!-- The FreeBSD Documentation Project -->
 
   <sect>
@@ -170,6 +170,25 @@
       <url url="http://www.freebsd.org/~brian" name="latest version">.
       It will build on FreeBSD version 2.1.5 and higher.
 
+      <sect2>
+        <heading>Ppp just hangs when I run it</heading>
+
+        <p>This is usually because your hostname won't resolve.  The best
+        way to fix this is to make sure that <tt>/etc/hosts</tt> is
+        consoluted by your resolver first by editing <tt>/etc/host.conf</tt>
+        and putting the <tt>hosts</tt> line first.  Then, simply put an
+        entry in <tt>/etc/hosts</tt> for your local machine.  If you have
+        no local network, change your <tt>localhost</tt> line:
+
+        <verb>
+127.0.0.1	foo.bar.com foo localhost
+        </verb>
+
+        Otherwise, simply add another entry for your host.  Consult the
+        relevant man pages for more details.
+        <p>You should be able to successfully <tt>ping -c1 `hostname`</tt>
+        when you're done.
+
       <sect2>
         <heading>Ppp won't dial in -auto mode</heading>