Return to map-mbone.8 CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / mrouted

mrouted

    1: .\"	$OpenBSD: map-mbone.8,v 1.13 2007/05/31 19:20:25 jmc Exp $
    2: .\"	$NetBSD: map-mbone.8,v 1.2 1995/10/03 23:16:53 thorpej Exp $
    3: .\"
    4: .\" Mapper for connections between MRouteD multicast routers.
    5: .\" Written by Pavel Curtis <Pavel@PARC.Xerox.Com>
    6: .\"
    7: .\" Copyright (c) 1992, 2001 Xerox Corporation.  All rights reserved.
    8: .\"
    9: .\" Redistribution and use in source and binary forms, with or without
   10: .\" modification, are permitted provided that the following conditions are met:
   11: .\"
   12: .\" Redistributions of source code must retain the above copyright notice,
   13: .\" this list of conditions and the following disclaimer.
   14: .\"
   15: .\" Redistributions in binary form must reproduce the above copyright notice,
   16: .\" this list of conditions and the following disclaimer in the documentation
   17: .\" and/or other materials provided with the distribution.
   18: .\"
   19: .\" Neither name of the Xerox, PARC, nor the names of its contributors may be
   20: .\" used to endorse or promote products derived from this software
   21: .\" without specific prior written permission.
   22: .\"
   23: .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   24: .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
   25: .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
   26: .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE XEROX CORPORATION OR
   27: .\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
   28: .\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
   29: .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
   30: .\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
   31: .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
   32: .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
   33: .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   34: .\"
   35: .Dd $Mdocdate: May 31 2007 $
   36: .Dt MAP-MBONE 8 SMM
   37: .Os
   38: .Sh NAME
   39: .Nm map-mbone
   40: .Nd Multicast connection mapper
   41: .Sh SYNOPSIS
   42: .Nm map-mbone
   43: .Op Fl fgn
   44: .Op Fl d Ar level
   45: .Op Fl r Ar count
   46: .Op Fl t Ar seconds
   47: .Op Ar starting_router
   48: .Sh DESCRIPTION
   49: .Nm
   50: attempts to display all multicast routers that are reachable from the multicast
   51: router
   52: .Ar starting_router .
   53: If not specified on the command line,
   54: .Ar starting_router
   55: is
   56: .Dq localhost .
   57: .Nm
   58: must be run as root.
   59: .Pp
   60: .Nm
   61: sends an
   62: .Dv ASK_NEIGHBORS
   63: .Tn IGMP
   64: message to
   65: .Ar starting_router .
   66: A response contains the
   67: multicast version number
   68: of
   69: .Ar starting_router
   70: and the addresses of
   71: all its neighboring multicast routers.
   72: If the multicast version number is recent, then
   73: .Nm
   74: requests additional information such as metrics, thresholds, and flags.
   75: .Pp
   76: If a recursive search has been requested (see
   77: .Fl f ) ,
   78: .Nm
   79: repeats the above operation for each new
   80: multicast router in the list of neighbors and
   81: continues the process until no new multicast routers are reported.
   82: .Pp
   83: The options are as follows:
   84: .Pp
   85: .Bl -tag -width "-t seconds"
   86: .It Fl d Ar level
   87: Sets the debug level to
   88: .Ar level .
   89: When the debug level is greater than
   90: 0, additional debugging messages are printed to stderr.
   91: Regardless of
   92: the debug level, an error condition will always write an error message and will
   93: cause
   94: .Nm
   95: to terminate.
   96: Non-zero debug levels are:
   97: .Bl -enum -offset indent
   98: .It
   99: Print packet warnings, plus level 0 messages.
  100: .It
  101: Print notifications of down networks, plus level 1 messages.
  102: .It
  103: Print notifications of all packet timeouts, plus level 2 messages.
  104: .El
  105: .Pp
  106: Default is 0.
  107: .It Fl f
  108: Causes a recursive (flooding) search.
  109: If no
  110: .Ar starting_router
  111: is specified, a recursive search is always performed.
  112: .It Fl g
  113: Sets graphing format to GraphEd format.
  114: .It Fl n
  115: Disables DNS lookup for the names of the multicast routers.
  116: .It Fl r Ar count
  117: Sets the neighbor query retry limit to
  118: .Ar count .
  119: Default is 1.
  120: .It Fl t Ar seconds
  121: Sets the number of seconds to wait for a neighbor query
  122: reply before retrying to
  123: .Ar seconds .
  124: Default is 2.
  125: .El
  126: .Sh SEE ALSO
  127: .Xr mrinfo 8 ,
  128: .Xr mrouted 8 ,
  129: .Xr mtrace 8
  130: .Sh AUTHORS
  131: Pavel Curtis