mtrace v2 ipv6

Use mtrace v2 ipv6 to trace an IPv6 multicast path through mtrace2.

Syntax

mtrace v2 ipv6 [ vpn-instance vpn-instance-name ] { source-address | group-address } * [ destination address | port number | wait-time time | max-hop count ] * [ verbose ]

Views

Any view

Predefined user roles

network-admin

mdc-admin

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command traces an IPv6 multicast path on the public network.

source-address: Specifies an IPv6 multicast source by its IPv6 address.

group-address: Specifies an IPv6 multicast group by its IPv6 address. The value range for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers from 0 to F.

destination address: Specifies the destination address of IPv6 mtrace. The default destination address is FF02::2.

port number: Specifies a UDP port number for IPv6 mtrace, in the range of 1024 to 49151. The default value is 10240.

wait-time time: Specifies the length of time that the client waits for a Reply message. The value range for the time argument is 1 to 65535 seconds and the default value is 10 seconds. If the client does not receive a Reply message within the waiting time, the client initiates a hop-by-hop IPv6 mtrace.

max-hop count: Specifies the maximum number of the hops to be traced. The value range for the count argument is 1 to 255 and the default value is 255. If the maximum number of hops is reached on a device, the device directly sends a Reply message to the client and the mtrace is terminated.

verbose: Displays detailed information about IPv6 mtrace. If you do not specify this keyword, the command displays brief information about IPv6 mtrace.

Usage guidelines

To perform a non-group-specific mtrace, specify an IPv6 multicast source and a destination. The mtrace starts from the destination and ends at the device directly connected to the source.

To perform a non-source-specific mtrace, specify an IPv6 multicast group and a destination. The mtrace starts from the destination and ends at the RP associated with the group.

To perform a source-and-group-specific mtrace, specify both an IPv6 multicast source and an IPv6 multicast group. If you also specify a destination, the mtrace starts from the destination and ends at the device directly connected to the source. If you do not specify a destination, the mtrace starts from the upstream device of the client and ends at the device directly connected to the source.

An IPv6 mtrace process stops if the maximum number of the hops to be traced is reached.

If the client does not receive a Reply message within the waiting time, the client initiates a hop-by-hop mtrace to determine which device on the path encountered an error. It sends a Query message with the hops field set to 1 and waits for a Reply message. If the client receives a Reply message within the waiting time, it sends a Query message with the hops field value increased by 1 and waits for a Reply message. This process continues until the client does not receive a Reply message within the waiting time any more.

Examples

# Use mtrace2 to trace the path along which IPv6 multicast data of group FF1E::1 travels from source 10::7 to destination 50::5 and display brief mtrace information.

<Sysname> mtrace v2 ipv6 10::7 ff1e::1 destination 50::5
 Mtrace from 10::7 to 50::5 via group ff1e::1, 255 hops at most, press 
CTRL_C to break.
 Querying full reverse path...

  Hop  Local address                       Protocol       Time    Fwd code
    0  50::1                               PIM-SM(OSPF)   50 s    NO_ERROR
   -1  40::1                               PIM-SM(OSPF)   40 s    NO_ERROR
   -2  30::1                               PIM-SM(OSPF)   60 s    NO_ERROR
   -3  20::1                               PIM-SM(OSPF)   55 s    NO_ERROR
   -4  10::1                               PIM-SM(OSPF)   30 s    NO_ERROR

Table 108: Command output

Field	Description
Hop	Number of the hop. 0 represents the last hop, -1 represents the hop before the last hop, and so on.
Local address	IPv6 address of this hop on the traced path.
Protocol	Multicast routing protocol used between this device and the previous-hop device: PIM-SM. PIM-DM. Unicast routing protocol used between this device and the previous-hop device: LOCAL—Direct route. STATIC ROUTE—Static route. RIP. ISIS. OSPF. BGP.
Time	Length of time used to transmit an mtrace message between this device and the previous-hop device, in seconds.
Fwd code	Forwarding code or error code: NO_ERROR—No error. WRONG_IF—The interface on which the mtrace message arrives is not in the outgoing interface list of the multicast data. PRUNE_SENT—This device has sent a prune message to the upstream device. PRUNE_RCVD—This device has received a prune message from the downstream device. SCOPED—A multicast border is configured on the incoming interface or outgoing interface of the multicast data. NO_ROUTE—This device does not have any route for the source or the RP. WRONG_LAST_HOP—This device is not the expected last-hop device. REACHED_RP—This device is the RP for the (, G) multicast data. RPF_IF—The mtrace message arrived on the RPF interface for the multicast data. NO_MULTICAST—The mtrace message arrived on an interface that is not enabled with IP multicast. NO_SPACE*—No space is available for inserting a response data block in the packet.

# Use mtrace2 to trace the path along which IPv6 multicast data of group FF1E::1 travels from source 10::7 to destination 50::5 and display detailed mtrace information.

<Sysname> mtrace v2 ipv6 10::7 ff1e::1 destination 50::5 verbose
 Mtrace from 10::7 to 50::5 via group ff1e::1, 255 hops at most, use query 
ID 12345, client port 50001, press CTRL_C to break.
 Querying full reverse path...

    0: Incoming interface ID: 1501
       Outgoing interface ID: 1502
       Local address: 50::1
       Remote address: FE80::A27B:99FF:FECB:207
       Input multicast packets: 111
       Output multicast packets: 111
       Forwarded packets for the (S, G) pair: 22
       Multicast protocol in use: PIM-SM
       Unicast protocol in use: OSPF
       Forwarding code: NO_ERROR
       Time used (s): 50

   -1: Incoming interface ID: 1601
       Outgoing interface ID: 1602
       Local address: 40::1
       Remote address: FE80::A27B:99FF:FECB:206
       Input multicast packets: 111
       Output multicast packets: 111
       Forwarded packets for the (S, G) pair: 22
       Multicast protocol in use: PIM-SM
       Unicast protocol in use: OSPF
       Forwarding code: NO_ERROR
       Time used (s): 50

Table 109: Command output

Field	Description
n	Number of the hop. 0 represents the last hop, -1 represents the hop before the last hop, and so on.
Incoming interface ID	Index of the incoming interface of the IPv6 multicast data.
Outgoing interface ID	Index of the outgoing interface of the IPv6 multicast data.
Local address	IPv6 address of this hop on the traced path.
Remote address	IPv6 address of the upstream device.
Input multicast packets	Statistics of packets received on the incoming interface of the IPv6 multicast data.
Output multicast packets	Statistics of packets forwarded through the outgoing interface of the IPv6 multicast data.
Forwarded packets for the (S, G) pair	Statistics of forwarded (S, G) packets.
Multicast protocol in use	Multicast routing protocol running on the incoming interface of the multicast data.
Unicast protocol in use	Unicast routing protocol running on the incoming interface of the multicast data.
Forwarding code	Forwarding code or error code: NO_ERROR—No error. WRONG_IF—The interface on which the mtrace message arrives is not in the outgoing interface list of the multicast data. PRUNE_SENT—This device has sent a prune message to the upstream device. PRUNE_RCVD—This device has received a prune message from the downstream device. SCOPED—A multicast border is configured on the incoming interface or outgoing interface of the multicast data. NO_ROUTE—This device does not have any route for the source or the RP. WRONG_LAST_HOP—This device is not the expected last-hop device. REACHED_RP—This device is the RP for the (, G) multicast data. RPF_IF—The mtrace message arrived on the RPF interface for the multicast data. NO_MULTICAST—The mtrace message arrived on an interface that is not enabled with IP multicast. NO_SPACE*—No space is available for inserting a response data block in the packet.
Time used (s)	Length of time for transmitting the mtrace message from the previous-hop device to this device.

Related commands

ipv6 mtrace-service port

prev	up	next
longest-match (IPv6 MRIB view)	home	reset ipv6 multicast fast-forwarding cache