From krw@Pkrw.tcn.net  Wed Mar 26 19:32:25 1997
Received: from Pkrw.tcn.net (Pkrw.tcn.net [199.166.4.58])
          by freefall.freebsd.org (8.8.5/8.8.5) with ESMTP id TAA29449
          for <FreeBSD-gnats-submit@freebsd.org>; Wed, 26 Mar 1997 19:32:21 -0800 (PST)
Received: (from krw@localhost)
	by Pkrw.tcn.net (8.8.5/8.8.5) id WAA00335;
	Wed, 26 Mar 1997 22:35:47 -0500 (EST)
Message-Id: <199703270335.WAA00335@Pkrw.tcn.net>
Date: Wed, 26 Mar 1997 22:35:47 -0500 (EST)
From: krw@tcn.net
Reply-To: krw@tcn.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: FreeBSD Handbook Section 12.1.5 example incorrect
X-Send-Pr-Version: 3.2

>Number:         3114
>Category:       docs
>Synopsis:       Use of HISADDR in ppp.conf incorrect
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    brian
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Mar 26 19:40:01 PST 1997
>Closed-Date:    Wed May 7 18:52:03 PDT 1997
>Last-Modified:  Sat Mar 16 23:12:39 UTC 2013
>Originator:     Kenneth R. Westerback
>Release:        FreeBSD 2.2.1-RELEASE i386
>Organization:
>Environment:

>Description:

	The example configuration for PPP and static IP addresses shown in section
	12.1.5 of FreeBSD Handbook will not work. Line 13 is

		add 0 0 HISADDR

	which does NOT add a default route to your ISP.  I'm assuming this is
	a documentation bug (using HISADDR in an incorrect context) rather than
	a ppp bug (HISADDR not being set where it should be).

>How-To-Repeat:

	1) Setup /etc/ppp/ppp.conf as in the example with your user specific info
	2) delete or rename /etc/ppp/ppp.linkup if present
	3) run ppp -auto provider
	4) check netstat -rn for a default route

>Fix:
	
	change line 13 to read

		add 0 0 y.y.y.y

	change Line 13: descriptive paragraph to read

		Adds a default route to your ISP's IP number.  Note use of
		IP address rather than HISADDR macro.  The macro is not
		available for use at this point.
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->brian 
Responsible-Changed-By: brian 
Responsible-Changed-When: Tue Apr 15 09:19:55 PDT 1997 
Responsible-Changed-Why:  
This isn't (IMHO) a bug, it's a feature.  I've contacted the sender. 

From: Brian Somers <brian@utell.co.uk>
To: freebsd-gnats-submit@freebsd.org, krw@tcn.net, brian@awfulhak.org
Cc:  Subject: Re: docs/3114: Use of HISADDR in ppp.conf incorrect
Date: Tue, 15 Apr 1997 17:17:42 +0100

 I don't agree that this is a bug.  When ppp reads the ppp.conf entry,
 
 it sets up HISADDR according to the second arg of "set ifaddr".  This,
 
 as far as ppp knows, will be "his address".  If this address is
 
 changed at connection time, then the HISADDR macro changes too (making
 
 the ppp.linkup entry necessary for connections that don't know the
 
 other sides IP up front)..
 
 Essentially, HISADDR is always valid as being the "target IP".
 
 The only exception would be if "set ifaddr xxxx 0/0" is used, but
 
 then HISADDR doesn't make sense anyway - nobody's mentioned "his
 
 address" yet.
 
 --
 Brian
 
 Don't _EVER_ lose your sense of humour !
 
 
 
State-Changed-From-To: open->closed 
State-Changed-By: brian 
State-Changed-When: Wed May 7 16:04:05 PDT 1997 
State-Changed-Why:  
The original submitter has not replied to my mail suggesting that 
this is not an error (sent 3 weeks ago). 
State-Changed-From-To: closed->open 
State-Changed-By: brian 
State-Changed-When: Wed May 7 17:09:30 PDT 1997 
State-Changed-Why:  
Oops - the original submitter pointed out that he *did* reply 
to me.  I'll dig deeper. 
State-Changed-From-To: open->closed 
State-Changed-By: brian 
State-Changed-When: Wed May 7 18:52:03 PDT 1997 
State-Changed-Why:  
Updated ppp.conf.sample and the handbook as suggested. 
HISADDR is not available in ppp.conf. 
>Unformatted:
