show ip pim traffic

Displays IPv4 PIM traffic statistics.
Syntax
show ip pim traffic [ join-prune ] [ rx | tx ]
Parameters
join-prune
Specifies displaying join and prune statistics.
rx
Specifies displaying received PIM traffic statistics.
tx
Specifies displaying transmitted PIM traffic statistics.
Modes

Privileged EXEC mode

Usage Guidelines

PIM control packet statistics for interfaces that are configured for standard PIM are listed first by the display.

The show ip pim traffic command displays the following information:

Output Field

Description

Port

The port or virtual interface on which the PIM interface is configured.

HELLO

The number of PIM Hello messages sent or received on the interface.

JOIN-PRUNE

The number of Join or Prune messages sent or received on the interface.

Note: Unlike PIM Dense, PIM Sparse uses the same messages for Joins and Prunes.

ASSERT

The number of Assert messages sent or received on the interface.

REGISTER GRAFT (DM)

The number of Register messages sent or received on the interface.

REGISTER STOP (SM)

The number of Register Stop messages sent or received on the interface.

BOOTSTRAP MSGS (SM)

The number of bootstrap messages sent or received on the interface.

CAND. RP ADV. (SM)

The total number of Candidate-RP-Advertisement messages sent or received on the interface.

Err

The total number of messages discarded, including a separate counter for those that failed the checksum comparison.

Examples

The following example shows PIM join and prune traffic statistics for received and sent packets.

device> show ip pim traffic
Port    HELLO     JOIN-PRUNE  ASSERT    REGISTER  REGISTER  BOOTSTRAP CAND. RP  Err
                                      GRAFT(DM) STOP(SM)  MSGS (SM) ADV. (SM)    
-------+---------+-----------+---------+---------+---------+---------+---------+---
       Rx        Rx          Rx        Rx        Rx        Rx        Rx        Rx
------+---------+-----------+---------+---------+---------+---------+---------+---
v30     0         0           0         0         0         0         0         0  
v50     2526      1260        0         0         0         1263      0         0  
v150    2531      0           0         0         0         1263      0         0  
v200    2531      0           0         0         0         1         0         0  
Port    HELLO     JOIN-PRUNE  ASSERT    REGISTER  REGISTER  BOOTSTRAP CAND. RP  Err
                                      GRAFT(DM) STOP(SM)  MSGS (SM) ADV. (SM)    
-------+---------+-----------+---------+---------+---------+---------+---------+---
       Tx        Tx          Tx        Tx        Tx        Tx        Tx       
------+---------+-----------+---------+---------+---------+---------+---------+---
v30     2528      0           0         0         0         0         0        
v50     2540      1263        0         0         0         2         0        
v150    2529      0           0         0         0         1262      0        
v200    2529      0           0         0         0         1262      0        

The following example shows the number of received IPv4 PIM Hello packets dropped on interface 1/1/9 because an ACL to control neighbor access is configured on it.

device> show ip pim traffic rx

Port    HLO   JN-PRNE  ASSERT REG      REG       BTSTRP    CAND RP   Err
                              GRFT(DM) STOP(SM)  MSGS(SM)  ADV.(SM)

-------+-------+------+-----+-------+----------+---------+---------+---
        Rx      Rx     Rx    Rx      Rx         Rx        Rx         Rx
-------+-------+------+-----+-------+----------+---------+---------+---
e1/1/1  0       0      0     0       0          0         0          0
e1/1/9  764     0      0     0       0          0         0          757
e1/1/12 0       0      0     0       0          0         0          0
v20     758     0      0     1916    0          0         0          0
v60     0       0      0     0       0          0         0          0
v310    0       0      0     0       0          0         0          0
v360    0       0      0     0       0          0         0          0

The following example shows PIM join and prune traffic statistics for sent packets.

device> show ip pim traffic tx

Port    HELLO     JOIN-PRUNE  ASSERT    REGISTER  REGISTER  BOOTSTRAP CAND. RP  Err
                                      GRAFT(DM) STOP(SM)  MSGS (SM) ADV. (SM)    
-------+---------+-----------+---------+---------+---------+---------+---------+---
       Tx        Tx          Tx        Tx        Tx        Tx        Tx       
------+---------+-----------+---------+---------+---------+---------+---------+---
v30     2528      0           0         0         0         0         0        
v50     2540      1263        0         0         0         2         0        
v150    2529      0           0         0         0         1262      0        
v200    2530      0           0         0         0         1262      0        

The following example shows PIM join and prune traffic statistics.

device> show ip pim traffic join-prune 
 
Port  Packet    Join      Prune     Avg Aggr  Last Aggr
-----+---------+---------+---------+---------+----------
      Rx        Rx        Rx        Rx        Rx     
-----+---------+---------+---------+---------+----------
v30   0         0         0         0         0        
v50   1260      1260      0         1         1        
v150  0         0         0         0         0        
v200  0         0         0         0         0        
Port  Packet    Join      Prune     Avg Aggr  Last Aggr
-----+---------+---------+---------+---------+----------
      Tx        Tx        Tx        Tx        Tx     
-----+---------+---------+---------+---------+----------
v30   0         0         0         0         0        
v50   1263      1262      1         1         1        
v150  0         0         0         0         0        
v200  0         0         0         0         0        

The following example shows PIM join and prune traffic statistics.

device> show ip pim traffic join-prune rx

Port  Packet    Join      Prune     Avg Aggr  Last Aggr
-----+---------+---------+---------+---------+----------
      Rx        Rx        Rx        Rx        Rx     
-----+---------+---------+---------+---------+----------
v30   0         0         0         0         0        
v50   1260      1260      0         1         1        
v150  0         0         0         0         0        
v200  0         0         0         0         0        

The following example shows PIM join and prune traffic statistics.

device> show ip pim traffic join-prune tx

Port  Packet    Join      Prune     Avg Aggr  Last Aggr
-----+---------+---------+---------+---------+----------
      Tx        Tx        Tx        Tx        Tx     
-----+---------+---------+---------+---------+----------
v30   0         0         0         0         0        
v50   1264      1263      1         1         1        
v150  0         0         0         0         0        
v200  0         0         0         0         0 
History
Release version Command history
08.0.20a This command was modified to display, in the Err column, received Hello packets dropped on an interface because of an ACL to control neighbor access.