On Sat, Jun 16, 2018 at 11:56:44AM +0100, Jason McIntyre wrote:
> On Fri, Jun 15, 2018 at 11:38:27AM +0100, Pedro Caetano wrote:
> > Hi bugs@
> > 
> > I spent some time reading afterboot.8 and noticed a few discrepancies with
> > reality.
> > Output from netstat(1) and from ifconfig(8) itself has changed lately.
> > 
> > I wasn't able to validate the correct output from the ppp(4), but based my
> > patch on gre(4) which i guess is similar enough.
> > 
> > Thank you for your time working on your project!
> > 
> > Best regards,
> > Pedro Caetano
> > 
> 
> morning.
> 
> the trouble with making changes like this is that we're playing catchup.
> i don;t think the actual output being in sync is going to make much
> difference to the afterboot(8) reader. in fact i am tempted to say it
> would make more sense to squash all the example output in that section -
> it doesn;t tell you anything anyway.
> 
> if anyone can think of reasons why it is helpful, we could update it i
> suppose. but, does anyone? if not i will squash it.
> 
> jmc
> 

no feedback, so below is my proposed diff.
jmc

Index: afterboot.8
===================================================================
RCS file: /cvs/src/share/man/man8/afterboot.8,v
retrieving revision 1.160
diff -u -r1.160 afterboot.8
--- afterboot.8 7 Sep 2017 13:08:39 -0000       1.160
+++ afterboot.8 17 Jun 2018 19:55:31 -0000
@@ -152,7 +152,7 @@
 You will also need to edit the
 .Pa /etc/myname
 file to have it stick around for the next reboot.
-.Ss Verify network interface configuration
+.Ss Verify network interface configuration and routing tables
 The first thing to do is an
 .Ic ifconfig -a
 to see if the network interfaces are properly configured.
@@ -171,65 +171,17 @@
 man page for more information on the format of
 .Pa /etc/hostname. Ns Ar interface
 files.
-The loopback interface will look something like:
-.Bd -literal -offset indent
-lo0: flags=8009<UP,LOOPBACK,MULTICAST> mtu 32972
-       inet6 fe80::1%lo0 prefixlen 64 scopeid 0x3
-       inet6 ::1 prefixlen 128
-       inet 127.0.0.1 netmask 0xff000000
-.Ed
-.Pp
-an Ethernet interface something like:
-.Bd -literal -offset indent
-em0: flags=9863<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST>
-       inet 192.168.4.52 netmask 0xffffff00 broadcast 192.168.4.255
-       inet6 fe80::5ef0:f0f0%em0 prefixlen 64 scopeid 0x1
-.Ed
-.Pp
-and a PPP interface something like:
-.Bd -literal -offset indent
-ppp0: flags=8051<UP,POINTOPOINT,RUNNING,MULTICAST>
-        inet 203.3.131.108 --> 198.181.0.253 netmask 0xffff0000
-.Ed
 .Pp
 See
 .Xr netstart 8
 for instructions on configuring multicast routing.
-.Pp
 See
 .Xr hostname.if 5
 for instructions on configuring interfaces with DHCP.
-.Ss Check routing tables
-Issue a
+.Pp
+Routing tables can be viewed by issuing a
 .Ic netstat -rn
 command.
-The output will look something like:
-.Bd -literal -offset indent
-Routing tables
-
-Internet:
-Destination    Gateway           Flags  Refs     Use  Mtu  Interface
-default        192.168.4.254     UGS      0 11098028    -  em0
-127            127.0.0.1         UGRS     0        0    -  lo0
-127.0.0.1      127.0.0.1         UH       3       24    -  lo0
-192.168.4      link#1            UC       0        0    -  em0
-192.168.4.52   8:0:20:73:b8:4a   UHL      1     6707    -  em0
-192.168.4.254  0:60:3e:99:67:ea  UHL      1        0    -  em0
-
-Internet6:
-Destination        Gateway       Flags  Refs  Use     Mtu  Interface
-::/96              ::1           UGRS     0     0   32972  lo0 =>
-::1                ::1           UH       4     0   32972  lo0
-::ffff:0.0.0.0/96  ::1           UGRS     0     0   32972  lo0
-fc80::/10          ::1           UGRS     0     0   32972  lo0
-fe80::/10          ::1           UGRS     0     0   32972  lo0
-fe80::%em0/64      link#1        UC       0     0    1500  em0
-fe80::%lo0/64      fe80::1%lo0   U        0     0   32972  lo0
-ff01::/32          ::1           U        0     0   32972  lo0
-ff02::%em0/32      link#1        UC       0     0    1500  em0
-ff02::%lo0/32      fe80::1%lo0   UC       0     0   32972  lo0
-.Ed
-.Pp
 The default gateway address is stored in the
 .Pa /etc/mygate
 file.

Reply via email to