map-mbone(1M)                                                 map-mbone(1M)




 NAME    [Toc]    [Back]
      map-mbone - Multicast Router Connection Mapper

 SYNOPSIS    [Toc]    [Back]
      /usr/sbin/map-mbone [-d debuglevel] [-f] [-g] [-n] [-r retries] [-t
      timeout] [ multicast-router ]

 DESCRIPTION    [Toc]    [Back]
      map-mbone requests the multicast router connection information from
      the multicast-router, and prints the information to the standard out.
      map-mbone sends out the ASK_NEIGHBORS igmp message to the multicastrouter.
  When the multicast-router receives the request, it sends back
      its configuration information. multicast-router can be either an ip
      address or a system name.

      If the multicast-router is not specified, flood mode is on by default
      and the igmp request message is sent to all the multicast router on
      the local network. With flood mode on, when map-mbone finds new
      neighbor routers from the replies, it will send the same igmp request
      to the new neighbor routers. This activity continues until no new
      neighbor routers are reported in the replies.

      The command line options are:

           -ddebuglevel  Sets the level for printing out the debug message.
                         The default is 0, which prints only error and
                         warning messages. Debug level three prints most the
                         messages.

           -rretries     Sets the retry times to poll the routing daemon for
                         information. The default is 1.

           -ttimeout     It specifies the timeout value in seconds for
                         waiting the reply. The default value is 2 seconds.

           -f            Sets the flood mode on. It is the default value
                         when no multicast-router is given on the command
                         line input.

           -g            Generates output in GRaphEd format.

           -n            Disable DNS lookup for the multicast router names.

      The output contains the interface configuration information of  the
      requested router(s).  The format for each interface output is:

           interface_addr -> neighbor_addr (neighbor_name) [metrics/thresh/flags]

      If there are multiple neighbor routers on one interface, they will all
      be reported.  The neighbor_name will not be printed if the -n option
      is specified on the command line.



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 map-mbone(1M)                                                 map-mbone(1M)




      The possible values for flags are:

           tunnel        Neighbors are reached via tunnel.

           srcrt         The tunnel uses IP source routing.

           down          The interface is down.

           disabled      The interface is administratively disabled for
                         multicast routing.

           querier       The local router is the querier of the subnet.

      The format of the GRaphEd output is:

           interface_addr_in_integer {$ NP low_byte_addr high_byte_addr} node_name
           [ neighbor_addr_in_integer metrics/threshold/flags ]

      If there is no neighbor router on an interface, then a * will be put
      next to the node_name. If there are multiple neighbor routers on one
      interface, all of them will be reported.  The possible values for
      flags are:

           E    The neighbor is reached via tunnel.

           P         The neighbor is on the same network/subnet.

           D         The interface is down.

           Please see mrouted(1M) for metrics and thresh.

 EXAMPLES    [Toc]    [Back]
      Querying camden.cup.hp.com for the multicast router connection
      information.

           map-mbone hpntclt.cup.hp.com

           127.0.0.1 (localhost) [version 3.3]:
             193.2.1.39 -> 0.0.0.0 (all-zeros-broadcast) [1/1/disabled]
             15.13.106.144 -> 15.255.176.33 (matmos.hpl.hp.com) [10/1/tunnel]
             15.13.106.144 -> 15.17.20.7 (hpspddc.vid.hp.com) [10/1/tunnel/down]

      Querying hpntcbs.cup.hp.com for multicast router connectivity with -g
      option:

           map-mbone -g hpntcbs.cup.hp.com

           GRAPH "Multicast Router Connectivity: Wed Feb  1 17:34:59 1995"=UNDIRECTED
             252537488 {$ NP 1440 1060 $} "hpntc1t.cup.hp.com*"
               ;
             252538974 {$ NP 940 1120 $} "hpntcbs.cup.hp.com"



 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 map-mbone(1M)                                                 map-mbone(1M)




               252537488 "10/1E"
               252539807 "1/1P"
               ;
             252539807 {$ NP 1590 1150 $} "hpntc1h.cup.hp.com*"
               ;

    Note    [Toc]    [Back]
      map-mbone must be run as root.

 AUTHOR    [Toc]    [Back]
      map-mbone was developed by Pavel Curtis.

 SEE ALSO    [Toc]    [Back]
      mrouted (1M), mrinfo(1M).


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003