display pim ipv6 routing-table

Function

The display pim ipv6 routing-table command displays the PIM (IPv6) multicast routing table.

Format

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

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

Parameters

Parameter	Description	Value
ipv6-source-address	Specifies the IPv6 address of a multicast source.	The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X.
ipv6-group-address	Specifies the IPv6 address of a multicast group address.	The address is a 32-digit hexadecimal number, in the format X:X:X:X:X:X:X:X. An IPv6 multicast address starts with FF.
mask mask-length	Specifies the mask length of a multicast source or group.	The value is an integer. The mask length of a multicast source ranges from 0 to 128. The mask length of a multicast group ranges from 8 to 128.
flags flag-value	Displays of routing entries of a specified type. flag-value specifies the flag of a routing entry.	-
fsm	Displays detailed information about the finite state machine (FSM).	-
incoming-interface	Displays the routing entry with the specified upstream interface.	-
interface-type interface-number	Specifies the type and number of an interface.	-
register	Displays the register interface.	-
dm	Displays PIM-DM (IPv6) routing entries.	-
sm	Displays PIM-SM (IPv6) routing entries.	-
ssm	Displays PIM-SSM (IPv6) routing entries.	-
outgoing-interface { exclude \| include \| match }	Displays the routing entries with or without a specified outbound interface. exclude: displays the entries that do not contain the specified interface. include: displays the entries that contain the specified interface. match: displays the entries match the specified interface.	-
none	Displays the routing entry without the downstream interface.	-
outgoing-interface-number	Displays the number of the outbound interfaces of routing entries.	-
number	Specifies the number of the outbound interfaces to be queried.	-
brief	Displays only the name of upstream interface and the number of downstream interfaces of routing entries.	-

Views

All views

Default Level

1: Monitoring level

Usage Guidelines

You can use this command to:

Check whether PIM (IPv6) 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 (IPv6) network.

The PIM (IPv6) 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
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 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 switch directly connected to the network segment where the source resides.
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 switch and PIM (IPv6) is the owner of the downstream interface.
sgjoin	Indicates that the (S, G) receiver of S exists on the local switch and PIM (IPv6) 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 (IPv6) multicast routing table.

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

 (*, FFE3::1)
     RP: FC00:0:0:1::1
     Protocol: pim-sm, Flag: WC
     UpTime: 00:57:31
     Upstream interface: NULL
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 1
         1: Vlanif10
             Protocol: static, UpTime: 00:57:31, Expires: never

 (FC00:0:0:2001::2, FFE3::1)
     RP: FC00:0:0:1::1
     Protocol: pim-sm, Flag: ACT WC
     UpTime: 00:04:24
         1: Vlanif20
         Upstream neighbor: FE80::A01:100:1
         RPF prime neighbor: FE80::A01:100:1
     Downstream interface(s) information:
     Upstream interface: Vlanif10
             Protocol: pim-dm, UpTime: 00:04:24, Expires:  -

Choose Columns...

**Table 2** Description of the **display pim ipv6 routing-table** command output
Item	Description
Total 1 (*, G) entry; 1 (S, G) entry	Total number of the (S, G) entries and (*, G) entries in the PIM routing table.
(*, FFE3::1)	(*, G) entry in the PIM routing table.
RP	RP address.
Protocol	Type of PIM (IPv6) protocols, PIM-DM (IPv6), PIM-SM (IPv6), or PIM-SSM (IPv6).
Flag	Flag of a (S, G) entry or (*, G) entry in the PIM (IPv6) routing table.
UpTime	Lifetime of an interface.
Upstream interface	Upstream interface of a (S, G) entry or (*, G) entry.
Upstream neighbor	Upstream neighbor of a (S, G) entry or (*, G) entry.
RPF prime neighbor	RPF neighbor of a (S, G) entry or (, G) entry. For a (, G) entry, when the local device is an RP, the RPF neighbor is Null. For a (S, G) entry, when the local device is directly connected to the multicast source, the RPF neighbor is Null.
Downstream interface(s) information	Information about downstream interfaces, including: Number of downstream interfaces Names of downstream interfaces Type of the PIM (IPv6) protocol configured on the downstream interfaces Existing period and timeout period of downstream interfaces
Total number of downstreams	Number of downstream interfaces.
Vlanif10	Interface name.
Expires	Timeout period of an entry.

# Display the brief information about PIM (IPv6) routing entries.

<HUAWEI> display pim ipv6 routing-table brief FF25::1
 VPN-Instance: public net
 Total 3 (*, G) entries; 3 (S, G) entries

 Total matched 1 (*, G) entry; 1 (S, G) entry

  00001. (FC00:0:0:2008::55, FF25::1)
       Upstream interface: Vlanif10
       Number of downstreams: 2
  00002. (*, FF25::1)
       Upstream interface: Vlanif10
       Number of downstreams: 2

**Table 3** Description of the display pim ipv6 routing-table brief command output
Item	Description
Total 3 (*, G) entries; 3 (S, G) entries	Total number of the (S, G) entries and (*, G) entries in the PIM (IPv6) routing table.
Total matched 1 (*, G) entry; 1 (S, G) entry	Total number of the (S, G) entries and (*, G) entries that meet the query conditions in the PIM routing table.
00001. (FC00:0:0:2008::55, FF25::1)	(S, G) entry.
Number of downstreams	Number of downstream interfaces in (S, G) entries or (*, G) entries.

# Display the number of the outbound interfaces of PIM (IPv6) routing entries.

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

 (*, FF25::1)
     RP: FC00:0:0:2008::5:3:2 (local)
     Protocol: pim-sm, Flag: WC
     UpTime: 00:00:04
     Upstream interface: Register
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 2

 (*, FF25::2)
     RP: FC00:0:0:2008::5:3:2 (local)
     Protocol: pim-sm, Flag: WC
     UpTime: 00:00:05
     Upstream interface: Register
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 2