vpn-instance vpn-instance-name: Specifies an MPLS L3VPN, where the vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If this option is not specified, the command deletes all multicast static routes on the public network.

Description

Use delete ip rpf-route-static to delete all multicast static routes.

Related commands: ip rpf-route-static.

Examples

# Delete all multicast static 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]:

display mac-address multicast

Syntax

display mac-address [ mac-address [ vlan vlan-id ] | [ multicast ] [ vlan vlan-id ] [ count ] ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

mac-address: Specifies a multicast MAC address. The MAC address can be any legal multicast MAC address except 0100-5Exx-xxxx and 3333-xxxx-xxxx, where "x" represents any hexadecimal numbers from 0 to F.

vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094. If you do not specify a VLAN, this command displays static multicast MAC address entries for all VLANs.

multicast: Specifies static multicast MAC address entries.

count: Specifies the number of static multicast MAC address entries. If this keyword is specified, this command displays the number of matching static multicast MAC address entries. If this keyword is not specified, this command displays the contents of the matching entries rather than the entry count.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display mac-address multicast to display the static multicast MAC address entries.

With no parameters specified or with only vlan, count, or both of them specified, this command displays all MAC address table entries, including static multicast MAC address entries and unicast MAC address entries.

Related commands: mac-address multicast; display mac-address (Layer 2—LAN Switching Command Reference).

Examples

# Display the static multicast MAC address entries for VLAN 2.

<Sysname> display mac-address multicast vlan 2

MAC ADDR VLAN ID STATE PORT INDEX AGING TIME(s)

0100-0001-0001 2 Multicast GigabitEthernet3/0/1 NOAGED

GigabitEthernet3/0/2

GigabitEthernet3/0/3

GigabitEthernet3/0/4

--- 1 mac address(es) found ---

Table 1 Command output

Field	Description
MAC ADDR	MAC address.
VLAN ID	ID of the VLAN to which the network device identified by the MAC address belongs.
STATE	Status of the MAC address. If the multicast MAC address entry is static, this field displays Multicast.
PORT INDEX	Outgoing ports of the multicast MAC address entry.
AGING TIME(s)	State of the aging timer. For a static multicast MAC address entry, this field displays NOAGED because this entry never expires.
1 mac address(es) found	One static multicast MAC address entry is found.

display multicast boundary

Syntax

display multicast [ all-instance | vpn-instance vpn-instance-name ] boundary [ group-address [ mask | mask-length ] ] [ interface interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN, where the vpn-instance-name argument is a case-sensitive string of 1 to 31 characters.

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

mask: Specifies the address mask, 255.255.255.255 by default.

mask-length: Specifies the address mask length in the range of 4 to 32. The default is 32.

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

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display multicast boundary to display the multicast boundary information on the specified interface or all interfaces.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Related commands: multicast boundary.

Examples

# Display the multicast boundary information on all interfaces on the public network.

<Sysname> display multicast boundary

Multicast boundary information of VPN-Instance: public net

Boundary Interface

224.1.1.0/24 Vlan77

239.2.2.0/24 Vlan88

Table 2 Command output

Field	Description
Multicast boundary information of VPN-Instance: public net	Multicast boundary for the public network.
Boundary	Multicast group corresponding to the multicast boundary.
Interface:	Boundary interface corresponding to the multicast boundary.

display multicast forwarding-table

Syntax

In standalone mode:

display multicast [ all-instance | vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask | mask-length } ] | group-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } | outgoing-interface { exclude | include | match } { interface-type interface-number | register } | statistics | slot slot-number ] * [ port-info ] [ | { begin | exclude | include } regular-expression ]

In IRF mode:

display multicast [ all-instance | vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask | mask-length } ] | group-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } | outgoing-interface { exclude | include | match } { interface-type interface-number | register } | statistics | chassis chassis-number slot slot-number ] * [ port-info ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN, where the vpn-instance-name argument is a case-sensitive string of 1 to 31 characters.

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 the address mask, 255.255.255.255 by default.

mask-length: Specifies the address mask length. The default 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.

incoming-interface: Specifies the multicast forwarding entries that include the specified incoming interface.

interface-type interface-number: Specifies the interface by its type and number.

outgoing-interface: Specifies the multicast forwarding entries that include the specified outgoing interface.

exclude: Specifies the multicast forwarding entries that do not include the specified interface in the outgoing interface list.

include: Specifies the multicast forwarding entries that include the specified interface in the outgoing interface list.

match: Specifies the forwarding entries that include only the specified interface in the outgoing interface list.

statistics: Displays statistics of the multicast forwarding table.

slot slot-number: Specifies a card by its slot number. If no slot is specified, the command displays the multicast forwarding table information of the main board. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument refers to the ID of the IRF member device, and the slot-number argument refers to the number of the slot where the card resides. If this option is not configured, the command displays the multicast forwarding table information of all main boards in the IRF member device. To obtain the chassis number and slot number, you can use the display device command. (In IRF mode.)

port-info: Displays Layer 2 port information.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

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

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Multicast forwarding tables guide multicast forwarding. You can view the forwarding state of multicast traffic by checking the multicast forwarding table.

Related commands: display multicast routing-table, multicast forwarding-table downstream-limit, and multicast forwarding-table route-limit.

Examples

# Display the multicast forwarding table information on the public network.

<Sysname> display multicast forwarding-table

Multicast Forwarding Table of VPN-Instance: public net

Total 2 entries

Total 2 entries matched

00001. (172.168.0.2, 227.0.0.1)

MID: 0, Flags: 0x0:0

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

Incoming interface: Vlan-interface20

List of 1 outgoing interfaces:

1: Vlan-interface50

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

Forwarded 19648 packets(20512512 bytes)

00002. (100.1.1.10, 224.1.1.5)

MID: 1199, Flags: 0x100000:0

Uptime: 00:00:29, Timeout in: 00:03:26

Incoming interface: Vlan-interface30 (subvlan: 31)

List of 1 outgoing interfaces:

1: Vlan-interface60

Matched 110 packets(11555 bytes), Wrong If 0 packets

Forwarded 110 packets(11555 bytes)

Table 3 Command output

Field	Description
Multicast Forwarding Table of VPN-Instance: public net	Multicast forwarding table for the public network.
Total 2 entries	Total number of (S, G) entries in the multicast forwarding table.
Total 2 entries matched	Total number of matched (S, G) entries in the multicast forwarding table.
00001	Sequence number of the (S, G) entry.
(172.168.0.2,227.0.0.1)	(S, G) entry of the multicast forwarding table.
MID	(S, G) entry ID. Each (S, G) entry has a unique MID.
Flags	Current state of the (S, G) entry. Different bits indicate different states of (S, G) entries. For major values of this field, see Table 4.
Uptime	Length of time for which the (S, G) entry has been up, in the format hh:mm:ss.
Timeout in	Length of time in which the (S, G) entry will expire, in the format hh:mm:ss.
Incoming interface	Incoming interface of the (S, G) entry.
subvlan	If the incoming interface of the (S, G) entry is a super VLAN interface, this field displays sub VLAN where the incoming interface resides. · If the multicast source matches an ARP entry of the sub VLAN, the field displays VLAN ID of this sub VLAN. · If the multicast source does not match an ARP entry of the sub VLAN, or the sub VLAN that learned the matched ARP entry does not belong to the super VLAN, this field displays unknown.
List of 1 outgoing interface: 1: Vlan-interface50	Outgoing interface list. Interface number: outgoing interface and number.
Matched 19648 packets(20512512 bytes), Wrong If 0 packets	(S, G)-matched packets (bytes), packets with incoming interface errors.
Forwarded 19648 packets(20512512 bytes)	(S, G)-forwarded packets (bytes).

Table 4 Major values of the flags field

Value	Meaning
0x1	A register-stop message must be sent.
0x2	Whether the multicast source corresponding to the (S, G) is active.
0x4	Null forwarding entry.
0x8	Whether the RP is a PIM domain border router.
0x10	A register outgoing interface is available.
0x400	(S, G) entry to be deleted.
0x8000	The (S, G) entry is in the smoothening process after active/standby switchover.
0x10000	The (S, G) has been updated during the smoothing process.
0x80000	The (S, G) entry has been updated and needs to be deleted before a new entry is added.
0x100000	An entry is successfully added.
0x1000000	Multicast forwarding entry for BIDIR-PIM.
0x2000000	RP for BIDIR-PIM.

display multicast forwarding-table df-info

Syntax

In standalone mode:

display multicast [ all-instance | vpn-instance vpn-instance-name ] forwarding-table df-info [ rp-address ] [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

In IRF mode:

display multicast [ all-instance | vpn-instance vpn-instance-name ] forwarding-table df-info [ rp-address ] [ chassis chassis-number slot slot-number ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all MPLS L3VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance, where the vpn-instance-name argument is a case-sensitive string of 1 to 31 characters.

rp-address: Specifies an RP address of BIDIR-PIM.

slot slot-number: Specifies a card by its slot number. If no slot is specified, the command displays the DF information of the multicast forwarding table for the main board. (In standalone mode.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument refers to the ID of the IRF member device, and the slot-number argument refers to the number of the slot where the card resides. If this option is not configured, the command displays the DF information of the multicast forwarding tables for all main boards in the IRF member device. To obtain the chassis number and slot number, you can use the display device command. (In IRF mode.)

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display multicast forwarding-table df-info to display the DF information of the multicast forwarding table.

If neither all-instance nor vpn-instance is specified, this command displays the DF information for the public network.

Examples

# Display the DF information of the multicast forwarding table for the public network.

<Sysname> display multicast forwarding-table df-info

Multicast DF information of VPN-Instance: public net

Total 1 RP

Total 1 RP matched

00001. RP Address: 1.1.1.1

MID: 0, Flags: 0x2100000:0

Uptime: 00:08:32

RPF interface: GigabitEthernet4/0/1

List of 1 DF interfaces:

1: GigabitEthernet4/0/2

Table 5 Command output

Field	Description
Total 1 RP	Total number of RPs.
Total 1 RP matched	Total number of matched RPs.
00001	Sequence number of the RP.
MID	ID of the RP. Each RP has a unique MID.
Flags	Current state of the RP. Different bits indicate different states of an RP. For major values of this field, see Table 4.
Uptime	Length of time for which the RP has been up, in the format hh:mm:ss.
RPF interface	RPF interface to the RP.
List of 1 DF interfaces	DF interface list.

display multicast routing-table

Syntax

display multicast [ all-instance | vpn-instance vpn-instance-name ] routing-table [ source-address [ mask { mask | mask-length } ] | group-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } | outgoing-interface { exclude | include | match } { interface-type interface-number | register } ] * [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN, where the vpn-instance-name argument is a case-sensitive string of 1 to 31 characters.

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 the address mask, 255.255.255.255 by default.

incoming-interface: Specifies the multicast routing entries that include the specified incoming interface.

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

outgoing-interface: Specifies the multicast routing entries that include the specified outgoing interface.

exclude: Specifies the multicast routing entries that do not include the specified interface in the outgoing interface list.

include: Specifies the multicast routing entries that include the specified interface in the outgoing interface list.

match: Specifies the multicast routing entries that include only the specified interface in the outgoing interface list.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display multicast routing-table to display the multicast routing table information.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Multicast routing tables are the basis of multicast forwarding. You can view the establishment state of an (S, G) entry by checking the multicast routing table.

Related commands: display multicast forwarding-table.

Examples

# Display routing information about the multicast routing table in the public network.

<Sysname> display multicast routing-table

Multicast routing table of VPN-Instance: public net

Total 1 entry

00001. (172.168.0.2, 227.0.0.1)

Uptime: 00:00:28

Upstream Interface: Vlan-interface55

List of 2 downstream interfaces

1: Vlan-interface66

2: Vlan-interface77

Table 6 Command output

Field	Description
Total 1 entry	Total number of (S, G) entries in the multicast routing table.
00001	Sequence number of the (S, G) entry.
(172.168.0.2, 227.0.0.1)	(S, G) entry of the multicast forwarding table.
Uptime	Length of time for which the (S, G) entry has been up, in the format hh:mm:ss.
Upstream interface	Upstream interface the (S, G) entry. Multicast packets should arrive at this interface.
List of 2 downstream interfaces	Downstream interface list. These downstream interfaces need to forward multicast packets.

display multicast routing-table static

Syntax

display multicast routing-table [ all-instance | vpn-instance vpn-instance-name ] static [ source-address { mask-length | mask } ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN, where the vpn-instance-name argument is a case-sensitive string of 1 to 31 characters.

source-address: Specifies a multicast source address.

mask: Specifies the address mask.

mask-length: Specifies the address mask length in the range of 0 to 32.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display multicast routing-table static to display the information of multicast static routes.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Examples

# Display all the multicast static routes on the public network.

<Sysname> display multicast routing-table static

Multicast Routing Table of VPN-Instance: public net

Routes : 1

Mroute 10.10.0.0/16

Interface = Vlan-interface66 RPF Neighbor = 2.2.2.2

Matched routing protocol = <none>, Route-policy = <none>

Preference = 1, Order = 1

Running Configuration = ip rpf-route-static 10.10.0.0 16 2.2.2.2 order 1

Table 7 Command output

Field	Description
Multicast Routing Table of VPN-Instance: public net	Multicast routing table for the public network.
Mroute	Multicast route source address and its mask length.
Interface	Outgoing interface to the multicast source.
RPF Neighbor	IP address of the RPF neighbor through which the multicast source is reachable.
Route-policy	Routing policy. The multicast source address of the route should match the routing policy.
Preference	Route preference.
Order	Sequence number of the route.
Running Configuration	Command line that configures the multicast static route.

display multicast rpf-info

Syntax

display multicast [ all-instance | vpn-instance vpn-instance-name ] rpf-info source-address [ group-address ] [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN, where the vpn-instance-name argument is a case-sensitive string of 1 to 31 characters.

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.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Description

Use display multicast rpf-info to display RPF information about a multicast source.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

Related commands: display multicast forwarding-table and display multicast routing-table.

Examples

# Display all the RPF information about 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:

VPN instance: public net

RPF interface: Vlan-interface66, 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

Table 8 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—Unicast route (IGP). · egp—Unicast route (EGP). · unicast (direct)—Unicast route (directly connected). · unicast—Other unicast route (such as unicast static route). · mbgp—MBGP route. · multicast static—Multicast static route.
Route selection rule	Rule for RPF route selection, based on the preference of the routing protocol or based on the longest match on the destination address.
Load splitting rule	Status of the load splitting rule: enabled/disabled.

ip rpf-route-static

Syntax

ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask | mask-length } [ protocol [ process-id ] ] [ route-policy policy-name ] { rpf-nbr-address | interface-type interface-number } [ preference preference ] [ order order-number ]

undo ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask | mask-length } [ protocol [ process-id ] ] [ route-policy policy-name ]

View

System view

Default level

2: System level

Parameters

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN, where the vpn-instance-name argument is a case-sensitive string of 1 to 31 characters. If this option is not specified, this command configures a multicast static route on the public network.

source-address: Specifies a multicast source address.

mask: Specifies the address mask.

mask-length: Specifies the address mask length in the range of 0 to 32.

protocol: Routing protocol:

· bgp: Specifies the BGP protocol.

· isis: Specifies the IS-IS protocol.

· ospf: Specifies the OSPF protocol.

· rip: Specifies the RIP protocol.

· static: Specifies a static route.

process-id: Specifies a process number of the unicast routing protocol, in the range of 1 to 65535. This argument must be provided if IS-IS, OSPF or RIP is the specified unicast routing protocol.

policy-name: Specifies the name of the routing policy used for matching multicast static routes, a case-sensitive string of 1 to 63 characters.

rpf-nbr-address: Specifies an RPF neighbor by the IP address.

interface-type interface-number: Specifies an RPF neighbor by providing the type and number of the interface connecting the RPF neighbor.

preference: Specifies a route preference. The value range is 1 to 255 and the default is 1.

order-number: Specifies a match order for routes on the same segment, in the range of 1 to 100.

Description

Use ip rpf-route-static to configure a multicast static route.

Use undo ip rpf-route-static to delete a multicast static route from the multicast static routing table.

By default, no multicast static route is configured.

The arguments source-address { mask | mask-length }, protocol and policy-name are critical elements in multicast static route configuration. The variation of any of these arguments results in a different configuration.

When you configure a multicast static route, the system first checks whether any of these argument exists. If the system finds a match, you must modify the corresponding fields without changing the configuration sequence. Otherwise, the system adds a multicast static route.

When you configure a multicast static route, specify an RPF neighbor only by providing its IP address (rpf-nbr-address) rather than providing the type and number (interface-type interface-number) of the interface connecting the RPF if the interface of the RPF neighbor is a Layer 3 Ethernet interface, Layer 3 aggregate interface, Loopback interface, Layer 3 RPR logical interface, or VLAN interface.

Because outgoing interface iteration might fail or the specified interface might be in the down state, the multicast static route configured with this command might fail to take effect. Therefore, use the display multicast routing-table static command after you configure a multicast static route to check whether the route has been successfully configured or whether the route has taken effect.

Related commands: delete ip rpf-route-static and display multicast routing-table static.

Examples

# Configure a multicast static route to the multicast source 10.1.1.1/24, specifying a router with the IP address of 192.168.1.23 as its RPF neighbor.

<Sysname> system-view

[Sysname] ip rpf-route-static 10.1.1.1 24 192.168.1.23

mac-address multicast

Syntax

In system view:

mac-address multicast mac-address interface interface-list vlan vlan-id

undo mac-address [ multicast ] [ [ mac-address [ interface interface-list ] ] vlan vlan-id ]

In Ethernet interface view or Layer 2 aggregate interface view:

mac-address multicast mac-address vlan vlan-id

undo mac-address [ multicast ] mac-address vlan vlan-id

In port group view:

mac-address multicast mac-address vlan vlan-id

undo mac-address multicast mac-address vlan vlan-id

View

System view, Ethernet interface view, Layer 2 aggregate interface view, port group view

Default level

2: System level

Parameters

mac-address: Specifies a static multicast MAC address, which can be any legal multicast MAC address except 0100-5Exx-xxxx and 3333-xxxx-xxxx, where "x" represents any hexadecimal number from 0 to F. Multicast MAC addresses are the MAC addresses whose the least signification bit of the most significant octet is 1. The system will give a prompt if the configured static multicast MAC address conflicts with the MAC address of other protocols.

interface-list: Specifies a list of interfaces. You can specify up to four single interfaces, interface ranges, or combinations of both for the list. A single interface takes the form of interface-type interface-number. An interface range takes the form of interface-type interface-number to interface-type interface-number, where the end interface number must be greater than the start interface number.

vlan vlan-id: Specifies a VLAN. The value range for the vlan-id argument is 1 to 4094. The specified VLAN must exist and the system gives a prompt if the specified interface does not belong to the VLAN.

Description

Use mac-address multicast to configure a static multicast MAC address entry.

Use undo mac-address multicast to delete a static multicast MAC address entry.

By default, no static multicast MAC address entry is configured.

If multicast is not specified when using the undo mac-address multicast command, all MAC address entries including static multicast MAC address entries and unicast MAC address entries will be deleted.

Related commands: display mac-address multicast; mac-address (Layer 2—LAN Switching Command Reference).

Examples

# Configure a static multicast MAC address entry with the MAC address of 0100-0001-0001 and outgoing interfaces GigabitEthernet 3/0/1 through GigabitEthernet 3/0/5 in VLAN 2.

<Sysname> system-view

[Sysname] mac-address multicast 0100-0001-0001 interface GigabitEthernet 3/0/1 to GigabitEthernet 3/0/5 vlan 2

# Configure a static multicast MAC address entry with the MAC address of 0100-0001-0001 in interface view of GigabitEthernet 3/0/1 in VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 3/0/1

[Sysname-GigabitEthernet3/0/1] mac-address multicast 0100-0001-0001 vlan 2

mtracert

Syntax

mtracert source-address [ [ last-hop-router-address ] group-address ]

View

Any view

Default level

1: Monitor level

Parameters

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.

last-hop-router-address: Specifies a last-hop router address, which is the IP address of the local router by default.

Description

Use mtracert to trace the path down which the multicast traffic flows to the last-hop router.

If the last-hop-router-address argument is given in the command to trace the path for a specific (S, G) multicast stream, the interface corresponding to the last-hop router address must be the outgoing interface for the (S, G) entry. Otherwise the multicast traceroute will fail.

Examples

# Trace the path down which the (6.6.6.6, 225.2.1.1) multicast traffic flows to the last-hop router with an IP address of 5.5.5.8.

<Sysname> mtracert 6.6.6.6 5.5.5.8 225.2.1.1

Type Ctrl+C to quit mtrace facility

Tracing reverse path of (6.6.6.6, 225.2.1.1) from last-hop router (5.5.5.8) to source via multicast routing-table

-1 5.5.5.8

Incoming interface address: 4.4.4.8

Previous-hop router address: 4.4.4.7

Input packet count on incoming interface: 17837

Output packet count on outgoing interface: 0

Total number of packets for this source-group pair: 8000

Protocol: PIM

Forwarding TTL: 0

Forwarding code: No error

-2 4.4.4.7

Incoming interface address: 6.6.6.7

Previous-hop router address: 0.0.0.0

Input packet count on incoming interface: 2

Output packet count on outgoing interface: 259

Total number of packets for this source-group pair: 8100

Protocol: PIM

Forwarding TTL: 0

Forwarding code: No error

Table 9 Command output

Field	Description
(6.6.6.6, 225.2.1.1)	(S, G) multicast stream for which the forwarding path is being traced.
-1 5.5.5.8	(S, G) outgoing interface address of each hop, starting from the last-hop router.
Incoming interface address	Address of the interface on which the (S, G) packets arrive.
Previous-hop router address	IP address of the router from which this router receives packets from this source.
Input packet count on incoming interface	Total number of multicast packets received on the incoming interface.
Output packet count on outgoing interface	Total number of multicast packets transmitted on the outgoing interface.
Total number of packets for this source-group pair	Total number of packets from the specified source forwarded by this router to the specified group.
Protocol	Multicast routing protocol in use.
Forwarding TTL	Minimum TTL that a packet is required to have before it can be forwarded over the outgoing interface.

multicast boundary

Syntax

multicast boundary group-address { mask | mask-length }

undo multicast boundary { group-address { mask | mask-length } | all }

View

Interface view

Default level

2: System level

Parameters

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

mask: Specifies the address mask.

mask-length: Specifies the address mask length in the range of 4 to 32.

all: Specifies to remove all forwarding boundaries configured on the interface.

Description

Use multicast boundary to configure a multicast forwarding boundary.

Use undo multicast boundary to remove a multicast forwarding boundary.

By default, no multicast forwarding boundary is configured.

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 will not be forwarded.

An interface can act as a forwarding boundary for multiple multicast groups in different address ranges. To achieve this, use this command on the interface for each multicast address range.

Assume that Set A and Set B are multicast forwarding boundary sets with different address ranges, and B is a subset of A. If B is configured after A, A still takes effect. If A is configured after B, B will be removed.

Related commands: display multicast boundary.

Examples

# Configure VLAN-interface 100 to be 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

multicast forwarding on-demand

Syntax

multicast forwarding on-demand

undo multicast forwarding on-demand

View

VLAN view

Default level

2: System level

Parameters

None

Description

Use multicast forwarding on-demand to enable the multicast forwarding on-demand function in the VLAN.

Use undo multicast forwarding on-demand to restore the default.

By default, multicast forwarding on-demand is disabled.

After using this command in a VLAN that has been enabled with BIDIR-PIM, you must clear all entries in the multicast forwarding table. Otherwise, this configuration cannot take effect.

After using this command in a multicast VLAN, you must clear all the IGMP snooping multicast group information in the VLAN. Otherwise, this configuration cannot take effect.

After using this command in a non-multicast VLAN with a Layer 3 multicast protocol (IGMP or PIM) enabled on the corresponding VLAN interface, you must clear the Layer 2 port information of all IGMP multicast groups in the VLAN and the IGMP multicast group information on the corresponding VLAN interface. Otherwise, this configuration cannot take effect.

This command cannot take effect in a non-multicast VLAN with IGMP snooping enabled in the VLAN.

Related commands: igmp-snooping enable, reset igmp group, reset igmp group port-info, and reset igmp-snooping group.

Examples

# Enable multicast forwarding on-demand in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] multicast forwarding on-demand

multicast forwarding-table downstream-limit

Syntax

multicast forwarding-table downstream-limit limit

undo multicast forwarding-table downstream-limit

View

System view, VPN instance view

Default level

2: System level

Parameters

limit: Specifies the maximum number of downstream nodes (the maximum number of outgoing interfaces) for a single multicast forwarding entry. The value range for this argument is 0 to 256.

Description

Use multicast forwarding-table downstream-limit to configure the maximum number of downstream nodes for a single entry in the multicast forwarding table.

Use undo multicast forwarding-table downstream-limit to restore the default.

By default, the maximum number of downstream nodes for a single multicast forwarding entry is 256.

Related commands: display multicast forwarding-table.

Examples

# Set the maximum number of downstream nodes for a single multicast forwarding entry in the public network to 120.

<Sysname> system-view

[Sysname] multicast forwarding-table downstream-limit 120

# Set the maximum number of downstream nodes for a single multicast forwarding entry of VPN instance mvpn to 60.

<Sysname> system-view

[Sysname] ip vpn-instance mvpn

[Sysname-vpn-instance-mvpn] multicast forwarding-table downstream-limit 60

multicast forwarding-table route-limit

Syntax

multicast forwarding-table route-limit limit

undo multicast forwarding-table route-limit

View

System view, VPN instance view

Default level

2: System level

Parameters

limit: Specifies the maximum number of entries in the multicast forwarding table. The value range for this argument is 0 to the maximum number that the switch allows.

Description

Use multicast forwarding-table route-limit to configure the maximum number of entries in the multicast forwarding table.

Use undo multicast forwarding-table route-limit to restore the maximum number of entries in the multicast forwarding table to the system default.

The default upper limit for the public network depends on the system operating mode. For more information about the system operating modes, see Fundamentals Configuration Guide.

The default upper limit for VPN instance is 1024.

Related commands: display multicast forwarding-table.

Examples

# Set the maximum number of entries in the multicast forwarding table in the public network to 200.

<Sysname> system-view

[Sysname] multicast forwarding-table route-limit 200

# Set the maximum number of entries in the multicast forwarding table of VPN instance mvpn to 200.

<Sysname> system-view

[Sysname] ip vpn-instance mvpn

[Sysname-vpn-instance-mvpn] multicast forwarding-table route-limit 200

multicast load-splitting

Syntax

multicast load-splitting { source | source-group }

undo multicast load-splitting

View

System view, VPN instance view

Default level

2: System level

Parameters

source: Specifies to implement per-source load splitting.

source-group: Specifies to implement per-source and per-group load splitting simultaneously.

Description

Use multicast load-splitting to enable load splitting of multicast traffic.

Use undo multicast load-splitting to disable load splitting of multicast traffic.

By default, load splitting of multicast traffic is disabled.

This command does not take effect on BIDIR-PIM.

Examples

# Enable per-source load splitting of multicast traffic on the public network.

<Sysname> system-view

[Sysname] multicast load-splitting source

# Enable per-source load splitting of multicast traffic in VPN instance mvpn.

<Sysname> system-view

[Sysname] ip vpn-instance mvpn

[Sysname-vpn-instance-mvpn] multicast load-splitting source

multicast longest-match

Syntax

multicast longest-match

undo multicast longest-match

View

System view, VPN instance view

Default level

2: System level

Parameters

None

Description

Use multicast longest-match to configure the device to select the RPF route based on the longest match principle.

Use undo multicast longest-match to restore the default.

By default, the device selects the route with the highest priority as the RPF route.

Examples

# Configure the device to select the RPF route based on the longest match principle on the public network.

<Sysname> system-view

[Sysname] multicast longest-match

# Configure route selection based on the longest match in VPN instance mvpn.

<Sysname> system-view

[Sysname] ip vpn-instance mvpn

[Sysname-vpn-instance-mvpn] multicast longest-match

multicast routing-enable

Syntax

multicast routing-enable

undo multicast routing-enable

View

System view, VPN instance view

Default level

2: System level

Parameters

None

Description

Use multicast routing-enable to enable IP multicast routing.

Use undo multicast routing-enable to disable IP multicast routing.

By default, IP multicast routing is disabled.

You must enable IP multicast routing on the public network or VPN instance before you can execute other Layer 3 multicast commands in the corresponding instance.

The device does not forward any multicast packets before IP multicast routing is enabled.

When the system is operating in standard mode, you must configure a reserved VLAN before you configure multicast routing and forwarding for a VPN instance. For more information about the system operating mode, see Fundamentals Configuration Guide. For more information about the configuration and commands about a reserved VLAN, see MPLS Configuration Guide and MPLS Command Reference.

Examples

# Enable IP multicast routing on the public network.

<Sysname> system-view

[Sysname] multicast routing-enable

# Enable IP multicast routing in VPN instance mvpn.

<Sysname> system-view

[Sysname] ip vpn-instance mvpn

[Sysname-vpn-instance-mvpn] route-distinguisher 100:1

[Sysname-vpn-instance-mvpn] multicast routing-enable

multicast rpf-fail-pkt bridging

Syntax

multicast rpf-fail-pkt bridging

undo multicast rpf-fail-pkt bridging

View

System view

Default level

2: System level

Parameters

None

Description

Use multicast rpf-fail-pkt bridging to enable forwarding of multicast packets in case of RPF check failure on VLAN interfaces.

Use undo multicast rpf-fail-pkt bridging to restore the default.

By default, multicast packets that fail RPF check on a VLAN interface are discarded.

After using this command, you must clear all the entries in the multicast forwarding table. Otherwise, this configuration cannot take effect.

Related commands: reset multicast forwarding-table.

Examples

# Enable forwarding of multicast packets that fail RPF check on VLAN interfaces.

<Sysname> system-view

[Sysname] multicast rpf-fail-pkt bridging

multicast rpf-fail-pkt trap-to-cpu

Syntax

multicast rpf-fail-pkt trap-to-cpu

undo multicast rpf-fail-pkt trap-to-cpu

View

System view

Default level

2: System level

Parameters

None

Description

Use multicast rpf-fail-pkt trap-to-cpu to enable sending multicast data packets that have failed an RPF check to the CPU.

Use undo multicast rpf-fail-pkt trap-to-cpu to restore the default.

By default, this function is disabled.

After using this command, you must clear all the entries in the multicast forwarding table. Otherwise this configuration cannot take effect.

Related commands: reset multicast forwarding-table.

Examples

# Configure the device to send multicast data packets that have failed an RPF check to the CPU.

<Sysname> system-view

[Sysname] multicast rpf-fail-pkt trap-to-cpu

reset multicast forwarding-table

Syntax

reset multicast [ all-instance | vpn-instance vpn-instance-name ] forwarding-table { { source-address [ mask { mask | mask-length } ] | group-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } } * | all }

View

User view

Default level

2: System level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN, where the vpn-instance-name argument is a case-sensitive string of 1 to 31 characters.

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 the address mask, 255.255.255.255 by default.

incoming-interface: Specifies to clear multicast forwarding entries of which the incoming interface is the specified one.

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

register: Specifies to clear multicast forwarding entries of which the incoming interface is the specified register interface of PIM-SM.

all: Specifies to clear all the forwarding entries from the multicast forwarding table.

Description

Use reset multicast forwarding-table to clear the multicast forwarding table.

If neither all-instance nor vpn-instance is specified, this command clears the forwarding table information on the public network.

When a forwarding entry is deleted from the multicast forwarding table, the corresponding routing entry is also deleted from the multicast routing table.

Related commands: display multicast forwarding-table, display multicast routing-table, and reset multicast routing-table.

Examples

# Clear the multicast forwarding entries related to multicast group 225.5.4.3 from the multicast forwarding table in the public network.

<Sysname> reset multicast forwarding-table 225.5.4.3

# Clear the multicast forwarding entries related to multicast group 226.1.2.3 from the multicast forwarding table of VPN instance mvpn.

<Sysname> reset multicast vpn-instance mvpn forwarding-table 226.1.2.3

reset multicast routing-table

Syntax

reset multicast [ all-instance | vpn-instance vpn-instance-name ] routing-table { { source-address [ mask { mask | mask-length } ] | group-address [ mask { mask | mask-length } ] | incoming-interface { interface-type interface-number | register } } * | all }

View

User view

Default level

2: System level

Parameters

all-instance: Specifies all VPN instances.

vpn-instance vpn-instance-name: Specifies an MPLS L3VPN, where the vpn-instance-name argument is a case-sensitive string of 1 to 31 characters.

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 the address mask, 255.255.255.255 by default.

incoming-interface: Specifies to clear the routing entries of which the incoming interface is the specified one.

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

register: Specifies to clear the routing entries of which the incoming interface is the specified register interface of PIM-SM.

all: Specifies to clear all the routing entries from the multicast routing table.

Description

Use reset multicast routing-table to clear the multicast routing table.

If neither all-instance nor vpn-instance is specified, this command displays the information on the public network.

When a routing entry is deleted from the multicast routing table, the corresponding forwarding entry is also deleted from the multicast forwarding table.

Related commands: display multicast forwarding-table, display multicast routing-table, and reset multicast forwarding-table.

Examples

# Clear the route entries related to multicast group 225.5.4.3 from the multicast routing table in the public network.

<Sysname> reset multicast routing-table 225.5.4.3

# Clear the route entries related to multicast group 226.1.2.3 from the multicast routing table of VPN instance mvpn.

<Sysname> reset multicast vpn-instance mvpn routing-table 226.1.2.3

08-IP Multicast Command Reference

delete ip rpf-route-static

display multicast forwarding-table

display multicast routing-table

display multicast routing-table static

display multicast rpf-info

ip rpf-route-static

mac-address multicast

multicast forwarding on-demand

multicast forwarding-table route-limit

multicast load-splitting

multicast longest-match

multicast routing-enable

multicast rpf-fail-pkt bridging

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