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

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

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.

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.

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.

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.

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.

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.

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