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 to map the letters in `route show` to the > RTF_ values. > > I figured while I was in there, I'd send a patch along adding that to > the manpage in the hopes it's a bit easier for others in the future. > Most of the descriptions were pulled from the .h > > First time sending anything in to OpenBSD, please let me know if > there's anything I can do better for next time! I'm wary of my MUA > (GMail's web interface) destroying the patch, so I've attached it > for redundancy. > > paultag > -- > :wq >
hi. some of the relevant flags are already documented in route(8) ("Routes have associated flags...). the entire list is documented in route(4), but you have to explicitly ask for it (man 4 route) and again the flags with detail in netstat(8) ("The mapping between letters and flags is..."). jmc > Index: route.8 > =================================================================== > RCS file: /cvs/src/sbin/route/route.8,v > retrieving revision 1.106 > diff -u -p -r1.106 route.8 > --- route.8 19 Nov 2022 19:23:37 -0000 1.106 > +++ route.8 21 Dec 2022 01:11:22 -0000 > @@ -571,6 +571,37 @@ and > .Dv RTM_CHANGE . > As such, only the superuser may modify > the routing tables. > +.Sh FLAGS > +When displaying routes with the > +.Cm show > +command, the output contains a > +.Ar Flags > +column indicating what flags have been set on the route. The possible > +values and their corresponding header definition names are: > +.Bl -column "U" "RTF_BLACKHOLE" "description" > +.It U Ta Dv RTF_UP Ta "route is usable" > +.It G Ta Dv RTF_GATEWAY Ta "route traffic through a gateway" > +.It H Ta Pf RTF_HOST Ta "route target is a host entry" > +.It R Ta Dv RTF_REJECT Ta "host or net is unreachable" > +.It D Ta Dv RTF_DYNAMIC Ta "route created dynamically (by redirect)" > +.It M Ta Pf RTF_MODIFIED Ta "route modified dynamically (by redirect)" > +.It C Ta Dv RTF_CLONING Ta "generate new routes on use" > +.It m Ta Dv RTF_MULTICAST Ta "route associated to a multicast addr" > +.It L Ta Dv RTF_LLINFO Ta "route generated by ARP or NDP" > +.It S Ta Dv RTF_STATIC Ta "route was manually added" > +.It B Ta Dv RTF_BLACKHOLE Ta "discard all traffic" > +.It 3 Ta Dv RTF_PROTO3 Ta "protocol specific routing flag" > +.It 2 Ta Dv RTF_PROTO2 Ta "protocol specific routing flag" > +.It 1 Ta Dv RTF_PROTO1 Ta "protocol specific routing flag" > +.It c Ta Dv RTF_CLONED Ta "route was cloned" > +.It h Ta Dv RTF_CACHED Ta "referenced by gateway route" > +.It P Ta Dv RTF_MPATH Ta "multipath route" > +.It T Ta Dv RTF_MPLS Ta "MPLS route" > +.It l Ta Dv RTF_LOCAL Ta "route is local to the host" > +.It F Ta Dv RTF_BFD Ta "link state controlled by BFD" > +.It b Ta Dv RTF_BROADCAST Ta "route associated to a broadcast addr" > +.It n Ta Dv RTF_CONNECTED Ta "interface route" > +.El > .Sh FILES > .Bl -tag -width "/etc/mygate" -compact > .It Pa /etc/hosts > Index: route.8 > =================================================================== > RCS file: /cvs/src/sbin/route/route.8,v > retrieving revision 1.106 > diff -u -p -r1.106 route.8 > --- route.8 19 Nov 2022 19:23:37 -0000 1.106 > +++ route.8 21 Dec 2022 01:11:22 -0000 > @@ -571,6 +571,37 @@ and > .Dv RTM_CHANGE . > As such, only the superuser may modify > the routing tables. > +.Sh FLAGS > +When displaying routes with the > +.Cm show > +command, the output contains a > +.Ar Flags > +column indicating what flags have been set on the route. The possible > +values and their corresponding header definition names are: > +.Bl -column "U" "RTF_BLACKHOLE" "description" > +.It U Ta Dv RTF_UP Ta "route is usable" > +.It G Ta Dv RTF_GATEWAY Ta "route traffic through a gateway" > +.It H Ta Pf RTF_HOST Ta "route target is a host entry" > +.It R Ta Dv RTF_REJECT Ta "host or net is unreachable" > +.It D Ta Dv RTF_DYNAMIC Ta "route created dynamically (by redirect)" > +.It M Ta Pf RTF_MODIFIED Ta "route modified dynamically (by redirect)" > +.It C Ta Dv RTF_CLONING Ta "generate new routes on use" > +.It m Ta Dv RTF_MULTICAST Ta "route associated to a multicast addr" > +.It L Ta Dv RTF_LLINFO Ta "route generated by ARP or NDP" > +.It S Ta Dv RTF_STATIC Ta "route was manually added" > +.It B Ta Dv RTF_BLACKHOLE Ta "discard all traffic" > +.It 3 Ta Dv RTF_PROTO3 Ta "protocol specific routing flag" > +.It 2 Ta Dv RTF_PROTO2 Ta "protocol specific routing flag" > +.It 1 Ta Dv RTF_PROTO1 Ta "protocol specific routing flag" > +.It c Ta Dv RTF_CLONED Ta "route was cloned" > +.It h Ta Dv RTF_CACHED Ta "referenced by gateway route" > +.It P Ta Dv RTF_MPATH Ta "multipath route" > +.It T Ta Dv RTF_MPLS Ta "MPLS route" > +.It l Ta Dv RTF_LOCAL Ta "route is local to the host" > +.It F Ta Dv RTF_BFD Ta "link state controlled by BFD" > +.It b Ta Dv RTF_BROADCAST Ta "route associated to a broadcast addr" > +.It n Ta Dv RTF_CONNECTED Ta "interface route" > +.El > .Sh FILES > .Bl -tag -width "/etc/mygate" -compact > .It Pa /etc/hosts