07-IP Multicast Command Reference

HomeSupportResource CenterRoutersH3C SR8800 Series RoutersH3C SR8800Technical DocumentsCommandCommand ReferenceH3C SR8800 Command Reference-Release3347-6W10307-IP Multicast Command Reference
04-Multicast Routing and Forwarding Commands
Title Size Download
04-Multicast Routing and Forwarding Commands 150.14 KB

delete ip rpf-route-static

Syntax

delete ip rpf-route-static [ vpn-instance vpn-instance-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, 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 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 MPLS L3VPNs.

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

exclude: Displays all lines that do not match the specified regular expression.

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 in the public network instance.

<Sysname> display multicast boundary

Multicast boundary information of VPN-Instance: public net

 Boundary            Interface

 224.1.1.0/24        GE3/1/1

 239.2.2.0/24        Pos5/1/1

Table 1 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

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 ]

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all MPLS L3VPNs.

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: Displays the forwarding entries containing the specified multicast source address.

group-address: Displays the forwarding entries containing the specified multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

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

mask-length: Mask length of the multicast group/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 forwarding 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 forwarding entries of which the incoming interface is the PIM-SM register interface.

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

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

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

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

statistics: Specifies to display the statistics information of the multicast forwarding table.

slot slot-number: Specifies the slot number of an interface card. If you do not specify this option, this command will display the multicast forwarding table information of the switching and routing processing unit (SRPU).

port-info: Specifies to display 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.

exclude: Displays all lines that do not match the specified regular expression.

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 are used to 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 in the public network instance.

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

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

     Incoming interface: GigabitEthernet3/1/1

     List of 1 outgoing interfaces:

       1: GigabitEthernet3/1/2

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

     Forwarded 19648 packets(20512512 bytes)

Table 2 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 are used to indicate different states of (S, G) entries. Major values of this field are described in Table 3.

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

Name of the incoming interface of the (S, G) entry.

List of 1 outgoing interface:

1: GigabitEthernet3/1/2

Outgoing interface list

Interface ID: outgoing interface name 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 3 Major values of the flags field

Value

Meaning

0x00000001

Indicates that  a register-stop message must be sent

0x00000002

Indicates whether the multicast source corresponding to the (S, G) is active

0x00000004

Indicates a null forwarding entry

0x00000008

Indicates whether the RP is a PIM domain border router

0x00000010

Indicates that a register outgoing interface is available

0x00000400

Identifies an (S, G) entry to be deleted

0x00008000

Indicates that the (S, G) entry is in the smoothening process after active/standby switchover

0x00010000

Indicates that the (S, G) has been updated during the smoothing process

0x00080000

Indicates that the (S, G) entry has been repeatedly updated and needs to be deleted before a new entry is added

0x00100000

Indicates that an entry is successfully added

0x01000000

Indicates a multicast forwarding entry for BIDIR-PIM

0x02000000

Indicates the RP for BIDIR-PIM

 

display multicast forwarding-table df-info

Syntax

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

View

Any view

Default level

1: Monitor level

Parameters

all-instance: Specifies all MPLS L3VPNs.

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.

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 processing board.

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

exclude: Displays the lines that do not match the specified regular expression.

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: GigabitEthernet3/1/1

     List of 1 DF interfaces:

       1: GigabitEthernet3/1/2

Table 4 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 are used to indicate different states of an RP. For major values of this field, see Table 3.

Uptime

Length of time for which the RP has been up, in 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 MPLS L3VPNs.

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: Displays multicast routing entries containing the specified multicast source address.

group-address: Displays multicast routing entries containing the specified multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

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

mask-length: Mask length of the multicast group/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 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 multicast routing entries of which the incoming interface is the PIM-SM register interface.

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

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

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

match: Displays 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.

exclude: Displays all lines that do not match the specified regular expression.

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 on 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: GigabitEthernet3/1/1

       List of 2 downstream interfaces

           1:  GigabitEthernet3/1/2

           2:  GigabitEthernet3/1/3

Table 5 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

Name of the 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 MPLS L3VPNs.

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

exclude: Displays all lines that do not match the specified regular expression.

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 multicast static routes on the public network.

<Sysname> display multicast routing-table static

Multicast Routing Table of VPN-Instance: public net

Routes : 1

 Mroute 50.1.1.0/24

          Interface = GigabitEthernet4/1/7        RPF Neighbor = 162.2.2.10

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

          Preference = 1, Order = 1

 Running Configuration = ip rpf-route-static 50.1.1.0 24 162.2.2.10 order 1

Table 6 Output description

Field

Description

Multicast Routing Table of VPN-Instance: public net

Multicast routing table for the public network.

Routes

Number of routes.

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

CLI that configured 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 MPLS L3VPNs.

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

exclude: Displays all lines that do not match the specified regular expression.

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 in 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: GigabitEthernet3/1/1, RPF neighbor: 10.1.1.1

     Referenced route/mask: 192.168.1.0/24

     Referenced route type: igp

     Route selection rule: preference-preferred

     Load splitting rule: disable 

Table 7 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 interface

Name of the RPF interface

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 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: 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 the 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 the interface that connects to an RPF neighbor by the interface type and interface number.

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

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 from a given multicast source 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) multicast stream; 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: 1

   Forwarding code: No error

Table 8 Output description

Field

Description

last-hop router

Last-hop router

(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 between this router and the previous hop router

Forwarding TTL

The minimum TTL that a packet is required to have before it can be forwarded over the outgoing interface

Forwarding code

Forwarding code

 

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, execute 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 is removed.

Related commands: display multicast boundary.

Examples

# Configure GigabitEthernet 3/1/1 to be the forwarding boundary of multicast groups 239.2.0.0/16.

<Sysname> system-view

[Sysname] interface GigabitEthernet3/1/1

[Sysname-GigabitEthernet3/1/1] 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 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 forwarding entry in the multicast forwarding table. The value ranges from 0 to 128.

Description

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

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

By default, the upper limit is 128.

Related commands: display multicast forwarding-table.

Examples

# Set the maximum number of downstream nodes for a single forwarding entry in the multicast forwarding table on 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 forwarding entry in the multicast forwarding table 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 0 to 13824.

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.

By default, the upper limit is 13824.

Related commands: display multicast forwarding-table.

Examples

# Set the maximum number of entries in the multicast forwarding table on 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 RPF route selection based on the longest match, namely based on the mask length.

Use the undo multicast longest-match command to restore the default.

By default, the route with the highest priority is selected as an RPF route.

Examples

# Configure RPF route selection based on the longest match on the public network.

<Sysname> system-view

[Sysname] multicast longest-match

# Configure RPF 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.

IP multicast routing is disabled by default.

You must enable IP multicast routing on the public network or VPN instance before you can use 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 upon RPF check failure on VLAN interfaces.

Use the undo multicast rpf-fail-pkt bridging 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: multicast rpf-fail-pkt trap-to-cpu and reset multicast forwarding-table.

Examples

# Configure the device to forward multicast packets that have failed an RPF check in all VLANs.

<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: multicast rpf-fail-pkt bridging and 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 MPLS L3VPNs.

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: Clears multicast forwarding entries containing the specified multicast source address.

group-address: Clears multicast forwarding entries containing the specified multicast group address, in the range of 224.0.0.0 to 239.255.255.255.

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

mask-length: Mask length of the multicast group/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: Clears 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: Clears multicast forwarding entries of which the incoming interface is the PIM-SM register interface.

all: Clears all the forwarding entries from the multicast forwarding table.

Description

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

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 route 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 on 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 MPLS L3VPNs.

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: Clears multicast routing entries containing the specified multicast source address.

group-address: Clears multicast routing entries containing the specified multicast group address, in the range of 224.0.1.0 to 239.255.255.255.

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

mask-length: Mask length of the multicast group/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: Specifies the incoming interface of multicast routing entries.

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

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

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

Description

Use the reset multicast routing-table command to clear multicast routing entries from the multicast routing table.

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

When a route 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 on 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