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 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 to determine whether bidirectional adjacencies exist.

Parameters

ip-address

Specifies the IP address of the multicast capable target router should be entered.

dns-name

Specifies the DNS name, if the DNS name resolution is configured.

Values

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

dns-name: [max 63 chars]

router router-instance

Specifies the router instance that this command applies to.

Default

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

service-name

Specifies the service instance that this command applies to, up to 64 characters.

Output

The following output is an example of mrinfo, 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 -> 239.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]
? 10.1.1.1 -> ? 10.1.1.2 [1/0/pim]
? 10.1.1.1 -> ? 10.1.1.9 [1/0/pim]
? 10.1.1.1 -> ? 0.0.0.0 [1/0/pim/leaf]
? 10.1.1.1 -> ? 10.1.1.7 [1/0/pim]
? 10.1.2.1 -> ? 10.1.2.7 [1/0/pim]
Table: Output fields: mrinfo

Label

Description

General flags

version

Indicates software version on queried router

prune

Indicates the router understands pruning

genid

Indicates the router sends generation IDs

mtrace

Indicates the router handles mtrace requests

Neighbors flags

1

Metric

0

Threshold (multicast time-to-live)

pim

PIM enabled on the interface

down

Operational status of the interface

disabled

Administrative status of the interface

leaf

No downstream neighbors on the 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 if DNS name resolution is configured.

Values

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

dns-name: [max 63 chars]

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. The default address for the destination address is the incoming IETF format for that (S,G)

hop hop

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

Values

1 to 255

Default

32 hops (infinity for the DVMRP routing protocol).

router router-instance

Specifies the router instance that this command applies to.

Default

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

service-name service-name

Specifies the service instance that this command applies to, up to 64 characters.

wait-time 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 multicast path tracing 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 is forwarded over the outgoing interface.

forwarding code

Displays the forwarding information or error code for this hop