Operational commands

mrinfo

Syntax

mrinfo ip-address | dns-name [router router-instance | service-name service-name]

Context

<GLOBAL>

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays relevant multicast information from the target multicast router. Information displayed includes adjacency information, protocol, metrics, thresholds, and flags from the target multicast router. This information can be used by network operators to determine whether bidirectional adjacencies exist.

Parameters

ip-address

Specifies the IP address of the multicast capable target router.

Values

ip-address ipv4 unicast address (a.b.c.d)

dns-name

Specifies the DNS name, up to 63 characters.

router-instance

Specifies the router instance.

Default

router-name - "Base" | "management" Default - Base

service-name

Specifies the service name, up to 64 characters

Output

The following output is an example of multicast information, and Table: Output fields: mrinfo describes the output fields.

Sample output
A:dut-f# mrinfo 10.1.1.2

10.1.1.2  [version 3.0,prune,genid,mtrace]:
  10.1.1.2 -> 10.1.1.1 [1/0/pim]
  16.1.1.1 -> 0.0.0.0 [1/0/pim/down/disabled]
  17.1.1.1 -> 0.0.0.0 [1/0/pim/querier/leaf]
  200.200.200.3 -> 200.200.200.5 [1/0/tunnel/pim]... 

A:dut-g# mrinfo 1.1.1.1

1.1.1.1  [version 7.0,prune,genid,mtrace]:
? 1.1.1.1 -> ? 0.0.0.0 [1/0/pim/leaf]
? 12.1.1.1 -> ? 12.1.1.2 [1/0/pim]
? 19.1.1.1 -> ? 19.1.1.9 [1/0/pim]
? 11.1.1.1 -> ? 0.0.0.0 [1/0/pim/leaf]
? 17.1.1.1 -> ? 17.1.1.7 [1/0/pim]
? 17.1.2.1 -> ? 17.1.2.7 [1/0/pim]
Table: Output fields: mrinfo

Label

Description

General flags

version

Displays the software version on queried router

prune

Indicates that router understands pruning

genid

Indicates that router sends generation IDs

mtrace

Indicates that the router handles mtrace requests

Neighbors flags

1

Metric

0

Threshold (multicast time-to-live)

pim

PIM enabled on interface

down

Operational status of interface

disabled

Administrative status of interface

leaf

No downstream neighbors on interface

querier

Interface is IGMP querier

tunnel

Neighbor reached via tunnel

mtrace

Syntax

mtrace source ip-address | dns-name [group ip-address | dns-name] [destination ip-address | dns-name] [hop hop] [router router-instance | service-name service-name] [wait-time wait-time]

Context

<GLOBAL>

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command traces the multicast path from a source to a receiver by passing a trace query hop-by-hop along the reverse path from the receiver to the source. At each hop, information such as the hop address, routing error conditions, and packet statistics are gathered and returned to the requester. A network administrator can determine where multicast flows stop and verify the flow of the multicast stream.

Parameters

source ip-address

Specifies the IP address of the multicast-capable source. This is a unicast address of the beginning of the path to be traced.

dns-name

Specifies the DNS name, up to 63 characters.

Values

ip-address ipv4 unicast address (a.b.c.d)

group ip-address

Specifies the multicast address.

destination ip-address

Specifies the IP address of the unicast destination. If this parameter is omitted, the IP address of the system where the command is entered is used. The destination parameter can also be used to specify a local interface address as the destination address to send the trace query.

Default

The default address for the destination address is the incoming IETF format for that (S,G)

hop

Specifies the maximum number of hops that will be traced from the receiver back toward the source.

Values

1 to 255

Default

32 hops (infinity for the DVMRP routing protocol).

router-instance

Specifies the router name or service ID used to identify the router instance.

Default

router-name - "Base" | "management" Default - Base

service-name

Specifies the service name, up to 64 characters.

wait-time

Specifies the number of seconds to wait for the response.

Values

1 to 60

Default

10

Output

The following output is an example of mtrace information, and Table: Output fields: mtrace describes the output fields.

Sample output
A:Dut-F# mtrace source 10.10.16.9 group 224.5.6.7
 
Mtrace from 10.10.16.9 via group 224.5.6.7
Querying full reverse path...
 
  0  ? (10.10.10.6)
 -1  ? (10.10.10.5)  PIM  thresh^ 1  No Error
 -2  ? (10.10.6.4)  PIM  thresh^ 1  No Error
 -3  ? (10.10.4.2)  PIM  thresh^ 1  Reached RP/Core
 -4  ? (10.10.1.1)  PIM  thresh^ 1  No Error
 -5  ? (10.10.2.3)  PIM  thresh^ 1  No Error
 -6  ? (10.10.16.9)
Round trip time 29 ms; total ttl of 5 required.
Table: Output fields: mtrace

Label

Description

hop

Displays the number of hops from the source to the listed router

router name

Displays the name of the router for this hop. If a DNS name query is not successful a ‟?” displays

address

Displays the address of the router for this hop

protocol

Displays the protocol used

ttl

Displays the forward TTL threshold. TTL that a packet is required to have before it will be forwarded over the outgoing interface

forwarding code

Displays the forwarding information or error code for this hop