vpn-instance vpn-instance-name: Specifies an MPLS L3VPN, where vpn-instance-name 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 the delete ip rpf-route-static command 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: Displays the multicast MAC address entry for the specified MAC address. The MAC address can be any legal multicast MAC address except 0100-5Exx-xxxx and 3333-xxxx-xxxx, where x represents an arbitrary hexadecimal number from 0 to F.

vlan vlan-id: Displays multicast MAC address entries for the specified VLAN, where vlan-id is in the range of 1 to 4094. If you do not specify a VLAN, this command will display the static multicast MAC address entries for all VLANs.

multicast: Displays static multicast MAC address entries.

count: Displays the number of matched static multicast MAC address entries. With this argument specified, the number of matched static multicast MAC address entries is displayed, without displaying any content of the matched entries.

|: 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 the display mac-address multicast command 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 Output description

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; multicast indicates a static multicast MAC address entry.
PORT INDEX	Outgoing ports of the multicast MAC address entry.
AGING TIME(s)	State of the aging timer. The aging timer for static multicast MAC addresses has only one state NOAGED, which indicates that 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 vpn-instance-name is a case-sensitive string of 1 to 31 characters.

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

mask: Mask of the multicast group address, 255.255.255.255 by default.

mask-length: Mask length of the multicast group address, in the range of 4 to 32. The system 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 the display multicast boundary command 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 Output description

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 vpn-instance-name is a case-sensitive string of 1 to 31 characters.

source-address: Multicast source address.

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

mask: Mask of the multicast group address or multicast source address, 255.255.255.255 by default.

mask-length: Mask length of the multicast group address or multicast source address. For a multicast group address, this argument has an effective value range of 4 to 32. For a multicast source address, this argument has an effective value range of 0 to 32. The system default is 32 in both cases.

incoming-interface: Displays multicast forwarding entries of which the incoming interface is the specified one.

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

outgoing-interface: Displays multicast forwarding entries of which the outgoing interface is the specified one.

exclude: Displays the multicast forwarding entries of which the outgoing interface list excludes the specified interface.

include: Displays the multicast forwarding entries of which the outgoing interface list includes the specified interface.

match: Displays the forwarding entries of which the outgoing interface list includes and includes only the specified interface.

statistics: Displays the statistics of the multicast forwarding table.

slot slot-number: Displays the multicast forwarding entries for the card specified 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: Displays the forwarding entries of 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 the display multicast forwarding-table command 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 1 entry

Total 1 entry 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)

Table 3 Output description

Field	Description
Multicast Forwarding Table of VPN-Instance: public net	Multicast forwarding table for the public network.
Total 1 entry	Total number of (S, G) entries in the multicast forwarding table.
Total 1 entry 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)	An (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 hours:minutes:seconds.
Timeout in	Length of time in which the (S, G) entry will expire, in hours:minutes:seconds.
Incoming interface	Incoming interface of the (S, G) entry.
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	Indicates that a register-stop message must be sent
0x2	Indicates whether the multicast source corresponding to the (S, G) is active
0x4	Indicates a null forwarding entry
0x8	Indicates whether the RP is a PIM domain border router
0x10	Indicates that a register outgoing interface is available
0x400	Identifies an (S, G) entry to be deleted
0x8000	Indicates that the (S, G) entry is in the smoothening process after active/standby switchover
0x10000	Indicates that the (S, G) has been updated during the smoothing process
0x80000	Indicates that the (S, G) entry has been repeatedly updated and needs to be deleted before a new entry is added
0x100000	Indicates that an entry is successfully added
0x1000000	Indicates a multicast forwarding entry for BIDIR-PIM
0x2000000	Indicates the 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 vpn-instance-name is a case-sensitive string of 1 to 31 characters.

rp-address: RP address of BIDIR-PIM.

slot slot-number: Displays the DF information of the multicast forwarding table for the card specified 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: Displays the DF information of the multicast forwarding table for 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 the display multicast forwarding-table df-info command 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 Output description

Field	Description
Multicast DF information of VPN-Instance: public net	DF information of the multicast forwarding table for the public network.
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 hours:minutes:seconds
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 vpn-instance-name is a case-sensitive string of 1 to 31 characters.

source-address: Multicast source address.

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

mask: Mask of the multicast group address or multicast source address, 255.255.255.255 by default.

incoming-interface: Displays the multicast routing entries of which the incoming interface is the specified one.

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

register: Displays the multicast routing entries of which the incoming interface is the specified register interface of PIM-SM.

outgoing-interface: Displays the multicast routing entries of which the outgoing interface is the specified one.

exclude: Displays the multicast routing entries of which the outgoing interface list excludes the specified interface.

include: Displays the multicast routing entries of which the outgoing interface list includes the specified interface.

match: Displays the multicast routing entries of which the outgoing interface list includes only the specified interface.

|: 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 the display multicast routing-table command 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 the routing information in 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 Output description

Field	Description
Multicast routing table of VPN-Instance: public net	Multicast routing table for the public network.
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)	An (S, G) entry of the multicast forwarding table.
Uptime	Length of time for which the (S, G) entry has been up, in hours:minutes:seconds.
Upstream interface	Upstream interface the (S, G) entry: multicast packets should arrive at this interface.
List of 2 downstream interfaces	Downstream interface list: these 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 vpn-instance-name is a case-sensitive string of 1 to 31 characters.

source-address: Multicast source address.

mask: Mask of the multicast source address.

mask-length: Mask length of the multicast source address, 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 the display multicast routing-table static command 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 Output description

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 vpn-instance-name is a case-sensitive string of 1 to 31 characters.

source-address: Multicast source address.

group-address: 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 the display multicast rpf-info command to display the RPF information of 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 of 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 Output description

Field	Description
RPF information about source 192.168.1.55	Information of the RPF path to multicast source 192.168.1.55
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, which can be any of the following: · 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, which can be 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 vpn-instance-name 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: Multicast source address.

mask: Mask of the multicast source address.

mask-length: Mask length of the multicast source address, in the range of 0 to 32.

protocol: Routing protocol, which can have any of the following values:

· 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: 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: 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: Route preference, in the range of 1 to 255 and defaulting to 1.

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

Description

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

Use the undo ip rpf-route-static command 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: Static multicast MAC address, which can be any legal multicast MAC address except 0100-5Exx-xxxx and 3333-xxxx-xxxx, where x represents an arbitrary 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 n 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. The value range of n varies with card types.

vlan vlan-id: Specifies the VLAN to which the interface belongs. vlan-id is in the range of 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 the mac-address multicast command to configure a static multicast MAC address entry.

Use the undo mac-address multicast command 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 the mtracert command 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 Output description

Field	Description
(6.6.6.6, 225.2.1.1)	The (S, G) multicast stream for which the forwarding path is being traced
-1 5.5.5.8	The (S, G) outgoing interface address of each hop, starting from the last-hop router
Incoming interface address	The address of the interface on which the (S, G) packets arrive
Previous-hop router address	The IP address of the router from which this router receives packets from this source
Input packet count on incoming interface	The total number of multicast packets received on the incoming interface
Output packet count on outgoing interface	The total number of multicast packets transmitted on the outgoing interface
Total number of packets for this source-group pair	The total number of packets from the specified source forwarded by this router to the specified group
Protocol	The multicast routing protocol in use
Forwarding TTL	The 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: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

mask: Mask of the multicast group address.

mask-length: Mask length of the multicast group address, in the range of 4 to 32.

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

Description

Use the multicast boundary command to configure a multicast forwarding boundary.

Use the undo multicast boundary command 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 the multicast forwarding on-demand command to enable the multicast forwarding on-demand function in the VLAN.

Use the undo multicast forwarding on-demand command 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 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: Maximum number of downstream nodes (namely, the maximum number of outgoing interfaces) for a single multicast forwarding entry. The value ranges from 0 to 256.

Description

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

Use the undo multicast forwarding-table downstream-limit command 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: Maximum number of entries in the multicast forwarding table. The value ranges from 0 to the maximum number that the switch allows.

Description

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

Use the undo multicast forwarding-table route-limit command 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 working mode. For more information about the system working 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 the multicast load-splitting command to enable load splitting of multicast traffic.

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

By default, load splitting of multicast traffic is disabled.

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 the multicast longest-match command to configure the device to select the RPF route based on the longest match principle, namely, to select the route with the longest mask as the RPF route.

Use the undo multicast longest-match command 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 the multicast routing-enable command to enable IP multicast routing.

Use the undo multicast routing-enable command 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.

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 the multicast rpf-fail-pkt bridging command to enable forwarding of multicast packets in case of RPF check failure on VLAN interfaces.

Use the undo multicast rpf-fail-pkt bridging command 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 the multicast rpf-fail-pkt trap-to-cpu command to enable sending multicast data packets that have failed an RPF check to the CPU.

Use the undo multicast rpf-fail-pkt trap-to-cpu command 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 vpn-instance-name is a case-sensitive string of 1 to 31 characters.

source-address: Multicast source address.

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

mask: Mask of the multicast group address or multicast source address, 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 the reset multicast forwarding-table command 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 vpn-instance-name is a case-sensitive string of 1 to 31 characters.

source-address: Multicast source address.

group-address: Multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

mask: Mask of the multicast group address or multicast source address, 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 the reset multicast routing-table command 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

Cloud & AI

InterConnect

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Contact Us