- Table of Contents
-
- 06-IP Multicast Command Reference
- 00-Preface
- 01-IGMP snooping commands
- 02-PIM snooping commands
- 03-Multicast VLAN commands
- 04-Multicast routing and forwarding commands
- 05-IGMP commands
- 06-PIM commands
- 07-MSDP commands
- 08-MLD snooping commands
- 09-IPv6 PIM snooping commands
- 10-IPv6 multicast VLAN commands
- 11-IPv6 multicast routing and forwarding commands
- 12-MLD commands
- 13-IPv6 PIM commands
- Related Documents
-
Title | Size | Download |
---|---|---|
09-IPv6 PIM snooping commands | 111.19 KB |
display ipv6 pim-snooping neighbor
display ipv6 pim-snooping router-port
display ipv6 pim-snooping routing-table
display ipv6 pim-snooping statistics
ipv6 pim-snooping graceful-restart join-aging-time
ipv6 pim-snooping graceful-restart neighbor-aging-time
reset ipv6 pim-snooping statistics
IPv6 PIM snooping commands
display ipv6 pim-snooping neighbor
Use display ipv6 pim-snooping neighbor to display IPv6 PIM snooping neighbor information.
Syntax
display ipv6 pim-snooping neighbor [ vlan vlan-id | vsi vsi-name ] [ slot slot-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays IPv6 PIM snooping neighbor information for all VLANs.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays IPv6 PIM snooping neighbor information for all VSIs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays IPv6 PIM snooping neighbor information for the master device.
verbose: Displays detailed information about IPv6 PIM snooping neighbors. If you do not specify this keyword, the command displays brief information about IPv6 PIM snooping neighbors.
Examples
# Display detailed information about IPv6 PIM snooping neighbors for VLAN 2.
<Sysname> display ipv6 pim-snooping neighbor vlan 2 verbose
Total 2 neighbors.
VLAN 2: Total 2 neighbors.
FE80::6401:101
Slots (0 in total):
Ports (1 in total):
GE1/0/1 (02:02:23) LAN Prune Delay(T)
FE80::C801:101
Slots (0 in total):
Ports (1 in total):
GE1/0/2 (02:02:25)
# Display brief information about IPv6 PIM snooping neighbors for VSI aaa.
<Sysname> display ipv6 pim-snooping neighbor vsi aaa
Total 3 neighbors.
VSI aaa: Total 3 neighbors.
FE80::1
Ports (1 in total):
GE1/0/3 (Link ID 0) (00:02:04)
FE80::2
Ports (1 in total):
NPW (Link ID 8) (00:02:04)
FE80::3
Ports (1 in total):
UPW (Link ID 9) (00:02:13)
# Display brief information about IPv6 PIM snooping neighbors for VSI bbb.
<Sysname> display ipv6 pim-snooping neighbor vsi bbb
Total 2 neighbors.
VSI bbb: Total 2 neighbors.
FE80::1
Ports (1 in total):
GE1/0/3 (Link ID 0) (00:02:04)
FE80::4
Ports (1 in total):
Tun0 (VXLAN ID 0) (00:02:13)
Table 1 Command output
Field |
Description |
Total 2 neighbors |
Total number of IPv6 PIM snooping neighbors. |
VLAN 2: Total 2 neighbors |
Total number of IPv6 PIM snooping neighbors in VLAN 2. |
VSI aaa: Total 2 neighbors |
Total number of IPv6 PIM snooping neighbors in VSI aaa. |
FE80::6401:101 |
IPv6 address of the IPv6 PIM snooping neighbor. |
Slots (0 in total) |
Member IDs and total number of the member devices that have the neighbor, except for the specified member device or the master device when no member device is specified. |
Ports (1 in total) |
Ports where IPv6 PIM snooping neighbors reside, and the total number of the ports. |
(02:02:23) |
Remaining aging time for an IPv6 PIM snooping neighbor on the port. This field is always displayed for a global port (such as Layer 2 aggregate interfaces, ACs, N-PWs, and U-PWs). For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified member device. · The port is on the master device and no member device is specified. |
LAN Prune Delay |
IPv6 PIM hello message sent by the IPv6 PIM snooping neighbor has the LAN_Prune_Delay option. |
(T) |
The join report suppression feature has been disabled for the IPv6 PIM snooping neighbor. |
GE1/0/3 (Link ID 0) |
AC and its link ID. |
NPW (Link ID 8) |
N-PW and its link ID. |
UPW (Link ID 9) |
U-PW and its link ID. |
Tun0 (VXLAN ID 0) |
VXLAN tunnel and its VXLAN ID. |
display ipv6 pim-snooping router-port
Use display ipv6 pim-snooping router-port to display IPv6 PIM snooping router port information.
Syntax
display ipv6 pim-snooping router-port [ vlan vlan-id | vsi vsi-name ] [ slot slot-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays IPv6 PIM snooping router port information for all VLANs.
verbose: Displays detailed information about IPv6 PIM snooping router ports. If you do not specify this keyword, the command displays brief information about IPv6 PIM snooping router ports.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays IPv6 PIM snooping router port information for all VSIs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays IPv6 PIM snooping router port information for the master device.
Examples
# Display brief information about IPv6 PIM snooping router ports for VLAN 2.
<Sysname> display ipv6 pim-snooping router-port vlan 2
VLAN 2:
Router ports (2 in total):
GE1/0/1 (00:01:30)
GE1/0/2 (00:01:32)
# Display detailed information about IPv6 PIM snooping router ports for VLAN 2.
<Sysname> display ipv6 pim-snooping router-port vlan 2 verbose
VLAN 2:
Router slots (0 in total):
Router ports (2 in total):
GE1/0/1 (00:01:30)
GE1/0/2 (00:01:32)
# Display brief information about IPv6 PIM snooping router ports for VSI aaa.
<Sysname> display ipv6 pim-snooping router-port vsi aaa
VSI aaa:
Router ports (3 in total):
GE1/0/3 (Link ID 0) (00:02:43)
NPW (Link ID 8) (00:02:52)
UPW (Link ID 9) (00:02:52)
# Display detailed information about IPv6 PIM snooping router ports for VSI bbb.
<Sysname> display ipv6 pim-snooping router-port vsi bbb verbose
VSI bbb:
Router slots (0 in total):
Router ports (2 in total):
GE1/0/3 (Link ID 0) (00:02:43)
Tun0 (VXLAN ID 0) (00:02:52)
Table 2 Command output
Field |
Description |
VLAN 2 |
VLAN ID. |
VSI aaa |
VSI name. |
Router slots (0 in total) |
Member IDs and total number of the member devices that have router ports, except for the specified member device or the master device when no member device is specified. |
Router ports (2 in total) |
Router ports and total number of router ports. |
(00:01:30) |
Remaining aging time for the router port. For a global port, this field is always displayed. For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified member device. · The port is on the master device and no member device is specified. |
GE1/0/3 (Link ID 0) |
AC and its link ID. |
NPW (Link ID 8) |
N-PW and its link ID. |
UPW (Link ID 9) |
U-PW and its link ID. |
Tun0 (VXLAN ID 0) |
VXLAN tunnel and its VXLAN ID. |
display ipv6 pim-snooping routing-table
Use display ipv6 pim-snooping routing-table to display IPv6 PIM snooping routing entries.
Syntax
display ipv6 pim-snooping routing-table [ vlan vlan-id | vsi vsi-name ] [slot slot-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays IPv6 PIM snooping routing entries for all VLANs.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays IPv6 PIM snooping routing entries for all VSIs.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays IPv6 PIM snooping routing entries for the master device.
verbose: Displays detailed information about IPv6 PIM snooping routing entries. If you do not specify this keyword, the command displays brief information about IPv6 PIM snooping routing entries.
Examples
# Display detailed information about IPv6 PIM snooping routing entries for VLAN 2.
<Sysname> display ipv6 pim-snooping routing-table vlan 2 verbose
Total 1 entries.
FSM Flag: NI-no info, J-join, PP-prune pending
VLAN 2: Total 1 entries.
(2000::1, FF1E::1)
FSM information: dummy
Upstream neighbor: FE80::101
Upstream Slots (0 in total):
Upstream Ports (1 in total):
GE1/0/1
Downstream Slots (0 in total):
Downstream Ports (2 in total):
GE1/0/2
Expires: 00:03:01, FSM: J
Downstream Neighbors (2 in total):
1001::1
Expires: 00:59:19, FSM: J
1001::2
Expires: 00:59:20, FSM: J
GE1/0/3
Expires: 00:02:21, FSM: PP
# Display IPv6 PIM snooping routing entries for VSI aaa.
<Sysname> display ipv6 pim-snooping routing-table vsi aaa
Total 1 entries.
FSM Flag: NI-no info, J-join, PP-prune pending
VSI aaa: Total 1 entries.
(3000::1, FF1E::101)
Upstream neighbor: FE80::1
Upstream Ports (2 in total):
GE1/0/3 (Link ID 0)
NPW (Link ID 8)
Downstream Ports (1 in total):
UPW (Link ID 9)
Expires: 00:02:41, FSM: J
# Display IPv6 PIM snooping routing entries for VSI bbb.
<Sysname> display ipv6 pim-snooping routing-table vsi bbb
Total 1 entries.
FSM Flag: NI-no info, J-join, PP-prune pending
VSI bbb: Total 1 entries.
(3000::1, FF1E::101)
Upstream neighbor: FE80::1
Upstream Ports (1 in total):
GE1/0/3 (Link ID 0)
Downstream Ports (1 in total):
Tun0 (VXLAN ID 0)
Expires: 00:02:41, FSM: J
Table 3 Command output
Field |
Description |
Total 1 entries |
Total number of (S, G) and (*, G) entries. |
FSM Flag: NI-no info, J-join, PP-prune pending |
State machine flag of the downstream port: · NI—Initial state. · J—Join. · PP—Prune pending. |
VLAN 2: Total 1 entries |
Total number of (S, G) entries in VLAN 2. |
VSI aaa: Total 1 entries |
Total number of (S, G) entries in VSI aaa. |
(2000::1, FF1E::1) |
(S, G) entry. |
FSM information |
Finite state machine information for the entry: · delete—The entry attributes have been deleted. · dummy—The entry is a new temporary entry. · no info—The entry does not exist. · normal—The entry is a correct entry. |
Upstream neighbor |
Upstream neighbor of the (S, G) or (*, G) entry. |
Upstream Slots (0 in total) |
Member IDs and total number of the member devices that have the upstream neighbor, except for the specified member device or the master device when no member device is specified. |
Upstream Ports (1 in total) |
Upstream ports, and the total number of the ports. This field is displayed when one of the following conditions exists: · The port is on the specified member device. · The port is on the master device and no member device is specified. |
Downstream Slots (0 in total) |
Member IDs and total number of the member devices that have downstream ports, except for the specified member device or the master device when no member device is specified. |
Downstream Ports (2 in total) |
Downstream ports of the upstream neighbor, and the total number of the ports. |
Downstream Neighbors (2 in total) |
Downstream neighbors of the downstream port, and the total number of the neighbors. |
Expires: 00:03:01, FSM: J |
Remaining aging time for the downstream port or downstream neighbor, and the finite sate machine information. For a global port, this field is always displayed. For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified member device. · The port is on the master device and no member device is specified. |
GE1/0/3 (Link ID 0) |
AC and its link ID. |
NPW (Link ID 8) |
N-PW and its link ID. |
UPW (Link ID 9) |
U-PW and its link ID. |
Tun0 (VXLAN ID 0) |
VXLAN tunnel and its VXLAN ID. |
display ipv6 pim-snooping statistics
Use display ipv6 pim-snooping statistics to display statistics for the IPv6 PIM messages learned through IPv6 PIM snooping.
Syntax
display ipv6 pim-snooping statistics
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display statistics for the IPv6 PIM messages learned through IPv6 PIM snooping.
<Sysname> display ipv6 pim-snooping statistics
Received IPv6 PIM message:
IPv6 PIM hello: 0
M-LAG: 0
IPv6 PIM join/prune: 0
M-LAG: 0
IPv6 PIM error: 0
M-LAG: 0
Received IPv6 PIM messages in total: 200
Field |
Description |
IPv6 PIM hello |
Number of received IPv6 PIM hello messages. |
M-LAG |
Number of IPv6 PIM messages received on M-LAG peer-link interfaces. |
IPv6 PIM join/prune |
Number of received IPv6 PIM join/prune messages. |
IPv6 PIM error |
Number of received IPv6 PIM messages with errors. |
Received IPv6 PIM messages in total |
Total number of received IPv6 PIM messages. |
Related commands
reset ipv6 pim-snooping statistics
ipv6 pim-snooping enable
Use ipv6 pim-snooping enable to enable IPv6 PIM snooping for a VLAN or VSI.
Use undo ipv6 pim-snooping enable to disable IPv6 PIM snooping for a VLAN or VSI.
Syntax
ipv6 pim-snooping enable
undo ipv6 pim-snooping enable
Default
IPv6 PIM snooping is disabled for a VLAN or VSI.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Usage guidelines
IPv6 PIM snooping does not take effect on sub-VLANs of IPv6 multicast VLANs.
You must enable the MLD snooping feature and enable MLD snooping for a VLAN or VSI before you execute this command.
Examples
# Enable the MLD snooping feature, and then enable MLD snooping and IPv6 PIM snooping for VLAN 2.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] ipv6 pim-snooping enable
# Enable the MLD snooping feature, and then enable MLD snooping and IPv6 PIM snooping for VSI aaa.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] ipv6 pim-snooping enable
Related commands
mld-snooping
mld-snooping enable
ipv6 pim-snooping graceful-restart join-aging-time
Use ipv6 pim-snooping graceful-restart join-aging-time to set the aging time for global downstream ports and global router ports on the new master device after a master/subordinate switchover.
Use undo ipv6 pim-snooping graceful-restart join-aging-time to restore the default.
Syntax
ipv6 pim-snooping graceful-restart join-aging-time seconds
undo ipv6 pim-snooping graceful-restart join-aging-time
Default
The aging time is 210 seconds for global downstream ports and global router ports on the new master device after a master/subordinate switchover.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging time in the range of 210 to 18000 seconds.
Usage guidelines
You must enable IPv6 PIM snooping for a VLAN or VSI before you execute this command.
Global ports include Layer 2 aggregate interfaces, ACs, N-PWs, and U-PWs. A global downstream port or a global router port is a global port that acts as a downstream port or router port, respectively.
Examples
# In VLAN 2, set the aging time to 300 seconds for global downstream ports and global router ports on the new master device after a master/subordinate switchover.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] ipv6 pim-snooping enable
[Sysname-vlan2] ipv6 pim-snooping graceful-restart join-aging-time 300
# In VSI aaa, set the aging time to 600 seconds for global downstream ports and global router ports on the new master device after a master/subordinate switchover.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] ipv6 pim-snooping enable
[Sysname-vsi-aaa] ipv6 pim-snooping graceful-restart join-aging-time 600
Related commands
ipv6 pim-snooping enable
ipv6 pim-snooping graceful-restart neighbor-aging-time
Use ipv6 pim-snooping graceful-restart neighbor-aging-time to set the aging time for global neighbor ports on the new master device after a master/subordinate switchover.
Use undo ipv6 pim-snooping graceful-restart neighbor-aging-time to restore the default.
Syntax
ipv6 pim-snooping graceful-restart neighbor-aging-time seconds
undo ipv6 pim-snooping graceful-restart neighbor-aging-time
Default
The aging time is 105 seconds for global neighbor ports on the new master device after a master/subordinate switchover.
Views
VLAN view
VSI view
Predefined user roles
network-admin
Parameters
seconds: Specifies an aging time in the range of 105 to 18000 seconds.
Usage guidelines
You must enable IPv6 PIM snooping for a VLAN or VSI before you execute this command.
Global ports include Layer 2 aggregate interfaces, ACs, N-PWs, and U-PWs. A global neighbor port is a global port that acts as a neighbor port.
Examples
# In VLAN 2, set the aging time to 300 seconds for global neighbor ports on the new master device after a master/subordinate switchover.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vlan 2
[Sysname-vlan2] mld-snooping enable
[Sysname-vlan2] ipv6 pim-snooping enable
[Sysname-vlan2] ipv6 pim-snooping graceful-restart neighbor-aging-time 300
# In VSI aaa, set the aging time to 300 seconds for global neighbor ports on the new master device after a master/subordinate switchover.
<Sysname> system-view
[Sysname] mld-snooping
[Sysname-mld-snooping] quit
[Sysname] vsi aaa
[Sysname-vsi-aaa] mld-snooping enable
[Sysname-vsi-aaa] ipv6 pim-snooping enable
[Sysname-vsi-aaa] ipv6 pim-snooping graceful-restart neighbor-aging-time 300
Related commands
ipv6 pim-snooping enable
reset ipv6 pim-snooping statistics
Use reset ipv6 pim-snooping statistics to clear statistics for the IPv6 PIM messages learned through IPv6 PIM snooping.
Syntax
reset ipv6 pim-snooping statistics
Views
User view
Predefined user roles
network-admin
Examples
# Clear statistics for the IPv6 PIM messages learned through IPv6 PIM snooping.
<Sysname> reset ipv6 pim-snooping statistics
Related commands
display ipv6 pim-snooping statistics