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 | proxy ] *

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-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.
2mvpn: Specifies PIM routing entries that have been advertised to MVPN.
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.
rc: Specifies PIM routing entries that have received C-Multicast route information.
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.
src-act: Specifies PIM routing entries that have received Source Active A-D route information.
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.

proxy: Displays information about the RPF vector used by PIM routing entries.

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 51: 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. 2MVPN—The entry has been advertised to MVPN. 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. RC—The entry has received C-Multicast route information. 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. SRC-ACT—The entry has received Source Active A-D route information. 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.

# Display information about the RPF vector used by the public network PIM routing entries on a PE device.

<Sysname> display pim routing-table proxy
 (100.0.0.8, 232.1.1.1)
    Proxy: 10:1/192.168.0.4
    Assigner: 0.0.0.0         Origin: BGP MDT
    Uptime: 02:08:18          Expires: Off

# Display information about the RPF vector used by the public network PIM routing entries on a P device.

<Sysname> display pim routing-table proxy
(100.0.0.8, 232.1.1.1)
    Proxy: 10:1/192.168.0.4
    Assigner: 1.0.3.1         Origin: PIM
    Uptime: 02:19:33          Expires: 00:02:12

# Display information about the RPF vector used by the public network PIM routing entries on an ASBR.

<Sysname> display pim routing-table proxy
(100.0.0.1, 232.1.1.1)
    Proxy: 10:1/local
    Assigner: 1.0.5.9         Origin: PIM
    Uptime: 02:22:04          Expires: 00:02:35
 (100.0.0.8, 232.1.1.1)
    Proxy: 10:1/local
    Assigner: 1.0.4.1         Origin: PIM
    Uptime: 02:21:10          Expires: 00:02:35

Table 52: Command output

Field	Description
Proxy	RPF vector, including the RD and the IP address of the RPF vector. If the RPF vector resides on the device where the command is executed, this field displays (local) after the IP address.
Assigner	IP address of the device from which the RPF vector is obtained: On PE devices, the RPF vector is obtained from a BGP MDT routing entry. This field displays 0.0.0.0. On non-PE devices, the RPF vector is obtained from the PIM join message sent by a downstream PIM neighbor. This field displays the IP address of the downstream PIM neighbor.
Origin	Protocol that origins the RPF vector: On PE devices, the RPF vector is obtained from a BGP MDT routing entry. This field displays BGP MDT. On non-PE devices, the RPF vector is obtained from the PIM join message sent by a downstream PIM neighbor. This field displays PIM.
Uptime	Length of time since the RPF vector is originated.
Expires	Remaining timeout time for the RPF vector, where Off means that the timer is disabled.

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