- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
05-IPv6 multicast routing and forwarding commands | 206.26 KB |
Contents
IPv6 multicast routing and forwarding commands
display ipv6 multicast boundary
display ipv6 multicast fast-forwarding cache
display ipv6 multicast forwarding df-info
display ipv6 multicast forwarding event
display ipv6 multicast forwarding-table
display ipv6 multicast forwarding-table df-list
display ipv6 multicast routing-table
display ipv6 multicast rpf-info
ipv6 multicast forwarding-table cache-unknown per-entry
ipv6 multicast forwarding-table cache-unknown total
load-splitting (IPv6 MRIB view)
longest-match (IPv6 MRIB view)
reset ipv6 multicast fast-forwarding cache
reset ipv6 multicast forwarding event
reset ipv6 multicast forwarding-table
reset ipv6 multicast routing-table
IPv6 multicast routing and forwarding commands
Non-default vSystems do not support some of the IPv6 multicast routing and forwarding commands. For information about vSystem support for a command, see the usage guidelines on that command. For information about vSystem, see Virtual Technologies Configuration Guide.
display ipv6 mrib interface
Use display ipv6 mrib interface to display information about interfaces maintained by the IPv6 MRIB.
Syntax
display ipv6 mrib [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
vsys-admin
vsys-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 information about interfaces maintained by the IPv6 MRIB on the public network.
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about all interfaces maintained by the IPv6 MRIB.
Examples
# Display information about interfaces maintained by the IPv6 MRIB on the public network.
<Sysname> display ipv6 mrib interface
Interface: GigabitEthernet1/0/1
Index: 0x00004444
Current state: up
MTU: 1500
Type: BROADCAST
Protocol: PIM-DM
PIM protocol state: Enabled
Address list:
1. Local address : FE80:7:11::1/10
Remote address: ::
Reference : 1
State : NORMAL
Table 1 Command output
Field |
Description |
Interface |
Interface name. |
Index |
Index number of the interface. |
Current state |
Current status of the interface: up or down. |
MTU |
MTU value. |
Type |
Interface type: · BROADCAST—Broadcast link interface. · P2P—P2P interface. · LOOP—Loopback interface. · REGISTER—Register interface. · NBMA—NBMA interface. · MTUNNEL—Multicast tunnel interface. This field is empty if the interface is Null 0. |
Protocol |
Protocol running on the interface: PIM-DM, PIM-SM, MLD, or PROXY. |
PIM protocol state |
Whether IPv6 PIM is enabled: Enabled or Disabled. |
Address list |
Interface address list. |
Local address |
Local IP address. |
Remote address |
Remote end IP address. This field is displayed only when the interface is vlink type. |
Reference |
Number of times that the address has been used. |
State |
Status of the interface address: NORMAL or DEL. |
display ipv6 multicast boundary
Use display ipv6 multicast boundary to display IPv6 multicast boundary information.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] boundary { group [ ipv6-group-address [ prefix-length ] ] | scope [ scope-id ] } [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-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 multicast boundary information on the public network.
group: Displays the IPv6 multicast boundary information for the specified groups.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of 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 multicast boundary information for all IPv6 multicast groups.
prefix-length: Specifies an address prefix length in the range of 8 to 128. The default is 128.
scope: Displays the IPv6 multicast group boundary information in the admin-scoped zone.
scope-id: Specifies an admin-scope zone by its ID in the range of 3 to 15, which is identified by the scope field in the IPv6 multicast group address. If you do not specify an admin-scoped zone, this command displays IPv6 multicast boundary information for all IPv6 admin-scoped zones.
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays IPv6 multicast boundary information for all interfaces.
Usage guidelines
Non-default vSystems do not support this command.
Examples
# Display IPv6 multicast boundary information of all IPv6 multicast groups for all interfaces on the public network.
<Sysname> display ipv6 multicast boundary group
Boundary Interface
FF1E::/64 GE1/0/1
# Display IPv6 multicast boundary information in all IPv6 admin-scope zones for all interfaces on the public network.
<Sysname> display ipv6 multicast boundary scope
Boundary Interface
3 GigabitEthernet1/0/1
Table 2 Command output
Field |
Description |
Boundary |
IPv6 multicast group or IPv6 admin-scoped zone associated with the IPv6 multicast boundary. |
Interface |
Boundary interface associated with the IPv6 multicast boundary. |
ipv6 multicast boundary
display ipv6 multicast fast-forwarding cache
Use display ipv6 multicast fast-forwarding cache to display IPv6 multicast fast forwarding entries.
Syntax
In standalone mode:
display ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ ipv6-source-address | ipv6-group-address ] * [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
display ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ ipv6-source-address | ipv6-group-address ] * [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
vsys-admin
vsys-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 multicast fast forwarding entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv6 multicast fast forwarding 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 multicast fast forwarding entries for the global active MPU. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
Examples
# Display IPv6 multicast fast forwarding entries on the public network.
<Sysname> display ipv6 multicast fast-forwarding cache
Total 1 entries, 1 matched
(FE1F:60::200, FF0E::1)
Status : Enabled
Source port: 2001 Destination port: 2002
Protocol : 2 Flag : 0x2
Incoming interface: GigabitEthernet1/0/3
List of 1 outgoing interfaces:
GigabitEthernet1/0/2
Status: Enabled Flag: 0x14
Table 3 Command output
Field |
Description |
Total 1 entries, 1 matched |
Total number of (S, G) entries, and the total number of matching (S, G) entries. |
(FE1F:60::200, FF0E::1) |
(S, G) entry. |
Protocol |
Protocol number. |
Flag |
Flag for the (S, G) entry or the outgoing interface of the entry. This field displays one flag or the sum of multiple flags. In this example, the value 0x2 means that the entry has only one flag 0x2. The value 0x14 means that the outgoing interface has flags 0x10 and 0x4. The following flags are available for an entry: · 0x1—The entry is created because of packets passed through between cards. · 0x2—The entry is added by IPv6 multicast forwarding. The following flags are available for an outgoing interface: · 0x1—The interface is added to the entry because of packets passed through between cards. · 0x2—The interface is added to an existing entry. · 0x4—The MAC address of the interface is needed for fast forwarding. · 0x8—The interface is an outgoing interface associated with the incoming VLAN. · 0x10—The interface is associated with the entry. · 0x20—The interface is to be deleted. |
Status |
Status of the (S, G) entry or the outgoing interface: · Enabled—Available. · Disabled—Unavailable. |
Incoming interface |
Incoming interface of the (S, G) entry. |
List of 1 outgoing interfaces |
Outgoing interface list of the (S, G) entry. |
Related commands
reset ipv6 multicast fast-forwarding cache all
display ipv6 multicast forwarding df-info
Use display ipv6 multicast forwarding df-info to display DF information.
Syntax
In standalone mode:
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ ipv6-rp-address ] [ verbose ] [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ ipv6-rp-address ] [ verbose ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
vsys-admin
vsys-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about DFs on the public network.
ipv6-rp-address: Specifies an IPv6 BIDIR-PIM RP by its IPv6 address.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information about DFs.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays DF 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 DF information for the global active MPU. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
Usage guidelines
In an IPv6 BIDIR-PIM domain, only the DF on each subnet can forward IPv6 multicast data destined for an IPv6 multicast group toward the RP of the group. For more information about DFs, see IP Multicast Configuration Guide.
Examples
# Display brief DF information on an ADVPN network.
<Sysname> display ipv6 multicast forwarding df-info
Total 1 RPs, 1 matched
00001. RP address: 2::2
Flags: 0x0
Uptime: 00:00:14
RPF interface: LoopBack0
List of 2 DF interfaces:
1: Tunnel2, FE80::1
2: Tunnel2, FE80::3
# Display brief information about DFs on the public network.
<Sysname> display ipv6 multicast forwarding df-info
Total 1 RPs, 1 matched
00001. RP address: 7:11::1
Flags: 0x0
Uptime: 01:46:40
RPF interface: GigabitEthernet1/0/1
List of 1 DF interface:
1: GigabitEthernet1/0/2
# Display detailed information about DFs on the public network.
<Sysname> display ipv6 multicast forwarding df-info verbose
Total 1 RPs, 1 matched
00001. RP address: 7:11::1
MID: 2, Flags: 0x0
Uptime: 00:03:53
Product information: 0x7a2f762f, 0x718fee9f, 0x4b82f137, 0x71c32184
RPF interface: GigabitEthernet1/0/1
Product information: 0xa567d6fc, 0xadeb03e3
Tunnel information: 0xdfb107d4, 0x7aa5d510
List of 1 DF interface:
1: GigabitEthernet1/0/2
Product information: 0xa986152b, 0xb74a9a2f
Tunnel information: 0x297ca208, 0x76985b89
Table 4 Command output
Field |
Description |
Total 1 RPs, 1 matched |
Total number of RPs, and the total number of matching RPs. |
00001 |
Sequence number of the entry to which the RP is designated. |
RP address |
IPv6 address of the RP. |
MID |
ID of the entry to which the RP is designated. Each entry to which the RP is designated has a unique MID. |
Flags |
Entry flag. This field displays one flag or the sum of multiple flags. In this example, the value 0x0 means that the entry has only one flag 0x0. The following flags are available for an entry: · 0x0—The entry is in correct state. · 0x4—The entry fails to update. · 0x8—DF interface information fails to update for the entry. · 0x40—The entry is to be deleted. · 0x100—The entry is being deleted. · 0x200—The entry is in GR state. |
Uptime |
Length of time for which the entry has been up. |
RPF interface |
RPF interface to the RP. |
List of 1 DF interfaces |
DF interface list. |
Tunnel2, FE80::1 |
ADVPN tunnel interface, and the IPv6 link-local address of the remote end. |
display ipv6 multicast forwarding event
Use display ipv6 multicast forwarding event to display statistics of IPv6 multicast forwarding events.
Syntax
In standalone mode:
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding event [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding event [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
vsys-admin
vsys-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 statistics of IPv6 multicast forwarding events on the public network.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays statistics of IPv6 multicast forwarding events 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 statistics of IPv6 multicast forwarding events for the global active MPU. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
Examples
# Display statistics of IPv6 multicast forwarding events on the public network.
<Sysname> display ipv6 multicast forwarding event
Total active events sent: 0
Total inactive events sent: 0
Total NoCache events sent: 2
Total NoCache events dropped: 0
Total WrongIF events sent: 0
Total WrongIF events dropped: 0
Total SPT switch events sent: 0
NoCache rate limit: 1024 packets/s
WrongIF rate limit: 1 packets/10s
Total timer of register suppress timeout: 0
Field |
Description |
Total active events sent |
Number of times that entry-active events have been sent. |
Total inactive events sent |
Number of times that entry-inactive events have been sent. |
Total NoCache events sent |
Number of times that NoCache events have been sent. |
Total NoCache events dropped |
Number of times that NoCache events have been dropped. |
Total WrongIF events sent |
Number of times that WrongIF events have been sent. |
Total WrongIF events dropped |
Number of times that WrongIF events have been dropped. |
Total SPT switch events sent |
Number of times that SPT-switch events have been sent. |
NoCache rate limit |
Rate limit for sending NoCache events, in pps. |
WrongIF rate limit |
Rate limit for sending WrongIF events, in packets per 10 seconds. |
Total timer of register suppress timeout |
Number of times that the registration suppression has timed out in total. |
Related commands
reset ipv6 multicast forwarding event
display ipv6 multicast forwarding-table
Use display ipv6 multicast forwarding-table to display IPv6 multicast forwarding entries.
Syntax
In standalone mode:
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table [ ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | slot slot-number [ cpu cpu-number ] | statistics ] *
In IRF mode:
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table [ ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | chassis chassis-number slot slot-number [ cpu cpu-number ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | statistics ] *
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
vsys-admin
vsys-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 multicast forwarding entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies an address prefix length. The default value 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.
incoming-interface: Specifies the IPv6 forwarding entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
outgoing-interface: Specifies the IPv6 forwarding entries that contain the specified outgoing interface.
exclude: Specifies the IPv6 forwarding entries that do not contain the specified interface in the outgoing interface list.
include: Specifies the IPv6 forwarding entries that contain the specified interface in the outgoing interface list.
match: Specifies the IPv6 forwarding entries that contain only the specified interface in the outgoing interface list.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays IPv6 multicast forwarding 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 multicast forwarding entries for the global active MPU. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
statistics: Displays statistics for the IPv6 multicast forwarding table.
Examples
# Display IPv6 multicast forwarding entries on an ADVPN network.
<Sysname> display ipv6 multicast forwarding-table
Total 1 entries, 1 matched
00001. (1::1, ff0e::1)
Flags: 0x0
Uptime: 00:08:32, Timeout in: 00:03:26
Incoming interface: Tunnel1, FE80::20:11
List of 1 outgoing interfaces:
1: Tunnel1, FE80::20:12
2: Tunnel1, FE80::20:13
Matched 19648 packets(20512512 bytes), Wrong If 0 packet
Forwarded 19648 packets(20512512 bytes)
# Display IPv6 multicast forwarding entries on the public network.
<Sysname> display ipv6 multicast forwarding-table
Total 1 entries, 1 matched
00001. (1::1, ff0e::1)
Flags: 0x0
Uptime: 00:08:32, Timeout in: 00:03:26
Incoming interface: Vlan-interface10
List of 1 outgoing interface:
1: Vlan-interface20
Matched 19648 packets(20512512 bytes), Wrong If 0 packet
Forwarded 19648 packets(20512512 bytes)
Table 6 Command output
Field |
Description |
Total 1 entries, 1 matched |
Total number of (S, G) entries, and the total number of matching (S, G) entries. |
00001 |
Sequence number of the (S, G) entry. |
(1::1, ff0e::1) |
(S, G) entry. |
Flags |
Entry flag. This field displays one flag or the sum of multiple flags. In this example, the value 0x0 means that the entry has only one flag 0x0. The following flags are available for an entry: · 0x0—The entry is in correct state. · 0x1—The entry is in inactive state. · 0x2—The entry is null. · 0x4—The entry fails to update. · 0x8—The outgoing interface information fails to update for the entry. · 0x20—A register outgoing interface is available. · 0x40—The entry is to be deleted. · 0x80—The entry is in registration suppression state. · 0x100—The entry is being deleted. · 0x200—The entry is in GR state. · 0x800—The entry has the associated ND entry for the IPv6 multicast source address. · 0x4000000—The entry is created by the MLD proxy. · 0x20000000—The entry is an IPv6 BIDIR-PIM forwarding entry. |
Uptime |
Length of time for which the (S, G) entry has been up. |
Timeout in |
Length of time in which the (S, G) entry will time out. |
Incoming interface |
Incoming interface of the (S, G) entry. |
List of 1 outgoing interfaces |
Outgoing interface list of the (S, G) entry. |
Tunnel1, FE80::20:12 |
ADVPN tunnel interface, and the IPv6 link-local address of the remote end. |
Matched 19648 packets (20512512 bytes), Wrong If 0 packet |
Number of packets (bytes) that match the (S, G) entry, and number of packets with incoming interface errors. The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot. |
Forwarded 19648 packets (20512512 bytes) |
Number of packets (bytes) that have been forwarded. The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot. |
reset ipv6 multicast forwarding-table
display ipv6 multicast forwarding-table df-list
Use display ipv6 multicast forwarding-table df-list to display information about the DF list in IPv6 multicast forwarding entries.
Syntax
In standalone mode:
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ ipv6-group-address ] [ verbose ] [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
display ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ ipv6-group-address ] [ verbose ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
vsys-admin
vsys-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about the DF list in IPv6 multicast forwarding entries on the public network.
ipv6-group-address: Specifies an IPv6 multicast address. The value range for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
verbose: Displays detailed information. If you do not specify this keyword, the command displays brief information.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information about the DF list in IPv6 multicast forwarding 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 information about the DF list in IPv6 multicast forwarding entries for the global active MPU. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
Examples
# Display brief information about the DF list in IPv6 multicast forwarding entries on the public network.
<Sysname> display ipv6 multicast forwarding-table df-list
Total 1 entries, 1 matched
00001. (::, FF1E::1)
List of 1 DF interfaces:
1: GigabitEthernet1/0/1
# Display detailed information about the DF list in IPv6 multicast forwarding entries on the public network.
<Sysname> display ipv6 multicast forwarding-table df-list verbose
Total 1 entries, 1 matched
00001. (::, FF1E::1)
List of 1 DF interfaces:
1: GigabitEthernet1/0/1
Product information: 0x347849f6, 0x14bd6837
Tunnel information: 0xc4857986, 0x128a9c8f
Table 7 Command output
Field |
Description |
Total 1 entries, 1 matched |
Total number of entries, and the total number of matching entries. |
00001 |
Sequence number of the entry. |
(::, FF1E::1) |
(*, G) entry. |
List of 1 DF interfaces |
DF interface list. |
display ipv6 multicast routing-table
Use display ipv6 multicast routing-table to display IPv6 multicast routing entries.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] routing-table [ ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number ] *
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
vsys-admin
vsys-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 multicast routing entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies an address prefix length. 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.
incoming-interface: Displays the IPv6 routing entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
outgoing-interface: Displays the IPv6 routing entries that contain the specified outgoing interface.
exclude: Displays the IPv6 routing entries that do not contain the specified interface in the outgoing interface list.
include: Displays the IPv6 routing entries that contain the specified interface in the outgoing interface list.
match: Displays the IPv6 routing entries that contain only the specified interface in the outgoing interface list.
Usage guidelines
IPv6 multicast routing entries are the basis of IPv6 multicast forwarding. You can use this command to view the establishment state of (S, G) entries.
Examples
# Display IPv6 multicast routing entries on an ADVPN network.
<Sysname> display ipv6 multicast routing-table
Total 1 entries
00001. (2001::2, FFE3::101)
Uptime: 00:00:14
Upstream Interface: Tunnel1, FE80::20:11
List of 2 downstream interfaces
1: Tunnel1, FE80::20:12
2: Tunnel1, FE80::20:13
# Display IPv6 multicast routing entries on the public network.
<Sysname> display ipv6 multicast routing-table
Total 1 entries
00001. (2001::2, FFE3::101)
Uptime: 00:00:14
Upstream Interface: GigabitEthernet1/0/1
List of 2 downstream interfaces
1: GigabitEthernet1/0/2
2: GigabitEthernet1/0/3
Table 8 Command output
Field |
Description |
Total 1 entries |
Total number of (S, G) entries. |
00001 |
Sequence number of the (S, G) entry. |
(2001::2, FFE3::101) |
(S, G) entry. |
Uptime |
Length of time for which the (S, G) entry has been up. |
Upstream Interface |
Upstream interface at which the (S, G) packets should arrive. |
List of 2 downstream interfaces |
List of downstream interfaces that forward (S, G) packets. |
Tunnel11, FE80::20:12 |
ADVPN tunnel interface, and the IPv6 link-local address of the remote end. |
reset ipv6 multicast routing-table
display ipv6 multicast rpf-info
Use display ipv6 multicast rpf-info to display RPF information for an IPv6 multicast source.
Syntax
display ipv6 multicast [ vpn-instance vpn-instance-name ] rpf-info ipv6-source-address [ ipv6-group-address ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
vsys-admin
vsys-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 RPF information for an IPv6 multicast source on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
Examples
# Display RPF information for IPv6 multicast source 2001::101 on the public network.
<Sysname> display ipv6 multicast rpf-info 2001::101
RPF information about source 2001::101:
RPF interface: GigabitEthernet1/0/1, RPF neighbor: FE80::A01:101:1
Referenced prefix/prefix length: 2001::/64
Referenced route type: igp
Route selection rule: preference-preferred
Load splitting rule: disable
Source AS: 0
C-multicast route target: 0x0000000000000000
Table 9 Command output
Field |
Description |
RPF information about source 2001::101 |
RPF information of the IPv6 multicast source 2001::101. |
RPF interface |
Type and number of the RPF interface. |
RPF neighbor |
IPv6 address (link-local address) of the RPF neighbor. |
Referenced prefix/prefix length |
Referenced route and its prefix length. |
Referenced route type |
Type of the referenced route: · igp—IPv6 IGP unicast route. · egp—IPv6 EGP unicast route. · unicast (direct) —IPv6 directly connected unicast route. · unicast—Other IPv6 unicast route, such as IPv6 unicast static route. · mbgp—IPv6 MBGP route. |
Route selection rule |
RPF route selection rule: · Route preference. · Longest prefix match. |
Load splitting rule |
Whether load splitting is enabled. |
Source AS |
AS number of the source-side PE. |
C-multicast route target |
Route target attribute value of the C-multicast route. |
display ipv6 multicast forwarding-table
display ipv6 multicast routing-table
ipv6 multicast boundary
Use ipv6 multicast boundary to configure an IPv6 multicast forwarding boundary.
Use undo ipv6 multicast boundary to delete an IPv6 multicast forwarding boundary.
Syntax
ipv6 multicast boundary { ipv6-group-address prefix-length | scope { scope-id | admin-local | global | organization-local | site-local } }
undo ipv6 multicast boundary { ipv6-group-address prefix-length| all | scope { scope-id | admin-local | global | organization-local | site-local } }
Default
An interface is not an IPv6 multicast forwarding boundary.
Views
Interface view
Predefined user roles
network-admin
context-admin
Parameters
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies the address prefix length in the range of 8 to 128.
all: Specifies all IPv6 multicast boundaries configured on the interface.
scope-id: Specifies the ID of an admin-scoped zone, in the range of 3 to 15, which is identified by the scope field in the IPv6 multicast group address.
admin-local: Specifies the scoped zone as admin-local, which has a scope ID of 4.
global: Specifies the scoped zone as global, which has a scope ID of 14.
organization-local: Specifies the scoped zone as organization-local, which has a scope ID of 8.
site-local: Specifies the scoped zone as site-local, which has a scope ID of 5.
Usage guidelines
Non-default vSystems do not support this command.
A multicast forwarding boundary sets the boundary condition for the IPv6 multicast groups in the specified address range. If the destination address of an IPv6 multicast packet matches the set boundary condition, the packet is not forwarded.
An interface can act as a forwarding boundary for multiple IPv6 multicast groups in different address ranges. You can implement this by using this command on the interface for each multicast address range. These multicast groups must be in the same scope. The latest configuration of a scope overwrites the previous one.
You do not need to enable IPv6 multicast routing before you execute this command.
Assume that Set A and Set B are both IPv6 multicast forwarding boundary sets with different address ranges, and that B is a subset of A. A takes effect on the interface no matter whether A is configured earlier or later than B.
Examples
# Configure GigabitEthernet 1/0/1 as the forwarding boundary of IPv6 multicast groups in the range of FF03::/16.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] ipv6 multicast boundary ff03:: 16
# Configure GigabitEthernet 1/0/1 as the forwarding boundary of IPv6 multicast groups in the admin-local scope.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] ipv6 multicast boundary scope 4
Related commands
display ipv6 multicast boundary
ipv6 multicast forwarding-table cache-unknown per-entry
Use ipv6 multicast forwarding-table cache-unknown per-entry to set the maximum number of unknown IPv6 multicast packets that can be cached for an (S, G) entry.
Use undo ipv6 multicast forwarding-table cache-unknown per-entry to restore the default.
Syntax
ipv6 multicast forwarding-table cache-unknown per-entry per-entry-limit
undo ipv6 multicast forwarding-table cache-unknown per-entry
Default
The device can cache only one unknown IPv6 multicast packet for an (S, G) entry.
Views
System view
Predefined user roles
network-admin
context-admin
Parameters
per-entry-limit: Specifies the maximum number of unknown IPv6 multicast packets that can be cached for an (S, G) entry. The value range for this argument is 0 to 256. If you set the value to 0, the device cannot cache unknown IPv6 multicast packets.
Usage guidelines
Non-default vSystems do not support this command.
Examples
# Set the maximum number to 20 for unknown IPv6 multicast packets that can be cached for an (S, G) entry.
<Sysname> system-view
[Sysname] ipv6 multicast forwarding-table cache-unknown per-entry 20
Related commands
ipv6 multicast forwarding-table cache-unknown total
ipv6 multicast forwarding-table cache-unknown total
Use ipv6 multicast forwarding-table cache-unknown total to set the maximum number of all unknown IPv6 multicast packets that can be cached.
Use undo multicast forwarding-table cache-unknown total to restore the default.
Syntax
ipv6 multicast forwarding-table cache-unknown total total-limit
undo ipv6 multicast forwarding-table cache-unknown total
Default
The device can cache 1024 unknown IPv6 multicast packets in total.
Views
System view
Predefined user roles
network-admin
context-admin
Parameters
total-limit: Specifies the maximum number of all unknown IPv6 multicast packets that can be cached. The value range for this argument is 0 to 65535. If you set the value to 0, the device cannot cache unknown IPv6 multicast packets.
Usage guidelines
Non-default vSystems do not support this command.
As a best practice, set the value in this command to be far greater than the value set in the ipv6 multicast forwarding-table cache-unknown per-entry command.
Examples
# Set the maximum number to 10000 for all unknown IPv6 multicast packets that can be cached.
<Sysname> system-view
[Sysname] ipv6 multicast forwarding-table cache-unknown total 10000
Related commands
ipv6 multicast forwarding-table cache-unknown per-entry
ipv6 multicast routing
Use ipv6 multicast routing to enable IPv6 multicast routing and enter IPv6 MRIB view.
Use undo ipv6 multicast routing to disable IPv6 multicast routing.
Syntax
ipv6 multicast routing [ vpn-instance vpn-instance-name ]
undo ipv6 multicast routing [ vpn-instance vpn-instance-name ]
Default
IPv6 multicast routing is disabled.
Views
System view
Predefined user roles
network-admin
context-admin
vsys-admin
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 enables IPv6 multicast routing on the public network.
Usage guidelines
Other Layer 3 IPv6 multicast commands take effect only when IPv6 multicast routing is enabled on the public network or for the VPN instance to which the device belongs.
The device does not forward any IPv6 multicast packets before IPv6 multicast routing is enabled.
Examples
# Enable IPv6 multicast routing on the public network, and enter IPv6 MRIB view.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6]
# Enable IPv6 multicast routing for VPN instance mvpn, and enter IPv6 MRIB view.
<Sysname> system-view
[Sysname] ipv6 multicast routing vpn-instance mvpn
[Sysname-mrib6-mvpn]
load-splitting (IPv6 MRIB view)
Use load-splitting to enable IPv6 multicast load splitting.
Use multicast load-splitting to restore the default.
Syntax
load-splitting { source | source-group }
undo load-splitting
Default
IPv6 multicast load splitting is disabled.
Views
IPv6 MRIB view
Predefined user roles
network-admin
context-admin
Parameters
source: Enables IPv6 multicast load splitting based on IPv6 multicast source.
source-group: Enables IPv6 multicast load splitting based on IPv6 multicast source and group.
Usage guidelines
Non-default vSystems do not support this command.
This command does not take effect on IPv6 BIDIR-PIM.
Examples
# Enable IPv6 multicast load splitting based on IPv6 multicast source on the public network.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] load-splitting source
longest-match (IPv6 MRIB view)
Use longest-match to specify the longest prefix match principle for RPF route selection.
Use undo longest-match to restore the default.
Syntax
longest-match
undo longest-match
Default
Route preference is used for RPF route selection. The route with the highest route preference is used as the RPF route.
Views
IPv6 MRIB view
Predefined user roles
network-admin
context-admin
Usage guidelines
This command enables the device to use the matching route with the longest prefix as the RPF route.
Usage guidelines
Non-default vSystems do not support this command.
Examples
# Specify the longest prefix match principle for RPF route selection on the public network.
<Sysname> system-view
[Sysname] ipv6 multicast routing
[Sysname-mrib6] longest-match
reset ipv6 multicast fast-forwarding cache
Use reset ipv6 multicast fast-forwarding cache to clear IPv6 multicast fast forwarding entries.
Syntax
In standalone mode:
reset ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { ipv6-source-address | ipv6-group-address } * | all } [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
reset ipv6 multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { ipv6-source-address | ipv6-group-address } * | all } [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
User view
Predefined user roles
network-admin
context-admin
vsys-admin
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 clears IPv6 multicast fast forwarding entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address. The value range for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command clears IPv6 multicast fast forwarding 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 clears IPv6 multicast fast forwarding entries for the global active MPU. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
all: Specifies all IPv6 multicast fast forwarding entries.
Examples
# Clear all IPv6 multicast fast forwarding entries on the public network.
<Sysname> reset ipv6 multicast fast-forwarding cache all
# Clear the IPv6 multicast fast forwarding entry for IPv6 multicast source and group (FE1F:20::2, FF0E::1) on the public network.
<Sysname> reset ipv6 multicast fast-forwarding cache fe1f:20::2 ff0e::1
Related commands
display ipv6 multicast fast-forwarding cache
reset ipv6 multicast forwarding event
Use reset ipv6 multicast forwarding event to clear statistics for IPv6 multicast forwarding events.
Syntax
reset ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding event
Views
User view
Predefined user roles
network-admin
context-admin
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 clears statistics for the IPv6 multicast forwarding events on the public network.
Usage guidelines
Non-default vSystems do not support this command.
Examples
# Clear statistics for the IPv6 multicast forwarding events on the public network.
<Sysname> reset ipv6 multicast forwarding event
Related commands
display ipv6 multicast forwarding event
reset ipv6 multicast forwarding-table
Use reset ipv6 multicast forwarding-table to clear IPv6 multicast forwarding entries.
Syntax
reset ipv6 multicast [ vpn-instance vpn-instance-name ] forwarding-table { { ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface { interface-type interface-number } } * | all }
Views
User view
Predefined user roles
network-admin
context-admin
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 clears IPv6 multicast forwarding entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies the address prefix length. The default value 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.
incoming-interface: Specifies the IPv6 multicast forwarding entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
all: Specifies all IPv6 multicast forwarding entries.
Usage guidelines
Non-default vSystems do not support this command.
When you clear an IPv6 multicast forwarding entry, the associated IPv6 multicast routing entry is also cleared.
Examples
# Clear IPv6 multicast forwarding entries for IPv6 multicast group FF0E::1 on the public network.
<Sysname> reset ipv6 multicast forwarding-table ff0e::1
display ipv6 multicast forwarding-table
reset ipv6 multicast routing-table
Use reset ipv6 multicast routing-table to clear IPv6 multicast routing entries.
Syntax
reset ipv6 multicast [ vpn-instance vpn-instance-name ] routing-table { { ipv6-source-address [ prefix-length ] | ipv6-group-address [ prefix-length ] | incoming-interface interface-type interface-number } * | all }
Views
User view
Predefined user roles
network-admin
context-admin
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 clears IPv6 multicast routing entries on the public network.
ipv6-source-address: Specifies an IPv6 multicast source address.
ipv6-group-address: Specifies an IPv6 multicast group address in the range of FFxy::/16, where "x" and "y" represent any hexadecimal numbers in the range of 0 to F.
prefix-length: Specifies an address prefix length. 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.
incoming-interface: Specifies the IPv6 multicast routing entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
all: Specifies all IPv6 multicast routing entries.
Usage guidelines
Non-default vSystems do not support this command.
When you clear an IPv6 multicast routing entry, the associated IPv6 multicast forwarding entry is also cleared.
Examples
# Clear IPv6 multicast routing entries for IPv6 multicast group FF03::101 on the public network.
<Sysname> reset ipv6 multicast routing-table ff03::101
Related commands
display ipv6 multicast routing-table