1 .\" $FreeBSD: src/usr.sbin/mrouted/map-mbone.8,v 1.7.2.4 2003/03/11 21:13:51 trhodes Exp $
8 .Nd multicast connection mapper
11 .Op Fl d Ar debug_level
15 .Op Fl r Ar retry_count
16 .Op Fl t Ar timeout_count
17 .Op Ar starting_router
22 attempts to display all multicast routers that are reachable from the multicast
24 If not specified on the command line, the default multicast
31 traverses neighboring multicast routers by sending the ASK_NEIGHBORS IGMP
32 message to the multicast starting_router.
33 If this multicast router responds,
34 the version number and a list of their neighboring multicast router addresses is
35 part of that response.
36 If the responding router has recent multicast version
39 requests additional information such as metrics, thresholds, and flags from the
41 For each new occurrence of neighboring multicast router in
42 the reply and provided the flooding option has been selected, then
44 asks each of this multicast router for a list of neighbors.
46 for unique routers will continue until no new neighboring multicast routers
49 The following options are available:
50 .Bl -tag -width indent
53 When the debug level is greater than the
54 default value of 0, addition debugging messages are printed.
56 the debug level, an error condition, will always write an error message and will
60 Non-zero debug levels have the following effects:
61 .Bl -tag -width indent
63 packet warnings are printed to stderr.
65 all level 1 messages plus notifications down networks are printed to stderr.
67 all level 2 messages plus notifications of all packet
68 timeouts are printed to stderr.
72 Flooding allows the recursive search
73 of neighboring multicast routers and is enable by default when starting_router
76 Set graphing in GraphEd format.
78 Disable the DNS lookup for the multicast routers names.
79 .It Fl r Ar retry_count
80 Set the neighbor query retry limit.
82 .It Fl t Ar timeout_count
83 Set the number of seconds to wait for a neighbor query
84 reply before retrying.
85 Default timeout is 2 seconds.
90 utility must be run as root.