display pim ipv6 routing-table (All views)

Function

The display pim ipv6 routing-table command displays information about an IPv6 PIM routing table.

Format

display pim ipv6 { vpn-instance vpn-instance-name | all-instance } routing-table [ groupAddr [ mask group-mask-length ] | srcAddr [ mask source-mask-length ] | incoming-interface { { iif-port-type iif-port-num | iif-port-name } | register | through-bgp | pseudo } | backup-incoming-interface through-bgp | outgoing-interface { include | exclude | match } { { oif-port-type oif-port-num | oif-port-name } [ bas ] | register | none | pseudo } | mode { ssm | sm } | flags { act | del | exprune | ext | loc | niif | nonbr | none | rpt | sg_rcvr | sgjoin | spt | swt | upchg | wc | excl | bgp | 2bgp | frrchg } | fsm ] ^* [ outgoing-interface-number [ oif-number ] ]

Parameters

Parameter	Description	Value
vpn-instance vpn-instance-name	Specifies the name of a VPN instance.	The value is a string of 1 to 31 case-sensitive characters, spaces not supported. The VPN instance name cannot be <b>_public_</b>. When double quotation marks are used around the string, spaces are allowed in the string.
all-instance	Specifies all VPN instances.	-
groupAddr	Specifies the IPv6 address of a multicast group.	The value is in the format X:X:X:X:X:X:X:X.
mask group-mask-length	Specifies the mask length of a multicast group.	The value is an integer. The mask length of the multicast group ranges from 0 to 128.
mask source-mask-length	Specifies the mask length of a multicast source.	The value is an integer. The mask length of the multicast source ranges from 0 to 128.
srcAddr	Specifies the IPv6 address of a multicast source.	The value is in the format X:X:X:X:X:X:X:X.
incoming-interface iif-port-type iif-port-num	Displays the PIM routing entries with specified upstream interfaces.	The value is a string of 1 to 63 case-sensitive characters, spaces not supported.
iif-port-name	Displays the PIM routing entries with specified upstream interfaces.	The value is a string of 1 to 63 case-sensitive characters, spaces not supported.
register	Displays information about a register interface.	-
through-bgp	Specifies the interface that uses BGP to send signaling.	-
pseudo	Specifies the MVPN pseudo interface.	-
backup-incoming-interface	Displays the backup PIM routing entries with specified upstream interfaces.	-
outgoing-interface oif-port-type oif-port-num	Displays the PIM routing entries with specified downstream interfaces.	The values of outgoing-interface are as follows: include exclude match
oif-port-name	Displays the PIM routing entries with specified downstream interfaces.	The value is a string of 1 to 63 case-sensitive characters, spaces not supported.
bas	Specifies the bas interface.	-
none	Displays the PIM routing entries with no downstream interfaces.	-
mode	Indicates an IPv6 PIM mode.	-
ssm	Displays Protocol Independent Multicast-Source-Specific Multicast (PIM-SSM) routing entries.	-
sm	Displays Protocol Independent Multicast-Sparse Mode (PIM-SM) routing entries.	-
flags	Indicates the type of a routing entry.	Type of a routing entry: act del exprune ext loc niif nonbr none rpt sg_rcvr sgjoin spt swt upchg wc excl bgp 2bgp frrchg
frrchg	Specifies the type of a frrchg routing entry.	-
fsm	Indicates the details of FSM states.	-
outgoing-interface-number oif-number	Displays the IPv6 PIM routing entries with a specified number of downstream interfaces.	-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name	Operations
pim	read

Usage Guidelines

Usage Scenario

The display pim ipv6 routing-table command is used to display the contents of an IPv6 PIM routing table, including the source addresses and group addresses, Rendezvous Points (RPs), and upstream interface and downstream interface lists of the (S, G) and (*, G) entries.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the IPv6 PIM routing entries with a specified number of downstream interfaces.

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

 (*, FF25::1)
     RP: 2001:DB8:1::1 (local)
     Protocol: pim-sm, Flag: WC
     UpTime: 00:00:04
     Upstream interface: Register, Refresh time: 00:00:04
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 2048

 (*, FF25::2)
     RP: 2001:DB8:1::1 (local)
     Protocol: pim-sm, Flag: WC
     UpTime: 00:00:05
     Upstream interface: Register, Refresh time: 00:00:05
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
     Downstream interface(s) information:
     Total number of downstreams: 2048

# Display the IPv6 PIM routing table of the backup upstream interface that is through-BGP.

<R1-PE-LEAF> display pim ipv6 all-instance routing-table backup-incoming-interface through-bgp
 VPN-Instance: ng_bier
 Total 2 (*, G) entries; 2 (S, G) entries 
 
 Total matched 0 (*, G) entry; 1 (S, G) entry
 
 (2001:DB5:1::6, FF1E::4)
     RP: 2001:DB2:1::2 
     Protocol: pim-sm, Flag: SPT ACT BGP 
     UpTime: 19:12:08
     Upstream interface: through-BGP, Refresh time: 19:12:08     
         Upstream neighbor: ::FFFF:1.1.1.2
         RPF prime neighbor: ::FFFF:1.1.1.2
     Backup upstream interface: through-BGP
         Backup upstream neighbor: ::FFFF:1.1.1.3
         Backup RPF prime neighbor: ::FFFF:1.1.1.3
     Downstream interface(s) information:
     Total number of downstreams: 1
        1: Ethernet0/1/22.1
             Protocol: pim-sm, UpTime: 19:12:08, Expires: -

# Display information about an IPv6 PIM routing table.

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

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

(2001:DB8:1::1, FFE3::1)
  Protocol: pim-sm, Flag:
  UpTime: 00:04:24
  Upstream interface: GigabitEthernet0/1/8, Refresh time: 00:04:24
    Upstream neighbor: FE80::A01:100:1
    RPF prime neighbor: FE80::A01:100:1
 Downstream interface(s) information:
 Total number of downstreams: 1
    1: GigabitEthernet0/1/0
        Protocol: pim-sm, UpTime: 00:04:24, Expires:  -

**Table 1** Description of the **display pim ipv6 routing-table (All views)** command output
Item	Description
Total 1 (*, G) entry; 1 (S, G) entry	Total number of (S, G) entries and (*, G) entries in an IPv6 PIM routing table.
Total number of downstreams	Total number of downstream interfaces.
(*, FFE3::1)	(*, G) entry in an IPv6 PIM routing table.
Upstream interface	Upstream interface of an (S, G) entry or (*, G) entry.
Upstream neighbor	Upstream neighbor of an (S, G) entry or (*, G) entry.
Refresh time	Refresh time of upstream interface.
RPF prime neighbor	RPF neighbor of an (S, G) entry or (, G) entry. For an (, G) entry, when the local router is an RP, the RPF neighbor is Null. For an (S, G) entry, when the local router is directly connected to the multicast source, the RPF neighbor is Null.
Downstream interface(s) information	Information about downstream interfaces, including: Total number of downstream interfaces. Downstream interface name. Type of the PIM protocol configured on the downstream interface. Existing time and timeout period of the downstream interface.
Backup upstream interface	Backup upstream interface of an (S, G) entry.
Backup upstream neighbor	Backup upstream neighbor of an (S, G) entry.
Backup RPF prime neighbor	Backup RPF neighbor of an (S, G) entry.
VPN-Instance	VPN instance to which PIM routing information belongs.
Protocol	PIM protocol type, which can be PIM-SM, PIM-SSM.
Flag	Flag of a PIM (S, G) entry or (*, G) entry.
UpTime	UpTime under (S, G) or (*, G) indicates the lifetime of the entry. UpTime in the interface list indicates the lifetime of the entry on the corresponding interface.
GigabitEthernet0/1/0	Interface name.
Expires	Timeout interval.
RP	RP information.