From krw@tcn.net  Wed May 21 04:32:34 1997
Received: from Pkrw.tcn.net (Pkrw.tcn.net [199.166.4.58])
          by hub.freebsd.org (8.8.5/8.8.5) with ESMTP id EAA05521
          for <FreeBSD-gnats-submit@freebsd.org>; Wed, 21 May 1997 04:32:32 -0700 (PDT)
Received: (from krw@localhost)
	by Pkrw.tcn.net (8.8.5/8.8.5) id HAA00497;
	Wed, 21 May 1997 07:32:17 -0400 (EDT)
Message-Id: <199705211132.HAA00497@Pkrw.tcn.net>
Date: Wed, 21 May 1997 07:32:17 -0400 (EDT)
From: "Kenneth R. Westerback" <krw@tcn.net>
Reply-To: krw@tcn.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: ppp man page urges incorrect use of HISADDR
X-Send-Pr-Version: 3.2

>Number:         3651
>Category:       docs
>Synopsis:       ppp man page urges incorrect use of HISADDR
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    brian
>State:          closed
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed May 21 04:40:00 PDT 1997
>Closed-Date:    Mon Jun 16 06:55:40 PDT 1997
>Last-Modified:  Mon Jun 16 06:56:41 PDT 1997
>Originator:     Kenneth R. Westerback
>Release:        FreeBSD 2.2-STABLE i386
>Organization:
>Environment:

	FreeBSD 2.2-STABLE i386 ctm'd through 284

>Description:

	The man page for ppp urges you to put the two lines

	delete ALL
	add 0 0 HISADDR

	in your ppp.conf file to add a default route to your ISP.  

	As I pointed out in a previous PR against the ppp section in
	the handbook, HISADDR is not available for use during the 
	processing of ppp.conf.  While the man page covers up this
	error by urging the inclusion of the same two lines in the 
	ppp.linkup file, it would I think be better to not urge the
	erroneous use of HISADDR at all.

>How-To-Repeat:

	man ppp and hit the space bar 30 times.  Or look for HISADDR in
	the file /usr/src/usr.sbin/ppp/ppp.8

>Fix:
	
	Here's a stab at a modification.  It might be even better to
	just say put the lines in ppp.linkup and ignore the chance to
	do without that file.

--- ppp.8	Mon May 19 12:26:58 1997
+++ new.ppp.8	Wed May 21 07:16:00 1997
@@ -963,30 +963,41 @@
 .Ed
 
 .It
-In most cases, your ISP will also be your default router.  If this is
-the case, add the lines
+In most cases, your ISP will also be your default router.  If you know your
+ISP's IP number (say it's 1.2.3.4) you can add the lines
 .Bd -literal -offset indent
 delete ALL
-add 0 0 HISADDR
+add 0 0 1.2.3.4
 .Ed
 .Pp
 to
-.Pa ppp.conf .
+.Pa ppp.conf 
+and do without
+.Pa ppp.linkup .
 .Pp
 This tells
 .Nm ppp
 to delete all routing entries already made by
 .Nm ppp ,
-then to add a default route to HISADDR.  HISADDR is a macro meaning the
-"other side"s IP number.
+then to add a default route to your ISP.
+.Pp
+If you're using dynamic IP numbers, you don't put the above two lines
+in
+.Pa ppp.conf .
+Instead you must put the two lines
+.Bd -literal -offset indent
+delete ALL
+add 0 0 HISADDR
+.Ed
 .Pp
-If you're using dynamic IP numbers, you must also put these two lines
 in the
 .Pa ppp.linkup
 file.  Then, once the link has been established and
 .Nm ppp
 knows the actual IP numbers in use, all previous (and probably incorrect)
-entries are deleted and a default to the correct IP number is added.  Use
+entries are deleted and a default to the correct IP number is added.  HISADDR 
+is a macro that expands to the IP address negotiated for your ISP during the
+connection process.  Use
 the same label as the one used in
 .Pa ppp.conf .
 .Pp

>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: brian 
State-Changed-When: Mon Jun 16 06:55:40 PDT 1997 
State-Changed-Why:  
This was fixed by a re-write (almost) a few days ago. 


Responsible-Changed-From-To: freebsd-bugs->brian 
Responsible-Changed-By: brian 
Responsible-Changed-When: Mon Jun 16 06:55:40 PDT 1997 
Responsible-Changed-Why:  
I fixed this with a virtual rewrite the other day. 
>Unformatted:
