1 .\" $FreeBSD: src/usr.sbin/mrouted/mrinfo.8,v 1.9.2.4 2003/03/11 21:13:51 trhodes Exp $
8 .Nd display configuration info from a multicast router
11 .Op Fl d Ar debug_level
12 .Op Fl r Ar retry_count
13 .Op Fl t Ar timeout_count
19 attempts to display the configuration information from the multicast router
20 .Ar multicast_router .
24 utility uses the ASK_NEIGHBORS IGMP message to the specified multicast router.
26 multicast router responds, the version number and a list of their neighboring
27 multicast router addresses is part of that response.
28 If the responding router
29 has a recent multicast version number, then
31 requests additional information such as metrics, thresholds, and flags from the
33 Once the specified multicast router responds, the
34 configuration is displayed to the standard output.
36 The following options are available:
37 .Bl -tag -width indent
38 .It Fl d Ar debug_level
40 When the debug level is greater than the
41 default value of 0, addition debugging messages are printed.
43 the debug level, an error condition, will always write an error message and will
47 Non-zero debug levels have the following effects:
48 .Bl -tag -width indent
50 packet warnings are printed to stderr.
52 all level 1 messages plus notifications down networks are printed to stderr.
54 all level 2 messages plus notifications of all packet
55 timeouts are printed to stderr.
57 .It Fl r Ar retry_count
58 Set the neighbor query retry limit.
60 .It Fl t Ar timeout_count
61 Set the number of seconds to wait for a neighbor query
63 Default timeout is 4 seconds.
67 .Nm mrinfo Ar mbone.phony.dom.net
68 127.148.176.10 (mbone.phony.dom.net) [version 3.3]:
69 127.148.176.10 -> 0.0.0.0 (?) [1/1/querier]
70 127.148.176.10 -> 127.0.8.4 (mbone2.phony.dom.net) [1/45/tunnel]
71 127.148.176.10 -> 105.1.41.9 (momoney.com) [1/32/tunnel/down]
72 127.148.176.10 -> 143.192.152.119 (mbone.dipu.edu) [1/32/tunnel]
75 For each neighbor of the queried multicast router, the IP of the queried router
76 is displayed, followed by the IP and name of the neighbor.
78 the metric (cost of connection), the threshold (multicast ttl) is displayed.
80 the queried multicast router has a newer version number, the type (tunnel,
81 srcrt) and status (disabled, down) of the connection is displayed.
85 utility must be run as root.