From owner-freebsd-doc Sat Aug 17 14:42:53 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A44DA37B400 for ; Sat, 17 Aug 2002 14:42:47 -0700 (PDT) Received: from services.webwarrior.net (overlord-host99.dsl.visi.com [209.98.86.99]) by mx1.FreeBSD.org (Postfix) with ESMTP id 06CB743E3B for ; Sat, 17 Aug 2002 14:42:47 -0700 (PDT) (envelope-from friar_josh@webwarrior.net) Received: from markx.vladsempire.net (12-218-27-215.client.mchsi.com [12.218.27.215]) by services.webwarrior.net (Postfix) with ESMTP id BD47E24FA5; Sat, 17 Aug 2002 16:42:52 +0000 (GMT) Subject: Re: docs/40841 Wrong info in ppp-primer From: Josh Paetzel Reply-To: friar_josh@webwarrior.net To: freebsd-doc@freebsd.org Cc: freebsd-doc@freebsd.org, ripper@eskimo.com In-Reply-To: <1029598994.530.26.camel@markx.vladsempire.net> References: <1029598994.530.26.camel@markx.vladsempire.net> Content-Type: text/plain Content-Transfer-Encoding: 7bit X-Mailer: Ximian Evolution 1.0.5 Date: 17 Aug 2002 16:41:12 +0000 Message-Id: <1029602481.530.32.camel@markx.vladsempire.net> Mime-Version: 1.0 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org 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 @@

The '/etc/ppp/ppp.conf' 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.

- + contained in this file. The FreeBSD Handbook + describes the contents and syntax of this file in detail.

This section will describe only the minimal configuration to get a dial-out connection working.

@@ -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 @@ -616,7 +614,7 @@ 
-    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

@@ -624,9 +622,9 @@

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 'tun0' (tunnel) device and 127.2.2.2 + "EMPHASIS">tun0' (tunnel) device and 10.0.0.2 for the remote side. Appending '/0' 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.

+ 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.

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 instead of 127.1.1.1.

+ "emphasis">10.0.0.1.

Conversely, if your ISP gave you a specific IP address that he uses on his end you should enter that IP address here instead of 127.2.2.2.

+ "emphasis">10.0.0.2.

In both cases, it is probably a good idea to leave the '/0' on the end of each @@ -656,53 +660,6 @@ change the address(es) of the link if it has to.

-
- -
-    add 0 0 127.2.2.2
-
-
-
-
- -

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.

- -

Note: If you used an - ISP-specified address instead of 127.2.2.2 on - the preceding line, use the same number here instead of - 127.2.2.2.

- -

By adding this "fake" route for IP traffic, the PPP - program can, while idle:

- -
    -
  • -

    Accept packets that FreeBSD does not already know - how to forward,

    -
    • - -
  • -

    Establish a connection to the ISP "on-the-fly",

    -
    • - -
  • -

    Reconfigure the IP addresses of the local and - remote side of the link,

    -
    • -
  • -

    Forward packets between your workstation and the - ISP.

    -
    • -
- automatically!

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