ipv4-acl-number: Specifies an IPv4 basic or advanced ACL by its number, in the range of 2000 to 3999. If the ACL does not exist or does not have contain rules, the IPv4 multicast flow policy does not take effect on any multicast groups.

name ipv4-acl-name: Specifies an IPv4 basic or advanced ACL by its name. The acl-name argument is a case-insensitive string of 1 to 63 characters and must begin with an English letter. To avoid confusion, make sure the argument is not all. If the ACL does not exist or does not have contain rules, the IPv4 multicast flow policy does not take effect on any multicast groups.

Usage guidelines

This command is not supported by the default IPv4 multicast flow policy.

If a multicast group matches the ACL specified in an IPv4 multicast flow policy, the estimated bandwidth configured in the policy is used for the multicast flows of the multicast group.

In a basic ACL rule, the source parameter specifies a multicast group range. Among the other optional parameters, only the time-range time-range-name option takes effect.

In an advanced ACL rule, the source parameter specifies a multicast source range, and the destination parameter specifies a multicast group range. Among the other optional parameters, only the time-range time-range-name option takes effect.

An ACL rule containing the vpn-instance vpn-instance option does not take effect.

If you execute this command multiple times, the most recent configuration takes effect.

Example

# Configure an IPv4 multicast flow policy to take effect on the multicast group range 224.1.0.0/16.

<Sysname> system-view

[Sysname] acl basic 2000

[Sysname-acl-ipv4-basic-2000] rule permit source 224.1.0.0 0.0.255.255

[Sysname-acl-ipv4-basic-2000] quit

[Sysname] multicast routing

[Sysname-mrib] flow-policy name abc

[Sysname-mrib-flow-policy-abc] acl 2000

Related commands

flow-policy (IPv4 MRIB view)

bandwidth (IPv4 multicast flow policy view)

Use bandwidth to set the estimated bandwidth for multicast flows.

Use undo bandwidth to restore the default.

Syntax

bandwidth bandwidth { gbps | kbps | mbps }

undo bandwidth

Default

The estimated bandwidth for multicast flows is 0.

Views

IPv4 multicast flow policy view

Predefined user roles

network-admin

Parameters

bandwidth: Specifies the estimated bandwidth in the range of 1 to 10000.

gbps: Specifies Gbps as the bandwidth unit.

kbps: Specifies kbps as the bandwidth unit.

Mbps: Specifies Mbps as the bandwidth unit.

Usage guidelines

The estimated bandwidth is selected for IPv4 multicast flows as follows:

1. If the multicast group of an IPv4 multicast flow matches the ACL specified in a custom IPv4 multicast flow policy, the estimated bandwidth configured in the policy is selected for the multicast flow.

2. If the multicast group of an IPv4 multicast flow does not match an ACL in any custom IPv4 multicast flow policy, the estimated bandwidth configured in the default policy is selected for the multicast flow.

3. If the default policy is not created or the estimated bandwidth is not configured in the default policy, the estimated bandwidth for the multicast flow is 0.

Example

# Set the estimated bandwidth to 200 Mbps for IPv4 multicast flow policy abc.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] flow-policy name abc

[Sysname-mrib-flow-policy-abc] bandwidth 200 mbps

Related commands

flow-policy (IPv4 MRIB view)

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: Vlan-interface1

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

Flags : 0x2

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. · LOOP—Loopback interface. · REGISTER—Register 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.
Flags	Interface attribute. This field displays one flag or the sum of multiple flags. For example, value 0x2 means that the interface has only one flag 0x2, and value 0x14 means that the interface has flags 0x4 and 0x10. The following flags are available for an interface: · 0x0—The interface is in normal status. · 0x1—The interface address is being deleted. · 0x2—The interface address is an IPv4 primary address. · 0x4—The interface is a PMSI tunnel interface for RSVP-TE-based MVPN. · 0x8—The interface is a multicast tunnel interface for a Layer 3 VXLAN. · 0x10—The interface is a virtual multicast incoming interface for tunneled traffic.

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 Vlan1

239.2.2.0/24 Vlan2

Table 2 Command output

Field	Description
Boundary	Multicast group associated with the multicast boundary.
Interface	Boundary interface associated with the multicast boundary.

Related commands

multicast boundary

display multicast fast-forwarding cache

Use display multicast fast-forwarding cache to display multicast fast forwarding entries.

Syntax

display multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ source-address | group-address ] * [ 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 multicast fast 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.1.0 to 239.255.255.255.

slot slot-number: Specifies the slot number of the device, which is fixed at 1.

Examples

# Display multicast fast forwarding entries on the public network. ‌

<Sysname> display multicast fast-forwarding cache

Total 1 entries, 1 matched

(60.1.1.200, 225.0.0.2)

Status : Enabled

Source port: 2001 Destination port: 2002

Protocol : 2 Flag : 0x2

Incoming interface: Vlan-interface1

List of 1 outgoing interfaces:

Vlan-interface2

Status: Enabled Flag: 0x14

Table 3 Command output

Field	Description
Total 1 entries, 1 matched	Total number of (S, G) entries in the multicast fast forwarding table, and the total number of matching (S, G) entries.
(60.1.1.200, 225.0.0.2)	(S, G) entry.
Protocol	Protocol number.
Flag	Flag of the (S, G) entry or the outgoing interface in the entry. This field displays one flag or the sum of multiple flags. For example, value 0x2 means that the entry has only one flag 0x2, and value 0x14 means that the interface has flags 0x4 and 0x10. 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 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 multicast fast-forwarding cache all

display multicast flow-policy info

Use display multicast flow-policy info to display link selection information for IPv4 multicast flow policies.

Syntax

display multicast [ vpn-instance vpn-instance-name ] flow-policy info [ interface interface-type interface-number | source source-address | group group-address | policy { default | name policy-name } ] *

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 link selection information for IPv4 multicast flow policies on the public network.

interface interface-type interface-number: Displays link selection information for IPv4 multicast flow policies on an interface.

source source-address: Displays link selection information for IPv4 multicast flow policies for a multicast source.

group group-address: Displays link selection information for IPv4 multicast flow policies for a multicast group. The value range for the group-address argument is 224.0.0.0 to 239.255.255.255.

policy default: Specifies the default IPv4 multicast flow policy.

policy name policy-name: Specifies a custom IPv4 multicast flow policy by its name, a case-insensitive string of 1 to 63 characters.

Usage guidelines

If you do not specify the source, group, or policy parameter, this command displays link selection information for all IPv4 multicast flow policies.

Examples

# Display link selection information for all IPv4 multicast flow policies on the public network. ‌

<Sysname> display multicast flow-policy info

Total 2 interfaces, 2 matched

Vlan-interface100:

Available bandwidth: 100M

Used bandwidth: 30M (30%)

Total 4 entries, 4 matched

Flow bandwidth: 5M

Total 2 entries, 2 matched

(1.1.1.1, 225.0.0.1)

Flow policy: video1

(1.1.1.1, 225.0.0.2)

Default flow policy

Flow bandwidth: 10M

Total 2 entries, 2 matched

(1.1.1.1, 225.0.0.11)

Flow policy: audio1

(1.1.1.1, 225.0.0.12)

Flow policy: video2

Vlan-interface200:

Available bandwidth: 100M

Used bandwidth: 10M (10%)

Total 1 entries, 1 matched

Flow bandwidth: 10M

Total 1 entries, 1 matched

(1.1.1.1, 226.0.0.1)

Flow policy: video3

Table 4 Command output

Field	Description
Total 2 interfaces, 2 matched	Total number of interfaces enabled with PIM and number of matching interfaces.
Available bandwidth	Total available multicast bandwidth on the interface.
Used bandwidth	Used multicast bandwidth in percentage on the interface.
Total 4 entries, 4 matched	Total number of (S, G) entries that have selected the interface as an upstream interface and number of matching (S, G) entries.
Flow bandwidth	Estimated bandwidth configured in an IPv4 multicast flow policy.
Total 1 entries, 1 matched	Total number of (S, G) entries for the IPv4 multicast flow policy and number of matching (S, G) entries.
(1.1.1.1, 225.0.0.1)	(S, G) entry for the IPv4 multicast flow.
Flow policy	Name of the custom IPv4 multicast flow policy.
Default flow policy	Name of the default IPv4 multicast flow policy.

Related commands

flow-ucmp unicast reserved-bandwidth

display multicast forwarding df-info

Use display multicast forwarding df-info to display DF information.

Syntax

display multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ rp-address ] [ verbose ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-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 DF information on the public network.

rp-address: Specifies a BIDIR-PIM RP by its IP address.

verbose: Specifies detailed information. If you do not specify this keyword, the command displays brief information about DFs.

slot slot-number: Specifies the slot number of the device, which is fixed at 1.

Usage guidelines

In a BIDIR-PIM domain, only the DF on each subnet can forward multicast data destined for a multicast group toward the RP of the group. For more information about the DF, see IP Multicast Configuration Guide.

Examples

# Display brief information about DFs on the public network. ‌

<Sysname> display multicast forwarding df-info

Total 1 RPs, 1 matched

00001. RP address: 7.11.0.2

Flags: 0x0

Uptime: 04:14:40

RPF interface: Vlan-interface1

List of 1 DF interfaces:

1: Vlan-interface2

# Display detailed information about DFs on the public network. ‌

<Sysname> display multicast forwarding df-info verbose

Total 1 RPs, 1 matched

00001. RP address: 7.11.0.2

MID: 2, Flags: 0x0

Uptime: 03:37:22

Product information: 0x7a2f762f, 0x718fee9f, 0x4b82f137, 0x71c32184

RPF interface: Vlan-interface1

Product information: 0xa567d6fc, 0xadeb03e3

Tunnel information: 0xdfb107d4, 0x7aa5d510

List of 1 DF interfaces:

1: Vlan-interface2

Product information: 0xa986152b, 0xb74a9a2f

Tunnel information: 0x297ca208, 0x76985b89

Table 5 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	IP 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. For example, 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.

display multicast forwarding event

Use display multicast forwarding event to display statistics of multicast forwarding events.

Syntax

display multicast [ vpn-instance vpn-instance-name ] forwarding event [ 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 the slot number of the device, which is fixed at 1.

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

Table 6 Command output

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

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 | replicate replicate-index | frr frr-index | slot slot-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 the slot number of the device, which is fixed at 1.

replicate replicate-index: Specifies the multicast forwarding entries that used a multicast replication resource. The argument represents the index of the multicast replication resource, in the range of 0x1 to 0xFFFFFFFF.

frr frr-index: Specifies the multicast forwarding entries that used a multicast FRR resource. Multicast VXLAN, BIDIR-PIM, and multicast VLAN do not support this option.

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, FlagExts: 0x0

Uptime: 00:08:32, Timeout in: 00:03:26

Incoming interface: Vlan-interface10

Backup incoming interface: Vlan-interface11

FRR index: 0x2

Replicate index: 1

List of 1 outgoing interfaces:

1: Vlan-interface20

Matched 19648 packets(20512512 bytes), Wrong If 0 packet

Forwarded 19648 packets(20512512 bytes)

Table 7 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. For example, 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. · 0x400000—The entry is created by the IGMP proxy. · 0x2000000—The entry is a BIDIR-PIM forwarding entry.
FlagExts	Entry flag: · 0x1—The next-hop entry of a multicast VXLAN tunnel needs to be issued to the driver again. · 0x2—The entry failed to be issued to the driver during FRR switchover. · 0x4—Multicast VXLAN traffic came from a peer link or M-LAG interface. · 0x8—Multicast VXLAN traffic came from a DCI tunnel. · 0x10—The entry was successfully bound to replication resources. · 0x20—The entry was created in on-demand mode.
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.
Backup incoming interface	Backup incoming interface of the (S, G) entry. If the primary incoming interface of the (S, G) entry fails, multicast data arrived at the backup incoming interface will be forwarded to receivers.
FRR index	Index of the multicast FRR resource.
Replicate index	Index of the multicast replication resource.
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.

Related commands

reset multicast forwarding-table

display multicast forwarding-table capability

Use display multicast forwarding-table capability to display multicast forwarding capability information.

Syntax

display multicast forwarding-table capability [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies the slot number of the device, which is fixed at 1.

Examples

# Display all multicast forwarding capability information.

<Sysname> display multicast forwarding-table capability

Local entries: 0/1000

Global entries: 500/2000/128000

Software entry index: 1000/6000

Capability Slot number

16384 Slot 1

Table 8 Command output

Field	Description
Local entries	This field is not supported in the current software version. Multicast forwarding capability of the card, in value1/value2 format. · value1—The current number of entries with their incoming interface on the card. This field is significant only when conversational multicast entry learning is enabled. This field is fixed at 0 if the feature is disabled. · value2—Maximum number of entries with their incoming interface on the card. This field is significant only when conversational multicast entry learning is enabled. This field is meaningless when the feature is disabled.
Global entries	Statistics for the global multicast forwarding capability of the device, in value1/value2/value3 format. · value1—The number of existing entries. · value2—The maximum number of entries the device can have when it is installed with the current number of interface modules. · value3—The maximum number of entries the device would have when it was fully configured with the maximum number of interface modules. For example, the device can have a maximum of four interface modules and it is installed with two interface modules. Then, the second value in this field indicates the maximum number of entries the device can have when it is installed with two interface modules. The third value in this field indicates the maximum number of entries the device would have when it was fully configured with four interface modules.
Software entry index	Assignment status of indexes in software for entries on the interface module, in value1/value2 format. · value1—The highest value among all index values assigned in software to the multicast forwarding table entries. · value2—Index count upper limit in software. NOTE: Each multicast forwarding entry has a unique index in software to identify their storage location.
Capability	Maximum number of entries in the multicast forwarding table on each slot.

display multicast forwarding-table df-list

Use display multicast forwarding-table df-list to display information about the DF list in multicast forwarding entries.

Syntax

display multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ group-address ] [ verbose ] [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-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 multicast forwarding entries on the public network.

group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.

verbose: Specifies detailed information about the DF list in multicast forwarding entries. If you do not specify this keyword, the command displays brief information about the DF list in multicast forwarding entries.

slot slot-number: Specifies the slot number of the device, which is fixed at 1.

Examples

# Display brief information about the DF list in multicast forwarding entries on the public network. ‌

<Sysname> display multicast forwarding-table df-list

Total 1 entries, 1 matched

00001. (0.0.0.0, 225.0.0.1)

List of 1 DF interfaces:

1: Vlan-interface1

# Display detailed information about the DF list in multicast forwarding entries on the public network. ‌

<Sysname> display multicast forwarding-table df-list verbose

Total 1 entries, 1 matched

00001. (0.0.0.0, 225.0.0.1)

List of 1 DF interfaces:

1: Vlan-interface1

Product information: 0x347849f6, 0x14bd6837

Tunnel information: 0xc4857986, 0x128a9c8f

Table 9 Command output

Field	Description
Total 1 entries, 1 matched	Total number of forwarding entries, and the total number of matching entries.
00001	Sequence number of the entry.
(0.0.0.0, 225.0.0.1)	(*, G) entry.
List of 1 DF interfaces	DF interface list.

display multicast replication-share info

Use display multicast replication-share info to display information about multicast replication resources.

Syntax

display multicast replication-share info [ outgoing-interface { exclude | include | match } interface-type interface-number | replicate replicate-index ] * [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

outgoing-interface: Specifies the multicast replication resources that contain the specified outgoing interface.

exclude: Specifies the multicast replication resources that do not contain the specified interface in the outgoing interface list.

include: Specifies the multicast replication resources that contain the specified interface in the outgoing interface list.

match: Specifies the multicast replication resources that contain only the specified interface in the outgoing interface list.

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

replicate replicate-index: Specifies a multicast replication resource by its index in the range of 0x1 to 0xFFFFFFFF.

slot slot-number: Specifies the slot number of the device, which is fixed at 1.

Examples

# Display all multicast replication resources.

<Sysname> display multicast replication-share info

multicast replication-share status: active

Total 5 entries, 5 matched

00001. Replicate index: 0x3

Drv context: 0x11112222, 0x33330001

Creation time: 00:21:20

Flags: 0x1

Match key: 120

Reference count: 2

List of 1 outgoing interfaces:

1: HundredGigE1/1/2

00002. Replicate index: 0x5

Drv context: 0x11112222, 0x33330002

Creation time: 00:12:30

Flags: 0x3

Match key: 820

Reference count: 3

Outgoing slots (2 in total): 1-2

Incoming interface: Vlan-interface10

List of 2 outgoing interfaces:

1: Vlan-interface10

List of 1 outgoing ports:

1: HundredGigE1/1/1

2: Vlan-interface20

List of 2 outgoing ports:

1: GigabitEthernet2/0/1

2: GigabitEthernet2/0/2

00003.Replicate index: 0xb

Drv context: 0x11112222, 0x33330003

Creation time: 00:11:30

Flags: 0x0

Match key: 2020

Reference count: 1

Outgoing slots (1 in total): 2

Incoming interface: Vlan-interface100

Incoming sub-VLAN: VLAN 101

List of 1 outgoing interfaces:

1: Vlan-interface100

Sub-VLAN: VLAN 101

List of 1 outgoing ports:

1: GigabitEthernet2/0/3

Sub-VLAN: VLAN 102

List of 1 outgoing ports:

1: GigabitEthernet2/0/4

00004.Replicate index: 0x20

Drv context: 0x11112222, 0x33330004

Creation time: 00:10:30

Flags: 0x4

Match key: 2510

Reference count: 1

Outgoing slots (1 in total): 1

Incoming interface: Vsi-interface1

List of 2 outgoing interfaces:

1: Vsi-interface1

VSI instance: a

List of 1 outgoing ports:

1: HundredGigE1/1/3

VSI instance: b

List of 1 outgoing ports:

1: HundredGigE1/1/4

2: Vsi-interface2

VSI instance: c

List of 2 outgoing ports:

1: HundredGigE1/1/5

2: HundredGigE1/1/6

00005.Replicate index: 0x35

Drv context: 0x11112222, 0x33330005

Creation time: 00:09:20

Flags: 0x3

Match key: 33757175

Reference count: 1

List of 1 outgoing interfaces:

1: MTunnel0 (VPN: a)

Data-group: 225.2.2.1

Table 10 Command output

Field	Description
multicast replication-share status	State of the multicast replication resource reuse feature: · not configured—Multicast replication resource reuse was disabled. · inactive—Multicast replication resource reuse was enabled but did not take effect. · active—Multicast replication resource reuse was enabled and took effect.
Total 5 entries, 5 matched	Total number of replication entries, and the total number of matching entries.
00001	Sequence number of the multicast replication resource entry.
Replicate index	Index of the multicast replication resource.
Drv context	Index of the hardware resource.
Creation time	Time when the multicast replication entry was created.
Flags	State of the multicast replication resource entry: · 0x0—The entry is normal. · 0x1—Failed to create a multicast replication resource. · 0x2—Failed to bind a multicast replication resource. · 0x4—Failed to edit a multicast replication resource.
Match key	Key value used to fast match multicast replication resources that can be reused.
Reference count	Number of entries that are associated with the multicast replication resource.
Incoming interface	Incoming interface of the entry.
List of 1 outgoing interfaces	Outgoing interface list of the entry.
Outgoing slots (0 in total)	This field is meaningless.
List of 1 outgoing ports	Outgoing interfaces in a VLAN or VSI: · When Layer 2 multicast is configured, this field indicates the member port or router port in the VLAN or VSI. · When Layer 2 multicast is not configured, this field indicates all ports in the VLAN or VSI.
MTunnel0 (VPN: a)	Multicast VPN tunnel interface and the VPN instance name.
Data-group	Data group in the multicast VPN.
Incoming VSI instance	Incoming VSI instance when the incoming interface of the entry is MVXLAN-UPE type.

Related commands

display 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

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: 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: Vlan-interface1

Backup Upstream Interface: Vlan-interface4

List of 2 downstream interfaces

1: Vlan-interface2

2: Vlan-interface3

Table 11 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.
Backup Upstream Interface	Backup incoming interface of the (S, G) entry. If the primary incoming interface of the (S, G) entry fails, multicast data arrived at the backup incoming interface will be forwarded to receivers.
List of 2 downstream interfaces	List of downstream interfaces that need to forward (S, G) packets. A downstream interface marked with (inactive) indicates that the interface does not participate in multicast forwarding.

Related commands

reset multicast routing-table

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 Vlan12

7.11.0.1 Vlan11

2.2.2.0/24 20 7.11.0.1 Vlan11

3.3.3.3/32 50 7.12.0.1 Vlan12

Table 12 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:Vlan-interface1, RPF neighbor: 10.1.1.1

Backup RPF interface: Vlan-interface2, backup RPF neighbor: 2.2.2.2

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 13 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.

Related commands

display multicast forwarding-table

display multicast routing-table

flow-policy (MRIB view)

Use flow-policy to create an IPv4 multicast flow policy and enter its view, or enter the view of an existing IPv4 multicast flow policy.

Use undo flow-policy to delete IPv4 multicast flow policies.

Syntax

flow-policy { default | name policy-name }

undo flow-policy { all | default | name policy-name }

Default

No IPv4 multicast flow policies exist.

Views

MRIB view

Predefined user roles

network-admin

Parameters

default: Specifies the default IPv4 multicast flow policy.

policy name policy-name: Specifies a custom IPv4 multicast flow policy by its name, a case-insensitive string of 1 to 63 characters.

all: Deletes all IPv4 multicast flow policies.

Usage guidelines

Operating mechanism

The device selects the link with the smallest bandwidth usage as the optimal link if the following conditions exist:

· ECMP routes between the device and an upstream device.

· The multicast load-splitting mode is flow-ucmp.

If two links have the same bandwidth usage, the link with the higher next-hop IP address is selected.

The bandwidth usage is calculated according to the following formula: Bandwidth usage = (Used bandwidth+Estimated bandwidth)/(Total interface bandwidth x (1–Unicast reserved bandwidth)).

· The estimated bandwidth is configured by the bandwidth command in IPv4 multicast flow policy view.

· The total interface bandwidth is configured by the bandwidth command in interface view.

· The unicast reserved bandwidth is configured by the flow-ucmp unicast reserve-bandwidth or multicast flow-ucmp unicast reserve-bandwidth command.

Restrictions and guidelines

For this command to take effect, you must configure the multicast load-splitting mode as flow-ucmp.

Adding, deleting, or modifying an IPv4 multicast flow policy does not affect the link selection results of existing multicast flows and affects link selection for only new multicast flows. Before configuring the multicast load-splitting mode as flow-ucmp, you must plan the configuration of an IPv4 multicast flow policy and the unicast reserved bandwidth configuration.

The change of link bandwidth and the change in the number of ECMP routes do not affect the route selection of existing multicast flows.

This feature does not affect multicast source-side link selection, link selection in PIM-DM, RPT link selection in PIM-SM, or local RP link selection.

If both IPv4 and IPv6 multicast flows exist in the network, increase the unicast reserved bandwidth as needed to avoid congestion.

Examples

# Create an IPv4 multicast flow policy named abc and enter its view.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] flow-policy name abc

# Create the default IPv4 multicast flow policy and enter its view.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] flow-policy default

Related commands

acl (IPv4 multicast flow policy)

bandwidth

display multicast flow-policy info

flow-ucmp unicast reserve-bandwidth (MRIB view)

Use flow-ucmp unicast reserve-bandwidth to set the global IPv4 unicast reserved bandwidth percentage.

Use undo flow-ucmp unicast reserve-bandwidth to restore the default.

Syntax

flow-ucmp unicast reserve-bandwidth percentage

undo flow-ucmp unicast reserve-bandwidth

Default

The global IPv4 unicast reserved bandwidth percentage is not set.

Views

MRIB view

Predefined user roles

network-admin

Parameters

percentage: Specifies the global IPv4 unicast reserved bandwidth percentage in the range of 1 to 100.

Usage guidelines

For this command to take effect, you must configure the multicast load-splitting mode as flow-ucmp.

Execute this command when IPv4 unicast traffic and IPv4 multicast traffic coexist in the network. The available bandwidth for multicast traffic is calculated based on the total interface bandwidth and the configured IPv4 unicast reserved bandwidth percentage. For example, if the total interface bandwidth is 100 kbps and the unicast reserved bandwidth percentage is 20% (20 kbps), the available bandwidth for multicast traffic is 80 kbps.

The flow-ucmp unicast reserve-bandwidth command takes effect on all interfaces, and the multicast flow-ucmp unicast reserve-bandwidth command takes effect only on the current interface. If you execute both commands, the latter has higher priority.

Example

# Set the global IPv4 unicast reserved bandwidth percentage to 50%.

<Sysname> system-view

[Sysname] multicast routing

[Sysname-mrib] flow-ucmp unicast reserve-bandwidth 50

Related commands

multicast flow-ucmp unicast reserve-bandwidth

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 } { gateway-address | interface-type interface-number } [ preference preference ]

undo ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { gateway-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.

gateway-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 Layer 3 Ethernet, Layer 3 aggregate, Loopback, and VLAN interfaces.

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-ecmp | balance-ucmp | ecmp | flow-ucmp | source | source-group | ucmp }

undo load-splitting

Default

Multicast load splitting is disabled.

Views

MRIB view

Predefined user roles

network-admin

Parameters

balance-ecmp: Enables multicast load balancing based on ECMP paths. Multicast traffic is evenly distributed among ECMP paths.

balance-ucmp: Enables multicast load balancing based on links. Multicast traffic is evenly distributed among links.

ecmp: Enables multicast load splitting based on ECMP paths.

flow-ucmp: Enables multicast load splitting based on the bandwidth usage of multicast flows.

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 links.

Usage guidelines

This command does not take effect on BIDIR-PIM.

To use the flow-ucmp multicast load-splitting mode, you must first configure an IPv4 multicast flow policy and the IPv4 unicast reserved bandwidth percentage. Adding, deleting, or modifying an IPv4 multicast flow policy does not affect the link selection results of existing multicast flows and affects link selection for only new multicast flows.

On a network with ECMP routes, specify the balance-ecmp, ecmp, flow-ucmp, source, or source-group keyword. On a network with UCMP routes, specify the balance-ucmp or ucmp keyword.

· If you specify the ecmp keyword, adding or deleting ECMP routes severely affects multicast forwarding.

· If you specify the source or source-group keyword, adding or deleting ECMP routes slightly affects multicast forwarding. Specify either of the keywords on a network with unstable equal cost links.

· If you specify the balance-ecmp or balance-ucmp keyword, the device uses a polling mechanism for multicast load balancing. ECMP or UCMP-based multicast load balancing provides better stability and balance than ECMP or UCMP-based multicast load sharing.

· If you specify the flow-ucmp keyword, adding or deleting ECMP routes slightly affects multicast forwarding. Specify this keyword on a network with unstable equal-cost links. It provides better stability and balance than the ucmp multicast load-sharing mode.

Examples

# Enable multicast 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 VLAN-interface 100 as the forwarding boundary of multicast groups in the range of 239.2.0.0/16. ‌

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] multicast boundary 239.2.0.0 16

Related commands

display multicast boundary

multicast cpu-forwarding max-copy-count

Use multicast cpu-forwarding max-copy-count to set the maximum number of copied multicast packets during software forwarding.

Use undo multicast cpu-forwarding max-copy-count to restore the default.

Syntax

multicast cpu-forwarding max-copy-count count

undo multicast cpu-forwarding max-copy-count

Default

The maximum number of copied multicast packets during software forwarding is 5.

Views

System view

Predefined user roles

network-admin

Parameters

count: Specifies the maximum number of copied multicast packets during software forwarding. The value range for this argument is 1 to 36.

Usage guidelines

Setting a greater limit will cause high CPU usage and degrade forwarding performance. Setting a small limit will cause multicast packets to be dropped.

CAUTION:

Perform this task under the guidance of H3C Support.

Examples

# Set the maximum number to 3 for copied multicast packets during software forwarding.

<Sysname> system-view

[Sysname] multicast cpu-forwarding max-copy-count 3

multicast flow-ucmp unicast reserve-bandwidth

Use multicast flow-ucmp unicast reserve-bandwidth to set the IPv4 unicast reserved bandwidth percentage on an interface.

Use undo multicast flow-ucmp unicast reserve-bandwidth to restore the default.

Syntax

multicast flow-ucmp unicast reserve-bandwidth percentage

undo multicast flow-ucmp unicast reserve-bandwidth

Default

The IPv4 unicast reserved bandwidth percentage is not set on an interface.

Views

Interface view

Predefined user roles

network-admin

Parameters

percentage: Specifies the IPv4 unicast reserved bandwidth percentage in the range of 1 to 100.

Usage guidelines

For this command to take effect, you must use the load-splitting command to configure the multicast load-splitting mode.

Example

# Set the IPv4 unicast reserved bandwidth percentage to 50% on VLAN interface 100. ‌

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] multicast flow-ucmp unicast reserve-bandwidth 50

Related commands

flow-ucmp unicast reserve-bandwidth

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

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 frr mode

Use multicast frr mode to set the multicast FRR mode.

Use undo multicast frr mode to restore the default.

Syntax

multicast frr mode [ by-entry | by-iif ]

undo multicast frr mode

Default

The multicast FRR mode is by-entry.

Views

System view

Predefined user roles

network-admin

Parameters

by-entry: Specifies the by-entry mode. In this mode, multicast FRR periodically monitors multicast traffic on primary and backup incoming interfaces by entry.

by-iif: Specifies the by-incoming interface mode. In this mode, multicast FRR periodically monitors multicast traffic for different (S, G) entries by pair of primary and backup incoming interfaces.

Usage guidelines

With multicast FRR enabled, the device will add a primary incoming interface and a backup incoming interface for each (S, G) entry during entry creation. It will periodically monitor multicast traffic on the primary and backup incoming interfaces of all entries. If no multicast traffic is detected on the primary incoming interface, the device determines that the primary incoming interface fails and uses the backup incoming interface for multicast forwarding.

As a best practice, set the multicast FRR mode to by-incoming interface if the device has a large number of multicast entries and most entries have the same primary and backup incoming interfaces.

In the current software version, only PIM supports multicast FRR. Multicast VXLAN, BIDIR-PIM, and multicast VLAN do not support this feature. For more information about PIM FRR, see PIM configuration in IP Multicast Configuration Guide.

Examples

# Set the multicast FRR mode to by-incoming interface.

<Sysname> system-view

[Sysname] multicast frr mode by-iif

Related commands

rpf-frr enable

multicast frr monitor cycle

Use multicast frr monitor cycle to set the primary/backup link monitoring interval for multicast FRR.

Use undo multicast frr monitor cycle to restore the default.

Syntax

multicast frr monitor cycle monitor-time

undo multicast frr monitor cycle

Default

The primary/backup link monitoring interval is 200 milliseconds.

Views

System view

Predefined user roles

network-admin

Parameters

monitor-time: Specifies the primary/backup link monitoring interval in milliseconds. Valid values are 10, 20, 40, 100, 200, and 500.

Usage guidelines

Before executing this command, execute the rpf-frr enable command to enable PIM FRR.

As a best practice to prevent the CPU from being overloaded, set the monitoring interval to a larger value if there are many multicast entries. As a best practice to prevent the device from determining link failures mistakenly when the multicast traffic rate is small, also set the monitoring interval to a larger value if there are many multicast entries.

Multicast VXLAN, BIDIR-PIM, and multicast VLAN do not support this command.

Examples

# Set the primary/backup link monitoring interval to 20 milliseconds.

<Sysname> system-view

[Sysname] multicast frr monitor cycle 20

Related commands

rpf-frr enable

multicast frr wtr

Use multicast frr wtr to configure traffic switchback from the backup link to the primary link for multicast FRR.

Use undo multicast frr wtr to restore the default.

Syntax

multicast frr wtr { wtr-time | disable }

undo multicast frr wtr

Default

Traffic switchback is disabled and the wait-to-restore (WTR) time is 600 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

wtr-time: Specifies the wait-to-restore (WTR) time in the range of 60 to 1800 seconds.

disable: Disables traffic switchback.

Usage guidelines

Before executing this command, execute the rpf-frr enable command to enable PIM FRR.

To prevent multicast traffic from being switched back before the multicast entries are created for the primary link, do not set too short a wait-to-restore (WTR) time.

Multicast packets might be lost or duplicate multicast packets might exist during a traffic switchback. As a best practice, do not configure traffic switchback for multicast services requiring high reliability.

The wait-to-restore (WTR) time takes effect on only switchback operations performed after it is configured.

Multicast VXLAN, BIDIR-PIM, and multicast VLAN do not support this command.

Examples

# Set the WTR time to 800 seconds.

<Sysname> system-view

[Sysname] multicast frr wtr 800

Related commands

rpf-frr enable

multicast permit ssdp-group

Use multicast permit ssdp-group to allow the generation of multicast entries with group address 239.255.255.250.

Use undo multicast permit ssdp-group to restore the default.

Syntax

multicast permit ssdp-group

undo multicast permit ssdp-group

Default

The device cannot generate multicast entries with 239.255.255.250 as the group address.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Application scenarios

Simple Service Discovery Protocol (SSDP) is a LAN discovery protocol that uses 239.255.255.250 for advertisement and discovery of network services.

Execute this command to allow multicast entries with 239.255.255.250 as the group address to be generated on the device.

Restrictions and guidelines

The generation of multicast entries with 239.255.255.250 as the group address is also affected by a multicast group policy and a multicast source policy. If 239.255.255.250 is filtered by the ACL in a multicast group policy or multicast source policy, such multicast entries cannot be generated. A multicast group policy is configured by using the igmp group-policy command, and a multicast source policy is configured by using the source-policy command.

Examples

# Allow the generation of multicast entries with group address 239.255.255.250.

<Sysname> system-view

[Sysname] multicast permit ssdp-group

multicast replication-share enable

Use multicast replication-share enable to enable multicast replication resource reuse.

Use undo multicast replication-share enable to disable multicast replication resource reuse.

Syntax

multicast replication-share enable

undo multicast replication-share enable

Default

Multicast replication resource reuse is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Multicast replication resources are hardware resources used to replicate multicast traffic. By default, multiple (S, G) entries with the same outgoing interface use multiple multicast replication resources.

This feature allows (S, G) entries with the same outgoing interface to use the same multicast replication resource.

For this command to take effect ,you must use the reboot command to reboot the device.

Examples

# Enable multicast replication resource reuse.

<Sysname> system-view

[Sysname] multicast replication-share enable

Configuring success. Please save the configuration first, then reboot the device to activate the function.

Related commands

display multicast replication-share info

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]

reset multicast fast-forwarding cache

Use reset multicast fast-forwarding cache to clear multicast fast forwarding entries.

Syntax

reset multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { source-address | group-address } * | all } [ slot slot-number ]

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 fast 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.

slot slot-number: Specifies the slot number of the device, which is fixed at 1.

all: Specifies all multicast fast forwarding entries.

Examples

# Clear all multicast fast forwarding entries on the public network.

<Sysname> reset multicast fast-forwarding cache all

# Clear the multicast fast forwarding entry for multicast source and group (20.0.0.2, 225.0.0.2) on the public network.

<Sysname> reset multicast fast-forwarding cache 20.0.0.2 225.0.0.2

Related commands

display multicast fast-forwarding cache

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

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: 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

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: 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

06-IP Multicast Command Reference

acl (IPv4 multicast flow policy view)

bandwidth (IPv4 multicast flow policy view)

display mrib interface

Operating mechanism

multicast boundary

Application scenarios

Restrictions and guidelines

reset multicast fast-forwarding cache

reset multicast routing-table

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us