NetBSD/sbin/routed/rtquery/rtquery.8

.\"	$NetBSD: rtquery.8,v 1.14 1999/02/23 10:47:41 christos Exp $
.\"
.Dd June 1, 1996
.Dt RTQUERY 8
.Os BSD 4.4
.Sh NAME
.Nm rtquery
.Nd query routing daemons for their routing tables
.Sh SYNOPSIS
.Nm
.Op Fl np1
.Op Fl w Ar timeout
.Op Fl r Ar addr
.Op Fl a Ar secret
.Ar host ...
.Nm ""
.Op Fl t Ar op
.Ar host ...
.Sh DESCRIPTION
.Nm
is used to query a RIP network routing daemon,
.Xr routed 8
or
.Xr gated 8 ,
for its routing table by sending a
.Em request
or
.Em poll
command.
The routing information in any routing
.Em response
packets returned is displayed numerically and symbolically.
.Pp
.Nm
by default uses the
.Em request
command.
When the
.Fl p
option is specified,
.Nm
uses the
.Em poll
command, an
undocumented extension to the RIP protocol supported by
.Xr gated 8 .
When querying
.Xr gated 8 ,
the
.Em poll
command is preferred over the
.Em request
command because the response is not subject to Split Horizon and/or
Poisoned Reverse, and because some versions of gated do not answer the
.Em request
command.
.Xr routed 8
does not answer the
.Em poll
command, but recognizes
.Em requests
coming from
.Nm
and so answers completely.
.Pp
.Nm
is also used to turn tracing on or off in
.Xr routed 8 .
.Pp
The following options are available:
.Bl -tag -width indent
.It Fl n
displays only the numeric network and host numbers instead of both
numeric and symbolic.
.It Fl p
uses the
.Em poll
command to request full routing information from
.Xr gated 8 .
This is an undocumented extension RIP protocol supported only by
.Xr gated 8 .
.It Fl 1
queries using RIP version 1 instead of RIP version 2.
.It Fl w Ar timeout
changes the delay for an answer from each host.
By default, each host is given 15 seconds to respond.
.It Fl r Ar addr
asks about the route to destination
.Em addr .
.It Fl a Ar passwd=XXX
.It Fl a Ar md5_passwd=XXX|KeyID
causes the query to be sent with the indicated cleartext or MD5 password.
.It Fl t Ar op
changes tracing, where
.Em op
is one of the following.
Requests from processes not running with UID 0 or on distant networks
are generally ignored by the daemon except for a message in the system log.
.Xr gated 8
is likely to ignore these debugging requests.
.El
.Bl -tag -width Ds -offset indent-two
.It Em on=tracefile
turns tracing on into the specified file.
That file must usually have been specified when the daemon was
started or be the same as a fixed name, often
.Pa /etc/routed.trace .
.It Em more
increases the debugging level.
.It Em off
turns off tracing.
.It Em dump
dumps the daemon's routing table to the current tracefile.
.El
.Sh SEE ALSO
.Xr routed 8 ,
.Xr gated 8
.br
RFC\ 1058 - Routing Information Protocol, RIPv1
.br
RFC\ 1723 - Routing Information Protocol, RIPv2
Resolve conflicts. 1999-02-23 13:47:39 +03:00			`.\" $NetBSD: rtquery.8,v 1.14 1999/02/23 10:47:41 christos Exp $`
- Finished up merge. - Add some prototypes and definitions for types as necessary, wrapped in __NetBSD__ to maintain portability. - Explicit size types in structures that go out the wire. - RCS id police. 1996-08-10 05:28:58 +04:00			`.\"`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.Dd June 1, 1996`
			`.Dt RTQUERY 8`
			`.Os BSD 4.4`
			`.Sh NAME`
			`.Nm rtquery`
			`.Nd query routing daemons for their routing tables`
			`.Sh SYNOPSIS`
			`.Nm`
			`.Op Fl np1`
			`.Op Fl w Ar timeout`
			`.Op Fl r Ar addr`
- resolve conflicts. - remove md5 stuff; it is in libc. - define MCAST_PPP_BUG, until we fix if_ppp.c 1997-02-04 01:02:51 +03:00			`.Op Fl a Ar secret`
			`.Ar host ...`
- Use .Nm "" instead of .Nm rtquery in SYNOPSIS. - Don't use captialized wort to refer command name. - Delete period at the end of ``SEE ALSO'' list. - Use .Xr instead of .Em to refer routed. 1997-10-11 06:55:20 +04:00			`.Nm ""`
- resolve conflicts. - remove md5 stuff; it is in libc. - define MCAST_PPP_BUG, until we fix if_ppp.c 1997-02-04 01:02:51 +03:00			`.Op Fl t Ar op`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.Ar host ...`
			`.Sh DESCRIPTION`
* cleanup for WARNS=1 * deprecate register * bcmp, bcopy, bzero, rindex -> memcmp, memmove, memset, strrchr * correct use of .Nm 1997-09-15 14:38:11 +04:00			`.Nm`
- resolve conflicts. - remove md5 stuff; it is in libc. - define MCAST_PPP_BUG, until we fix if_ppp.c 1997-02-04 01:02:51 +03:00			`is used to query a RIP network routing daemon,`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.Xr routed 8`
			`or`
			`.Xr gated 8 ,`
			`for its routing table by sending a`
			`.Em request`
			`or`
			`.Em poll`
fix bad .Xr references 1998-04-29 13:49:10 +04:00			`command.`
			`The routing information in any routing`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.Em response`
			`packets returned is displayed numerically and symbolically.`
			`.Pp`
- Use .Nm "" instead of .Nm rtquery in SYNOPSIS. - Don't use captialized wort to refer command name. - Delete period at the end of ``SEE ALSO'' list. - Use .Xr instead of .Em to refer routed. 1997-10-11 06:55:20 +04:00			`.Nm`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`by default uses the`
			`.Em request`
			`command.`
			`When the`
fix a roff command bug 1998-08-18 22:03:28 +04:00			`.Fl p`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`option is specified,`
* cleanup for WARNS=1 * deprecate register * bcmp, bcopy, bzero, rindex -> memcmp, memmove, memset, strrchr * correct use of .Nm 1997-09-15 14:38:11 +04:00			`.Nm`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`uses the`
			`.Em poll`
			`command, an`
			`undocumented extension to the RIP protocol supported by`
			`.Xr gated 8 .`
Resolve conflicts. 1999-02-23 13:47:39 +03:00			`When querying`
			`.Xr gated 8 ,`
			`the`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.Em poll`
			`command is preferred over the`
- Use .Nm "" instead of .Nm rtquery in SYNOPSIS. - Don't use captialized wort to refer command name. - Delete period at the end of ``SEE ALSO'' list. - Use .Xr instead of .Em to refer routed. 1997-10-11 06:55:20 +04:00			`.Em request`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`command because the response is not subject to Split Horizon and/or`
- Use .Nm "" instead of .Nm rtquery in SYNOPSIS. - Don't use captialized wort to refer command name. - Delete period at the end of ``SEE ALSO'' list. - Use .Xr instead of .Em to refer routed. 1997-10-11 06:55:20 +04:00			`Poisoned Reverse, and because some versions of gated do not answer the`
			`.Em request`
			`command.`
			`.Xr routed 8`
			`does not answer the`
			`.Em poll`
			`command, but recognizes`
			`.Em requests`
			`coming from`
			`.Nm`
			`and so answers completely.`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.Pp`
- Use .Nm "" instead of .Nm rtquery in SYNOPSIS. - Don't use captialized wort to refer command name. - Delete period at the end of ``SEE ALSO'' list. - Use .Xr instead of .Em to refer routed. 1997-10-11 06:55:20 +04:00			`.Nm`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`is also used to turn tracing on or off in`
- Use .Nm "" instead of .Nm rtquery in SYNOPSIS. - Don't use captialized wort to refer command name. - Delete period at the end of ``SEE ALSO'' list. - Use .Xr instead of .Em to refer routed. 1997-10-11 06:55:20 +04:00			`.Xr routed 8 .`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.Pp`
Update to 980910 from ftp.rhyolite.com 1998-10-25 17:56:06 +03:00			`The following options are available:`
			`.Bl -tag -width indent`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.It Fl n`
Update to 980910 from ftp.rhyolite.com 1998-10-25 17:56:06 +03:00			`displays only the numeric network and host numbers instead of both`
s/ and and / and / 1998-11-23 01:27:32 +03:00			`numeric and symbolic.`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.It Fl p`
Update to 980910 from ftp.rhyolite.com 1998-10-25 17:56:06 +03:00			`uses the`
- Use .Nm "" instead of .Nm rtquery in SYNOPSIS. - Don't use captialized wort to refer command name. - Delete period at the end of ``SEE ALSO'' list. - Use .Xr instead of .Em to refer routed. 1997-10-11 06:55:20 +04:00			`.Em poll`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`command to request full routing information from`
fix some nits from SAITOH Masanobu, pr-3149 1997-01-27 18:01:58 +03:00			`.Xr gated 8 .`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`This is an undocumented extension RIP protocol supported only by`
			`.Xr gated 8 .`
			`.It Fl 1`
Update to 980910 from ftp.rhyolite.com 1998-10-25 17:56:06 +03:00			`queries using RIP version 1 instead of RIP version 2.`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.It Fl w Ar timeout`
			`changes the delay for an answer from each host.`
			`By default, each host is given 15 seconds to respond.`
			`.It Fl r Ar addr`
Update to 980910 from ftp.rhyolite.com 1998-10-25 17:56:06 +03:00			`asks about the route to destination`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.Em addr .`
- resolve conflicts. - remove md5 stuff; it is in libc. - define MCAST_PPP_BUG, until we fix if_ppp.c 1997-02-04 01:02:51 +03:00			`.It Fl a Ar passwd=XXX`
			`.It Fl a Ar md5_passwd=XXX\|KeyID`
Update to 980910 from ftp.rhyolite.com 1998-10-25 17:56:06 +03:00			`causes the query to be sent with the indicated cleartext or MD5 password.`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.It Fl t Ar op`
Update to 980910 from ftp.rhyolite.com 1998-10-25 17:56:06 +03:00			`changes tracing, where`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.Em op`
			`is one of the following.`
			`Requests from processes not running with UID 0 or on distant networks`
- resolve conflicts - try to follow rcsid style more closely - fix rn_walktree callback routine signatures. 1996-09-24 20:24:12 +04:00			`are generally ignored by the daemon except for a message in the system log.`
- Use .Nm "" instead of .Nm rtquery in SYNOPSIS. - Don't use captialized wort to refer command name. - Delete period at the end of ``SEE ALSO'' list. - Use .Xr instead of .Em to refer routed. 1997-10-11 06:55:20 +04:00			`.Xr gated 8`
- resolve conflicts. - remove md5 stuff; it is in libc. - define MCAST_PPP_BUG, until we fix if_ppp.c 1997-02-04 01:02:51 +03:00			`is likely to ignore these debugging requests.`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.El`
			`.Bl -tag -width Ds -offset indent-two`
- resolve conflicts - try to follow rcsid style more closely - fix rn_walktree callback routine signatures. 1996-09-24 20:24:12 +04:00			`.It Em on=tracefile`
Update to 980910 from ftp.rhyolite.com 1998-10-25 17:56:06 +03:00			`turns tracing on into the specified file.`
fix bad .Xr references 1998-04-29 13:49:10 +04:00			`That file must usually have been specified when the daemon was`
			`started or be the same as a fixed name, often`
- resolve conflicts - try to follow rcsid style more closely - fix rn_walktree callback routine signatures. 1996-09-24 20:24:12 +04:00			`.Pa /etc/routed.trace .`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.It Em more`
			`increases the debugging level.`
			`.It Em off`
			`turns off tracing.`
- resolve conflicts - try to follow rcsid style more closely - fix rn_walktree callback routine signatures. 1996-09-24 20:24:12 +04:00			`.It Em dump`
			`dumps the daemon's routing table to the current tracefile.`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.El`
			`.Sh SEE ALSO`
			`.Xr routed 8 ,`
- Use .Nm "" instead of .Nm rtquery in SYNOPSIS. - Don't use captialized wort to refer command name. - Delete period at the end of ``SEE ALSO'' list. - Use .Xr instead of .Em to refer routed. 1997-10-11 06:55:20 +04:00			`.Xr gated 8`
A leaner, meaner routed(8), implementing RIPv1, RIPv2, and ICMP Router Discovery, courtesy of Vernon Schryver <vjs@sgi.com>. Thanks! 1996-08-10 05:08:06 +04:00			`.br`
			`RFC\ 1058 - Routing Information Protocol, RIPv1`
			`.br`
			`RFC\ 1723 - Routing Information Protocol, RIPv2`