MAP-MBONE(8)                                                      MAP-MBONE(8)

NAME
       map-mbone - Multicast connection mapper

SYNOPSIS
       /usr/sbin/map-mbone  [  -d  debug_level  ]  [  -f  ] [ -g ] [ -n ] [ -r
       retry_count ] [ -t timeout_count ] [ starting_router ]

DESCRIPTION
       map-mbone attempts to display all multicast routers that are  reachable
       from  the  multicast  starting_router.  If not specified on the command
       line, the default multicast starting_router is the localhost.

       map-mbone  traverses  neighboring  multicast  routers  by  sending  the
       ASK_NEIGHBORS  IGMP  message  to the multicast starting_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 recent multicast version number,  then  map-mbone
       requests  additional information such as metrics, thresholds, and flags
       from the multicast router. For each new occurrence of neighboring  mul-
       ticast  router  in  the reply and provided the flooding option has been
       selected, then map-mbone asks each of this multicast router for a  list
       of neighbors. This search for unique routers will continue until no new
       neighboring multicast routers are reported.

INVOCATION
       "-d" option sets the debug level. 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 map-mbone to terminate.  Non-zero debug
       levels have the following effects:

       level 1
              packet warnings are printed to stderr.

       level 2
              all level  1  messages  plus  notifications  down  networks  are
              printed to stderr.

       level 3
              all  level  2 messages plus notifications of all packet timeouts
              are printed to stderr.

       "-f" option sets flooding option. Flooding allows the recursive  search
       of  neighboring  multicast routers and is enable by default when start-
       ing_router is not used.

       "-g" option sets graphing in GraphEd format.

       "-n" option disables the DNS lookup for the multicast  routers names.

       "-r retry_count" sets the neighbor query  retry  limit.  Default  is  1
       retry.

       "-t  timeout_count"  sets  the number of seconds to wait for a neighbor
       query reply before retrying. Default timeout is 2 seconds.

IMPORTANT NOTE
       map-mbone must be run as root.

SEE ALSO
       mrouted(8), mrinfo(8), mtrace(8)

AUTHOR
       Pavel Curtis

4.2 Berkeley Distribution                                         MAP-MBONE(8)