On Thu, Dec 22, 2022 at 05:08:15PM +0000, Jason McIntyre wrote: > On Thu, Dec 22, 2022 at 07:32:18AM +0000, Jason McIntyre wrote: > > > > next step is to examine Xr. will get round to that when i can. > > > > so i looked at where we are using netstat. a lot of the references still > make sense. diff below is for ones i think we can change. claudio kindly > help me sift through some of the less clear ones (specifically where we > have an Xr to netstat(1) in SEE ALSO but do not discuss it in any way > within the manual). > > here's the diff. >
A few comments below. > Index: sbin/ifconfig/ifconfig.8 > =================================================================== > RCS file: /cvs/src/sbin/ifconfig/ifconfig.8,v > retrieving revision 1.387 > diff -u -p -r1.387 ifconfig.8 > --- sbin/ifconfig/ifconfig.8 26 Nov 2022 07:26:43 -0000 1.387 > +++ sbin/ifconfig/ifconfig.8 22 Dec 2022 17:04:39 -0000 > @@ -2329,11 +2329,11 @@ tried to alter an interface's configurat > .Xr inet 4 , > .Xr intro 4 , > .Xr netintro 4 , > -.Xr route 4 , > .Xr rtable 4 , > .Xr hostname.if 5 , > .Xr hosts 5 , > .Xr rc 8 , > +.Xr route 8 , > .Xr slaacd 8 , > .Xr tcpdump 8 > .Sh HISTORY > Index: sbin/ping/ping.8 > =================================================================== > RCS file: /cvs/src/sbin/ping/ping.8,v > retrieving revision 1.65 > diff -u -p -r1.65 ping.8 > --- sbin/ping/ping.8 21 Feb 2021 17:18:01 -0000 1.65 > +++ sbin/ping/ping.8 22 Dec 2022 17:04:39 -0000 > @@ -418,8 +418,8 @@ Others may use completely wild values. > exits 0 if at least one reply is received, > and >0 if no reply is received or an error occurred. > .Sh SEE ALSO > -.Xr netstat 1 , > -.Xr ifconfig 8 > +.Xr ifconfig 8 , > +.Xr route 8 > .Sh HISTORY > The > .Nm > Index: share/man/man4/ipcomp.4 > =================================================================== > RCS file: /cvs/src/share/man/man4/ipcomp.4,v > retrieving revision 1.16 > diff -u -p -r1.16 ipcomp.4 > --- share/man/man4/ipcomp.4 12 Jan 2018 04:36:44 -0000 1.16 > +++ share/man/man4/ipcomp.4 22 Dec 2022 17:04:39 -0000 > @@ -105,9 +105,9 @@ can be used to obtain some statistics ab > .Fl p > flag. > Just like for IPsec, using the > -.Fl r > -flag, > -.Xr netstat 1 > +.Xr route 8 > +.Cm show > +command > displays information about IPComp flows. That's a lie. Neither netstat nor route show IPsec flows. This was moved to ipsecctl(8). At least I was not able to display the flows with netstat or route. > .Sh SEE ALSO > .Xr enc 4 , > Index: share/man/man4/ipsec.4 > =================================================================== > RCS file: /cvs/src/share/man/man4/ipsec.4,v > retrieving revision 1.88 > diff -u -p -r1.88 ipsec.4 > --- share/man/man4/ipsec.4 31 Mar 2022 17:27:21 -0000 1.88 > +++ share/man/man4/ipsec.4 22 Dec 2022 17:04:39 -0000 > @@ -360,10 +360,9 @@ can be used to obtain some statistics ab > .Fl p > flag. > Using the > -.Fl r > -flag, > -.Xr netstat 1 > -displays information about IPsec flows. > +.Xr route 8 > +.Cm show > +command displays information about IPsec flows. See above. > .Pp > .Xr vmstat 8 > displays information about memory use by IPsec with the > Index: share/man/man8/afterboot.8 > =================================================================== > RCS file: /cvs/src/share/man/man8/afterboot.8,v > retrieving revision 1.171 > diff -u -p -r1.171 afterboot.8 > --- share/man/man8/afterboot.8 13 Apr 2022 18:00:34 -0000 1.171 > +++ share/man/man8/afterboot.8 22 Dec 2022 17:04:39 -0000 > @@ -184,7 +184,8 @@ See > for instructions on configuring interfaces with DHCP. > .Pp > Routing tables can be viewed by issuing a > -.Ic netstat -rn > +.Xr route 8 > +.Cm show Should we add -n here as well so people don't end up waiting for DNS lookups? I would love if someone made -n the default and add a -N flag instead. Reverse DNS lookups are just not helpful in routing table output. > command. > The default gateway address is stored in the > .Pa /etc/mygate > @@ -199,8 +200,7 @@ Or, you may prefer to manually configure > .Ic route add > and > .Ic route delete > -commands (see > -.Xr route 8 ) . > +commands. > .Pp > If you wish to route packets between interfaces, add one or both > of the following directives (depending on whether IPv4 or IPv6 routing > Index: usr.sbin/traceroute/traceroute.8 > =================================================================== > RCS file: /cvs/src/usr.sbin/traceroute/traceroute.8,v > retrieving revision 1.74 > diff -u -p -r1.74 traceroute.8 > --- usr.sbin/traceroute/traceroute.8 30 Jul 2022 07:19:31 -0000 1.74 > +++ usr.sbin/traceroute/traceroute.8 22 Dec 2022 17:04:39 -0000 > @@ -387,8 +387,8 @@ Because of the load it could impose on t > .Nm > during normal operations or from automated scripts. > .Sh SEE ALSO > -.Xr netstat 1 , > -.Xr ping 8 > +.Xr ping 8 , > +.Xr route 8 > .Sh HISTORY > The very first > .Nm > I like this (apart from the already present lies) :) -- :wq Claudio
