mrinfo ip-address|dns-name[router router-instance| service-name service-name]
<global>
This command is used to display 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.
specifies an IPv4 unicast address (a.b.c.d) for the multicast-capable target router
specifies the DNS name of the multicast-capable target router (if DNS name resolution is configured)
specifies a router name or service ID
specifies the service name, up to 64 characters
The following output is an example of mrinfo information, and Table: Multicast mrinfo Field Descriptions describes the fields. In the example, the target router has IP address 239.255.0.1.
Output Example*A:7CSA:Dut-C# mrinfo 239.255.0.1
239.252.0.1 [version 0.0,prune,genid,mtrace]:
? 10.1.7.1 -> ? 10.1.7.7 [1/0/pim]
? 10.1.1.1 -> ? 10.0.0.0 [1/0/pim/leaf]
|
Label |
Description |
|---|---|
|
General flags |
|
|
version |
The software version on the queried router |
|
prune |
Indicates that the router understands pruning |
|
genid |
Indicates that the router sends generation IDs |
|
mtrace |
Indicates that the router handles mtrace requests |
|
Neighbors flags |
|
|
? |
Indicates that the IPAddr to Name conversion in DNS is not found |
|
1 |
The metric |
|
0 |
The threshold (multicast time-to-live) |
|
pim |
Indicates that PIM is enabled on the interface |
|
down |
The operational status of the interface |
|
disabled |
The administrative status of the interface |
|
leaf |
Indicates that there are no downstream neighbors on the interface |
|
querier |
Indicates that the interface is an IGMP querier |
|
tunnel |
The neighbor reached via the tunnel |
mstat source ip-address|dns-name group grp-ip-address|dns-name[destination dst-ip-address|dns-name][hop hop][router router-instance| service-name service-name][wait-time wait-time]
<global>
This command traces a multicast path from a source to a receiver and displays multicast packet rate and loss information. The mstat command adds the capability to show the multicast path in a limited graphic display and provides information about drops, duplicates, TTLs, and delays at each node. This information is useful to network operators because it identifies nodes with high drop and duplicate counts. Duplicate counts are shown as negative drops.
specifies an IPv4 unicast address (a.b.c.d) for the multicast-capable source. This is the unicast address of the beginning of the path to be traced.
specifies the DNS name of the multicast-capable source
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 to.
specifies the multicast group address that will be used
specifies the maximum number of hops that will be traced from the receiver back toward the source
specifies a router name or service ID
specifies the service name, up to 64 characters
specifies the number of seconds to wait for the response
The following output is an example of mstat information, and Table: Multicast mstat Field Descriptions describes the fields.
For each interface between two nodes, a line is displayed. Note the following:
the forwarding information/error code is only displayed when it is different from "No Error"
"?" means that there is no reverse DNS translation
To follow the packet, start at Source and read down to Receiver. To count the number of hops, read back up fromQuery Source to Response Dest. The example below shows two hops between Query Source and Response Dest.
A:7CSA:Dut-C# mstat source 239.255.0.0 group 10.0.0.0
Mtrace from 239.255.0.via group 10.0.0.0
Querying full reverse path...
Waiting to accumulate statistics...Results after 10 seconds:
Source Response Dest Overall Packet Statistics For Traffic From
239.255.0.0 10.0.0.0 Mcast Pkt 239.255.0.0 To 239.255.0.1
| __/ rtt 11.0ms Rate Lost/Sent = Pct Rate
v / ------- ---------------------
239.255.0.1
10.1.7.1 ?
| \__ ttl 2 0 pps 0/0 = -- 0 pps
v \
10.1.7.7 10.0.0.1
Receiver Query Source
|
Label |
Description |
|---|---|
|
Source |
The start ("Source") of the trace |
|
Response Dest |
The name of the router for this hop or "?" when there is no reverse DNS translation |
|
rtt |
The round-trip time |
|
Overall Mcast Pkt Rate |
The overall multicast packet rate (that is, the average multicast packet rate across the router), expressed in pps (packets per second) |
|
Packet Statistics For Traffic From (source) To (group) |
The packet statistics from the specified source to the specified multicast group |
|
Lost/Sent = Pct Rate |
The number of packets lost and sent, expressed as a percentage and as a rate |
|
Receiver |
The end ("Receiver") of the trace |
|
Query Source |
The query source address. On the 7705 SAR, the query source is the receiver-end router, which generates queries to determine if there is a path to the source when a receiver is available. The query source and the response destination are the same. |
mtrace source ip-address|dns-name group grp-ip-address|dns-name[destination dst-ip-address|dns-name][hop hop][router router-instance| service-name service-name][wait-time wait-time]
<global>
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.
specifies an IPv4 unicast address (a.b.c.d) for the multicast-capable source. This is a unicast address of the beginning of the path to be traced.
specifies the DNS name of the multicast-capable source
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 to.
specifies the multicast group address that will be used
specifies the maximum number of hops that will be traced from the receiver back toward the source
specifies a router name or service ID
specifies the service name, up to 64 characters
specifies the number of seconds to wait for the response
The following output is an example of mtrace information, where each line consists of fields separated by a space. If the output was formatted as a table, it would look like the following:
Hop Router Name (Address) Protocol TTL Forwarding Code
--- ----------- ----------- ------------- --------- ---------------
-1 ? (10.10.10.5) PIM thresh^ 1 No Error
Table: Multicast mtrace Field Descriptions describes the fields.
Output Example*A:7CSA:Dut-C# mtrace source 239.255.0.0 group 10.0.0.0
Mtrace from 239.255.0.via group 10.0.0.0
Querying full reverse path...
0 ? (10.1.7.7)
-1 ? (10.1.7.1) PIM thresh^ 1 No Error
-2 ? (239.255.0)
Round trip time 11.0 ms; total ttl of 2 required.
|
Field |
Description |
|---|---|
|
Hop |
The number of hops from the source to the listed router. The "-" sign indicates that the TTL value is decremented by 1 after each hop. |
|
Router Name |
The name of the router for this hop. If a DNS name query is not successful, a "?" displays. |
|
(Address) |
The address of the router for this hop |
|
Protocol |
The protocol used |
|
TTL |
The forward TTL threshold, which is the TTL that a packet is required to have before it will be forwarded over the outgoing interface The TTL default value of 1 s cannot be changed for multicast control messages because the packets are not forwarded beyond the next-hop router |
|
Forwarding Code |
The forwarding information/error code for this hop |