On 8/2/23 18:59, Matthew Martin wrote: > On Wed, Aug 02, 2023 at 06:36:26PM -0400, A Tammy wrote: >> Not a huge fan of this complicated representation. >>> +.Ar command >>> +was invoked but failed with this exit status; >>> +see its manual page for more information. >>> +.It 126 >>> +.Ar command >>> +was found but could not be invoked, or it was invoked but failed >>> +with exit status 126. >>> +.It 127 >>> +.Ar command >>> +could not be found, or it was invoked but failed with exit status 127. >>> +.El >> A lot of repetition of '<special case> but failed with exit status >> 1/126/127' maybe condense them into something like: route exits with the >> exit status of the invoked command on successful execution or with the >> following special exit codes - then the 1/126/127 thing. >>> .Sh EXAMPLES >>> Show the current IPv4 routing tables, >>> without attempting to print hostnames symbolically: > I agree; was just trying to match the existing docs. How is the below?
Looks a lot better, thanks, committed! > diff --git route.8 route.8 > index 887446c1420..5a7b0355520 100644 > --- route.8 > +++ route.8 > @@ -281,7 +281,8 @@ and/or a gateway. > .Op Fl T Ar rtable > .Tg > .Cm exec > -.Op Ar command ... > +.Ar command > +.Op Ar arg ... > .Xc > Execute a command, forcing the process and its children to use the > routing table and appropriate routing domain as specified with the > @@ -514,6 +515,35 @@ host and network name database > .It Pa /etc/mygate > default gateway address > .El > +.Sh EXIT STATUS > +For commands other than > +.Cm exec , > +the > +.Nm > +utility exits 0 on success, and >0 if an error occurs. > +.Pp > +For the > +.Cm exec > +command the > +.Nm > +utility exits with the exit status of > +.Ar command > +if it could be invoked. > +Otherwise the > +.Nm > +utility exits with one of the following values: > +.Bl -tag -width Ds > +.It 1 > +An invalid command line option was passed to > +.Nm > +or setting the routing table failed. > +.It 126 > +.Ar command > +was found but could not be invoked. > +.It 127 > +.Ar command > +could not be found. > +.El > .Sh EXAMPLES > Show the current IPv4 routing tables, > without attempting to print hostnames symbolically: >
