- Table of Contents
-
- 08-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-Multicast VPN commands
- 09-MLD snooping commands
- 10-IPv6 PIM snooping commands
- 11-IPv6 multicast VLAN commands
- 12-IPv6 multicast routing and forwarding commands
- 13-MLD commands
- 14-IPv6 PIM commands
- Related Documents
-
Title | Size | Download |
---|---|---|
10-IPv6 PIM snooping commands | 82.58 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
In standalone mode:
display ipv6 pim-snooping neighbor [ vlan vlan-id ] [ verbose ] [ slot slot-number ]
In IRF mode:
display ipv6 pim-snooping neighbor [ vlan vlan-id ] [ verbose ] [ chassis chassis-number slot slot-number ]
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.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv6 PIM snooping neighbor information for the MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays IPv6 PIM snooping neighbor information for the global active MPU. (In IRF mode.)
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
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):
XGE3/1/1 (02:02:23) LAN Prune Delay(T)
FE80::C801:101
Slots (0 in total):
Ports (1 in total):
XGE3/1/2 (02:02:25)
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. |
FE80::6401:101 |
IPv6 address of the IPv6 PIM snooping neighbor. |
Slots (0 in total) |
(In standalone mode.) Slot numbers and total number of the cards that have the neighbor, except for the specified card or the MPU when no card is specified. 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. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have the neighbor, except for the specified card or the global active MPU when no card 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 (including Layer 2 aggregate interfaces, AC interfaces, N-PW interfaces, and U-PW interfaces). (In standalone mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. 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. (In IRF mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card 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. |
display ipv6 pim-snooping router-port
Use display ipv6 pim-snooping router-port to display IPv6 PIM snooping router port information.
Syntax
In standalone mode:
display ipv6 pim-snooping router-port [ vlan vlan-id ] [ slot slot-number ]
In IRF mode:
display ipv6 pim-snooping router-port [ vlan vlan-id ] [ chassis chassis-number slot slot-number ]
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.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv6 PIM snooping router port information for the MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays IPv6 PIM snooping router port information for the global active MPU. (In IRF mode.)
Usage guidelines
Information about IPv6 PIM snooping router ports is available only when the device receives fragmented IPv6 PIM Join messages from IPv6 PIM snooping neighbor ports.
Examples
# Display IPv6 PIM snooping router port information for VLAN 2.
<Sysname> display ipv6 pim-snooping router-port vlan 2
VLAN 2:
Router slots (0 in total):
Router ports (2 in total):
XGE3/1/1 (00:01:30)
XGE3/1/2 (00:01:32)
Table 2 Command output
Field |
Description |
VLAN 2 |
VLAN ID. |
Router slots (0 in total) |
(In standalone mode.) Slot numbers and total number of the cards that have router ports, except for the specified card or the MPU when no card is specified. 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. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have router ports, except for the specified card or the global active MPU when no card 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. (In standalone mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (In IRF mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified. |
display ipv6 pim-snooping routing-table
Use display ipv6 pim-snooping routing-table to display IPv6 PIM snooping routing entries.
Syntax
In standalone mode:
display ipv6 pim-snooping routing-table [ vlan vlan-id ] [ verbose ] [ slot slot-number ]
In IRF mode:
display ipv6 pim-snooping routing-table [ vlan vlan-id ] [ verbose ] [ chassis chassis-number slot slot-number ]
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.
slot slot-number: Specifies a card. The slot-number argument represents the number of the slot that holds the card. If you do not specify a card, this command displays IPv6 PIM snooping routing entries for the MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays IPv6 PIM snooping routing entries for the global active MPU. (In IRF mode.)
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
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: normal
Upstream neighbor: FE80::101
Upstream Slots (0 in total):
Upstream Ports (1 in total):
XGE3/1/1
Downstream Slots (0 in total):
Downstream Ports (2 in total):
XGE3/1/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
XGE3/1/3
Expires: 00:02:21, FSM: PP
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. |
(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) |
(In standalone mode.) Slot numbers and total number of the cards that have the upstream neighbor, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have the upstream neighbor, except for the specified card or the global active MPU when no card is specified. |
Upstream Ports (1 in total) |
Upstream ports, and the total number of the ports. (In standalone mode.) This field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (In IRF mode.) This field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified. |
Downstream Slots (0 in total) |
(In standalone mode.) Slot numbers and total number of the cards that have downstream ports, except for the specified card or the MPU when no card is specified. (In IRF mode.) Chassis numbers, slot numbers, and total number of the cards that have downstream ports, except for the specified card or the global active MPU when no card 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. (In standalone mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the MPU and no card is specified. (In IRF mode.) For a non-global port, this field is displayed when one of the following conditions exists: · The port is on the specified card. · The port is on the global active MPU and no card is specified. |
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 hello: 100
Received IPv6 PIM join/prune: 100
Received IPv6 PIM error: 0
Received IPv6 PIM messages in total: 200
Field |
Description |
Received IPv6 PIM hello |
Number of received IPv6 PIM hello messages. |
Received IPv6 PIM join/prune |
Number of received IPv6 PIM join/prune messages. |
Received 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.
Use undo ipv6 pim-snooping enable to disable IPv6 PIM snooping for a VLAN.
Syntax
ipv6 pim-snooping enable
undo ipv6 pim-snooping enable
Default
IPv6 PIM snooping is disabled for a VLAN.
Views
VLAN 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 MLD snooping globally and for a VLAN before you enable IPv6 PIM snooping for a VLAN.
Examples
# Enable MLD snooping globally, and 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
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 after an active/standby 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 neighbor ports after an active/standby switchover.
Views
VLAN 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 before you execute this command.
For a global router port or global downstream port, the set aging time does not take effect when the port receives an IPv6 PIM join message after an active/standby switchover. The aging time for the port is determined by the aging time in the IPv6 PIM join message.
Examples
# In VLAN 2, set the aging time to 600 seconds for global downstream ports and global router ports after an active/standby 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
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 after an active/standby 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 after an active/standby switchover.
Views
VLAN 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 before you execute this command.
For a global neighbor port, the set aging time does not take effect when the port receives an IPv6 PIM hello message after an active/standby switchover. The aging time for the port is determined by the aging time in the IPv6 PIM hello message.
Examples
# In VLAN 2, set the aging time to 300 seconds for global neighbor ports after an active/standby 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
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