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 <<<<<<< HEAD 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 ======= 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 >>>>>>> 1ecc2f585d37484ebb74f3bcbefa3675aa8d42ce null0 vpn1 n/a n/a n/a n/a
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 <<<<<<< HEAD ifl-0/0/3/3 vpn1 198.51.100.25 Non-DR 198.51.100.33 2123016228 ======= ifl-0/0/3/3 vpn1 198.51.100.25 Non-DR 198.51.100.33 2123016228 >>>>>>> 1ecc2f585d37484ebb74f3bcbefa3675aa8d42ce null0 vpn1 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/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 <<<<<<< HEAD Source Group Interface Instance Uptime ======= Source Group Interface Instance Uptime >>>>>>> 1ecc2f585d37484ebb74f3bcbefa3675aa8d42ce 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 <<<<<<< HEAD Source Group Interface Instance Uptime ======= Source Group Interface Instance Uptime >>>>>>> 1ecc2f585d37484ebb74f3bcbefa3675aa8d42ce 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 <<<<<<< HEAD Source Group Upstream Interface Instance ======= Source Group Upstream Interface Instance >>>>>>> 1ecc2f585d37484ebb74f3bcbefa3675aa8d42ce 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 <<<<<<< HEAD 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 ======= 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 >>>>>>> 1ecc2f585d37484ebb74f3bcbefa3675aa8d42ce
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