From owner-freebsd-bugs Wed May 21 04:40:03 1997 Return-Path: Received: (from root@localhost) by hub.freebsd.org (8.8.5/8.8.5) id EAA05748 for bugs-outgoing; Wed, 21 May 1997 04:40:03 -0700 (PDT) Received: (from gnats@localhost) by hub.freebsd.org (8.8.5/8.8.5) id EAA05734; Wed, 21 May 1997 04:40:01 -0700 (PDT) Resent-Date: Wed, 21 May 1997 04:40:01 -0700 (PDT) Resent-Message-Id: <199705211140.EAA05734@hub.freebsd.org> Resent-From: gnats (GNATS Management) Resent-To: freebsd-bugs Resent-Reply-To: FreeBSD-gnats@FreeBSD.ORG, krw@tcn.net 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 ; 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" Reply-To: krw@tcn.net To: FreeBSD-gnats-submit@FreeBSD.ORG X-Send-Pr-Version: 3.2 Subject: docs/3651: ppp man page urges incorrect use of HISADDR Sender: owner-bugs@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk >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: