add EXIT STATUS section with information for the exec subcommand

patch by Matthew Martin <phy1729 AT gmail DOT com>

Markup route flags to get tags

":tM" to jump to the definition of RTF_MODIFIED is easier and faster than
manually navigating there.

OK schwarze

sourceaddr:

- show that -ifp and "address" do not mix
- show how to reset value (from claudio)
- tweak text

ok claudio

tweak sourceaddr:

- remove "-inet|-inet6" as it is not generally meaningful
- remove the qualifier "if set": sourceaddr now works nicely in cases
where no "address is given

restore tags for commands lost in r1.112 restructuring; OK jmc

mpls gateway clarification; from claudio

namservers -> nameservers

restructure the page into one single list for all routing commands;
while there, whack anything either out of date or not useful

joint work with claudio

some nameserver proposal bits:

unwind.8: point to resolvd(8) for autoconf sources
unwind.conf.5: order preferred list by order of preference
resolvd.8: reformat to read better
route.8: no need to discuss unwind in the nameserver command
umb.4 + sppp.4: note the sending of nameserver proposals

the umb/sppp text is from claudio
tobhe confirmed iked sending proposals when configured to do so

much assistance and ok: florian claudio

Typofix -ssthresh in HISTORY

Denote multiple arguments with 'arg ...' not 'args'

A few programs used the plural in their synopsis which doesn't read as
clear as the obvious triple-dot notation.

mdoc(7) .Ar defaults to "file ..." if no arguments are given and consistent
use of 'arg ...' matches that behaviour.

Cleanup a few markups of the same argument so the text keeps reading
naturally; omit unhelpful parts like 'if optional arguments are given,
they are passed along' for tools like time(1) and timeout(1) that obviously
execute commands with whatever arguments where given -- just like doas(1)
which doesn't mention arguments in its DESCRIPTION in the first place.

For expr(1) the difference between 'expressions' and 'expression ...' is
crucial, as arguments must be passed as individual words.

Feedback millert jmc schwarze deraadt
OK jmc

it seems we made a separate list for the two sourceaddr commands,
just to remove some vertical spacing; that is unfortunate
because when i adjusted the list spacing it did not affect this second
list, and logically it is one list (route commands) not two;

resolve this by having one -compact list, and inserting Pp between list items
where needed;

move the flag mappings displayed by "route show" from netstat(1) to route(8):
diff from paul tagliamonte, who was surprised to find them not documented
in route(8);

claudio agreed placement was not ideal;
deraadt confirmed users better served by route(8) than netstat(1);

i've tweaked some of the spacing and text so it displays better,
and removed some macros incorrectly associated with the "nameserver"
list item, which was messing up the formatting. should display better
now

fix vertical spacing in previous

add an example for adding a cloning host route to reach a gateway which is
outside the subnet, some hosting providers use this. info from Eric JACQUOT
ok florian kn phessler

Mention id(1) -R, reference rtable(4) in route(8)

Fix "ps -o rtable" example description while here.

Initial idea to mention id -R in route(8) from sthen
Feedback OK sthen

man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@

Generalise "nameserver" workings

The generated route message is not at all resolvd(8) specific.
Mention how unwind(8) reacts to proposals as well.

"Broadcast" wording deraadt jmc
OK millert

Make ":tdelete" work

r1.91 added tags for all commands, but "del[ete]" is special in that
mandoc(1) will generate a tag for "del" only.

Add an explicit for the full command to fix this.

Clarify how dns proposals are replaced not added per interface

OK benno

nameserver command requires an interface argument

for nameserver usage, show multiple addresses as "address ..."; ok benno
while here, Pa->Xr for resolv.conf;

sort the new nameserver text; rework it a little; sort SEE ALSO;

Add a new 'nameserver' command to route(8).
It sends nameserver proposals to resolvd(8) using the dns proposal
protocol over the route socket. Based on a seperate program
written by florian@. deraadt noticed some whitespace issues.
more fixes and ok florian@

add three missing .Dv macros,
and move punctuation out of two that are already there

Rework source IP address setting.

- Move most of the processing out of rtable.c (reasonnable tb@, ok bluhm@)
- Remove memory allocation, store pointer to existing ifaddr
- Fix tunnel interface handling

looks fine mpi@

Source address set can be printed

Add feature to force the selection of source IP address

Based/previous work on an idea from deraadt@
Input from claudio@, djm@, deraadt@, sthen@

OK deraadt@

add some explicit tagging macros; OK kn@ on a previous version

elaborate a little on how route priorities work;
help/ok claudio

signpost the location of the text explaining routing table output a little better...

Document that route monitor also takes -T rtable as an argument.

Use "rtable" not "tableid" as argument name for rtable

Make rtable(4) usage documentation consistent with other programs.
This is to have `man -k ar~rtable' show the full list without having to
look for other variations of the same argument type.

OK bluhm

Kill fluff about how route(8) is of limited usefulness

Don't say that route(8) is mostly useful to set up a default route,
which is almost a lie. What's more, I'm not sure new users struggling
with route(8) should be pointed to ripd(8) (sic) or bgpd(8) as
a solution to their problems. ok benno@ kn@

* simplify code by no longer calling getnetbyname(3)
* avoid double lookups for unresolvable names without -net
* more fitting error message for unresolvable names after -net
OK florian@

remove references to /etc/networks; reminded by jmc@

backout previous diff:
autodetect AF when setting inet6 default route
From Denis Fondras, thanks!
ok phessler@ bluhm@
it breaks with ipv6 link-local routes, e.g.
/sbin/route -inet6 default -ifp pppoe0 fe80::%pppoe0
found by jmc@
ok florian

new sentence, new line;

document use of del as short form for delete, from jca
ok schwarze@

autodetect AF when setting inet6 default route
From Denis Fondras, thanks!
ok phessler@ bluhm@

Hyphenate compound adjectives 'up-to-date', 'out-of-date' and 'well-known'
if they precede the noun and omit hyphens otherwise.

ok tj

Remove RTF_XRESOLVE support.

On systems with a full routing table (550k+), we often want to be able to
look at the routes with a priority, or to display all routes that do not
have a specific priority (normally, don't show bgp).

We are intentionally not updating netstat -r yet, as we do not have a
good flag to use.

first version from, and OK benno@

nope, ioctl has not been used for a while

Document that priority 1 is reserved for kernel use.

Remove route/netstat -f encap in favor of ipsecctl -s flow.

OK deraadt@

Try to be more precise about rtable and rdomains.

Remove genmask support from route(8). It still will show them in monitor
or get but you can no longer set it. genmask will die soon since nobody
needs it. OK benno@ and agreed by dlg@

autodetect ipv6 addresses for route(8). ok benno@ bluhm@, manpage help jmc@

allow destination/prefixlen syntax for ipv6 routes.
from Florian Obser, florian -AT- narrans -DOT- de

ok sthen@

make -column lists pretty again;

specifically, rewrite them to permit some markup in the column headers,
and use "Ta" instead of literal tabs; mandoc does not currently match groff
100%, but a mandoc fix may be some time off, and we've gone enough releases
with poorly formatting column lists.

in some cases i have rewritten the lists as -tag, where -column made
little sense.

kill a useless Pp;

Flip one .Fl interface to .Fl iface since iface is used everywhere else
even though -interface is the same as -iface.
OK jmc@

15 months later, there is still no mpls(4) man page: .Xr mpls 4 -> MPLS

Add '-label' to specify that you only want to see routes having the
given label. No change to existing functionality.

ok henning@ claudio@

First shot at making this manual page not look like a black sheep. Been
looking at it with claudio since I started doing more routing stuff.

be a little more specific about -ifp; from Doran Mori

Add the new exec command to run a process and its children in a
non-default rdomain/rtable. route will change the default rdomain
using the new setrdomain() syscall and execute the supplied command,
eg. "route -T1 exec /usr/sbin/named".

Tested by many including michele@, phessler@
ok claudio@, deraadt@

tweak previous;

Lies. We no longer support this magic netmask at the end of the line
compatibility.

Document how to add static MPLS labels.

input jmc@, ok claudio@

Make it possible to filter monitor output on AF or show only interface
specific changes. OK henning@

Make route flush more powerful by allowing -iface/-interface or -priority
to be specified. So only routes matching these conditions will be flushed.
This will help making dhclient less dumb when fiddeling with routes.
OK henning@

Document -priority. looks good norby@

remove IPX, agreed by many
libc and kernel side awaiting a libc major bump to piggyback to

convert to new .Dd format;

Instead of using the global -F flag that only works with show, switch to a
show specific modifier -gateway to show only routes whose gateway are in the
same AF as the destination.
Requested by deraadt@, OK pyr@, reyk@, michele@

add -F to SYNOPSIS;

Add a new flag -F to netstat restricting route display in conjuction
with -r to routes in the same address family as the destination.
ok henning@, claudio@

add an EXAMPLES section;

from mark lumsden via otto, tidied up somewhat by myself;
ok otto claudio

reference ripd(8) vs. routed(8) and remove routed statement in BUGS
that no longer applies because it is not referenced. ok claudio@ jmc@

tweak; ok henning

add -T to synopsis;

-T in synopsis and briefly in manpage

More details on multipath.

ok henning + style suggestions from jmc

document -encap. ok claudio@

mention ospfd as well

remove ccitt x.25 traces, ok theo

update to reality
- fix syntax usage
- remove source routing stuff
- mention bgpd
- document -t, -genmask (from FreeBSD), and -label
- move -rtt, -rttvar, -recvpipe ... into HISTORY
- remove ISO mention
mdoc fixes
sort list of and add syntax usage for sub-commands
list supported address families in a separate table
consistency and reorganizational fixes
elaborate on some topics (some from NetBSD)
punctuation, grammar, and rewording fixes
add some FILES and cross-refs

requested by, help, and ok henning
help and ok jmc

-src/-srcmask are no more

remove references to removed pages: clnp(4), esis(4), and iso(4);

- repair examples which i damaged in previous commit
- tidy up DIAGNOSTICS, and use -diag
- wording

from jared yanovich;

grammar, formatting, consistency, spelling, etc. from jared yanovich;

grammar;

remove netiso and netns code

require RTF_MPATH to enter a multipath route with RTM_ADD.
route(8) takes a new -mpath modifier to enter a multipath route.
requested deraadt@, ok itojun@ mcbride@ millert@

Make this better reflect reality; OK and with help from Cedric

- wording
- simplify some displays

add new "-src" and "-srcmask" modifiers to make it possible to add a source
selector part to the routing table entry. complements existing "-dst" and
"-dstmask". typical use:

route add -src 20.20.20.22 20.20.20.21
route add -src 192.168.1.0/24 -dst 192.168.2.0/24 20.20.20.21

useful for example to implement symetrical routing on multihomed boxes,
or to better select which packets to send to gif/tun/... tunnels.
new '-S' flag similar to netstat one. ok deraadt@ mcbride@

add references to /etc/mygate in FILES and SEE ALSO;
from Han Boetes.

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.

typos;

raidctl(8) ok millert@
mknetid(8) help maja@

support IPv4 in -prefixlen.

document "default" argument

Don't show or delete IPsec flows with the route command -- this was a
kludge to begin with, and it's about time we get rid of it.

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.

Mostly punctuation fixes.

Trailing whitespace begone!

Remove hard sentence breaks, and some other cleanup along the way.

Suffix "i.e." and "e.g." with a comma. Just another really picky man page
commit, as we want our documentation to be as consistently formatted as
possible (it's getting there :-)).

ipv6 support from KAME (needs no libc upgrade). regen keywords.[ch].

Modified 'route flush' default behaviour to skip '-encap' (PF_KEY) flows,
as deleting these will leave the SPIs behind. 'route flush -encap' will
still delete the flows. 'ipsecadm' should do this, and properly.

PF_KEY/AF_KEY nitpick. Sync man page. Add ref to ipsecadm(1).

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

grammar police: do not hyphenate compound words that act as adjectives if the
first word ends in -ly

i.e., fully-qualified, newly-created, globally-visible, etc. are wrong

fix Xr; msfriedl@fau.de

clean; form

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net

kill redundant .Nm macro arguments; other misc fixes

more `` '' -> .Dq sillyness; remove redundant .Pp macros; other misc fixes

alphabetize SEE ALSO entries and order them numerically according to section

sbin/ man page fixes

document -d

Added -encap flag for flushing, added a missing break; in flushing X25
entries.

allow syntax of the form "route add -net 192.168.64.0/20 <destaddr>";
phk@freebsd, man page changes done by me 'cause i'm a bit bored

merge netbsd changes for show command
yet more buf oflows (provided by netbsd!)
an attempt at 64 bit cleanliness
-Wall

ipx.

update rcsid

branches: 1.1.1;
Initial revision

Markup route flags to get tags

":tM" to jump to the definition of RTF_MODIFIED is easier and faster than
manually navigating there.

OK schwarze

sourceaddr:

- show that -ifp and "address" do not mix
- show how to reset value (from claudio)
- tweak text

ok claudio

tweak sourceaddr:

- remove "-inet|-inet6" as it is not generally meaningful
- remove the qualifier "if set": sourceaddr now works nicely in cases
where no "address is given

restore tags for commands lost in r1.112 restructuring; OK jmc

mpls gateway clarification; from claudio

namservers -> nameservers

restructure the page into one single list for all routing commands;
while there, whack anything either out of date or not useful

joint work with claudio

some nameserver proposal bits:

unwind.8: point to resolvd(8) for autoconf sources
unwind.conf.5: order preferred list by order of preference
resolvd.8: reformat to read better
route.8: no need to discuss unwind in the nameserver command
umb.4 + sppp.4: note the sending of nameserver proposals

the umb/sppp text is from claudio
tobhe confirmed iked sending proposals when configured to do so

much assistance and ok: florian claudio

Typofix -ssthresh in HISTORY

Denote multiple arguments with 'arg ...' not 'args'

A few programs used the plural in their synopsis which doesn't read as
clear as the obvious triple-dot notation.

mdoc(7) .Ar defaults to "file ..." if no arguments are given and consistent
use of 'arg ...' matches that behaviour.

Cleanup a few markups of the same argument so the text keeps reading
naturally; omit unhelpful parts like 'if optional arguments are given,
they are passed along' for tools like time(1) and timeout(1) that obviously
execute commands with whatever arguments where given -- just like doas(1)
which doesn't mention arguments in its DESCRIPTION in the first place.

For expr(1) the difference between 'expressions' and 'expression ...' is
crucial, as arguments must be passed as individual words.

Feedback millert jmc schwarze deraadt
OK jmc

it seems we made a separate list for the two sourceaddr commands,
just to remove some vertical spacing; that is unfortunate
because when i adjusted the list spacing it did not affect this second
list, and logically it is one list (route commands) not two;

resolve this by having one -compact list, and inserting Pp between list items
where needed;

move the flag mappings displayed by "route show" from netstat(1) to route(8):
diff from paul tagliamonte, who was surprised to find them not documented
in route(8);

claudio agreed placement was not ideal;
deraadt confirmed users better served by route(8) than netstat(1);

i've tweaked some of the spacing and text so it displays better,
and removed some macros incorrectly associated with the "nameserver"
list item, which was messing up the formatting. should display better
now

fix vertical spacing in previous

add an example for adding a cloning host route to reach a gateway which is
outside the subnet, some hosting providers use this. info from Eric JACQUOT
ok florian kn phessler

Mention id(1) -R, reference rtable(4) in route(8)

Fix "ps -o rtable" example description while here.

Initial idea to mention id -R in route(8) from sthen
Feedback OK sthen

man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@

Generalise "nameserver" workings

The generated route message is not at all resolvd(8) specific.
Mention how unwind(8) reacts to proposals as well.

"Broadcast" wording deraadt jmc
OK millert

Make ":tdelete" work

r1.91 added tags for all commands, but "del[ete]" is special in that
mandoc(1) will generate a tag for "del" only.

Add an explicit for the full command to fix this.

Clarify how dns proposals are replaced not added per interface

OK benno

nameserver command requires an interface argument

for nameserver usage, show multiple addresses as "address ..."; ok benno
while here, Pa->Xr for resolv.conf;

sort the new nameserver text; rework it a little; sort SEE ALSO;

Add a new 'nameserver' command to route(8).
It sends nameserver proposals to resolvd(8) using the dns proposal
protocol over the route socket. Based on a seperate program
written by florian@. deraadt noticed some whitespace issues.
more fixes and ok florian@

add three missing .Dv macros,
and move punctuation out of two that are already there

Rework source IP address setting.

- Move most of the processing out of rtable.c (reasonnable tb@, ok bluhm@)
- Remove memory allocation, store pointer to existing ifaddr
- Fix tunnel interface handling

looks fine mpi@

Source address set can be printed

Add feature to force the selection of source IP address

Based/previous work on an idea from deraadt@
Input from claudio@, djm@, deraadt@, sthen@

OK deraadt@

add some explicit tagging macros; OK kn@ on a previous version

elaborate a little on how route priorities work;
help/ok claudio

signpost the location of the text explaining routing table output a little better...

Document that route monitor also takes -T rtable as an argument.

Use "rtable" not "tableid" as argument name for rtable

Make rtable(4) usage documentation consistent with other programs.
This is to have `man -k ar~rtable' show the full list without having to
look for other variations of the same argument type.

OK bluhm

Kill fluff about how route(8) is of limited usefulness

Don't say that route(8) is mostly useful to set up a default route,
which is almost a lie. What's more, I'm not sure new users struggling
with route(8) should be pointed to ripd(8) (sic) or bgpd(8) as
a solution to their problems. ok benno@ kn@

* simplify code by no longer calling getnetbyname(3)
* avoid double lookups for unresolvable names without -net
* more fitting error message for unresolvable names after -net
OK florian@

remove references to /etc/networks; reminded by jmc@

backout previous diff:
autodetect AF when setting inet6 default route
From Denis Fondras, thanks!
ok phessler@ bluhm@
it breaks with ipv6 link-local routes, e.g.
/sbin/route -inet6 default -ifp pppoe0 fe80::%pppoe0
found by jmc@
ok florian

new sentence, new line;

document use of del as short form for delete, from jca
ok schwarze@

autodetect AF when setting inet6 default route
From Denis Fondras, thanks!
ok phessler@ bluhm@

Hyphenate compound adjectives 'up-to-date', 'out-of-date' and 'well-known'
if they precede the noun and omit hyphens otherwise.

ok tj

Remove RTF_XRESOLVE support.

On systems with a full routing table (550k+), we often want to be able to
look at the routes with a priority, or to display all routes that do not
have a specific priority (normally, don't show bgp).

We are intentionally not updating netstat -r yet, as we do not have a
good flag to use.

first version from, and OK benno@

nope, ioctl has not been used for a while

Document that priority 1 is reserved for kernel use.

Remove route/netstat -f encap in favor of ipsecctl -s flow.

OK deraadt@

Try to be more precise about rtable and rdomains.

Remove genmask support from route(8). It still will show them in monitor
or get but you can no longer set it. genmask will die soon since nobody
needs it. OK benno@ and agreed by dlg@

autodetect ipv6 addresses for route(8). ok benno@ bluhm@, manpage help jmc@

allow destination/prefixlen syntax for ipv6 routes.
from Florian Obser, florian -AT- narrans -DOT- de

ok sthen@

make -column lists pretty again;

specifically, rewrite them to permit some markup in the column headers,
and use "Ta" instead of literal tabs; mandoc does not currently match groff
100%, but a mandoc fix may be some time off, and we've gone enough releases
with poorly formatting column lists.

in some cases i have rewritten the lists as -tag, where -column made
little sense.

kill a useless Pp;

Flip one .Fl interface to .Fl iface since iface is used everywhere else
even though -interface is the same as -iface.
OK jmc@

15 months later, there is still no mpls(4) man page: .Xr mpls 4 -> MPLS

Add '-label' to specify that you only want to see routes having the
given label. No change to existing functionality.

ok henning@ claudio@

First shot at making this manual page not look like a black sheep. Been
looking at it with claudio since I started doing more routing stuff.

be a little more specific about -ifp; from Doran Mori

Add the new exec command to run a process and its children in a
non-default rdomain/rtable. route will change the default rdomain
using the new setrdomain() syscall and execute the supplied command,
eg. "route -T1 exec /usr/sbin/named".

Tested by many including michele@, phessler@
ok claudio@, deraadt@

tweak previous;

Lies. We no longer support this magic netmask at the end of the line
compatibility.

Document how to add static MPLS labels.

input jmc@, ok claudio@

Make it possible to filter monitor output on AF or show only interface
specific changes. OK henning@

Make route flush more powerful by allowing -iface/-interface or -priority
to be specified. So only routes matching these conditions will be flushed.
This will help making dhclient less dumb when fiddeling with routes.
OK henning@

Document -priority. looks good norby@

remove IPX, agreed by many
libc and kernel side awaiting a libc major bump to piggyback to

convert to new .Dd format;

Instead of using the global -F flag that only works with show, switch to a
show specific modifier -gateway to show only routes whose gateway are in the
same AF as the destination.
Requested by deraadt@, OK pyr@, reyk@, michele@

add -F to SYNOPSIS;

Add a new flag -F to netstat restricting route display in conjuction
with -r to routes in the same address family as the destination.
ok henning@, claudio@

add an EXAMPLES section;

from mark lumsden via otto, tidied up somewhat by myself;
ok otto claudio

reference ripd(8) vs. routed(8) and remove routed statement in BUGS
that no longer applies because it is not referenced. ok claudio@ jmc@

tweak; ok henning

add -T to synopsis;

-T in synopsis and briefly in manpage

More details on multipath.

ok henning + style suggestions from jmc

document -encap. ok claudio@

mention ospfd as well

remove ccitt x.25 traces, ok theo

update to reality
- fix syntax usage
- remove source routing stuff
- mention bgpd
- document -t, -genmask (from FreeBSD), and -label
- move -rtt, -rttvar, -recvpipe ... into HISTORY
- remove ISO mention
mdoc fixes
sort list of and add syntax usage for sub-commands
list supported address families in a separate table
consistency and reorganizational fixes
elaborate on some topics (some from NetBSD)
punctuation, grammar, and rewording fixes
add some FILES and cross-refs

requested by, help, and ok henning
help and ok jmc

-src/-srcmask are no more

remove references to removed pages: clnp(4), esis(4), and iso(4);

- repair examples which i damaged in previous commit
- tidy up DIAGNOSTICS, and use -diag
- wording

from jared yanovich;

grammar, formatting, consistency, spelling, etc. from jared yanovich;

grammar;

remove netiso and netns code

require RTF_MPATH to enter a multipath route with RTM_ADD.
route(8) takes a new -mpath modifier to enter a multipath route.
requested deraadt@, ok itojun@ mcbride@ millert@

Make this better reflect reality; OK and with help from Cedric

- wording
- simplify some displays

add new "-src" and "-srcmask" modifiers to make it possible to add a source
selector part to the routing table entry. complements existing "-dst" and
"-dstmask". typical use:

route add -src 20.20.20.22 20.20.20.21
route add -src 192.168.1.0/24 -dst 192.168.2.0/24 20.20.20.21

useful for example to implement symetrical routing on multihomed boxes,
or to better select which packets to send to gif/tun/... tunnels.
new '-S' flag similar to netstat one. ok deraadt@ mcbride@

add references to /etc/mygate in FILES and SEE ALSO;
from Han Boetes.

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.

typos;

raidctl(8) ok millert@
mknetid(8) help maja@

support IPv4 in -prefixlen.

document "default" argument

Don't show or delete IPsec flows with the route command -- this was a
kludge to begin with, and it's about time we get rid of it.

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.

Mostly punctuation fixes.

Trailing whitespace begone!

Remove hard sentence breaks, and some other cleanup along the way.

Suffix "i.e." and "e.g." with a comma. Just another really picky man page
commit, as we want our documentation to be as consistently formatted as
possible (it's getting there :-)).

ipv6 support from KAME (needs no libc upgrade). regen keywords.[ch].

Modified 'route flush' default behaviour to skip '-encap' (PF_KEY) flows,
as deleting these will leave the SPIs behind. 'route flush -encap' will
still delete the flows. 'ipsecadm' should do this, and properly.

PF_KEY/AF_KEY nitpick. Sync man page. Add ref to ipsecadm(1).

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

grammar police: do not hyphenate compound words that act as adjectives if the
first word ends in -ly

i.e., fully-qualified, newly-created, globally-visible, etc. are wrong

fix Xr; msfriedl@fau.de

clean; form

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net

kill redundant .Nm macro arguments; other misc fixes

more `` '' -> .Dq sillyness; remove redundant .Pp macros; other misc fixes

alphabetize SEE ALSO entries and order them numerically according to section

sbin/ man page fixes

document -d

Added -encap flag for flushing, added a missing break; in flushing X25
entries.

allow syntax of the form "route add -net 192.168.64.0/20 <destaddr>";
phk@freebsd, man page changes done by me 'cause i'm a bit bored

merge netbsd changes for show command
yet more buf oflows (provided by netbsd!)
an attempt at 64 bit cleanliness
-Wall

ipx.

update rcsid

branches: 1.1.1;
Initial revision

tweak sourceaddr:

- remove "-inet|-inet6" as it is not generally meaningful
- remove the qualifier "if set": sourceaddr now works nicely in cases
where no "address is given

restore tags for commands lost in r1.112 restructuring; OK jmc

mpls gateway clarification; from claudio

namservers -> nameservers

restructure the page into one single list for all routing commands;
while there, whack anything either out of date or not useful

joint work with claudio

some nameserver proposal bits:

unwind.8: point to resolvd(8) for autoconf sources
unwind.conf.5: order preferred list by order of preference
resolvd.8: reformat to read better
route.8: no need to discuss unwind in the nameserver command
umb.4 + sppp.4: note the sending of nameserver proposals

the umb/sppp text is from claudio
tobhe confirmed iked sending proposals when configured to do so

much assistance and ok: florian claudio

Typofix -ssthresh in HISTORY

Denote multiple arguments with 'arg ...' not 'args'

A few programs used the plural in their synopsis which doesn't read as
clear as the obvious triple-dot notation.

mdoc(7) .Ar defaults to "file ..." if no arguments are given and consistent
use of 'arg ...' matches that behaviour.

Cleanup a few markups of the same argument so the text keeps reading
naturally; omit unhelpful parts like 'if optional arguments are given,
they are passed along' for tools like time(1) and timeout(1) that obviously
execute commands with whatever arguments where given -- just like doas(1)
which doesn't mention arguments in its DESCRIPTION in the first place.

For expr(1) the difference between 'expressions' and 'expression ...' is
crucial, as arguments must be passed as individual words.

Feedback millert jmc schwarze deraadt
OK jmc

it seems we made a separate list for the two sourceaddr commands,
just to remove some vertical spacing; that is unfortunate
because when i adjusted the list spacing it did not affect this second
list, and logically it is one list (route commands) not two;

resolve this by having one -compact list, and inserting Pp between list items
where needed;

move the flag mappings displayed by "route show" from netstat(1) to route(8):
diff from paul tagliamonte, who was surprised to find them not documented
in route(8);

claudio agreed placement was not ideal;
deraadt confirmed users better served by route(8) than netstat(1);

i've tweaked some of the spacing and text so it displays better,
and removed some macros incorrectly associated with the "nameserver"
list item, which was messing up the formatting. should display better
now

fix vertical spacing in previous

add an example for adding a cloning host route to reach a gateway which is
outside the subnet, some hosting providers use this. info from Eric JACQUOT
ok florian kn phessler

Mention id(1) -R, reference rtable(4) in route(8)

Fix "ps -o rtable" example description while here.

Initial idea to mention id -R in route(8) from sthen
Feedback OK sthen

man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@

Generalise "nameserver" workings

The generated route message is not at all resolvd(8) specific.
Mention how unwind(8) reacts to proposals as well.

"Broadcast" wording deraadt jmc
OK millert

Make ":tdelete" work

r1.91 added tags for all commands, but "del[ete]" is special in that
mandoc(1) will generate a tag for "del" only.

Add an explicit for the full command to fix this.

Clarify how dns proposals are replaced not added per interface

OK benno

nameserver command requires an interface argument

for nameserver usage, show multiple addresses as "address ..."; ok benno
while here, Pa->Xr for resolv.conf;

sort the new nameserver text; rework it a little; sort SEE ALSO;

Add a new 'nameserver' command to route(8).
It sends nameserver proposals to resolvd(8) using the dns proposal
protocol over the route socket. Based on a seperate program
written by florian@. deraadt noticed some whitespace issues.
more fixes and ok florian@

add three missing .Dv macros,
and move punctuation out of two that are already there

Rework source IP address setting.

- Move most of the processing out of rtable.c (reasonnable tb@, ok bluhm@)
- Remove memory allocation, store pointer to existing ifaddr
- Fix tunnel interface handling

looks fine mpi@

Source address set can be printed

Add feature to force the selection of source IP address

Based/previous work on an idea from deraadt@
Input from claudio@, djm@, deraadt@, sthen@

OK deraadt@

add some explicit tagging macros; OK kn@ on a previous version

elaborate a little on how route priorities work;
help/ok claudio

signpost the location of the text explaining routing table output a little better...

Document that route monitor also takes -T rtable as an argument.

Use "rtable" not "tableid" as argument name for rtable

Make rtable(4) usage documentation consistent with other programs.
This is to have `man -k ar~rtable' show the full list without having to
look for other variations of the same argument type.

OK bluhm

Kill fluff about how route(8) is of limited usefulness

Don't say that route(8) is mostly useful to set up a default route,
which is almost a lie. What's more, I'm not sure new users struggling
with route(8) should be pointed to ripd(8) (sic) or bgpd(8) as
a solution to their problems. ok benno@ kn@

* simplify code by no longer calling getnetbyname(3)
* avoid double lookups for unresolvable names without -net
* more fitting error message for unresolvable names after -net
OK florian@

remove references to /etc/networks; reminded by jmc@

backout previous diff:
autodetect AF when setting inet6 default route
From Denis Fondras, thanks!
ok phessler@ bluhm@
it breaks with ipv6 link-local routes, e.g.
/sbin/route -inet6 default -ifp pppoe0 fe80::%pppoe0
found by jmc@
ok florian

new sentence, new line;

document use of del as short form for delete, from jca
ok schwarze@

autodetect AF when setting inet6 default route
From Denis Fondras, thanks!
ok phessler@ bluhm@

Hyphenate compound adjectives 'up-to-date', 'out-of-date' and 'well-known'
if they precede the noun and omit hyphens otherwise.

ok tj

Remove RTF_XRESOLVE support.

On systems with a full routing table (550k+), we often want to be able to
look at the routes with a priority, or to display all routes that do not
have a specific priority (normally, don't show bgp).

We are intentionally not updating netstat -r yet, as we do not have a
good flag to use.

first version from, and OK benno@

nope, ioctl has not been used for a while

Document that priority 1 is reserved for kernel use.

Remove route/netstat -f encap in favor of ipsecctl -s flow.

OK deraadt@

Try to be more precise about rtable and rdomains.

Remove genmask support from route(8). It still will show them in monitor
or get but you can no longer set it. genmask will die soon since nobody
needs it. OK benno@ and agreed by dlg@

autodetect ipv6 addresses for route(8). ok benno@ bluhm@, manpage help jmc@

allow destination/prefixlen syntax for ipv6 routes.
from Florian Obser, florian -AT- narrans -DOT- de

ok sthen@

make -column lists pretty again;

specifically, rewrite them to permit some markup in the column headers,
and use "Ta" instead of literal tabs; mandoc does not currently match groff
100%, but a mandoc fix may be some time off, and we've gone enough releases
with poorly formatting column lists.

in some cases i have rewritten the lists as -tag, where -column made
little sense.

kill a useless Pp;

Flip one .Fl interface to .Fl iface since iface is used everywhere else
even though -interface is the same as -iface.
OK jmc@

15 months later, there is still no mpls(4) man page: .Xr mpls 4 -> MPLS

Add '-label' to specify that you only want to see routes having the
given label. No change to existing functionality.

ok henning@ claudio@

First shot at making this manual page not look like a black sheep. Been
looking at it with claudio since I started doing more routing stuff.

be a little more specific about -ifp; from Doran Mori

Add the new exec command to run a process and its children in a
non-default rdomain/rtable. route will change the default rdomain
using the new setrdomain() syscall and execute the supplied command,
eg. "route -T1 exec /usr/sbin/named".

Tested by many including michele@, phessler@
ok claudio@, deraadt@

tweak previous;

Lies. We no longer support this magic netmask at the end of the line
compatibility.

Document how to add static MPLS labels.

input jmc@, ok claudio@

Make it possible to filter monitor output on AF or show only interface
specific changes. OK henning@

Make route flush more powerful by allowing -iface/-interface or -priority
to be specified. So only routes matching these conditions will be flushed.
This will help making dhclient less dumb when fiddeling with routes.
OK henning@

Document -priority. looks good norby@

remove IPX, agreed by many
libc and kernel side awaiting a libc major bump to piggyback to

convert to new .Dd format;

Instead of using the global -F flag that only works with show, switch to a
show specific modifier -gateway to show only routes whose gateway are in the
same AF as the destination.
Requested by deraadt@, OK pyr@, reyk@, michele@

add -F to SYNOPSIS;

Add a new flag -F to netstat restricting route display in conjuction
with -r to routes in the same address family as the destination.
ok henning@, claudio@

add an EXAMPLES section;

from mark lumsden via otto, tidied up somewhat by myself;
ok otto claudio

reference ripd(8) vs. routed(8) and remove routed statement in BUGS
that no longer applies because it is not referenced. ok claudio@ jmc@

tweak; ok henning

add -T to synopsis;

-T in synopsis and briefly in manpage

More details on multipath.

ok henning + style suggestions from jmc

document -encap. ok claudio@

mention ospfd as well

remove ccitt x.25 traces, ok theo

update to reality
- fix syntax usage
- remove source routing stuff
- mention bgpd
- document -t, -genmask (from FreeBSD), and -label
- move -rtt, -rttvar, -recvpipe ... into HISTORY
- remove ISO mention
mdoc fixes
sort list of and add syntax usage for sub-commands
list supported address families in a separate table
consistency and reorganizational fixes
elaborate on some topics (some from NetBSD)
punctuation, grammar, and rewording fixes
add some FILES and cross-refs

requested by, help, and ok henning
help and ok jmc

-src/-srcmask are no more

remove references to removed pages: clnp(4), esis(4), and iso(4);

- repair examples which i damaged in previous commit
- tidy up DIAGNOSTICS, and use -diag
- wording

from jared yanovich;

grammar, formatting, consistency, spelling, etc. from jared yanovich;

grammar;

remove netiso and netns code

require RTF_MPATH to enter a multipath route with RTM_ADD.
route(8) takes a new -mpath modifier to enter a multipath route.
requested deraadt@, ok itojun@ mcbride@ millert@

Make this better reflect reality; OK and with help from Cedric

- wording
- simplify some displays

add new "-src" and "-srcmask" modifiers to make it possible to add a source
selector part to the routing table entry. complements existing "-dst" and
"-dstmask". typical use:

route add -src 20.20.20.22 20.20.20.21
route add -src 192.168.1.0/24 -dst 192.168.2.0/24 20.20.20.21

useful for example to implement symetrical routing on multihomed boxes,
or to better select which packets to send to gif/tun/... tunnels.
new '-S' flag similar to netstat one. ok deraadt@ mcbride@

add references to /etc/mygate in FILES and SEE ALSO;
from Han Boetes.

Remove the advertising clause in the UCB license which Berkeley
rescinded 22 July 1999. Proofed by myself and Theo.

typos;

raidctl(8) ok millert@
mknetid(8) help maja@

support IPv4 in -prefixlen.

document "default" argument

Don't show or delete IPsec flows with the route command -- this was a
kludge to begin with, and it's about time we get rid of it.

- For consistency, `super-user' -> `superuser' in all cases.
- Some punctuation fixes.
- Some `id' -> `ID'.

Mostly punctuation fixes.

Trailing whitespace begone!

Remove hard sentence breaks, and some other cleanup along the way.

Suffix "i.e." and "e.g." with a comma. Just another really picky man page
commit, as we want our documentation to be as consistently formatted as
possible (it's getting there :-)).

ipv6 support from KAME (needs no libc upgrade). regen keywords.[ch].

Modified 'route flush' default behaviour to skip '-encap' (PF_KEY) flows,
as deleting these will leave the SPIs behind. 'route flush -encap' will
still delete the flows. 'ipsecadm' should do this, and properly.

PF_KEY/AF_KEY nitpick. Sync man page. Add ref to ipsecadm(1).

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com

grammar police: do not hyphenate compound words that act as adjectives if the
first word ends in -ly

i.e., fully-qualified, newly-created, globally-visible, etc. are wrong

fix Xr; msfriedl@fau.de

clean; form

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net

kill redundant .Nm macro arguments; other misc fixes

more `` '' -> .Dq sillyness; remove redundant .Pp macros; other misc fixes

alphabetize SEE ALSO entries and order them numerically according to section

sbin/ man page fixes

document -d

Added -encap flag for flushing, added a missing break; in flushing X25
entries.

allow syntax of the form "route add -net 192.168.64.0/20 <destaddr>";
phk@freebsd, man page changes done by me 'cause i'm a bit bored

merge netbsd changes for show command
yet more buf oflows (provided by netbsd!)
an attempt at 64 bit cleanliness
-Wall

ipx.

update rcsid

branches: 1.1.1;
Initial revision

restore tags for commands lost in r1.112 restructuring; OK jmc

mpls gateway clarification; from claudio

namservers -> nameservers

restructure the page into one single list for all routing commands;
while there, whack anything either out of date or not useful

joint work with claudio

some nameserver proposal bits:

unwind.8: point to resolvd(8) for autoconf sources
unwind.conf.5: order preferred list by order of preference
resolvd.8: reformat to read better
route.8: no need to discuss unwind in the nameserver command
umb.4 + sppp.4: note the sending of nameserver proposals

the umb/sppp text is from claudio
tobhe confirmed iked sending proposals when configured to do so

much assistance and ok: florian claudio

Typofix -ssthresh in HISTORY

Denote multiple arguments with 'arg ...' not 'args'

A few programs used the plural in their synopsis which doesn't read as
clear as the obvious triple-dot notation.

mdoc(7) .Ar defaults to "file ..." if no arguments are given and consistent
use of 'arg ...' matches that behaviour.

Cleanup a few markups of the same argument so the text keeps reading
naturally; omit unhelpful parts like 'if optional arguments are given,
they are passed along' for tools like time(1) and timeout(1) that obviously
execute commands with whatever arguments where given -- just like doas(1)
which doesn't mention arguments in its DESCRIPTION in the first place.

For expr(1) the difference between 'expressions' and 'expression ...' is
crucial, as arguments must be passed as individual words.

Feedback millert jmc schwarze deraadt
OK jmc

it seems we made a separate list for the two sourceaddr commands,
just to remove some vertical spacing; that is unfortunate
because when i adjusted the list spacing it did not affect this second
list, and logically it is one list (route commands) not two;

resolve this by having one -compact list, and inserting Pp between list items
where needed;

move the flag mappings displayed by "route show" from netstat(1) to route(8):
diff from paul tagliamonte, who was surprised to find them not documented
in route(8);

claudio agreed placement was not ideal;
deraadt confirmed users better served by route(8) than netstat(1);

i've tweaked some of the spacing and text so it displays better,
and removed some macros incorrectly associated with the "nameserver"
list item, which was messing up the formatting. should display better
now

fix vertical spacing in previous

add an example for adding a cloning host route to reach a gateway which is
outside the subnet, some hosting providers use this. info from Eric JACQUOT
ok florian kn phessler

Mention id(1) -R, reference rtable(4) in route(8)

Fix "ps -o rtable" example description while here.

Initial idea to mention id -R in route(8) from sthen
Feedback OK sthen

man pages: add missing commas between subordinate and main clauses

jmc@ dislikes a comma before "then" in a conditional, so leave those
untouched.

ok jmc@

Generalise "nameserver" workings

The generated route message is not at all resolvd(8) specific.
Mention how unwind(8) reacts to proposals as well.

"Broadcast" wording deraadt jmc
OK millert

Make ":tdelete" work

r1.91 added tags for all commands, but "del[ete]" is special in that
mandoc(1) will generate a tag for "del" only.

Add an explicit for the full command to fix this.

Clarify how dns proposals are replaced not added per interface

OK benno

nameserver command requires an interface argument

for nameserver usage, show multiple addresses as "address ..."; ok benno
while here, Pa->Xr for resolv.conf;

sort the new nameserver text; rework it a little; sort SEE ALSO;

Add a new 'nameserver' command to route(8).
It sends nameserver proposals to resolvd(8) using the dns proposal
protocol over the route socket. Based on a seperate program
written by florian@. deraadt noticed some whitespace issues.
more fixes and ok florian@

add three missing .Dv macros,
and move punctuation out of two that are already there

Rework source IP address setting.

- Move most of the processing out of rtable.c (reasonnable tb@, ok bluhm@)
- Remove memory allocation, store pointer to existing ifaddr
- Fix tunnel interface handling

looks fine mpi@

Source address set can be printed

Add feature to force the selection of source IP address

Based/previous work on an idea from deraadt@
Input from claudio@, djm@, deraadt@, sthen@

OK deraadt@

add some explicit tagging macros; OK kn@ on a previous version

elaborate a little on how route priorities work;
help/ok claudio

signpost the location of the text explaining routing table output a little better...

Document that route monitor also takes -T rtable as an argument.

Use "rtable" not "tableid" as argument name for rtable

Make rtable(4) usage documentation consistent with other programs.
This is to have `man -k ar~rtable' show the full list without having to
look for other variations of the same argument type.

OK bluhm

Kill fluff about how route(8) is of limited usefulness

Don't say that route(8) is mostly useful to set up a default route,
which is almost a lie. What's more, I'm not sure new users struggling
with route(8) should be pointed to ripd(8) (sic) or bgpd(8) as
a solution to their problems. ok benno@ kn@

* simplify code by no longer calling getnetbyname(3)
* avoid double lookups for unresolvable names without -net
* more fitting error message for unresolvable names after -net
OK florian@

remove references to /etc/networks; reminded by jmc@

backout previous diff:
autodetect AF when setting inet6 default route
From Denis Fondras, thanks!
ok phessler@ bluhm@
it breaks with ipv6 link-local routes, e.g.
/sbin/route -inet6 default -ifp pppoe0 fe80::%pppoe0
found by jmc@
ok florian

new sentence, new line;

document use of del as short form for delete, from jca
ok schwarze@

autodetect AF when setting inet6 default route
From Denis Fondras, thanks!
ok phessler@ bluhm@

Hyphenate compound adjectives 'up-to-date', 'out-of-date' and 'well-known'
if they precede the noun and omit hyphens otherwise.

ok tj

Remove RTF_XRESOLVE support.

On systems with a full routing table (550k+), we often want to be able to
look at the routes with a priority, or to display all routes that do not
have a specific priority (normally, don't show bgp).

We are intentionally not updating netstat -r yet, as we do not have a
good flag to use.

first version from, and OK benno@

nope, ioctl has not been used for a while

Document that priority 1 is reserved for kernel use.

Remove route/netstat -f encap in favor of ipsecctl -s flow.

OK deraadt@

Try to be more precise about rtable and rdomains.

Remove genmask support from route(8). It still will show them in monitor
or get but you can no longer set it. genmask will die soon since nobody
needs it. OK benno@ and agreed by dlg@

autodetect ipv6 addresses for route(8). ok benno@ bluhm@, manpage help jmc@

allow destination/prefixlen syntax for ipv6 routes.
from Florian Obser, florian -AT- narrans -DOT- de

ok sthen@

make -column lists pretty again;

specifically, rewrite them to permit some markup in the column headers,
and use "Ta" instead of literal tabs; mandoc does not currently match groff
100%, but a mandoc fix may be some time off, and we've gone enough releases
with poorly formatting column lists.

in some cases i have rewritten the lists as -tag, where -column made
little sense.

kill a useless Pp;

Flip one .Fl interface to .Fl iface since iface is used everywhere else
even though -interface is the same as -iface.
OK jmc@

15 months later, there is still no mpls(4) man page: .Xr mpls 4 -> MPLS

Add '-label' to specify that you only want to see routes having the
given label. No change to existing functionality.

ok henning@ claudio@

First shot at making this manual page not look like a black sheep. Been
looking at it with claudio since I started doing more routing stuff.

be a little more specific about -ifp; from Doran Mori

Add the new exec command to run a process and its children in a
non-default rdomain/rtable. route will change the default rdomain
using the new setrdomain() syscall and execute the supplied command,
eg. "route -T1 exec /usr/sbin/named".

Tested by many including michele@, phessler@
ok claudio@, deraadt@

tweak previous;

Lies. We no longer support this magic netmask at the end of the line
compatibility.

Document how to add static MPLS labels.

input jmc@, ok claudio@

Make it possible to filter monitor output on AF or show only interface
specific changes. OK henning@

Make route flush more powerful by allowing -iface/-interface or -priority
to be specified. So only routes matching these conditions will be flushed.
This will help making dhclient less dumb when fiddeling with routes.
OK henning@

Document -priority. looks good norby@

remove IPX, agreed by many
libc and kernel side awaiting a libc major bump to piggyback to

convert to new .Dd format;

Instead of using the global -F flag that only works with show, switch to a
show specific modifier -gateway to show only routes whose gateway are in the
same AF as the destination.
Requested by deraadt@, OK pyr@, reyk@, michele@

add -F to SYNOPSIS;

Add a new flag -F to netstat restricting route display in conjuction
with -r to routes in the same address family as the destination.
ok henning@, claudio@

add an EXAMPLES section;

from mark lumsden via otto, tidied up somewhat by myself;
ok otto claudio

reference ripd(8) vs. routed(8) and remove routed statement in BUGS
that no longer applies because it is not referenced. ok claudio@ jmc@

tweak; ok henning

add -T to synopsis;

-T in synopsis and briefly in manpage

More details on multipath.

ok henning + style suggestions from jmc

document -encap. ok claudio@

mention ospfd as well

remove ccitt x.25 traces, ok theo

update to reality
- fix syntax usage
- remove source routing stuff
- mention bgpd
- document -t, -genmask (from FreeBSD), and -label
- move -rtt, -rttvar, -recvpipe ... into HISTORY
- remove ISO mention
mdoc fixes
sort list of and add syntax usage for sub-commands
list supported address families in a separate table
consistency and reorganizational fixes
elaborate on some topics (some from NetBSD)
punctuation, grammar, and rewording fixes
add some FILES and cross-refs

requested by, help, and ok henning
help and ok jmc

-src/-srcmask are no more

remove references to removed pages: clnp(4), esis(4), and iso(4);