Vyatta Network OS Documentation

Learn how to install, configure and operate the Vyatta NOS, which helps drive our virtual networking & physical platforms portfolio.

mtrace <host>

Displays the route that packets take from a multicast source.

set mtrace host [ destination addr [ group group [ detail ] | detail ] | group group [ destination addr [ detail ] | detail ] | detail ]

Output shows routes from the source host to the host on which the command is entered.

host
The host that is the source for the trace. The host is either a name (if DNS is being used on the network) or an IPv4 or IPv6 unicast address.
addr
The host that is the destination for the trace. The host is either an IPv4 or IPv6 unicast address.
group
The multicast group to trace. The format is an IPv4 or IPv6 multicast address.
detail
Displays detailed output. This output includes IP multicast packet-rate and packet-loss information.

Operational mode

Use this command to show the path from a source to a receiver in a multicast network.

The following example displays a trace from 10.14.0.1 through 10.12.0.2 using group 226.0.0.1.

vyatta@vyatta:~$ mtrace 10.14.0.1 destination 10.12.0.2 group 226.0.0.1
Mtrace from 10.14.0.1 to 10.12.0.2 via group 226.0.0.1
Querying full reverse path...
  0  ? (10.12.0.2)
 -1  ? (10.12.0.2)  PIM  thresh^ 1  RPF interface
 -2  ? (10.12.0.1)  PIM  thresh^ 1
 -3  ? (10.14.0.1)
Round trip time 1 ms

The following example displays a detailed trace from 10.14.0.1 through 10.12.0.2 using group 226.0.0.1.

vyatta@vyatta:~$ mtrace 10.14.0.1 destination 10.12.0.2 group 226.0.0.1 detail
Mtrace from 10.14.0.1 to 10.12.0.2 via group 226.0.0.1
Round trip time 0 ms
 
Waiting to accumulate statistics... Results after 10 seconds:
 
  Source        Response Dest    Packet Statistics For     Only For Traffic
10.14.0.1       10.12.0.2        All Multicast Traffic     From 10.14.0.1
     v       __/  rtt    0 ms    Lost/Sent = Pct  Rate       To 226.0.0.1
10.14.0.1
10.12.0.1
     v     ^      ttl    1          0            0 pps       0            0 pps
10.12.0.2                      RPF interface
     v      \__   ttl    2
10.12.0.2       10.12.0.2
  Receiver      Query Source