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 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 | 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 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 | vpn-instance vpn-instance-name | register | none } | mode { dm | sm | ssm } | flags flag-value | fsm ] ^* [ outgoing-interface-number [ number ] ]

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Displays PIM routing entries in a specified VPN instance. vpn-instance-name specifies the name of the VPN instance.	The value must be an existing VPN instance name.
all-instance	Displays PIM routing entries in all the instances.	-
group-address	Displays the PIM routing entry of a specified group.	The address is in dotted decimal notation. The value ranges from 224.0.1.0 to 239.255.255.255.
mask	Specifies the mask of a multicast source address or group address.	-
group-mask	Specifies the group address mask.	The address is in dotted decimal notation.
group-mask-length	Specifies the length of the group address mask.	The value is an integer that ranges from 4 to 32.
source-address	Displays the PIM routing entry of a specified multicast source.	The source address is in dotted decimal notation.
source-mask	Specifies the multicast source IP address mask.	The address mask 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.
incoming-interface	Displays the PIM routing entries with a specified interface as the upstream interface.	-
interface-type interface-number	Specifies the type and number of an interface.	-
register	Indicates the register interface.	-
outgoing-interface	Displays the PIM routing entries with a specified interface as the downstream interface.	-
include	Displays the PIM routing entries with the downstream interface list containing a specified interface.	-
exclude	Displays the PIM routing entries with the downstream interface list not containing a specified interface.	-
match	Displays the PIM routing entries with the downstream interface list containing only the specified interface.	-
none	Displays the PIM routing entries with an empty downstream interface list.	-
mode	Specifies the PIM operation mode.	-
dm	Displays PIM-DM routing entries.	-
sm	Displays PIM-SM routing entries.	-
ssm	Displays PIM-SSM routing entries.	-
flags flag-value	Displays PIM-SSM routing entries with the specified flag. The flag-value parameter is the type flag of entries.	-
fsm	Displays the details of FSM states.	-
outgoing-interface-number	Displays the number of downstream interfaces of PIM routing entries.	-
number	Specifies the number of the downstream interfaces to be displayed.	The value is an integer that ranges from 0 to 2048.
brief	Displays only the upstream interface names and the number of downstream interfaces in PIM routing entries.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to:

Check whether PIM has been configured successfully on the network.
Check the inbound interfaces, outbound interfaces, flags, and other information in the routing entries to identify failure points when forwarding errors occur on the PIM network.

The PIM routing table includes both (*, G) and (S, G) entries. (*, G) entries are used to set up a rendezvous point tree (RPT), and (S, G) entries are used to set up a shortest path tree (SPT).

Table 1 lists the values of the flags flag-value parameter.

Choose Columns...

**Table 1** Values of the flag-value parameter
Item	Description
2msdp	The RP received a Register message recently and learned the (S, G) entry. The RP will notify MSDP of the (S, G) entry in the next SA message.
act	Multicast routing entries that have matched received data.
del	Multicast routing entries to be deleted.
exprune	Multicast routing entries pruned from the RPT, with no receiver interested in the data from the source.
ext	Multicast routing entries that contain downstream interfaces provided by other multicast routing protocols.
loc	Multicast routing entries on the switch directly connected to the network segment of the multicast source.
msdp	Multicast routing entries learned from recently received MSDP SA messages.
niif	Multicast routing entries with unknown upstream interfaces.
nonbr	Multicast routing entries in which the upstream neighbor address (link-local address) towards the RP or the source is not found.
none	Multicast routing entries without any flag.
rpt	Multicast routing entries that are on the RPT but do not use the RPT data.
sg_rcvr	The switch has receivers of the source specified in the (S, G) entry, and PIM is the owner of the downstream interfaces.
sgjoin	The switch has receivers of the source specified in the (S, G) entry, but PIM is not the owner of the downstream interfaces.
spt	Multicast routing entries on the shortest path tree (SPT).
swt	Multicast routing entries during the SPT switchover.
upchg	A route change has occurred. The current entry is using the original upstream interface to forward data and is waiting for data received from a new interface.
wc	(*, G) entry.

Example

# Display the PIM routing table of the switch.

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

 (172.16.0.12, 227.0.0.1)
     RP: 10.2.2.2
     Protocol: pim-sm, Flag: SPT LOC ACT
     UpTime: 02:54:43
     Upstream interface: Vlanif 10
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 1
         1: Vlanif 20
             Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

Choose Columns...

**Table 2** Description of the **display pim routing-table** command output
Item	Description
Total 0 (*, G) entry; 1 (S, G) entry	Total number of (S, G) and (*, G) entries in the PIM routing table.
(172.16.0.12, 227.0.0.1)	(S, G) entry in the PIM routing table.
RP	RP address.
Protocol	PIM protocol type, which can be PIM-DM, PIM-SM or PIM-SSM.
Flag	Flag of PIM (S, G) or (, G) entry. Refer to the table of Values of the flag-value parameter*.
UpTime	Amount of time an interface has been Up.
Upstream interface	Upstream interface in an (S, G) entry or (*, G) entry.
Upstream neighbor	Upstream neighbor of an (S, G) or (*, G) entry.
RPF prime neighbor	RPF neighbor of an (S, G) or (, G) entry. For a (, G) entry, when the local device is an RP, the RPF neighbor in the (*, G) entry is null. For an (S, G) entry, when the local device is directly connected to the source, the RPF neighbor in the (S, G) entry is null.
Downstream interface(s) information	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	Number of downstream interfaces.
Expires	Timeout period of an interface.

# Display the number of the downstream interfaces of PIM routing entries on the switch.

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

 (*, 226.1.1.1)
     RP: 10.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: 50

 (*, 226.1.2.1)
     RP: 10.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: 50

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