Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 21 May 1997 07:32:17 -0400 (EDT)
From:      "Kenneth R. Westerback" <krw@tcn.net>
To:        FreeBSD-gnats-submit@FreeBSD.ORG
Subject:   docs/3651: ppp man page urges incorrect use of HISADDR
Message-ID:  <199705211132.HAA00497@Pkrw.tcn.net>
Resent-Message-ID: <199705211140.EAA05734@hub.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         3651
>Category:       docs
>Synopsis:       ppp man page urges incorrect use of HISADDR
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          open
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed May 21 04:40:00 PDT 1997
>Last-Modified:
>Originator:     Kenneth R. Westerback
>Organization:
>Release:        FreeBSD 2.2-STABLE i386
>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

>Audit-Trail:
>Unformatted:



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