map-mbone(1M)

NAME

map-mbone — Multicast Router Connection Mapper

SYNOPSIS

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

DESCRIPTION

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 multicast-router. 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.

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

Querying camden.cup.hp.com for the multicast router connection information.

map-mbone hpntclt.cup.hp.com 

0.0.1 (localhost) [version 3.3]:
2.1.39 -> 0.0.0.0 (all-zeros-broadcast) [1/1/disabled]
13.106.144 -> 15.255.176.33 (matmos.hpl.hp.com) [10/1/tunnel]
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"
    252537488 "10/1E"
    252539807 "1/1P"
    ;
  252539807 {$ NP 1590 1150 $} "hpntc1h.cup.hp.com*"
    ;

Note

map-mbone must be run as root.

AUTHOR

map-mbone was developed by Pavel Curtis.

map-mbone(1M)

Technical documentation

» Table of Contents