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-0/0/2/100         ce1-vrf         192.0.2.5         Non-DR     192.0.2.6            846930886
null0                 ce1-vrf         n/a               n/a        n/a                        n/a

ifl-0/0/2/0           default         192.0.2.1         Non-DR     192.0.2.2           1804289383
null0                 default         n/a               n/a        n/a                        n/a

Example 2: Summary of interfaces for the specified instance.

supervisor@rtbrick: op> show pim interface instance ce1-vrf
Interface             Instance        IP Address        State      DR                Generator ID
ifl-0/0/2/100         ce1-vrf         192.0.2.5         Non-DR     192.0.2.6            846930886
null0                 ce1-vrf         n/a               n/a        n/a                        n/a

Example 3: Detailed view of the specified PIM interface.

supervisor@rtbrick: op> show pim interface ifl-0/0/2/100
Interface: ifl-0/0/2/100
  Instance                 : ce1-vrf
  State                    : Non-DR
  Primary address          : 192.0.2.5
  Generation ID            : 846930886
  Timer values
    Hello interval         : 30s
    Join/Prune interval    : 60s
    Hold interval          : 90s
    Override interval      : 2000ms
    Prune delay interval   : 500ms
  DR election
    DR address             : 192.0.2.6
    DR priority            : 1
    DR election count      : 2
  Negotiated
    DR priority used       : True
    Lan delay used         : False
    Lan prune interval     : 0
    Lan override  used     : False
    Lan override interval  : 0
  Statistics
    Hello
      Received             : 1
      Sent                 : 1
    Membership
      Received             : 0
      Sent                 : 0
    Assert
      Received             : 0
      Sent                 : 0
    JP Timers
      Early Termination    : 0

api  To access the Operational State API that corresponds to this CLI, click include::common:partial$operational_api_links.adoc[tag=show_pim_interface].

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
192.0.2.60           232.252.0.11         null0                         ce1-vrf
192.0.2.60           232.252.0.12         null0                         ce1-vrf
192.0.2.60           232.252.0.13         null0                         ce1-vrf
192.0.2.54           232.252.0.1          null0                         default
192.0.2.54           232.252.0.2          null0                         default
192.0.2.54           232.252.0.3          null0                         default

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

supervisor@rtbrick: op> show pim membership instance default
Source               Group                Interface                     Instance
192.0.2.54           232.252.0.1          null0                         default
192.0.2.54           232.252.0.2          null0                         default
192.0.2.54           232.252.0.3          null0                         default

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

supervisor@rtbrick: op> show pim membership detail
192.0.2.60, 232.252.0.11
  Instance           : ce1-vrf
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
192.0.2.60, 232.252.0.12
  Instance           : ce1-vrf
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
192.0.2.60, 232.252.0.13
  Instance           : ce1-vrf
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
192.0.2.54, 232.252.0.1
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
192.0.2.54, 232.252.0.2
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
192.0.2.54, 232.252.0.3
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static

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

supervisor@rtbrick: op> show pim membership instance default detail
192.0.2.54, 232.252.0.1
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
192.0.2.54, 232.252.0.2
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static
192.0.2.54, 232.252.0.3
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static

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 232.252.0.1 192.0.2.54
192.0.2.54, 232.252.0.1
  Instance           : default
  Outgoing interface : null0
  Source             : pim
  Subtype            : Join
  Subsource          : Static

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
192.0.2.60           232.252.0.11         ifl-0/0/2/100         ce1-vrf
192.0.2.60           232.252.0.12         ifl-0/0/2/100         ce1-vrf
192.0.2.60           232.252.0.13         ifl-0/0/2/100         ce1-vrf
192.0.2.54           232.252.0.1          ifl-0/0/2/0           default
192.0.2.54           232.252.0.2          ifl-0/0/2/0           default
192.0.2.54           232.252.0.3          ifl-0/0/2/0           default

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

supervisor@rtbrick: op> show pim join-prune instance ce1-vrf
Source               Group                Upstream Interface    Instance
192.0.2.60           232.252.0.11         ifl-0/0/2/100         ce1-vrf
192.0.2.60           232.252.0.12         ifl-0/0/2/100         ce1-vrf
192.0.2.60           232.252.0.13         ifl-0/0/2/100         ce1-vrf

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

supervisor@rtbrick: op> show pim join-prune instance ce1-vrf detail
192.0.2.60, 232.252.0.11
  Instance           : ce1-vrf
  Upstream interface : ifl-0/0/2/100
  Upstream neighbor  : 192.0.2.6
  Type               : Join
192.0.2.60, 232.252.0.12
  Instance           : ce1-vrf
  Upstream interface : ifl-0/0/2/100
  Upstream neighbor  : 192.0.2.6
  Type               : Join
192.0.2.60, 232.252.0.13
  Instance           : ce1-vrf
  Upstream interface : ifl-0/0/2/100
  Upstream neighbor  : 192.0.2.6
  Type               : Join

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 ce1-vrf 232.252.0.11 192.0.2.60
192.0.2.60, 232.252.0.11
  Instance           : ce1-vrf
  Upstream interface : ifl-0/0/2/100
  Upstream neighbor  : 192.0.2.6
  Type               : Join

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       State          Generation ID  Uptime         Expires
192.0.2.6        ifl-0/0/2/100       ce1-vrf        Up                 846930886  00h:00m:18s    1m 27s
192.0.2.2        ifl-0/0/2/0         default        Up                1804289383  00h:00m:18s    1m 27s

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

supervisor@rtbrick: op> show pim neighbor instance default
Neighbor         Interface           Instance       State          Generation ID  Uptime         Expires
192.0.2.2        ifl-0/0/2/0         default        Up                1804289383  00h:00m:19s    1m 26s

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

supervisor@rtbrick: op> show pim neighbor instance default 192.0.2.2
Neighbor: 192.0.2.2
  Interface            : ifl-0/0/2/0
  Instance             : default
  Hold down interval   : 105s
  Expires              : 1m 24ss
  Generation ID        : 1804289383
  DR priority          : 1
  Uptime               : 00h:00m:20s
  Last transition time : Fri Jun 05 14:52:05 GMT +0000 2026
  Holddown received    : 1

api  To access the Operational State API that corresponds to this CLI, click include::common:partial$operational_api_links.adoc[tag=show_pim_neighbor].

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
192.0.2.60        ce1-vrf        ifl-0/0/2/100       n/a
192.0.2.54        default        ifl-0/0/2/0         n/a

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

supervisor@rtbrick: op> show pim rpf instance ce1-vrf
Multicast Source  Instance       RPF Interface       Neighbor
192.0.2.60        ce1-vrf        ifl-0/0/2/100       n/a

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

supervisor@rtbrick: op> show pim rpf instance ce1-vrf 192.0.2.60
Multicast source : 192.0.2.60
  Instance        : ce1-vrf
  AFI             : ipv4
  SAFI            : unicast
  RPF interface   : ifl-0/0/2/100
  Peer            : n/a
  Covering prefix : 192.0.2.60/32
  MAC address     : n/a

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: ce1-vrf, AFI: ipv4, SAFI: multicast
  Source              Group               Route Source   Preference  Nexthop             OIF
  192.0.2.60          232.252.0.11        pim            240         n/a                 null0
  192.0.2.60          232.252.0.12        pim            240         n/a                 null0
  192.0.2.60          232.252.0.13        pim            240         n/a                 null0
Instance: default, AFI: ipv4, SAFI: multicast
  Source              Group               Route Source   Preference  Nexthop             OIF
  192.0.2.54          232.252.0.1         pim            240         n/a                 null0
  192.0.2.54          232.252.0.2         pim            240         n/a                 null0
  192.0.2.54          232.252.0.3         pim            240         n/a                 null0

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

supervisor@rtbrick: op> show pim mroute detail
192.0.2.60, 232.252.0.11
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 192.0.2.6              RPF interface    : ifl-0/0/2/100
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : ce1-vrf-ipv4-multicast
  Resolved in  : ce1-vrf-ipv4-multicast
192.0.2.60, 232.252.0.12
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 192.0.2.6              RPF interface    : ifl-0/0/2/100
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : ce1-vrf-ipv4-multicast
  Resolved in  : ce1-vrf-ipv4-multicast
192.0.2.60, 232.252.0.13
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 192.0.2.6              RPF interface    : ifl-0/0/2/100
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : ce1-vrf-ipv4-multicast
  Resolved in  : ce1-vrf-ipv4-multicast
192.0.2.54, 232.252.0.1
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 192.0.2.2              RPF interface    : ifl-0/0/2/0
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast
192.0.2.54, 232.252.0.2
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 192.0.2.2              RPF interface    : ifl-0/0/2/0
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast
192.0.2.54, 232.252.0.3
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 192.0.2.2              RPF interface    : ifl-0/0/2/0
  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
  192.0.2.54          232.252.0.1         pim            240         n/a                 null0
  192.0.2.54          232.252.0.2         pim            240         n/a                 null0
  192.0.2.54          232.252.0.3         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
192.0.2.54, 232.252.0.1
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 192.0.2.2              RPF interface    : ifl-0/0/2/0
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast
192.0.2.54, 232.252.0.2
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 192.0.2.2              RPF interface    : ifl-0/0/2/0
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast
192.0.2.54, 232.252.0.3
  Source       : pim                    Preference       : 240
  Sub source   : Static                 Subtype          : Join
  RPF neighbor : 192.0.2.2              RPF interface    : ifl-0/0/2/0
  Nexthop      : n/a                    Egress interface : null0
  Nexthop type : Multicast Fanout       NextHop action   : None
  Destination  : default-ipv4-multicast
  Resolved in  : default-ipv4-multicast

api  To access the Operational State API that corresponds to this CLI, click include::common:partial$operational_api_links.adoc[tag=show_pim_mroute].

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 vrf1
Instance clear triggered

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

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