display pim routing-table

Function

The display pim routing-table command displays the PIM routing table.

Format

display pim [ vpn-instance vpn-instance-name | all-instance ] routing-table [ group-address [ mask { group-mask-length | group-mask } ] | source-address [ mask { source-mask-length | source-mask } ] | incoming-interface { interface-type interface-number | register } | outgoing-interface { include | exclude | match } { interface-type interface-number | register | none } | mode { dm | sm | ssm } | flags flag-value | fsm ] ^* [ outgoing-interface-number [ number ] ]

display pim [ vpn-instance vpn-instance-name | all-instance ] routing-table brief [ group-address [ mask { group-mask-length | group-mask } ] | source-address [ mask { source-mask-length | source-mask } ] | incoming-interface { interface-type interface-number | register } ] ^*

display pim [ vpn-instance vpn-instance-name ] routing-table channel channel-name

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Specifies a VPN instance. vpn-instance-name specifies the name of the VPN instance.	The value is a string of case-sensitive characters.
all-instance	Specifies all the instances.	-
group-address	Indicates the address of a multicast group. It is used to specify a multicast group and display the corresponding routing table of the group.	The address is in dotted decimal notation. The value ranges from 224.0.0.0 to 239.255.255.255.
mask	Indicates the mask of a multicast source address or group address.	-
group-mask-length	Specifies the length of the group address mask.	The value is an integer that ranges from 4 to 32.
group-mask	Specifies the group address mask.	The address is in dotted decimal notation.
source-address	Indicates the IP address of the multicast source. It is used to specify a multicast source and display the corresponding routing table of the source.	The address is in dotted decimal notation.
source-mask-length	Specifies the length of the source address mask.	The value is an integer that ranges from 0 to 32.
source-mask	Specifies the multicast source IP address mask.	The address mask is in dotted decimal notation.
incoming-interface	Indicates the entry with the upstream interface as a specified interface.	-
interface-type interface-number	Indicates the type and number of an interface.	-
register	Indicates the register interface.	If this parameter is specified, mode can be set only to sm.
outgoing-interface	Indicates the entry with the downstream interface as a specified interface.	-
include	Indicates that the downstream interface list contains the routing entry of the specified interface.	-
exclude	Indicates that the downstream interface list does not contain the routing entry of the specified interface.	-
match	Indicates that the downstream interface list contains the routing entry of only the specified interface.	-
none	Indicates that the downstream interface list does not have any routing entry.	-
mode	Specifies the PIM operation mode.	If this parameter is set to dm or ssm, the register parameter cannot be specified.
dm	Indicates the Protocol Independent Multicast-Dense Mode (PIM-DM) entry.	-
sm	Indicates the Protocol Independent Multicast-Sparse Mode (PIM-SM) entry.	-
ssm	Indicates the Protocol Independent Multicast-Source-Specific Multicast (PIM-SSM) entry.	-
flags flag-value	Indicates the PIM entry with the specified flag. The flag-value parameter is the type flag of entries.	-
fsm	Displays the details of FSM states.	-
number	Specifies the number of the downstream interfaces to be queried.	The value is an integer that ranges from 0 to 2048.
channel channel-name	Indicates the (*, G) entries or (S, G) entries related to a specified channel.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

Usage Scenario

The display pim routing-table command can be used to display information about PIM routing table. The information includes the RP address, protocol type, keepalive time of interfaces, and upstream and downstream interfaces in multicast routing entries.

Precautions

When using the display pim routing-table command, note the following points:

If vpn-instance or all-instance is not specified, only the public network instance is displayed.
If vpn-instance or all-instance is specified, you cannot specify the VPN instance for the downstream interface. That is, you cannot set vpn-instance or all-instance behind outgoing-interface. This is because only IPv4 multicast VPN is supported at present and only the downstream interface of a public network entry may belong to a specified VPN instance.
If flags flag-value is specified, only the PIM routing entries with flags are displayed.
If outgoing-interface-number is specified, the number of the downstream interfaces of PIM routing entries is displayed.
If number is specified, information about the multicast groups corresponding to the number of downstream interfaces is displayed.

**Table 1** Values of the *flag-value* parameter
Item	Description
2msdp	Indicates that the Rendezvous Point (RP) receives a Register message recently and learns the (S,G) entry. The RP prepares to inform Multicast Source Discovery Protocol (MSDP) of the Source Active (SA) message that contains the (S,G) entry.
act	Indicates that the multicast routing entry at which actual data arrives exists.
del	Indicates the multicast routing entry to be deleted.
exprune	Indicates that the entry on the rendezvous point tree (RPT) is pruned and no receiver on the RPT requests the information sent by the source.
ext	Indicates routing entries that contain downstream interfaces provided by other multicast routing protocols.
loc	Indicates routing entries on the FW directly connected to the network segment where the source resides.
msdp	Indicates the routing entries learned from recently received MSDP SA messages.
niif	Indicates routing entries with unknown upstream interfaces.
nonbr	Indicates that the routing entry of the upstream neighbor address (link-local address) towards the RP or the source is not found.
none	Indicates routing entries without any flag.
rpt	Indicates the routing entries that are on the RPT but do not use the RPT data.
sg_rcvr	Indicates that the (S, G) receiver of S exists on the local FW and PIM is the owner of the downstream interface.
sgjoin	Indicates that the (S, G) receiver of S exists on the local FW and PIM is not the owner of the downstream interface.
spt	Indicates routing entries on the shortest path tree (SPT).
swt	Indicates routing entries during the SPT switchover.
upchg	Indicates a route change has occurred. The current entry uses the original upstream interface to forward data and waits for data received from a new interface.
wc	Indicates a (*, G) entry.

Example

# Display the PIM routing table of the public network instance.

<sysname> display pim routing-table
 VPN-Instance: public net
 Total 0 (*, G) entry; 1 (S, G) entry

 (192.168.0.12, 227.0.0.1)
     RP: 2.2.2.2
     Protocol: pim-sm, Flag: SPT LOC ACT
     UpTime: 02:54:43
     Upstream interface: GigabitEthernet0/0/1
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 1
         1: GigabitEthernet0/0/2
             Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

**Table 2** Description of the **display pim routing-table** command output
Item	Description
VPN-Instance	Indicates the VPN instance to which PIM routing information corresponds.
Total 0 (*, G) entry; 1 (S, G) entry	Indicates the total number of (S, G) and (*, G) entries in the PIM routing table.
(192.168.0.12, 227.0.0.1)	Indicates the (S, G) entries in the PIM routing table.
RP	Indicates the RP address.
Protocol	Indicates the PIM protocol type, which can be PIM-DM, PIM-SM or PIM-SSM.
Flag	Indicates the flag of PIM (S, G) or (, G) entry. NOTE: Run the display pim routing-table* command on the MSDP peer nearest to the source to view routing information. If an (S, G) entry does not have a 2MSDP flag, the MSDP peer is not an RP. Change the configurations of the RP or MSDP peer on the PIM-SM network to ensure that the MSDP peer is an RP.
Uptime	Indicates the Keepalive period of the interface.
Upstream interface	Indicates the upstream interface of the (S, G) entry, (*, G) entry.
Upstream neighbor	Indicates the upstream neighbor of the (S, G) or (*, G) entry.
RPF prime neighbor	Indicates the RPF neighbor of the (S, G) or (, G) entry. For the (, G) entry, when the local FW is an RP, the RPF neighbor in the (*, G) entry is null. For the (S, G) entry, when the local FW is directly connected to the source, the RPF neighbor in the (S, G) entry is null.
Downstream interface (s) information	Indicates the information about the downstream interface, including the following: Total number of downstream interfaces Name of each downstream interface PIM protocol type configured for the downstream interface Keepalive period and timeout period of the downstream interface
Total number of downstreams	Indicates the number of downstream interfaces.
GigabitEthernet0/0/2	Indicates the interface name.
Expires	Indicates the timeout period.

# Display the routing entry to which a specified channel corresponds in the PIM routing table of the public network instance.

<sysname> display pim routing-table channel SDTV
 Total 1 (*, G) entry; 0 (S, G) entry
 Total matched 1 (*, G) entry; 0 (S, G) entry
 (*, 225.1.1.1)
     RP: 192.168.0.1
     Protocol: pim-sm, Flag: WC
     Channel Program: SDTV
     UpTime: 00:03:21
     Upstream interface: GigabitEthernet0/1/0
         Upstream neighbor: 10.0.0.1
         RPF prime neighbor: 10.0.0.1
     Downstream interface(s) information: None

**Table 3** Description of the **display pim routing-table** command output
Item	Description
Total 1 (*, G) entry; 0 (S, G) entry	Indicates the total number of the (S, G) and (*, G) entries in the PIM routing table.
Total matched 1 (*, G) entry; 0 (S, G) entry	Indicates the total number of the (S, G) entries and (*, G) entries that meet the query conditions.
(*, 225.1.1.1)	Indicates the (*, G) entry in the PIM routing table.
Channel Program	Indicates the name of the channel.

# Display the number of the downstream interfaces of PIM routing entries in the public network instance.

<sysname> display pim routing-table outgoing-interface-number
 VPN-Instance: public net
 Total 2 (*, G) entries; 0 (S, G) entry

 (*, 226.1.1.1)
     RP: 2.2.2.2 (local)
     Protocol: pim-sm, Flag: WC EXT
     UpTime: 21:37:28
     Upstream interface: Register
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 2048

 (*, 226.1.2.1)
     RP: 2.2.2.2 (local)
     Protocol: pim-sm, Flag: WC EXT
     UpTime: 21:37:28
     Upstream interface: Register
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 2048

**Table 4** Description of the **display pim routing-table** **outgoing-interface-number** command output
Item	Description
Total 2 (*, G) entries; 0 (S, G) entry	Indicates the total number of the (S,G) entries and (*,G) entries in the PIM routing table.
Total number of downstreams	Indicates the total number of the downstream interfaces of the (*, G) entries or (S, G) entries.

# Display brief information about the PIM routing entries in the public network instance.

<sysname> display pim routing-table brief
  VPN-Instance: public net
 Total 0 (*, G) entry; 6 (S, G) entries

  00001.(10.0.4.100, 225.0.0.1)
       Upstream interface:GigabitEthernet0/0/0
       Number of downstream:1
       Number of receive vrf:0
  00002.(10.0.4.100, 225.0.0.2)
       Upstream interface:GigabitEthernet0/0/0
       Number of downstream:1
       Number of receive vrf:0
  00003.(10.0.4.100, 225.0.0.3)
       Upstream interface:GigabitEthernet0/0/0
       Number of downstream:1
       Number of receive vrf:0
  00004.(10.0.4.100, 225.0.0.4)
       Upstream interface:GigabitEthernet0/0/0
       Number of downstream:1
       Number of receive vrf:0
  00005.(10.0.4.100, 225.0.0.5)
       Upstream interface:GigabitEthernet0/0/0
       Number of downstream:1
       Number of receive vrf:0
  00006.(10.0.4.100, 225.0.0.6)
       Upstream interface:GigabitEthernet0/0/0
       Number of downstream:1
       Number of receive vrf:0

**Table 5** Description of the **display pim routing-table** **brief** command output
Item	Description
Total 0 (*, G) entry; 6 (S, G) entries	Indicates the total number of the (S,G) entries and (*,G) entries in the PIM routing table.
Upstream interface	Indicates the upstream interface.
Number of downstream	Indicates the number of downstream.
Number of receive vrf	Indicates the number of receive vrf.

# Display detailed information about FSM states in the PIM multicast routing table of the public network instance

<sysname> display pim routing-table fsm
 VPN-Instance: public net
 Total 1 (S, G) entry

 Abbreviations for FSM states and Timers:
     NI - no info, J - joined, NJ - not joined, P - pruned,
     NP - not pruned, PP - prune pending, W - winner, L - loser,
     F - forwarding, AP - ack pending, DR - designated router,
     NDR - non-designated router, RCVR - downstream receivers,
     PPT - prunepending timer, GRT - graft retry timer,
     OT - override timer, PLT - prune limit timer,
     ET - join expiry timer, JT - join timer,
     AT - assert timer, PT - prune timer

 (1.1.1.1, 232.1.1.1)
     Protocol: pim-ssm, Flag: NIIF SG_RCVR
     UpTime: 00:01:21
     Upstream interface: NULL
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
         Join/Prune FSM: [NJ]
     Downstream interface(s) information:
     Total number of downstreams: 1
         1: Serial0/0/0
             Protocol: static, UpTime: 00:01:21, Expires: -
             DR state: [DR]
             Join/Prune FSM: [NI]
             Assert FSM: [NI]

     FSM information for non-downstream interfaces: None

**Table 6** Description of the **display pim routing-table fsm** command output
Item	Description
Abbreviations for FSM states and Timers	Abbreviations for FSM states and timers
Join/Prune FSM	FSM state of Join or Prune
DR state	FSM state of the DR
Assert FSM	FSM state of the Assert

# Display information about backup inbound and outbound interfaces in the PIM multicast routing table of the public network instance.

<sysname> display pim routing-table
 VPN-Instance: public net
 Total 0 (*, G) entry; 1 (S, G) entry

 (10.0.5.100, 225.0.0.1)
     RP: 3.3.3.3
     Protocol: pim-sm, Flag: SPT ACT
     UpTime: 03:33:11
     Upstream interface: GigabitEthernet0/0/1
         Upstream neighbor: 192.168.2.1
         RPF prime neighbor: 192.168.2.1
     Backup upstream interface: GigabitEthernet0/0/0
         Backup upstream neighbor: 192.168.4.2
     Backup downstream interface: GigabitEthernet0/0/1
             Protocol: pim-sm, UpTime: 00:45:32, Expires: 00:01:45
     Downstream interface(s) information:
     Total number of downstreams: 2
         1: GigabitEthernet0/0/0
             Protocol: pim-sm, UpTime: 00:54:57, Expires: 00:02:36
         2: LoopBack6
             Protocol: pim-sm, UpTime: 03:33:11, Expires: -

**Table 7** Description of the **display pim routing-table** command output
Item	Description
Backup upstream interface	Backup outbound interface information recorded in the (S, G) entry
Backup upstream neighbor	Upstream neighbor information recorded in the backup (S, G) entry
Backup downstream interface	Backup downstream interface information recorded in the backup (S, G) entry