PIM Operational Commands

PIM Show Commands

PIM Interface

Syntax:

show pim interface <option>

Option Description

-

Without any option, the commands displays the information for all interfaces.

<interface_name>

Displays the PIM interface detail for the default instance

instance <instance_name>

Displays interface summary on specific instance

Example 1: Summary of PIM logical interface for all instances.

supervisor@rtbrick: op> show pim interface
Interface      Instance     IP Address        State      DR                Generator ID
ifl-1/7/1/1    default      198.51.100.247    Non-DR     198.51.100.42     1896236448
null0          default      n/a               n/a        n/a               n/a
ifl-0/0/3/3    vpn1         198.51.100.25     Non-DR     198.51.100.33     2123016228

Example 2: Summary of interfaces for the specified instance.

supervisor@rtbrick: op> show pim interface instance vpn1
Interface       Instance     IP Address        State      DR                Generator ID
ifl-0/0/3/3     vpn1         198.51.100.25     Non-DR     198.51.100.33     2123016228

Example 3: Detailed view of the specified PIM interface.

supervisor@rtbrick: op> show pim interface ifl-0/0/3/3
Interface: ifl-0/0/3/3
  Instance                 : vpn1
  State                    : Non-DR
  Primary address          : 198.51.100.25
  Generation ID            : 2123016228
  Timer values
    Hello interval         : 35s
    Join/Prune interval    : 35s
    Hold interval          : 105s
    Override interval      : 2000ms
    Prune delay interval   : 500ms
  DR election
    DR address             : 198.51.100.33
    DR priority            : 1
    DR election count      : 251
  Negotiated
    DR priority used       : True
    Lan delay used         : False
    Lan prune interval     : 0
    Lan override  used     : False
    Lan override interval  : 0
  Statistics
    Hello
      Received             : 17214
      Sent                 : 95
    Membership
      Received             : 0
      Sent                 : 759
    Assert
      Received             : 0
      Sent                 : 0

PIM Membership

Syntax:

show pim membership <option>

Option Description

-

Without any option, the commands displays PIM membership summary on all instances.

instance <instance_name>

Displays the PIM membership summary information on specific instance.

detail

Detailed information on all BGP peers in all instances in a list view.

instance <instance_name> detail

Displays the PIM membership detailed information on specific instance.

<group_address>

Specifies the multicast multicast group address

<source_address>

Specifies the source from which the multicast traffic is received

Example 1: Summary of the PIM membership on all instances.

supervisor@rtbrick: op> show pim membership
Source                 Group             Interface    Instance       Uptime
198.51.100.42          198.51.100.222    null0        default        00h:38m:05s
198.51.100.42          198.51.100.187    null0        default        00h:38m:05s
198.51.100.42          198.51.100.235    null0        default        00h:38m:05s

Example 2: Summary of the PIM membership for the specified instance.

supervisor@rtbrick: op> show pim membership instance default
Source                 Group             Interface     Instance       Uptime
198.51.100.42          198.51.100.222    null0         default        00h:38m:18s
198.51.100.42          198.51.100.187    null0         default        00h:38m:18s
198.51.100.42          198.51.100.235    null0         default        00h:38m:18s

Example 3: Detailed view of PIM membership on all instances.

supervisor@rtbrick: op> show pim membership detail
198.51.100.42, 198.51.100.222
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
  Uptime             : 00h:39m:29s
198.51.100.42, 198.51.100.187
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
  Uptime             : 00h:39m:29s
198.51.100.42, 198.51.100.235
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
  Uptime             : 00h:39m:29s

Example 4: Detailed view of PIM membership for the specified instance.

supervisor@rtbrick: op> show pim membership instance default detail
198.51.100.42, 198.51.100.222
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
  Uptime             : 00h:39m:39s
198.51.100.42, 198.51.100.187
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
  Uptime             : 00h:39m:39s
198.51.100.42, 198.51.100.235
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
  Uptime             : 00h:39m:39s

Example 5: Detailed view of PIM membership for the specified group-address and source-address in selected instance.

supervisor@rtbrick: op> show pim membership instance default 198.51.100.222 198.51.100.42
198.51.100.42, 198.51.100.222
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
  Uptime             : 00h:39m:50s
supervisor@rtbrick: op>

PIM Join and Prune

Syntax:

show pim join-prune <option>

Option Description

-

Without any option, the commands displays join and prune summary command on all instances.

instance <instance_name>

Displays join and prune summary on a specific instance.

detail

Displays PIM join and prune detailed information on all instances.

instance <instance_name> detail

Displays detailed join and prune information in selected instance.

<group_address>

Displays PIM join and prune detailed information for a specific group on all instance

<source_address>

Specifies the source from which the multicast traffic is received.

Example 1: Summary of the PIM join and prune all instances.

supervisor@rtbrick: op> show pim join-prune
Source                 Group            Upstream Interface    Instance
198.51.100.42          198.51.100.222    ifl-1/7/1/1          default
198.51.100.42          198.51.100.187    ifl-1/7/1/1          default
198.51.100.42          198.51.100.235    ifl-1/7/1/1          default
198.51.100.11          198.51.100.22     ifl-0/0/3/3          vpn1
198.51.100.11          198.51.100.217    ifl-0/0/3/3          vpn1

Example 2: Summary of the PIM join and prune summary for the specified instance.

supervisor@rtbrick: op> show pim join-prune instance vpn1
Source            Group               Upstream Interface  Instance
198.51.100.11     198.51.100.22       ifl-0/0/3/3         vpn1
198.51.100.11     198.51.100.217      ifl-0/0/3/3         vpn1
198.51.100.33     198.51.100.23       ifl-0/0/3/3         vpn1
198.51.100.40     198.51.100.24       ifl-0/0/3/3         vpn1

Example 3: Detailed view of the PIM join and prune for the specified instance.

supervisor@rtbrick: op> show pim join-prune instance vpn1 detail
198.51.100.11, 198.51.100.22
  Instance           : vpn1
  Upstream interface : ifl-0/0/3/3
  Upstream neighbor  : 198.51.100.11
  Type               : Join
  Uptime             : 00h:01m:11s
198.51.100.11, 198.51.100.217
  Instance           : vpn1
  Upstream interface : ifl-0/0/3/3
  Upstream neighbor  : 198.51.100.11
  Type               : Join
  Uptime             : 00h:01m:11s
198.51.100.33, 198.51.100.23
  Instance           : vpn1
  Upstream interface : ifl-0/0/3/3
  Upstream neighbor  : 198.51.100.33
  Type               : Join
  Uptime             : 00h:03m:41s
198.51.100.40, 198.51.100.24
  Instance           : vpn1
  Upstream interface : ifl-0/0/3/3
  Upstream neighbor  : 198.51.100.40
  Type               : Join
  Uptime             : 00h:03m:41s
198.51.100.66, 198.51.100.196
  Instance           : vpn1
  Upstream interface : ifl-0/0/3/3
  Upstream neighbor  : 198.51.100.66
  Type               : Join
  Uptime             : 00h:55m:31s
198.51.100.70, 198.51.100.197
  Instance           : vpn1
  Upstream interface : ifl-0/0/3/3
  Upstream neighbor  : 198.51.100.70
  Type               : Join
  Uptime             : 00h:55m:30s
198.51.100.80, 198.51.100.198
  Instance           : vpn1
  Upstream interface : ifl-0/0/3/3
  Upstream neighbor  : 198.51.100.80
  Type               : Join
  Uptime             : 00h:55m:30s
198.51.100.38, 198.51.100.199
  Instance           : vpn1
  Upstream interface : ifl-0/0/3/3
  Upstream neighbor  : 198.51.100.38
  Type               : Join
  Uptime             : 00h:55m:31s
198.51.100.200, 198.51.100.210
  Instance           : vpn1
  Upstream interface : ifl-0/0/3/3
  Upstream neighbor  : 198.51.100.200
  Type               : Join
  Uptime             : 00h:55m:31s

Example 4: Detailed view of the PIM join and prune for the specified instance, source, and group.

supervisor@rtbrick: op> show pim join-prune instance vpn1 198.51.100.210 198.51.100.200
198.51.100.200, 198.51.100.210
  Instance           : vpn1
  Upstream interface : ifl-0/0/3/3
  Upstream neighbor  : 198.51.100.200
  Type               : Join
  Uptime             : 00h:55m:50s

PIM Neighbors

Syntax:

show pim neighbor <option>

Option Description

-

Without any option, the commands displays the PIM neighbor summary on all instances.

instance <instance_name>

Displays the PIM neighbor summary information on specific instance

instance <instance_name> <neighbor_address>

Displays detailed information for specific PIM neighbor in selected instance.

Example 1: Summary of PIM neighbor on all instances.

supervisor@rtbrick: op> show pim neighbor
Neighbor         Interface        Instance     Generation ID  Uptime         Expires
198.51.100.42    ifl-1/7/1/1      default      1413290566     00h:55m:34s    1m 35s
198.51.100.11    ifl-0/0/3/3      vpn1         666648646      00h:55m:59s    21s
198.51.100.37    ifl-0/0/3/3      vpn1         1893441310     00h:55m:59s    28s
198.51.100.33    ifl-0/0/3/3      vpn1         1582670973     00h:55m:56s    24s
198.51.100.40    ifl-0/0/3/3      vpn1         2114142516     00h:55m:59s    21s
198.51.100.50    ifl-0/0/3/3      vpn1         620803409      00h:55m:56s    29s

Example 2: Summary of PIM neighbor for the specified instance.

supervisor@rtbrick: op> show pim neighbor instance default
Neighbor         Interface           Instance       Generation ID  Uptime         Expires
198.51.100.42     ifl-1/7/1/1        default         1413290566  00h:55m:41s    1m 28s

Example 3: Detailed view of PIM neighbor for the specified instance.

supervisor@rtbrick: op> show pim neighbor instance default 198.51.100.42

Neighbor: 198.51.100.42
  Interface            : ifl-1/7/1/1
  Instance             : default
  Hold down interval   : 105s
  Expires              : 105s
  Generation ID        : 1413290566
  DR priority          : 1
  Uptime               : 00h:55m:47s
  Last transition time : Tue Nov 24 06:47:08 GMT +0000 2020
  Holddown received    : 1

PIM Reverse Path Forwarding (RPF)

Syntax:

show pim rpf <option>

Option Description

-

Without any option, the commands displays the PIM rpf summary information on all instance.

instance <instance_name>

Displays the PIM rpf summary information on specific instance.

instance <instance> <source_address>

Displays the PIM rpf detailed information for specific source-address in selected instance.

Example 1: Summary of PIM rpf on all instances.

supervisor@rtbrick: op> show pim rpf
Multicast Source  Instance       RPF Interface       Neighbor
198.51.100.42      default        ifl-1/7/1/1      198.51.100.42
198.51.100.11      vpn1           ifl-0/0/3/3      198.51.100.11
198.51.100.33      vpn1           ifl-0/0/3/3      198.51.100.33
198.51.100.40      vpn1           ifl-0/0/3/3      198.51.100.40
198.51.100.66      vpn1           ifl-0/0/3/3      198.51.100.66
198.51.100.107     vpn1           n/a              n/a

Example 2: Summary of PIM rpf for the specified instance.

supervisor@rtbrick: op> show pim rpf instance vpn1
Multicast Source  Instance       RPF Interface       Neighbor
198.51.100.11     vpn1         ifl-0/0/3/3      198.51.100.11
198.51.100.33     vpn1         ifl-0/0/3/3      198.51.100.33
198.51.100.40     vpn1         ifl-0/0/3/3      198.51.100.40
198.51.100.66     vpn1         ifl-0/0/3/3      198.51.100.66
198.51.100.70     vpn1         ifl-0/0/3/3      198.51.100.70
198.51.100.107    vpn1         n/a                 n/a

Example 3: Detailed view of PIM rpf for the specified source-address in selected instance.

supervisor@rtbrick: op> show pim rpf instance vpn1 198.51.100.11
Multicast source : 198.51.100.11
  Instance        : vpn1
  AFI             : ipv4
  SAFI            : unicast
  RPF interface   : ifl-0/0/3/3
  Peer            : 198.51.100.11
  Covering prefix : n/a
  MAC address     : 00:12:01:00:00:01

PIM Routes

Syntax:

show pim mroute <option>

Option Description

-

Without any option, the commands displays the PIM routes summary information on all instance.

detail

Displays the PIM routes detail for all instances.

instance <instance_name>

Displays the PIM routes summary on specific instance

instance <instance_name> detail

Displays the PIM routes detailed information on specific instances.

Example 1: Summary of PIM routes for all instances.

supervisor@rtbrick: op> show pim mroute
Instance: default, AFI: ipv4, SAFI: multicast
  Source              Group               Route Source   Preference  Nexthop             OIF
  198.51.100.42      198.51.100.222   pim            240         n/a                 null0
  198.51.100.42      198.51.100.187  pim             240         n/a                 null0
  198.51.100.42      198.51.100.235  pim             240         n/a                 null0

Example 2: Detailed view of PIM routes for all instances.

supervisor@rtbrick: op> show pim mroute detail
198.51.100.42, 198.51.100.222
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 198.51.100.42          RPF interface    : ifl-1/7/1/1
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast
198.51.100.42, 198.51.100.187
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 198.51.100.42          RPF interface    : ifl-1/7/1/1
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast
198.51.100.42, 198.51.100.235
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 198.51.100.42          RPF interface    : ifl-1/7/1/1
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast

Example 3: Summary of PIM routes for the specific instance.

supervisor@rtbrick: op> show pim mroute instance default
Instance: default, AFI: ipv4, SAFI: multicast
  Source              Group               Route Source   Preference  Nexthop             OIF
  198.51.100.96    198.51.100.222   pim            240         n/a                 null0
  198.51.100.96    198.51.100.187   pim            240         n/a                 null0
  198.51.100.96    198.51.100.235   pim            240         n/a                 null0

Example 4: Detailed view of PIM routes for the specified instances.

supervisor@rtbrick: op> show pim mroute instance default detail
198.51.100.96, 198.51.100.222
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 198.51.100.96          RPF interface    : ifl-1/7/1/1
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast
198.51.100.96, 198.51.100.187
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 198.51.100.96          RPF interface    : ifl-1/7/1/1
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast
198.51.100.96, 198.51.100.235
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 198.51.100.96          RPF interface    : ifl-1/7/1/1
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast

PIM Clear Commands

Clear commands allow to reset operational states.

PIM Neighbor

Syntax:

clear pim neighbor

Option Description

neighbor

Clears all neighbors.

Example: The example below shows how to clear pim neighbor.

supervisor@rtbrick: op> clear pim neighbor
All instance clear triggered

PIM Neighbor Instance

Syntax:

clear pim neighbor instance <option> …​

Option Description

neighbor instance <instance_name>

Clears all neighbors on the specified instance.

neighbor instance <instance_name> interface <interface-name>

Clears all neighbors on the specified interface.

Example 1: The example below shows how to clear neighbors of the specified instance

supervisor@rtbrick: op> clear pim neighbor instance ip2vrf
Instance clear triggered

Example 2: The example below shows how to clear neighbors of the specified interface

supervisor@rtbrick: op> clear pim neighbor instance ip2vrf interface ifl-0/0/0
Instance clear triggered