Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Philip Guenther
On Thu, Dec 22, 2022 at 12:04 PM Jason McIntyre wrote: > On Thu, Dec 22, 2022 at 11:49:09AM -0800, Philip Guenther wrote: > > On Thu, Dec 22, 2022 at 11:33 AM Jason McIntyre > wrote: > > ... > > > > > i have to say, i'm getting nowhere with this SYNOPSIS: > > > > > > netstat -r [-AFu]

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Claudio Jeker
On Thu, Dec 22, 2022 at 08:02:54PM +, Jason McIntyre wrote: > On Thu, Dec 22, 2022 at 11:49:09AM -0800, Philip Guenther wrote: > > On Thu, Dec 22, 2022 at 11:33 AM Jason McIntyre wrote: > > ... > > > > > i have to say, i'm getting nowhere with this SYNOPSIS: > > > > > > netstat -r

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Claudio Jeker
On Thu, Dec 22, 2022 at 05:58:47PM +, Jason McIntyre wrote: > On Thu, Dec 22, 2022 at 06:21:08PM +0100, Claudio Jeker wrote: > > On Thu, Dec 22, 2022 at 05:08:15PM +, Jason McIntyre wrote: > > > On Thu, Dec 22, 2022 at 07:32:18AM +, Jason McIntyre wrote: > > > > > > > > next step is

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 07:31:26PM +, Jason McIntyre wrote: > > anyway, how about this text for ipcomp/ipsec? > jmc > for completeness sake, here's the full diff. jmc Index: sbin/ifconfig/ifconfig.8 === RCS file:

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 11:49:09AM -0800, Philip Guenther wrote: > On Thu, Dec 22, 2022 at 11:33 AM Jason McIntyre wrote: > ... > > > i have to say, i'm getting nowhere with this SYNOPSIS: > > > > netstat -r [-AFu] [-f address_family] [-M core] [-N system] > > [-p

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Philip Guenther
On Thu, Dec 22, 2022 at 11:33 AM Jason McIntyre wrote: ... > i have to say, i'm getting nowhere with this SYNOPSIS: > > netstat -r [-AFu] [-f address_family] [-M core] [-N system] > [-p protocol] [-T rtable] > > i mean the combination of -r and -p. is it wholly

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 06:35:41PM +, Stuart Henderson wrote: > On 2022/12/22 17:58, Jason McIntyre wrote: > > > > flag. > > > > Just like for IPsec, using the > > > > -.Fl r > > > > -flag, > > > > -.Xr netstat 1 > > > > +.Xr route 8 > > > > +.Cm show > > > > +command > > > > displays

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Stuart Henderson
On 2022/12/22 17:58, Jason McIntyre wrote: > > > 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

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 06:21:08PM +0100, Claudio Jeker wrote: > On Thu, Dec 22, 2022 at 05:08:15PM +, Jason McIntyre wrote: > > On Thu, Dec 22, 2022 at 07:32:18AM +, Jason McIntyre wrote: > > > > > > next step is to examine Xr. will get round to that when i can. > > > > > > > so i

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Claudio Jeker
On Thu, Dec 22, 2022 at 05:08:15PM +, Jason McIntyre wrote: > On Thu, Dec 22, 2022 at 07:32:18AM +, 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.

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Jason McIntyre
On Thu, Dec 22, 2022 at 07:32:18AM +, 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

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-22 Thread Claudio Jeker
On Wed, Dec 21, 2022 at 10:21:16AM -0700, Theo de Raadt wrote: > Claudio Jeker wrote: > > > In the old world only netstat could show the routing table. I think this > > is still the case in FreeBSD for example. We added route show at some > > point but the documentation was not shared between

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Jason McIntyre
On Wed, Dec 21, 2022 at 05:15:35PM -0500, Paul Tagliamonte wrote: > Good news, I've got my MUA sorted. Hopefully this fixes the issues with > the CVS diffs in my reply body. > > On Wed, Dec 21, 2022 at 10:09:24PM +, Jason McIntyre wrote: > > i like the choice of "display" over "print out". >

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Theo de Raadt
Jason McIntyre wrote: > i would not remove the Xr. i think if we go ahead with this, we can make > a separate commit where we point people to route(8) rather than > netstart(8), but i suspect many pages will both want references to both. netstat, not netstart, heh But yes it is true that some

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Paul Tagliamonte
Good news, I've got my MUA sorted. Hopefully this fixes the issues with the CVS diffs in my reply body. On Wed, Dec 21, 2022 at 10:09:24PM +, Jason McIntyre wrote: > i like the choice of "display" over "print out". > i don;t like the "related metadata" bit though. > > what about just > >

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Jason McIntyre
On Wed, Dec 21, 2022 at 12:41:42PM -0500, Paul R. Tagliamonte wrote: > > So I think route.8 is where we should try to have complete documentation, > > and once that is done we should change Xr's and other documentation to > > point at route.8 instead of netstat.8 > > In an effort to have my

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Paul R. Tagliamonte
> So I think route.8 is where we should try to have complete documentation, > and once that is done we should change Xr's and other documentation to > point at route.8 instead of netstat.8 In an effort to have my interactions on this list wind up being helpful rather than more work for overworked

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Theo de Raadt
Claudio Jeker wrote: > In the old world only netstat could show the routing table. I think this > is still the case in FreeBSD for example. We added route show at some > point but the documentation was not shared between the manpages. > I agree that it is annoying to open up the netstat man page

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Claudio Jeker
On Wed, Dec 21, 2022 at 04:48:38PM +, Jason McIntyre wrote: > On Wed, Dec 21, 2022 at 10:43:18AM -0500, Paul R. Tagliamonte wrote: > > On Tue, Dec 20, 2022 at 8:27 PM Paul R. Tagliamonte > > wrote: > > > > > > Heyya tech@, > > > > > > Please keep me on cc, I'm not subscribed > > > > Please

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Jason McIntyre
On Wed, Dec 21, 2022 at 10:43:18AM -0500, Paul R. Tagliamonte wrote: > On Tue, Dec 20, 2022 at 8:27 PM Paul R. Tagliamonte wrote: > > > > Heyya tech@, > > > > Please keep me on cc, I'm not subscribed > > Please keep me on cc. The last message wasn't sent to me, so my In-Reply-To > is going to be

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-21 Thread Paul R. Tagliamonte
On Tue, Dec 20, 2022 at 8:27 PM Paul R. Tagliamonte wrote: > > Heyya tech@, > > Please keep me on cc, I'm not subscribed Please keep me on cc. The last message wasn't sent to me, so my In-Reply-To is going to be wrong. I'm not subscribed to tech@. >From the web: > some of the relevant flags are

Re: [patch] add show.c style flag descriptions to route(8)

2022-12-20 Thread Jason McIntyre
On Tue, Dec 20, 2022 at 08:27:14PM -0500, Paul R. Tagliamonte wrote: > Heyya tech@, > > Please keep me on cc, I'm not subscribed > > I've been working on porting some of my linux specific software to > work on OpenBSD. While working with some routing-specific code, > I needed to pull up show.c

[patch] add show.c style flag descriptions to route(8)

2022-12-20 Thread Paul R. Tagliamonte
Heyya tech@, Please keep me on cc, I'm not subscribed I've been working on porting some of my linux specific software to work on OpenBSD. While working with some routing-specific code, I needed to pull up show.c to map the letters in `route show` to the RTF_ values. I figured while I was in