Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Configuring PIM Trace Options

Tracing operations record detailed messages about the operation of routing protocols, such as the various types of routing protocol packets sent and received, and routing policy actions. You can specify which trace operations are logged by including specific tracing flags. The following table describes the flags that you can include.

Flag

Description

all

Trace all operations.

assert

Trace assert messages, which are used to resolve which of the parallel routers connected to a multiaccess LAN is responsible for forwarding packets to the LAN.

autorp

Trace bootstrap, RP, and auto-RP messages.

bidirectional-df-election

Trace bidirectional PIM designated-forwarder (DF) election events.

bootstrap

Trace bootstrap messages, which are sent periodically by the PIM domain's bootstrap router and are forwarded, hop by hop, to all routers in that domain.

general

Trace general events.

graft

Trace graft and graft acknowledgment messages.

hello

Trace hello packets, which are sent so that neighboring routers can discover one another.

join

Trace join messages, which are sent to join a branch onto the multicast distribution tree.

mdt

Trace messages related to multicast data tunnels.

normal

Trace normal events.

nsr-synchronization

Trace nonstop routing synchronization events

packets

Trace all PIM packets.

policy

Trace poison-route-reverse packets.

prune

Trace prune messages, which are sent to prune a branch off the multicast distribution tree.

register

Trace register and register-stop messages. Register messages are sent to the RP when a multicast source first starts sending to a group.

route

Trace routing information.

rp

Trace candidate RP advertisements.

state

Trace state transitions.

task

Trace task processing.

timer

Trace timer processing.

In the following example, tracing is enabled for all routing protocol packets. Then tracing is narrowed to focus only on PIM packets of a particular type.

To configure tracing operations for PIM:

  1. (Optional) Configure tracing at the [routing-options hierarchy level to trace all protocol packets.
  2. Configure the filename for the PIM trace file.
  3. (Optional) Configure the maximum number of trace files.
  4. (Optional) Configure the maximum size of each trace file.
  5. (Optional) Enable unrestricted file access.
  6. Configure tracing flags. Suppose you are troubleshooting issues with PIM version 1 control packets that are received on an interface configured for PIM version 2. The following example shows how to trace messages associated with this problem.
  7. View the trace file.