Bug 40841

Summary: the PPP primer gives a very wrong ppp.conf example, I think
Product: Documentation Reporter: Ross Lippert <ripper>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Ross Lippert 2002-07-21 16:40:02 UTC
It is my understanding, from some emails I say a few months ago that
FreeBSD recently made 127.x.x.x addresses entirely local in order to
comply with some RFC someone found as well as some firewall software
users wanted to use.  The issue was that traffic to 127.x.x.x addr's
should not leave the machine ever.

This makes the 127.x.x.x numbers very bad to use as bogus addr's in
the PPP primer.  I just tried out PPP with a conf in which

      set ifaddr 127.1.1.1/0 127.2.2.2/0 255.255.255.0
      add 0 0 127.2.2.2

and got some very nasty messages about routes already existing and other
weirdness when I tried using PPP.  The dialup connection would occur, but
I could not ping anything, even by IP addr.

Fix: 

Use different IP addr's as the bogus ones.  Since 10.x.x.x is bogus according
to RFC 1918, I suggest
      set ifaddr 10.1.1.127/0 10.2.2.127/0 255.255.255.0
      add 0 0 10.2.2.127
This fixed it for me.

That is, the use of 127.x.x.x as a bogus addr in the PPP Primer should be
changed to something bogus, but not that bogu

 -=- MIME -=- 
This is a MIME-encapsulated message

--g6JG28Kx093456.1027094528/laverne.home

    **********************************************
    **      THIS IS A WARNING MESSAGE ONLY      **
    **  YOU DO NOT NEED TO RESEND YOUR MESSAGE  **
    **********************************************

The original message was received at Fri, 19 Jul 2002 07:33:28 -0400 (EDT)
from localhost [127.0.0.1]

   ----- Transcript of session follows -----
451 freebsd.org: Name server timeout
Warning: message still undelivered after 4 hours
Will keep trying until message is 5 days old

--g6JG28Kx093456.1027094528/laverne.home
Content-Type: message/delivery-status

Reporting-MTA: dns; laverne.home
Arrival-Date: Fri, 19 Jul 2002 07:33:28 -0400 (EDT)

Final-Recipient: RFC822; FreeBSD-gnats-submit@freebsd.org
Action: delayed
Status: 4.4.3
Last-Attempt-Date: Fri, 19 Jul 2002 12:02:08 -0400 (EDT)
Will-Retry-Until: Wed, 24 Jul 2002 07:33:28 -0400 (EDT)

--g6JG28Kx093456.1027094528/laverne.home
Content-Type: message/rfc822

Return-Path: <ripper@laverne.home>
Received: from laverne.home (localhost [127.0.0.1])
	by laverne.home (8.12.3/8.12.3) with ESMTP id g6JBXSKv090450
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 19 Jul 2002 07:33:28 -0400 (EDT)
	(envelope-from ripper@laverne.home)
Received: (from ripper@localhost)
	by laverne.home (8.12.3/8.12.3/Submit) id g6JBXQAF090449;
	Fri, 19 Jul 2002 07:33:26 -0400 (EDT)
Date: Fri, 19 Jul 2002 07:33:26 -0400 (EDT)
Message-Id: <200207191133.g6JBXQAF090449@laverne.home>
To: FreeBSD-gnats-submit@freebsd.org
Subject: the PPP primer gives a very wrong ppp.conf example, I think
From: "Ross A. Lippert" <ripper@laverne.home>
Reply-To: "Ross A. Lippert" <ripper@laverne.home>
Cc: 
X-send-pr-version: 3.113
X-GNATS-Notify: 
MIME-Version: 1.0
How-To-Repeat: Read the PPP primer, and see the example ppp.conf file in section 3.2.1.

Use that example as the basis for your ppp.conf file, i.e. have the lines
      set ifaddr 127.1.1.1/0 127.2.2.2/0 255.255.255.0
      add 0 0 127.2.2.2
appropriately.

% ppp -ddial myisp
% ping <your name server's addr here>

and you will not get good pinging.
Comment 1 Ross Lippert 2002-07-25 12:58:05 UTC
This is a followup on how to fix the documentation.  The following
script modified the book.sgml sources to produce more RFC conformant
examples.  I chose 10.0.0.x dummy addresses because they are more
similar to the ppp.conf.sample file currently in use in 4.6-RELEASE.

#!/bin/sh
for dir in ` find /usr/doc -type d -name ppp-primer` ; do
   mv "$dir/book.sgml" "$dir/book.sgml.orig"
   sed -e 's/127\.1\.1/10.0.0/g;s/127\.2\.2/10.0.0/g' "$dir/book.sgml.orig" > "$dir/book.sgml"
done 

I've checked, and it does not look like this clobbers anything it shouldn't
and it hits what it should.

I suggest someone with commit bits apply this patch and commit it.


-r
Comment 2 Giorgos Keramidas freebsd_committer freebsd_triage 2002-08-19 23:34:34 UTC
(( Add to audit trail. ))

Message-Id: <1029598994.530.26.camel@markx.vladsempire.net>
Date: 17 Aug 2002 15:42:59 +0000
From: Josh Paetzel <friar_josh@webwarrior.net>
Subject: docs/40841 Wrong info in ppp-primer

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.
Comment 3 Tom Rhodes freebsd_committer freebsd_triage 2002-08-26 18:56:25 UTC
State Changed
From-To: open->closed

The PPP Primer has been removed from the doc build.