aboutsummaryrefslogtreecommitdiff
path: root/usr.sbin/mrouted/mrinfo.8
diff options
context:
space:
mode:
authorGarrett Wollman <wollman@FreeBSD.org>1995-03-31 21:18:13 +0000
committerGarrett Wollman <wollman@FreeBSD.org>1995-03-31 21:18:13 +0000
commit478140b95f826bf40f012d41a760579511937585 (patch)
tree4cf2183f3687085aa5d26b57e1506eb3e5c2162e /usr.sbin/mrouted/mrinfo.8
parent94036a8cf08853d60e47c939f4ecfe0bfb47c896 (diff)
downloadsrc-478140b95f826bf40f012d41a760579511937585.tar.gz
src-478140b95f826bf40f012d41a760579511937585.zip
Forgot to add these two.
Submitted by: Mark Tinguely <tinguely@plains.NoDak.edu>
Notes
Notes: svn path=/head/; revision=7541
Diffstat (limited to 'usr.sbin/mrouted/mrinfo.8')
-rw-r--r--usr.sbin/mrouted/mrinfo.892
1 files changed, 92 insertions, 0 deletions
diff --git a/usr.sbin/mrouted/mrinfo.8 b/usr.sbin/mrouted/mrinfo.8
new file mode 100644
index 000000000000..b1e7880bf8ae
--- /dev/null
+++ b/usr.sbin/mrouted/mrinfo.8
@@ -0,0 +1,92 @@
+.Dd March 31, 1995
+.Dt MRINFO 8
+.Sh NAME
+.Nm mrinfo
+.Nd displays configuration info from a multicast router
+.Sh SYNOPSIS
+.Nm mrinfo
+.Op Fl d Ar debuglevel
+.Op Fl r Ar retries
+.Op Fl t Ar timeout
+.Ar router
+.Sh DESCRIPTION
+The
+.Nm mrinfo
+program attempts to display the configuration information from the
+multicast router
+.Ar router .
+.Pp
+.Nm
+uses the
+.Dv ASK_NEIGHBORS
+.Tn IGMP
+message to the specified multicast router. If this multicast router
+responds, the version number and a list of their neighboring multicast
+router addresses is part of that response. If the responding router
+has a recent multicast version number, then
+.Nm mrinfo
+requests additional information such as metrics, thresholds, and flags
+from the multicast router. Once the specified multicast router
+responds, the configuration is displayed to the standard output.
+.Pp
+The
+.Nm
+program accepts the following options:
+.Bl -tag -width XXXdebuglevel
+.It Fl d Ar debuglevel
+This option sets the debug level to
+.Ar debuglevel .
+When the debug level is greater than the default value of 0, addition
+debugging messages are printed. Regardless of the debug level, an
+error condition, will always write an error message and will cause
+.Nm
+to terminate.
+Non-zero debug levels have the following effects:
+.Bl -tag -width "level 3"
+.It level 1
+packet warnings are printed to stderr.
+.It level 2
+all level 1 messages plus notifications down networks are printed to stderr.
+.It level 3
+all level 2 messages plus notifications of all packet
+timeouts are printed to stderr.
+.El
+.It Fl r Ar retries
+This option sets the neighbor query retry limit to
+.Ar retries .
+The default is three retries.
+.It Fl t Ar timeout
+This sets the number of seconds to wait for a neighbor query
+reply. The default timeout is four seconds.
+.El
+.Sh SAMPLE OUTPUT
+.Bd -literal
+# mrinfo mbone.phony.dom.net
+127.148.176.10 (mbone.phony.dom.net) [version 3.3]:
+ 127.148.176.10 -> 0.0.0.0 (?) [1/1/querier]
+ 127.148.176.10 -> 127.0.8.4 (mbone2.phony.dom.net) [1/45/tunnel]
+ 127.148.176.10 -> 105.1.41.9 (momoney.com) [1/32/tunnel/down]
+ 127.148.176.10 -> 143.192.152.119 (mbone.dipu.edu) [1/32/tunnel]
+.Ed
+.Pp
+For each neighbor of the queried multicast router, the IP of the
+queried router is displayed, followed by the IP and name of the
+neighbor. In square brackets the metric (cost of connection) and the
+threshold (minimum TTL to forward) are displayed. If the queried multicast
+router has a newer version number, the type (tunnel, srcrt) and status
+(disabled, down) of the connection are also displayed.
+.Sh RESTRICTIONS
+.Nm
+must be run as `root'.
+.Sh SEE ALSO
+.Xr map-mbone 8 ,
+.Xr mrouted 8 ,
+.Xr mtrace 8
+.Sh AUTHOR
+Pavel Curtis
+.Sh HISTORY
+An
+.Nm
+command first appeared in
+.Tn FreeBSD
+2.0.