display pim routing-table

Use display pim routing-table to display PIM routing entries.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays PIM routing entries on the public network.

group-address: Specifies a multicast group by its IP address in the range of 224.0.0.0 to 239.255.255.255. If you do not specify a multicast group, this command displays PIM routing entries for all multicast groups.

source-address: Specifies a multicast source by its IP address.

mask-length: Specifies an address mask length in the range of 0 to 32. The default value is 32.

mask: Specifies an address mask. The default value is 255.255.255.255.

flags flag-value: Specifies a flag. If you do not specify a flag, this command displays PIM routing entries that contain all flags. The following lists the values for the flag-value argument and their meanings:

2msdp: Specifies PIM routing entries to be contained in the next SA message to notify an MSDP peer.
act: Specifies PIM routing entries that have been used for routing data.
del: Specifies PIM routing entries to be deleted.
exprune: Specifies PIM routing entries containing outgoing interfaces pruned by other multicast routing protocols.
ext: Specifies PIM routing entries containing outgoing interfaces provided by other multicast routing protocols.
loc: Specifies PIM routing entries on the devices that reside on the same subnet as the multicast source.
msdp: Specifies PIM routing entries learned from MSDP SA messages.
niif: Specifies PIM routing entries containing unknown incoming interfaces.
nonbr: Specifies PIM routing entries with PIM neighbor lookup failure.
rpt: Specifies PIM routing entries on the RPT branches where (S, G) prunes have been sent to the RP.
rq: Specifies PIM routing entries of the receiving side of the data-MDT switchover.
spt: Specifies PIM routing entries on the SPT.
sq: Specifies PIM routing entries of the originator side of data-MDT switchover.
swt: Specifies PIM routing entries in the process of RPT-to-SPT switchover.
vxlan: Specifies VXLAN overlay entries maintained by PIM.
wc: Specifies PIM routing entries with wildcards.

fsm: Displays detailed information about the finite state machine.

incoming-interface interface-type interface-number: Specifies an incoming interface. If you do not specify an incoming interface, this command displays PIM routing entries that contain all incoming interfaces.

mode mode-type: Specifies a PIM mode. If you do not specify a PIM mode, this command displays PIM routing entries in all PIM modes. The available PIM modes include:

bidir: Specifies BIDIR-PIM.
dm: Specifies PIM-DM.
sm: Specifies PIM-SM.
ssm: Specifies PIM-SSM.

outgoing-interface { exclude | include | match } interface-type interface-number: Specifies an outgoing interface. If you do not specify an outgoing interface, this command displays PIM routing entries that contain all outgoing interfaces. Whether an outgoing interface is contained in the PIM routing table depends on the following conditions:

If you specify an excluded interface, this command displays PIM routing entries that do not contain the specified outgoing interface.
If you specify an included interface, this command displays PIM routing entries that contain the specified outgoing interface.
If you specify a matching interface, this command displays PIM routing entries that contain only the specified outgoing interface.

Examples

# Display PIM routing entries on the public network.

<Sysname> display pim routing-table
 Total 0 (*, G) entries; 1 (S, G) entries

 (172.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: Vlan-interface1
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface information:
     Total number of downstream interfaces: 1
         1: Vlan-interface2
             Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

Table 47: Command output

Field	Description
Total 0 (*, G) entries; 1 (S, G) entries	Total number of (*, G) entries, and the total number of (S, G) entries.
(172.168.0.12, 227.0.0.1)	(S, G) entry.
Protocol	PIM mode.
Flag	Flag of the (S, G) entry or (, G) entry: 2MSDP—The entry is to be advertised by the MSDP module in the next (S, A) message. ACT—The entry has been used for routing data. DEL—The entry is to be removed. EXPRUNE—Some outgoing interfaces are pruned by other multicast routing protocols. EXT—The entry contains outgoing interfaces provided by other multicast routing protocols. LOC—The entry is on a router directly connected to the same subnet with the multicast source. MSDP—The entry is learned from an MSDP (S, A) message. NIIF—The entry contains unknown incoming interfaces. NONBR—The entry has a PIM neighbor lookup failure. RPT—The entry is on an RPT branch where (S, G) prunes have been sent to the RP. SPT—The entry is on the SPT. SQ—The entry triggers the default-MDT to data-MDT switchover. SWT—The entry is in the process of RPT-to-SPT switchover. VXLAN*—The entry is a VXLAN overlay entry. WC—The entry contains a wildcard.
Uptime	Length of time for which the (S, G) entry or (*, G) entry has been up.
Upstream interface	Upstream (incoming) interface of the (S, G) entry or (*, G) entry.
Upstream neighbor	Upstream neighbor of the (S, G) entry or (*, G) entry.
RPF prime neighbor	RPF neighbor of the (S, G) or (, G) entry: For a (, G) entry, if the RPF neighbor is the RP, the field displays NULL. For an (S, G) entry, if the RPF neighbor is a router that directly connects to the multicast source, this field displays NULL.
Downstream interface information	Information about the downstream interfaces: Total number of downstream interfaces. Names of the downstream interfaces. Protocol type on the downstream interfaces. Uptime of the downstream interfaces. Expiration time of the downstream interfaces.

prev	up	next
display pim neighbor	home	display pim rp-info