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

NAME

       map-mbone - Multicast Router Connection Mapper

SYNOPSIS

       debuglevel] retries] timeout] [multicast-router]

DESCRIPTION

       requests  the multicast router connection information from the multicast-router, and prints the information to the standard out.  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 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:

	      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.

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

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

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

	      Generates output in GRaphEd format.

	      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:

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

       The possible values for are:

	      Neighbors are reached via tunnel.

	      The tunnel uses IP source routing.

	      The interface is down.

	      The interface is administratively disabled for multicast routing.

	      The local router is the querier of the subnet.

       The format of the GRaphEd output is:

       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 are:

	      The neighbor is reached via tunnel.

	      The neighbor is on the same network/subnet.

	      The interface is down.

	      Please see mrouted(1M) for and

EXAMPLES

       Querying for the multicast router connection information.

       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 for multicast router connectivity with option:

       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
       must be run as root.

AUTHOR

       was developed by Pavel Curtis.

SEE ALSO

       mrouted(1M), mrinfo(1M).

																     map-mbone(1M)