Return to mrinfo.8 CVS log

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

mrouted

    1: .\"	$OpenBSD: mrinfo.8,v 1.12 2007/05/31 19:20:25 jmc Exp $
    2: .\"	$NetBSD: mrinfo.8,v 1.2 1995/10/03 23:20:39 thorpej Exp $
    3: .\"
    4: .\" Written Wed Mar 24 1993 by Van Jacobson (adapted from the
    5: .\" multicast mapper written by Pavel Curtis).
    6: .\"
    7: .\" The lawyers insist we include the following UC copyright notice.
    8: .\" The mapper from which this is derived contained a Xerox copyright
    9: .\" notice which follows the UC one.  Try not to get depressed noting
   10: .\" that the legal gibberish is larger than the program.
   11: .\"
   12: .\" Copyright (c) 1993 Regents of the University of California.
   13: .\" All rights reserved.
   14: .\"
   15: .\" Redistribution and use in source and binary forms, with or without
   16: .\" modification, are permitted provided that the following conditions
   17: .\" are met:
   18: .\" 1. Redistributions of source code must retain the above copyright
   19: .\"    notice, this list of conditions and the following disclaimer.
   20: .\" 2. Redistributions in binary form must reproduce the above copyright
   21: .\"    notice, this list of conditions and the following disclaimer in the
   22: .\"    documentation and/or other materials provided with the distribution.
   23: .\" 3. All advertising materials mentioning features or use of this software
   24: .\"    must display the following acknowledgement:
   25: .\"	This product includes software developed by the Computer Systems
   26: .\"	Engineering Group at Lawrence Berkeley Laboratory.
   27: .\" 4. Neither the name of the University nor of the Laboratory may be used
   28: .\"    to endorse or promote products derived from this software without
   29: .\"    specific prior written permission.
   30: .\"
   31: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
   32: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   33: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   34: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
   35: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   36: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   37: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   38: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   39: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   40: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   41: .\" SUCH DAMAGE.
   42: .\" ---------------------------------
   43: .\" Copyright (c) 1992, 2001 Xerox Corporation.  All rights reserved.
   44: .\"
   45: .\" Redistribution and use in source and binary forms, with or without
   46: .\" modification, are permitted provided that the following conditions are met:
   47: .\"
   48: .\" Redistributions of source code must retain the above copyright notice,
   49: .\" this list of conditions and the following disclaimer.
   50: .\"
   51: .\" Redistributions in binary form must reproduce the above copyright notice,
   52: .\" this list of conditions and the following disclaimer in the documentation
   53: .\" and/or other materials provided with the distribution.
   54: .\"
   55: .\" Neither name of the Xerox, PARC, nor the names of its contributors may be
   56: .\" used to endorse or promote products derived from this software
   57: .\" without specific prior written permission.
   58: .\"
   59: .\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
   60: .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
   61: .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
   62: .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE XEROX CORPORATION OR
   63: .\" CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
   64: .\" EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
   65: .\" PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
   66: .\" OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
   67: .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
   68: .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
   69: .\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   70: .\"
   71: .Dd $Mdocdate: May 31 2007 $
   72: .Dt MRINFO 8 SMM
   73: .Os
   74: .Sh NAME
   75: .Nm mrinfo
   76: .Nd displays configuration info from a multicast router
   77: .Sh SYNOPSIS
   78: .Nm mrinfo
   79: .Op Fl hn
   80: .Op Fl d Ar level
   81: .Op Fl r Ar count
   82: .Op Fl t Ar seconds
   83: .Ar router
   84: .Sh DESCRIPTION
   85: .Nm
   86: attempts to display the configuration information from the specified multicast capable
   87: .Ar router .
   88: .Pp
   89: .Nm
   90: uses the ASK_NEIGHBORS IGMP message to query the specified multicast
   91: router.
   92: If the router responds, the version number and a list of their
   93: neighboring multicast router addresses is part of the response.
   94: If the responding router has a recent multicast version number, then
   95: .Nm
   96: requests additional information such as metrics, thresholds,
   97: and flags from the multicast router.
   98: Once the specified multicast router responds,
   99: the configuration is displayed to the standard output.
  100: .Pp
  101: The options are as follows:
  102: .Bl -tag -width timeout_levelxyz
  103: .It Fl h
  104: Print a help message and exit.
  105: .It Fl n
  106: Use numerical address instead of a symbolic host name.
  107: .It Fl d Ar level
  108: sets the debug level.
  109: When the debug level is greater than the default value of 0,
  110: additional debugging messages are printed.
  111: Regardless of the debug level,
  112: an error condition will always write an error message and cause
  113: .Nm
  114: to terminate.
  115: Non-zero debug levels have the following effects (printed to stderr):
  116: .Pp
  117: .Bl -tag -width 1n -compact -offset indent
  118: .It 1
  119: packet warnings.
  120: .It 2
  121: all level 1 messages plus notifications of down networks.
  122: .It 3
  123: all level 2 messages plus notifications of all packet timeouts.
  124: .El
  125: .It Fl r Ar count
  126: sets the neighbor query retry count limit.
  127: The default is to do 3 retries.
  128: .It Fl t Ar seconds
  129: sets the timeout in number of seconds to wait for a neighbor query reply.
  130: The default timeout is 4 seconds.
  131: .El
  132: .Sh EXAMPLES
  133: .Bd -literal
  134: # mrinfo mbone.phony.dom.net
  135: 127.148.176.10 (mbone.phony.dom.net) [version 3.3]:
  136:  127.148.176.10 -> 0.0.0.0 (?) [1/1/querier]
  137:  127.148.176.10 -> 127.0.8.4 (mbone2.phony.dom.net) [1/45/tunnel]
  138:  127.148.176.10 -> 105.1.41.9 (momoney.com) [1/32/tunnel/down]
  139:  127.148.176.10 -> 143.192.152.119 (mbone.dipu.edu) [1/32/tunnel]
  140: .Ed
  141: .Pp
  142: For each neighbor of the queried multicast router, the IP of the queried router
  143: is displayed, followed by the IP and name of the neighbor.
  144: In square brackets the metric (cost of connection)
  145: and threshold (multicast ttl) is displayed.
  146: If the queried multicast router has a newer version number, the type (tunnel,
  147: srcrt) and status (disabled, down) of the connection is displayed.
  148: .Sh SEE ALSO
  149: .Xr map-mbone 8 ,
  150: .Xr mrouted 8 ,
  151: .Xr mtrace 8
  152: .Sh AUTHORS
  153: .An Van Jacobson