Skip site navigation (1)Skip section navigation (2)
Date:      17 Aug 2002 16:41:12 +0000
From:      Josh Paetzel <friar_josh@webwarrior.net>
To:        freebsd-doc@freebsd.org
Cc:        freebsd-doc@freebsd.org, ripper@eskimo.com
Subject:   Re: docs/40841 Wrong info in ppp-primer
Message-ID:  <1029602481.530.32.camel@markx.vladsempire.net>
In-Reply-To: <1029598994.530.26.camel@markx.vladsempire.net>
References:  <1029598994.530.26.camel@markx.vladsempire.net>

next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, 2002-08-17 at 15:42, Josh Paetzel wrote:
> I took a look at this pr, Ths conclusions are correct, you cannot use
> 127.0.0.0/8 in your ppp.conf file.  Unfortunately  the submitted fix
> isn't a patch, and it isn't comprehensive enough.  I'm currently
> reworking the page in question and will have a patch tonight.
> 
> Josh

The attached diff is an emergency patch so to speak of that fixes info
in the ppp section of the handbook that will cause ppp not to work for
anyone that follows it.  

There's a lot of work to do on this section to get it more in sync with
the default ppp.conf files and man pages and so forth.  I'll get with
the author/maintainer of this chunk of docs and see where we can go from
there.

This file is also available for viewing at
http://www.webwarrior.net/x340.diff

--- x340.html.old       Sat Aug 17 15:28:20 2002
+++ x340.html   Sat Aug 17 16:23:42 2002
@@ -90,10 +90,9 @@
         <p>The '<tt class="FILENAME">/etc/ppp/ppp.conf</tt>' file
         contains the information and settings required to set up a
         dial-out PPP connection. More than one configuration may be
-        contained in this file. The FreeBSD handbook (XXX URL? XXX)
-        describes the contents and syntax of this file in
-        detail.</p>
-
+        contained in this file. The FreeBSD <a href=
+        "./doc/en_US.ISO8859-1/books/handbook/index.html">Handbook</a>
+       describes the contents and syntax of this file in detail.
         <p>This section will describe only the minimal
         configuration to get a dial-out connection working.</p>

@@ -164,8 +163,7 @@
       set timeout 300
       set openmode active
       accept chap
-      set ifaddr 127.1.1.1/0 127.2.2.2/0 255.255.255.0
-      add 0 0 127.2.2.2
+      set ifaddr  10.0.0.1/0 10.0.0.2/0 255.255.255.0 0.0.0.0
     ################################################################
     # End of /etc/ppp/ppp.conf
 </pre>
@@ -616,7 +614,7 @@
           <div class="INFORMALEXAMPLE">
             <a name="AEN506"></a>
 <pre class="SCREEN">
-    set ifaddr 127.1.1.1/0 127.2.2.2/0 255.255.255.0
+    set ifaddr 10.0.0.1/0 10.0.0.2/0 255.255.255.0 0.0.0.0
 </pre>
           </div>
           <br>
@@ -624,9 +622,9 @@

           <p>This command sets up a pair of "fake" IP addresses for
           the local and remote sides of the PPP link. It instructs
-          the PPP program to create an IP address of 127.1.1.1 for
+          the PPP program to request an IP address of 10.0.0.1 for
           the local side of the '<span class="emphasis"><i class=
-          "EMPHASIS">tun0</i></span>' (tunnel) device and 127.2.2.2
+          "EMPHASIS">tun0</i></span>' (tunnel) device and 10.0.0.2
           for the remote side. Appending '<tt class=
           "FILENAME">/0</tt>' to each address tells the PPP program
           that zero of the bits that make up these addresses are
@@ -634,7 +632,13 @@
           between the local and remote systems when the link is
           established. The 255.255.255.0 string tells the PPP
           program what Subnet mask to apply to these
-          pseudo-interfaces.</p>
+          pseudo-interfaces. The 0.0.0.0 tells ppp to accept whatever
+         ip the isp hands out.  A word of warning concering this
+          setting.  The only way you can screw it up is to use this
+          configuration on a natd box where the internal ips are
+         10.0.0.0/8.  If that's the case, use something else here,
+         10.1.1.1 works nicely. :) The ppp man page has extensive and
+         comprhensive on what these numbers are actually doing. </p>

           <p>Remember, we have assumed that your ISP provides the
           IP addresses for both ends of the link! If your ISP
@@ -642,13 +646,13 @@
           your side when configuring your system, enter that IP
           address here <span class="emphasis"><i class=
           "EMPHASIS">instead</i></span> of <span class=
-          "emphasis"><i class="EMPHASIS">127.1.1.1</i></span>.</p>
+          "emphasis"><i class="EMPHASIS">10.0.0.1</i></span>.</p>

           <p>Conversely, if your ISP gave you a specific IP address
           that he uses on his end you should enter that IP address
           here <span class="emphasis"><i class=
           "EMPHASIS">instead</i></span> of <span class=
-          "emphasis"><i class="EMPHASIS">127.2.2.2</i></span>.</p>
+          "emphasis"><i class="EMPHASIS">10.0.0.2</i></span>.</p>

           <p>In both cases, it is probably a good idea to leave the
           '<tt class="FILENAME">/0</tt>' on the end of each
@@ -656,53 +660,6 @@
           change the address(es) of the link if it <span class=
           "emphasis"><i class="EMPHASIS">has</i></span> to.</p>
-          <div class="INFORMALEXAMPLE">
-            <a name="AEN521"></a>
-<pre class="SCREEN">
-    add 0 0 127.2.2.2
-</pre>
-          </div>
-          <br>
-          <br>
-
-          <p>This last line tells the PPP program that it should
-          add a default route for IP traffic that points to the
-          (fake) IP address of the ISP's system.</p>
-
-          <p><span class="emphasis"><i class="EMPHASIS"><span
-          class="emphasis"><i class="EMPHASIS">Note: If you used an
-          ISP-specified address instead of <span class=
-          "emphasis"><i class="EMPHASIS">127.2.2.2</i></span> on
-          the preceding line, use the same number here instead of
-          <span class="emphasis"><i class=
-          "EMPHASIS">127.2.2.2</i></span></i></span></i></span>.</p>
-
-          <p>By adding this "fake" route for IP traffic, the PPP
-          program can, while idle:</p>
-
-          <ul>
-            <li>
-              <p>Accept packets that FreeBSD does not already know
-              how to forward,</p>
-            </li>
-
-            <li>
-              <p>Establish a connection to the ISP "<span class=
-              "emphasis"><i class=
-              "EMPHASIS">on-the-fly</i></span>",</p>
-            </li>
-
-            <li>
-              <p>Reconfigure the IP addresses of the local and
-              remote side of the link,</p>
-            </li>
-            <li>
-              <p>Forward packets between your workstation and the
-              ISP.</p>
-            </li>
-          </ul>
-          automatically!<br>
           <br>

           <p>Once the number of seconds specified by the timeout




To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?1029602481.530.32.camel>