- 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 |
---|---|---|
04-Multicast routing and forwarding commands | 102.59 KB |
Multicast routing and forwarding commands
display multicast forwarding event
display multicast forwarding-table
display multicast routing-table
display multicast routing-table static
multicast forwarding-table cache-unknown per-entry
multicast forwarding-table cache-unknown total
multicast rpf-fail-pkt flooding
multicast rpf-fail-pkt trap-to-cpu
reset multicast forwarding event
reset multicast forwarding-table
Multicast routing and forwarding commands
delete ip rpf-route-static
Use delete ip rpf-route-static to delete all static multicast routes.
Syntax
delete ip rpf-route-static [ vpn-instance vpn-instance-name ]
Views
System view
Predefined user roles
network-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 deletes all static multicast routes on the public network.
Usage guidelines
This command deletes all static multicast routes. To delete a specified static multicast route, use the undo ip rpf-route-static command.
Examples
# Delete all static multicast routes on the public network.
<Sysname> system-view
[Sysname] delete ip rpf-route-static
This will erase all multicast static routes and their configurations, you must reconfigure all static routes.
Are you sure?[Y/N]:y
Related commands
ip rpf-route-static
display mrib interface
Use display mrib interface to display information about interfaces maintained by the MRIB.
Syntax
display mrib [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-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 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 MRIB.
Examples
# Display information about interfaces maintained by the MRIB on the public network.
<Sysname> display mrib interface
Interface: GigabitEthernet3/1/1
Index: 0x00004444
Current state: up
MTU: 1500
Type: BROADCAST
Protocol: PIM-DM
PIM protocol state: Enabled
Address list:
1. Local address : 8.12.0.2/16
Remote address: 0.0.0.0
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, IGMP, PROXY, or MD. |
PIM protocol state |
Whether 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 referenced. |
State |
Status of the interface address: NORMAL or DEL. |
display multicast boundary
Use display multicast boundary to display multicast boundary information.
Syntax
display multicast [ vpn-instance vpn-instance-name ] boundary [ group-address [ mask-length | mask ] ] [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-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 multicast boundary information on the public network.
group-address: Specifies a multicast group by its IP address in the range of 224.0.0.0 to 239.255.255.255. If you do not specify a multicast group, this command displays multicast boundary information for all multicast groups.
mask-length: Specifies an address mask length in the range of 4 to 32. The default is 32.
mask: Specifies an address mask. The default is 255.255.255.255.
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays multicast boundary information for all interfaces.
Examples
# Display information about all multicast boundaries on the public network.
<Sysname> display multicast boundary
Boundary Interface
224.1.1.0/24 GE3/1/1
239.2.2.0/24 GE3/1/2
Table 2 Command output
Field |
Description |
Boundary |
Multicast group associated with the multicast boundary. |
Interface |
Boundary interface associated with the multicast boundary. |
multicast boundary
display multicast forwarding event
Use display multicast forwarding event to display statistics of multicast forwarding events.
Syntax
In standalone mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding event [ slot slot-number ]
In IRF mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding event [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-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 the 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 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 multicast forwarding events for the global active MPU. (In IRF mode.)
Examples
# Display statistics of multicast forwarding events on the public network.
<Sysname> display 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 event 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 multicast forwarding event
display multicast forwarding-table
Use display multicast forwarding-table to display multicast forwarding entries.
Syntax
In standalone mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | slot slot-number | statistics ] *
In IRF mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | chassis chassis-number slot slot-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
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 multicast forwarding entries on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.
mask: Specifies an address mask. The default value is 255.255.255.255.
incoming-interface: Specifies the multicast forwarding entries that contain the specified incoming interface.
interface-type interface-number: Specifies an incoming interface by its type and number.
outgoing-interface: Specifies the multicast forwarding entries that contain the specified outgoing interface.
exclude: Specifies the multicast forwarding entries that do not contain the specified interface in the outgoing interface list.
include: Specifies the multicast forwarding entries that contain the specified interface in the outgoing interface list.
match: Specifies the 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 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 multicast forwarding entries for the global active MPU. (In IRF mode.)
statistics: Displays statistics for the multicast forwarding table.
Examples
# Display multicast forwarding entries on the public network.
<Sysname> display multicast forwarding-table
Total 1 entries, 1 matched
00001. (172.168.0.2, 227.0.0.1)
Flags: 0x0
Uptime: 00:08:32, Timeout in: 00:03:26
Incoming interface: GigabitEthernet3/1/1
List of 1 outgoing interface:
1: GigabitEthernet3/1/2 (inactive)
Matched 19648 packets(20512512 bytes), Wrong If 0 packet
Forwarded 0 packets(0 bytes)
Table 4 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. |
(172.168.0.2,227.0.0.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 entries 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—Outgoing interface information fails to update for the entry. · 0x10—Data-group 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 ARP entry for the multicast source address. · 0x4000000—The entry is created by the IGMP proxy. |
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 expire. |
Incoming interface |
Incoming interface of the (S, G) entry. |
List of 1 outgoing interfaces |
Outgoing interface list of the (S, G) entry. An outgoing interface marked with (inactive) indicates that the interface does not participate in multicast forwarding. |
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 multicast forwarding-table
display multicast routing-table
Use display multicast routing-table to display multicast routing entries.
Syntax
display multicast [ vpn-instance vpn-instance-name ] routing-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | 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
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 multicast routing entries on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.
mask: Specifies an address mask. The default is 255.255.255.255.
incoming-interface: Specifies the multicast routing entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
outgoing-interface: Specifies the multicast routing entries that contain the specified outgoing interface.
exclude: Specifies the multicast routing entries that do not contain the specified interface in the outgoing interface list.
include: Specifies the multicast routing entries that contain the specified interface in the outgoing interface list.
match: Specifies the multicast routing entries that contain only the specified interface in the outgoing interface list.
Usage guidelines
Multicast routing entries are the basis of multicast forwarding. You can use this command to view the establishment state of (S, G) entries.
Examples
# Display multicast routing entries on the public network.
<Sysname> display multicast routing-table
Total 1 entries
00001. (172.168.0.2, 227.0.0.1)
Uptime: 00:00:28
Upstream Interface: GigabitEthernet3/1/1
List of 2 downstream interfaces
1: GigabitEthernet3/1/2
2: GigabitEthernet3/1/3
Table 5 Command output
Field |
Description |
Total 1 entries |
Total number of (S, G) entries. |
00001 |
Sequence number of the (S, G) entry. |
(172.168.0.2, 227.0.0.1) |
(S, G) entry. |
Uptime |
Length of time for which the (S, G) entry has been up. |
Upstream Interface |
Upstream interface at which (S, G) packets should arrive. |
List of 2 downstream interfaces |
List of downstream interfaces that need to forward (S, G) packets. |
display multicast routing-table static
Use display multicast routing-table static to display static multicast routing entries.
Syntax
display multicast [ vpn-instance vpn-instance-name ] routing-table static [ source-address { mask-length | mask } ]
Views
Any view
Predefined user roles
network-admin
network-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 static multicast routing entries on the public network.
source-address: Specifies a multicast source address.
mask-length: Specifies an address mask length in the range of 0 to 32.
mask: Specifies an address mask.
Usage guidelines
This command displays only valid static multicast routing entries.
Examples
# Display static multicast routing entries on the public network.
<Sysname> display multicast routing-table static
Destinations: 3 Routes: 4
Destination/Mask Pre RPF neighbor Interface
1.1.0.0/16 10 7.12.0.1 GE3/1/1
7.11.0.1 GE3/1/2
2.2.2.0/24 20 7.11.0.1 GE3/1/3
3.3.3.3/32 50 7.12.0.1 GE3/1/4
Table 6 Command output
Field |
Description |
Destinations |
Number of the multicast destination addresses. |
Routes |
Number of routes. |
Destination/Mask |
Destination address and its mask length. |
Pre |
Route preference. |
RPF neighbor |
IP address of the RPF neighbor to the reachable destination. |
Interface |
Outgoing interface to the reachable destination. |
display multicast rpf-info
Use display multicast rpf-info to display RPF information for a multicast source.
Syntax
display multicast [ vpn-instance vpn-instance-name ] rpf-info source-address [ group-address ]
Views
Any view
Predefined user roles
network-admin
network-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 a multicast source on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.
Examples
# Display RPF information for multicast source 192.168.1.55 on the public network.
<Sysname> display multicast rpf-info 192.168.1.55
RPF information about source 192.168.1.55:
RPF interface: GigabitEthernet3/1/1, RPF neighbor: 10.1.1.1
Referenced route/mask: 192.168.1.0/24
Referenced route type: igp
Route selection rule: preference-preferred
Load splitting rule: disable
Source AS: 0
C-multicast route target: 0x0000000000000000
Table 7 Command output
Field |
Description |
RPF neighbor |
IP address of the RPF neighbor. |
Referenced route/mask |
Referenced route and its mask length. |
Referenced route type |
Type of the referenced route: · igp—IGP unicast route. · egp—EGP unicast route. · unicast (direct)—Directly connected unicast route. · unicast—Other unicast routes, such as static unicast route. · multicast static—Static multicast route. · mbgp—MBGP route. |
Route selection rule |
Rule for RPF route selection: · Route preference. · Longest prefix match. |
Load splitting rule |
Status of the load splitting rule: enable or disable. |
Source AS |
AS number of the source-side PE. |
C-multicast route target |
Route target attribute value of the C-multicast route. |
display multicast forwarding-table
display multicast routing-table
ip rpf-route-static
Use ip rpf-route-static to configure a static multicast route.
Use undo ip rpf-route-static to delete a static multicast route.
Syntax
ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number } [ preference preference ]
undo ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number }
Default
No static multicast routes exist.
Views
System view
Predefined user roles
network-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 configures a static multicast route on the public network.
source-address: Specifies a multicast source address.
mask-length: Specifies an address mask length in the range of 0 to 32.
mask: Specifies an address mask.
rpf-nbr-address: Specifies an RPF neighbor by its IP address.
interface-type interface-number: Specifies an interface by its type and number. The interface connects the RPF neighbor.
preference: Sets a route preference in the range of 1 to 255. The default value is 1.
Usage guidelines
If the interface connected to an RPF neighbor is a point-to-point interface, you must specify the interface by its type and number.
If the interface connected to an RPF neighbor is not a point-to-point interface, you must specify the interface by its IP address. This type of interfaces includes VLAN interfaces, Layer 3 Ethernet, Layer 3 aggregate, and Loopback.
The configured static multicast route might not take effect when one of the following conditions exists:
· The outgoing interface iteration fails.
· The specified interface is not in the public network or the same VPN instance as the current interface.
· The specified interface is not a point-to-point interface.
· The specified interface is down.
If multiple static multicast routes within the same multicast source address range are available, only the one with the highest route preference can become active. You can use the display multicast routing-table static command to verify that the configured static multicast route has taken effect.
The undo ip rpf-route-static command deletes the specified static multicast route, but the delete ip rpf-route-static command deletes all static multicast routes.
Examples
# Configure a static multicast route to multicast source 10.1.1.0/24 and specify the interface with IP address 192.168.1.23 as the RPF neighbor on the public network.
<Sysname> system-view
[Sysname] ip rpf-route-static 10.1.1.0 24 192.168.1.23
Related commands
delete ip rpf-route-static
display multicast routing-table static
load-splitting (MRIB view)
Use load-splitting to enable multicast load splitting.
Use undo load-splitting to restore the default.
Syntax
load-splitting { balance | source | source-group | ucmp }
undo load-splitting
Default
Load splitting of multicast traffic is disabled.
Views
MRIB view
Predefined user roles
network-admin
Parameters
balance: Enables multicast load balancing based on multicast source and group.
source: Enables multicast load splitting based on multicast source.
source-group: Enables multicast load splitting based on multicast source and group.
ucmp: Enables multicast load splitting based on link.
Usage guidelines
To perform equal cost multipath load balancing or load splitting on multicast traffic, specify the balance, source, or source-group keyword. On a network with unstable equal cost links, specify the source or source-group keyword rather than the balance keyword to decrease the impact of adding or deletion equal cost links.
To perform unequal cost multipath load splitting on multicast traffic, specify the ucmp keyword.
Examples
# Enable load splitting based on multicast source on the public network.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] load-splitting source
longest-match (MRIB view)
Use longest-match to specify the longest prefix match principle for RPF route.
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 preference is used as the RPF route.
Views
MRIB view
Predefined user roles
network-admin
Usage guidelines
This command enables the device to use the matching route with the longest prefix as the RPF route.
Examples
# Specify the longest prefix match principle for RPF route selection on the public network.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] multicast longest-match
multicast boundary
Use multicast boundary to configure a multicast forwarding boundary.
Use undo multicast boundary to delete a multicast forwarding boundary.
Syntax
multicast boundary group-address { mask-length | mask }
undo multicast boundary { group-address { mask-length | mask } | all }
Default
No multicast forwarding boundaries are configured on an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
mask-length: Specifies an address mask length in the range of 4 to 32.
mask: Specifies an address mask.
all: Specifies all forwarding boundaries configured on the interface.
Usage guidelines
A multicast forwarding boundary sets the boundary condition for the multicast groups in the specified address range. If the destination address of a multicast packet matches the set boundary condition, the packet is not forwarded.
You can configure an interface as a multicast forwarding boundary for different multicast group ranges by executing this command multiple times on the interface.
You do not need to enable IP multicast routing before you execute this command.
Assume that Set A and Set B are multicast forwarding boundary sets with different address ranges, and 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 3/1/1 as the forwarding boundary of multicast groups in the range of 239.2.0.0/16.
<Sysname> system-view
[Sysname] interface gigabitethernet 3/1/1
[Sysname-GigabitEthernet3/1/1] multicast boundary 239.2.0.0 16
display multicast boundary
multicast forwarding-table cache-unknown per-entry
Use multicast forwarding-table cache-unknown per-entry to set the maximum number of unknown multicast packets that can be cached for an (S, G) entry.
Use undo multicast forwarding-table cache-unknown per-entry to restore the default.
Syntax
multicast forwarding-table cache-unknown per-entry per-entry-limit
undo multicast forwarding-table cache-unknown per-entry
Default
The device can cache only one unknown multicast packet for an (S, G) entry.
Views
System view
Predefined user roles
network-admin
Parameters
per-entry-limit: Specifies the maximum number of unknown 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 multicast packets.
Examples
# Set the maximum number to 20 for unknown multicast packets that can be cached for an (S, G) entry.
<Sysname> system-view
[Sysname] multicast forwarding-table cache-unknown per-entry 20
Related commands
multicast forwarding-table cache-unknown total
multicast forwarding-table cache-unknown total
Use multicast forwarding-table cache-unknown total to set the maximum number of all unknown multicast packets that can be cached.
Use undo multicast forwarding-table cache-unknown total to restore the default.
Syntax
multicast forwarding-table cache-unknown total total-limit
undo multicast forwarding-table cache-unknown total
Default
The device can cache 1024 unknown multicast packets in total.
Views
System view
Predefined user roles
network-admin
Parameters
total-limit: Specifies the maximum number of all unknown 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 multicast packets.
Usage guidelines
As a best practice, set the value in this command to be far greater than the value set in the multicast forwarding-table cache-unknown per-entry command.
Examples
# Set the maximum number to 10000 for all unknown multicast packets that can be cached.
<Sysname> system-view
[Sysname] multicast forwarding-table cache-unknown total 10000
Related commands
multicast forwarding-table cache-unknown per-entry
multicast routing
Use multicast routing to enable IP multicast routing and enter MRIB view.
Use undo multicast routing to disable IP multicast routing.
Syntax
multicast routing [ vpn-instance vpn-instance-name ]
undo multicast routing [ vpn-instance vpn-instance-name ]
Default
IP multicast routing is disabled.
Views
System view
Predefined user roles
network-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 IP multicast routing on the public network.
Usage guidelines
Other Layer 3 multicast commands take effect only when IP multicast routing is enabled on the public network or for a VPN instance.
The device does not forward multicast packets before IP multicast routing is enabled.
Examples
# Enable IP multicast routing on the public network, and enter MRIB view.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib]
# Enable IP multicast routing for the VPN instance mvpn, and enter MRIB view.
<Sysname> system-view
[Sysname] multicast routing vpn-instance mvpn
[Sysname-mrib-mvpn]
multicast rpf-fail-pkt flooding
Use multicast rpf-fail-pkt flooding to enable the device to flood RPF-check-failed multicast data packets in all VLANs.
Use multicast rpf-fail-pkt flooding to restore the default.
Syntax
multicast rpf-fail-pkt flooding
undo multicast rpf-fail-pkt flooding
Default
RPF-check-failed multicast data packets are not flooded in VLANs.
Views
System view
Predefined user roles
network-admin
Usage guidelines
You do not need to enable IP multicast routing before you execute this command.
For this command to take effect, you must clear all multicast forwarding entries after executing this command. To clear multicast forwarding entries, use the reset multicast forwarding-table command.
Examples
# Enable the device to flood RPF-check-failed multicast data packets.
<Sysname> system-view
[Sysname] multicast rpf-fail-pkt flooding
Related commands
reset multicast forwarding-table
multicast rpf-fail-pkt trap-to-cpu
Use multicast rpf-fail-pkt trap-to-cpu to enable the device to send RPF-check-failed multicast data packets to the CPU.
Use undo multicast rpf-fail-pkt trap-to-cpu to restore the default.
Syntax
multicast rpf-fail-pkt trap-to-cpu
undo multicast rpf-fail-pkt trap-to-cpu
Default
RPF-check-failed multicast data packets are not sent to the CPU.
Views
System view
Predefined user roles
network-admin
Usage guidelines
You do not need to enable IP multicast routing before you execute this command.
For this command to take effect, you must clear all multicast forwarding entries after executing this command. To clear multicast forwarding entries, use the reset multicast forwarding-table command.
Examples
# Enable the device to send multicast data packets that fail the RPF check to the CPU.
<Sysname> system-view
[Sysname] multicast rpf-fail-pkt trap-to-cpu
Related commands
reset multicast forwarding-table
reset multicast forwarding event
Use reset multicast forwarding event to clear statistics for multicast forwarding events.
Syntax
reset multicast [ vpn-instance vpn-instance-name ] forwarding event
Views
User view
Predefined user roles
network-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 multicast forwarding events on the public network.
Examples
# Clear statistics for multicast forwarding events on the public network.
<Sysname> reset multicast forwarding event
Related commands
display multicast forwarding event
reset multicast forwarding-table
Use reset multicast forwarding-table to clear multicast forwarding entries.
Syntax
reset multicast [ vpn-instance vpn-instance-name ] forwarding-table { { source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface { interface-type interface-number } } * | all }
Views
User view
Predefined user roles
network-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 multicast forwarding entries on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.
mask: Specifies an address mask. The default is 255.255.255.255.
incoming-interface: Specifies the multicast forwarding entries that contain the specified incoming interface.
interface-type interface-number: Specifies an incoming interface by its type and number.
all: Specifies all multicast forwarding entries.
Usage guidelines
When you clear a multicast forwarding entry, the associated multicast routing entry is also cleared.
Examples
# Clear multicast forwarding entries for multicast group 225.5.4.3 on the public network.
<Sysname> reset multicast forwarding-table 225.5.4.3
Related commands
display multicast forwarding-table
reset multicast routing-table
Use reset multicast routing-table to clear multicast routing entries.
Syntax
reset multicast [ vpn-instance vpn-instance-name ] routing-table { { source-address [ mask { mask-length | mask } ] | group-address [ mask { mask | mask-length } ] | incoming-interface interface-type interface-number } * | all }
Views
User view
Predefined user roles
network-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 multicast routing entries on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.
mask: Specifies an address mask. The default is 255.255.255.255.
incoming-interface: Specifies the routing entries that contain the specified incoming interface.
interface-type interface-number: Specifies an incoming interface by its type and number.
all: Specifies all multicast routing entries.
Usage guidelines
When you clear a multicast routing entry, the associated multicast forwarding entry is also cleared.
Examples
# Clear multicast routing entries for multicast group 225.5.4.3 on the public network.
<Sysname> reset multicast routing-table 225.5.4.3
Related commands
display multicast routing-table