map-mbone(1Mtcp)


map-mbone -- map multicast connections

Synopsis

/usr/sbin/map-mbone [ -d debug_level ] [ -f ] [ -g ] [ -n ] [ -r retries ] [ -t timeout ] [ starting_router ]

Description

map-mbone attempts to display all multicast routers that are reachable from the multicast starting_router. If not specified, the default starting_router is the local host.

map-mbone traverses neighboring multicast routers by sending the IGMP message ASK_NEIGHBORS to the multicast starting router. If the router responds, it includes the version number and a list of neighboring multicast router addresses in the response. If the responding router has a recent multicast version number, map-mbone requests additional information such as metrics, thresholds and flags from the multicast router. If the flooding option has been selected, map-mbone asks each multicast router mentioned in the response for a list of its neighbors. This search for unique routers continues until no new neighboring multicast routers are reported.

Only root can run map-mbone.

Options

map-mbone understands the following options:

-d debug_level
Set the debug level. If debug_level is greater than the default value of 0, map-mbone displays additional debugging messages. Regardless of the debug level, map-mbone will always output an error message and terminate if an error occurs. The debug levels are:

1
Print packet warnings to stderr.

2
As level 1 with the addition of printing notification of down networks to stderr.

3
As levels 1 and 2 with the addition of printing notification of all packet timeouts to stderr.

-f
Turn on ``flooding''; this allows recursive search of multicast routes. This is enabled by default if a starting_router is not specified.

-g
Set graphing in GraphEd format.

-n
Disable DNS for multicast router names.

-r retries
Set the limit on the number of times to try querying a neighbor. The default limit is 1 retry.

-t timeout
Set the number of seconds to wait for a neighbor to reply to a query before retrying. The default timeout is 2 seconds.

References

mrouted(1Mtcp), mrinfo(1Mtcp), mtrace(1Mtcp)

Notices

Author

Pavel Curtis
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004