display ipv6 pim routing-table

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

Syntax

display ipv6 pim [ vpn-instance vpn-instance-name ] routing-table [ ipv6-group-address [ prefix-length ] | ipv6-source-address [ prefix-length ] | 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

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 IPv6 PIM routing entries on the public network.

ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this argument is FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F. If you do not specify an IPv6 multicast group, this command displays IPv6 PIM routing entries for all IPv6 multicast groups.

ipv6-source-address: Specifies an IPv6 multicast source by its IPv6 address.

prefix-length: Specifies a prefix length of the IPv6 multicast group or IPv6 multicast source address. The default is 128. For an IPv6 multicast group address, the value range for this argument is 8 to 128. For an IPv6 multicast source address, the value range for this argument is 0 to 128.

flags flag-value: Specifies a flag. If you do not specify a flag, this command displays IPv6 PIM routing entries that contain all flags.

The following lists the values for the flag-value argument and their meanings:

act: Specifies IPv6 PIM routing entries that have been used for routing data.
del: Specifies IPv6 PIM routing entries to be deleted.
exprune: Specifies IPv6 PIM routing entries that contain outgoing interfaces pruned by other IPv6 multicast routing protocols.
ext: Specifies IPv6 PIM routing entries that contain outgoing interfaces provided by other multicast routing protocols.
loc: Specifies IPv6 PIM routing entries on the devices that reside on the same subnet as the IPv6 multicast source.
niif: Specifies IPv6 PIM routing entries that contain unknown incoming interfaces.
nonbr: Specifies IPv6 PIM routing entries with IPv6 PIM neighbor lookup failure.
rpt: Specifies IPv6 PIM routing entries on the RPT branches where (S, G) prunes have been sent to the RP.
rq: Specifies IPv6 PIM routing entries on the receiving side of the RPT-to-SPT switchover.
spt: Specifies IPv6 PIM routing entries on the SPT.
sq: Specifies IPv6 PIM routing entries on the originating side of the RPT-to-SPT switchover.
swt: Specifies IPv6 PIM routing entries in the process of RPT-to-SPT switchover.
wc: Specifies IPv6 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 IPv6 PIM routing entries that contain all incoming interfaces.

interface-type interface-number: Specifies an interface by its type and number.

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

bidir: Specifies IPv6 BIDIR-PIM.
dm: Specifies IPv6 PIM-DM.
sm: Specifies IPv6 PIM-SM.
ssm: Specifies IPv6 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 IPv6 PIM routing entries that contain all outgoing interfaces. Whether the specified outgoing interface is contained in the IPv6 PIM routing table depends on the following conditions:

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

Examples

# Display IPv6 PIM routing entries on the public network.

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

 (2001::2, FFE3::101)
     RP: FE80::A01:100:1
     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

# Display state machine information for the IPv6 PIM routing table on the public network.

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

 Abbreviations for FSM states:
     NI - no info, J - joined, NJ - not joined, P - pruned,
     NP - not pruned, PP - prune pending, W - winner, L - loser,
     F - forwarding, AP - ack pending, DR - designated router,
     NDR - non-designated router, RCV - downstream receivers

 (2001::2, FFE3::101)
     RP: FE80::A01:100:1
     Protocol: pim-sm, Flag: SPT LOC ACT
     UpTime: 02:54:43
     Upstream interface: Vlan-interface1
         Upstream neighbor: NULL
         RPF prime neighbor: NULL
         Join/Prune FSM: [SPT: J] [RPT: NP]
     Downstream interface information:
     Total number of downstream interfaces: 1
         1: Vlan-interface2
             Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47
             DR state: [DR]
             Join/Prune FSM: [NI]
             Assert FSM: [NI]

     FSM information for non-downstream interfaces: None

Table 124: 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.
(2001::2, FFE3::101)	(S, G) entry.
RP	IPv6 address of the RP.
Protocol	IPv6 PIM mode: IPv6 PIM-SM or IPv6 PIM-DM.
Flag	Flag of the (S, G) entry or (, G) entry: ACT—The entry has been used for routing data. DEL—The entry will be removed. EXPRUNE—Some outgoing interfaces are pruned by other IPv6 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 IPv6 multicast source. NIIF—The entry contains unknown incoming interfaces. NONBR—The entry has an IPv6 PIM neighbor lookup failure. RPT—The entry is on an RPT branch where (S, G) prunes have been sent to the RP. RQ—The entry is on the receiving side of the RPT-to-SPT switchover. SPT—The entry is on the SPT. SQ—The entry is on the originating side of the RPT-to-SPT switchover. SWT*—The entry is in the process of RPT-to-SPT switchover. WC—The entry contains a wildcard.
Uptime	Length of time since the (S, G) entry or (*, G) entry was installed.
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 IPv6 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 ipv6 pim neighbor	home	display ipv6 pim rp-info