Login
| Title | Size | Download |
|---|---|---|
| 01-Multicast routing and forwarding commands | 119.61 KB |
Contents
Multicast routing and forwarding commands
display mac-address [ multicast ]
display multicast fast-forwarding cache
display multicast forwarding df-info
display multicast forwarding event
display multicast forwarding-table
display multicast forwarding-table df-list
display multicast routing-table
display multicast routing-table static
reset multicast fast-forwarding cache
reset multicast forwarding event
reset multicast forwarding-table
Multicast routing and forwarding commands
delete ip rpf-route-static
Use delete ip rpf-route-static to delete all static multicast routes.
Syntax
delete ip rpf-route-static [ vpn-instance vpn-instance-name ]
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command deletes all static multicast routes on the public network.
Usage guidelines
This command deletes all static multicast routes. To delete a specified static multicast route, use the undo ip rpf-route-static command.
Examples
# Delete all static multicast routes on the public network.
<Sysname> system-view
[Sysname] delete ip rpf-route-static
This will erase all multicast static routes and their configurations, you must reconfigure all static routes.
Are you sure?[Y/N]:y
Related commands
ip rpf-route-static
display mac-address [ multicast ]
Use display mac-address [ multicast ] to display static multicast MAC address entries.
Syntax
display mac-address [ mac-address [ vlan vlan-id ] | [ multicast ] [ vlan vlan-id ] [ count ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
mac-address: Specifies a multicast MAC address. The MAC address can be any legal multicast MAC address except 0100-5Exx-xxxx and 3333-xxxx-xxxx, where "x" represents a hexadecimal number in the range of 0 to F.
vlan vlan-id: Specifies a VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a VLAN, this command displays MAC address entries for all VLANs.
multicast: Specifies static multicast MAC address entries.
count: Specifies the number of MAC address entries. If you specify the keyword, this command displays the number of matching MAC address entries. If you do not specify the keyword, this command displays the contents of the matching entries rather than the entry count.
Usage guidelines
If you do not specify any parameters, this command displays all MAC address entries, including unicast MAC address entries and static multicast address entries.
Examples
# Display static multicast MAC address entries for VLAN 2.
<Sysname> display mac-address multicast vlan 2
MAC Address VLAN ID State Port/NickName Aging
0100-0001-0001 2 Multicast GE1/1/1 N
GE1/1/2
# Display the number of static multicast MAC address entries.
<Sysname> display mac-address multicast count
1 mac address(es) found.
Table 1 Command output
|
Field |
Description |
|
MAC address |
MAC address of a multicast group. |
|
VLAN ID |
ID of the VLAN to which the network device identified by the MAC address belongs. |
|
State |
Status of the MAC address. If the multicast MAC address entry is static, this field displays Multicast. |
|
Port/NickName |
Outgoing ports for the packet that is sent to the MAC address in this MAC address entry. |
|
Aging |
Aging time state. If this entry never expires, this field displays N. |
|
1 mac address(es) found |
One static multicast MAC address entry is found. |
Related commands
mac-address multicast
display mrib interface
Use display mrib interface to display information about interfaces maintained by the MRIB.
Syntax
display mrib [ vpn-instance vpn-instance-name ] interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about interfaces maintained by the MRIB on the public network.
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays information about all interfaces maintained by the MRIB.
Examples
# Display information about all interfaces maintained by the MRIB on the public network.
<Sysname> display mrib interface
Interface: GigabitEthernet1/1/1
Index: 0x00000001
Current state: up
MTU: 1500
Type: BROADCAST
Protocol: PIM-DM
PIM protocol state: Enabled
Address list:
1. Local address : 8.12.0.2/16
Remote address: 0.0.0.0
Reference : 1
State : NORMAL
Table 2 Command output
|
Field |
Description |
|
Interface |
Interface name. |
|
Index |
Index number of the interface. |
|
Current state |
Current status of the interface: up or down. |
|
MTU |
MTU value. |
|
Type |
Interface type: · BROADCAST—Broadcast link interface. · P2P—P2P interface. · LOOP—Loopback interface. · REGISTER—Register interface. · NBMA—NBMA interface. · MTUNNEL—Multicast tunnel interface. This field is empty if the interface is Null 0. |
|
Protocol |
Protocol running on the interface: PIM-DM, PIM-SM, IGMP, PROXY, or MD. |
|
PIM protocol state |
Whether PIM is enabled: Enabled or Disabled. |
|
Address list |
Interface address list. |
|
Local address |
Local IP address. |
|
Remote address |
Remote end IP address. This field is displayed only when the interface is vlink type. |
|
Reference |
Number of times that the address has been referenced. |
|
State |
Status of the interface address: NORMAL or DEL. |
display multicast boundary
Use display multicast boundary to display multicast boundary information.
Syntax
display multicast [ vpn-instance vpn-instance-name ] boundary [ group-address [ mask-length | mask ] ] [ interface interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast boundary information on the public network.
group-address: Specifies a multicast group by its IP address in the range of 224.0.0.0 to 239.255.255.255. If you do not specify a multicast group, this command displays multicast boundary information for all multicast groups.
mask-length: Specifies an address mask length in the range of 4 to 32. The default is 32.
mask: Specifies an address mask. The default is 255.255.255.255.
interface interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays multicast boundary information for all interfaces.
Examples
# Display information about all multicast boundaries on the public network.
<Sysname> display multicast boundary
Boundary Interface
224.1.1.0/24 GE1/1/1
239.2.2.0/24 GE1/1/2
Table 3 Command output
|
Field |
Description |
|
Boundary |
Multicast group associated with the multicast boundary. |
|
Interface |
Boundary interface associated with the multicast boundary. |
multicast boundary
display multicast fast-forwarding cache
Use display multicast fast-forwarding cache to display multicast fast forwarding entries.
Syntax
In standalone mode:
display multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache [ source-address | group-address ] * [ slot slot-number ]
In IRF mode:
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast fast forwarding entries on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify an IRF member device, this command displays multicast fast forwarding entries on the master device. (In IRF mode.)
Examples
# Display multicast fast forwarding entries on the public network.
<Sysname> display multicast fast-forwarding cache
Total 1 entries, 1 matched
(60.1.1.200, 225.0.0.2)
Status : Enabled
Source port: 2001 Destination port: 2002
Protocol : 2 Flag : 0x2
Incoming interface: GigabitEthernet1/1/6
List of 1 outgoing interfaces:
GigabitEthernet1/1/2
Status: Enabled Flag: 0x14
Table 4 Command output
|
Field |
Description |
|
Total number of (S, G) entries in the multicast fast forwarding table, and the total number of matching (S, G) entries. |
|
|
(S, G) entry. |
|
|
Protocol number. |
|
|
Flag of the incoming interface or the outgoing interface in the (S, G) entry. This field displays one flag or the sum of multiple flags. In this example, the value 0x2 means that the entry has only one flag 0x2. The value 0x14 means that the interface has flags 0x4 and 0x10. The following flags are available for an entry: · 0x1—The entry is created because of packets passed through between cards. · 0x2—The entry is added by multicast forwarding. The following flags are available for an outgoing interface: · 0x1—The interface is added to the entry because of packets passed through between cards. · 0x2—The interface is added to an existing entry. · 0x4—The MAC address of the interface is needed for fast forwarding. · 0x8—The interface is an outgoing interface associated with the incoming VLAN interface. · 0x10—The interface is associated with the entry. · 0x20—The interface is to be deleted. |
|
|
Status of the (S, G) entry or the outgoing interface: · Enabled—Available. · Disabled—Unavailable. |
|
|
Incoming interface of the (S, G) entry. |
|
|
Outgoing interface list of the (S, G) entry. |
Related commands
reset multicast fast-forwarding cache all
display multicast forwarding df-info
Use display multicast forwarding df-info to display DF information.
Syntax
In standalone mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ rp-address ] [ verbose ] [ slot slot-number ]
In IRF mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding df-info [ rp-address ] [ verbose ] [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays DF information on the public network.
rp-address: Specifies a BIDIR-PIM RP by its IP address.
verbose: Specifies detailed information. If you do not specify the keyword, this command displays brief information.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify an IRF member device, this command displays DF information on the master device. (In IRF mode.)
Usage guidelines
In a BIDIR-PIM domain, only the DF on each subnet can forward multicast data destined for a multicast group toward the RP of the group. For more information about the DF, see IP Multicast Configuration Guide.
Examples
# Display brief information about DFs on an ADVPN network.
<Sysname> display multicast forwarding df-info
Total 1 RPs, 1 matched
00001. RP address: 1.1.1.1
Flags: 0x0
Uptime: 00:00:53
RPF interface: Tunnel0, 192.168.0.1
List of 2 DF interfaces:
1: LoopBack0
2: Tunnel0, 192.168.0.3
# Display brief information about DFs on the public network.
<Sysname> display multicast forwarding df-info
Total 1 RPs, 1 matched
00001. RP address: 7.11.0.2
Flags: 0x0
Uptime: 04:14:40
RPF interface: GigabitEthernet1/1/1
List of 1 DF interfaces:
1: GigabitEthernet1/1/2
# Display detailed information about DFs on the public network.
<Sysname> display multicast forwarding df-info verbose
Total 1 RPs, 1 matched
00001. RP address: 7.11.0.2
MID: 2, Flags: 0x0
Uptime: 03:37:22
Product information: 0x7a2f762f, 0x718fee9f, 0x4b82f137, 0x71c32184
RPF interface: GigabitEthernet1/1/1
Product information: 0xa567d6fc, 0xadeb03e3
Tunnel information: 0xdfb107d4, 0x7aa5d510
List of 1 DF interfaces:
1: GigabitEthernet1/1/2
Product information: 0xa986152b, 0xb74a9a2f
Tunnel information: 0x297ca208, 0x76985b89
Table 5 Command output
|
Field |
Description |
|
Total 1 RPs, 1 matched |
Total number of RPs, and the total number of matching RPs. |
|
00001 |
Sequence number of the entry to which the RP is designated. |
|
RP address |
IP address of the RP. |
|
MID |
ID of the entry to which the RP is designated. Each entry to which the RP is designated has a unique MID. |
|
Flags |
Entry flag. This field displays one flag or the sum of multiple flags. In this example, the value 0x0 means that the entry has only one flag 0x0. The following flags are available for an entry: · 0x0—The entry is in correct state. · 0x4—The entry fails to update. · 0x8—DF interface information fails to update for the entry. · 0x40—The entry is to be deleted. · 0x100—The entry is being deleted. · 0x200—The entry is in GR state. |
|
Uptime |
|
|
RPF interface |
RPF interface to the RP. |
|
List of 1 DF interfaces |
DF interface list. |
|
ADVPN tunnel interface, and the IP address of the remote end. |
display multicast forwarding event
Use display multicast forwarding event to display statistics of multicast forwarding events.
Syntax
In standalone mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding event [ slot slot-number ]
In IRF mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding event [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays statistics of the multicast forwarding events on the public network.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify an IRF member device, this command displays multicast forwarding event statistics on the master device. (In IRF mode.)
Examples
# Display statistics of multicast forwarding events on the public network.
<Sysname> display multicast forwarding event
Total active events sent: 0
Total inactive events sent: 0
Total NoCache events sent: 2
Total NoCache events dropped: 0
Total WrongIF events sent: 0
Total WrongIF events dropped: 0
Total SPT switch events sent: 0
NoCache rate limit: 1024 packets/s
WrongIF rate limit: 1 packets/10s
Total timer of register suppress timeout: 0
|
Field |
Description |
|
Total active events sent |
Number of times that entry-active events have been sent. |
|
Total inactive events sent |
Number of times that entry-inactive events have been sent. |
|
Total NoCache events sent |
Number of times that NoCache events have been sent. |
|
Total NoCache events dropped |
Number of times that NoCache events have been dropped. |
|
Total WrongIF events sent |
Number of times that WrongIF events have been sent. |
|
Total WrongIF event dropped |
Number of times that WrongIF events have been dropped. |
|
Total SPT switch events sent |
Number of times that SPT-switch events have been sent. |
|
NoCache rate limit |
Rate limit for sending NoCache events, in pps. |
|
WrongIF rate limit |
Rate limit for sending WrongIF events, in packets per 10 seconds. |
|
Total timer of register suppress timeout |
Number of times that the registration suppression has timed out in total. |
Related commands
reset multicast forwarding event
display multicast forwarding-table
Use display multicast forwarding-table to display multicast forwarding entries.
Syntax
In standalone mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | slot slot-number | statistics ] *
In IRF mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | chassis chassis-number slot slot-number | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number | statistics ] *
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast forwarding entries on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.
mask: Specifies an address mask. The default value is 255.255.255.255.
incoming-interface: Specifies the multicast forwarding entries that contain the specified incoming interface.
interface-type interface-number: Specifies an incoming interface by its type and number.
outgoing-interface: Specifies the multicast forwarding entries that contain the specified outgoing interface.
exclude: Specifies the multicast forwarding entries that do not contain the specified interface in the outgoing interface list.
include: Specifies the multicast forwarding entries that contain the specified interface in the outgoing interface list.
match: Specifies the forwarding entries that contain only the specified interface in the outgoing interface list.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify an IRF member device, this command displays multicast forwarding entries on the master device. (In IRF mode.)
statistics: Displays statistics for the multicast forwarding table.
Examples
# Display multicast forwarding entries on an ADVPN network.
<Sysname> display multicast forwarding-table
Total 1 entries, 1 matched
00001. (172.168.0.2, 227.0.0.1)
Flags: 0x0
Uptime: 00:08:32, Timeout in: 00:03:26
Incoming interface: Tunnel1, 12.1.1.3
List of 2 outgoing interface:
1: Tunnel1, 12.1.1.1
2: Tunnel1, 12.1.1.2
Matched 19648 packets(20512512 bytes), Wrong If 0 packet
Forwarded 19648 packets(20512512 bytes)
# Display multicast forwarding entries on the public network.
<Sysname> display multicast forwarding-table
Total 1 entries, 1 matched
00001. (172.168.0.2, 227.0.0.1)
Flags: 0x0
Uptime: 00:08:32, Timeout in: 00:03:26
Incoming interface: GigabitEthernet1/1/1
List of 2 outgoing interface:
1: GigabitEthernet1/1/2
2: GigabitEthernet1/1/3
Matched 19648 packets(20512512 bytes), Wrong If 0 packet
Forwarded 19648 packets(20512512 bytes)
Table 7 Command output
|
Field |
Description |
|
Total 1 entries, 1 matched |
Total number of (S, G) entries, and the total number of matching (S, G) entries. |
|
00001 |
Sequence number of the (S, G) entry. |
|
(172.168.0.2,227.0.0.1) |
(S, G) entry. |
|
Flags |
Entry flag. This field displays one flag or the sum of multiple flags. In this example, the value 0x0 means that the entry has only one flag 0x0. The following entries are available for an entry: · 0x0—The entry is in correct state. · 0x1—The entry is in inactive state. · 0x2—The entry is null. · 0x4—The entry fails to update. · 0x8—Outgoing interface information fails to update for the entry. · 0x10—Data-group information fails to update for the entry. · 0x20—A register outgoing interface is available. · 0x40—The entry is to be deleted. · 0x80—The entry is in registration suppression state. · 0x100—The entry is being deleted. · 0x200—The entry is in GR state. · 0x800—The entry has the associated ARP entry for the multicast source address. · 0x400000—The entry is created by the IGMP proxy. · 0x2000000—The entry is a BIDIR-PIM forwarding entry. |
|
Uptime |
Length of time for which the (S, G) entry has been up. |
|
Timeout in |
Length of time in which the (S, G) entry will expire. |
|
Incoming interface |
Incoming interface of the (S, G) entry. |
|
List of 1 outgoing interfaces |
Outgoing interface list of the (S, G) entry. |
|
ADVPN tunnel interface, and the IP address of the remote end. |
|
|
Matched 19648 packets(20512512 bytes), Wrong If 0 packet |
Number of packets (bytes) that match the (S, G) entry, and number of packets with incoming interface errors. The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot. |
|
Forwarded 19648 packets(20512512 bytes) |
Number of packets (bytes) that have been forwarded. The numbers are displayed as 0 if an outgoing interface of the (S, G) entry is on the specified slot. |
reset multicast forwarding-table
display multicast forwarding-table df-list
Use display multicast forwarding-table df-list to display information about the DF list in multicast forwarding entries.
Syntax
In standalone mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ group-address ] [ verbose ] [ slot slot-number ]
In IRF mode:
display multicast [ vpn-instance vpn-instance-name ] forwarding-table df-list [ group-address ] [ verbose ] [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays information about the DF list in multicast forwarding entries on the public network.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
verbose: Specifies detailed information about the DF list in multicast forwarding entries. If you do not specify the keyword, this command displays brief information about the DF list in multicast forwarding entries.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify an IRF member device, this command displays information about the DF list in multicast forwarding entries on the master device. (In IRF mode.)
Examples
# Display brief information about the DF list in multicast forwarding entries on the public network.
<Sysname> display multicast forwarding-table df-list
Total 1 entries, 1 matched
00001. (0.0.0.0, 225.0.0.1)
List of 1 DF interfaces:
1: GigabitEthernet1/1/1
# Display detailed information about the DF list in multicast forwarding entries on the public network.
<Sysname> display multicast forwarding-table df-list verbose
Total 1 entries, 1 matched
00001. (0.0.0.0, 225.0.0.1)
List of 1 DF interfaces:
1: GigabitEthernet1/1/1
Product information: 0x347849f6, 0x14bd6837
Tunnel information: 0xc4857986, 0x128a9c8f
Table 8 Command output
|
Field |
Description |
|
Total 1 entries, 1 matched |
Total number of forwarding entries, and the total number of matching entries. |
|
00001 |
Sequence number of the entry. |
|
(0.0.0.0, 225.0.0.1) |
(*, G) entry. |
|
List of 1 DF interfaces |
DF interface list. |
display multicast routing-table
Use display multicast routing-table to display multicast routing entries.
Syntax
display multicast [ vpn-instance vpn-instance-name ] routing-table [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface interface-type interface-number | outgoing-interface { exclude | include | match } interface-type interface-number ] *
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays multicast routing entries on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.
mask: Specifies an address mask. The default is 255.255.255.255.
incoming-interface: Specifies the multicast routing entries that contain the specified incoming interface.
interface-type interface-number: Specifies an interface by its type and number.
outgoing-interface: Specifies the multicast routing entries that contain the specified outgoing interface.
exclude: Specifies the multicast routing entries that do not contain the specified interface in the outgoing interface list.
include: Specifies the multicast routing entries that contain the specified interface in the outgoing interface list.
match: Specifies the multicast routing entries that contain only the specified interface in the outgoing interface list.
Usage guidelines
Multicast routing entries are the basis of multicast forwarding. You can use this command to view the establishment state of (S, G) entries.
Examples
# Display multicast routing entries on an ADVPN network.
<Sysname> display multicast routing-table
Total 1 entries
00001. (172.168.0.2, 227.0.0.1)
Uptime: 00:00:28
Upstream Interface: Tunnel1, 12.1.1.3
List of 2 downstream interfaces
1: Tunnel1, 12.1.1.1
2: Tunnel1, 12.1.1.2
# Display multicast routing entries on the public network.
<Sysname> display multicast routing-table
Total 1 entries
00001. (172.168.0.2, 227.0.0.1)
Uptime: 00:00:28
Upstream Interface: GigabitEthernet1/1/1
List of 2 downstream interfaces
1: GigabitEthernet1/1/2
2: GigabitEthernet1/1/3
Table 9 Command output
|
Field |
Description |
|
Total 1 entries |
Total number of (S, G) entries. |
|
00001 |
Sequence number of the (S, G) entry. |
|
(172.168.0.2, 227.0.0.1) |
(S, G) entry. |
|
Uptime |
Length of time for which the (S, G) entry has been up. |
|
Upstream Interface |
Upstream interface at which (S, G) packets should arrive. |
|
List of 2 downstream interfaces |
List of downstream interfaces that need to forward (S, G) packets. |
|
Tunnel11, 12.1.1.1 |
ADVPN tunnel interface, and the IP address of the remote end. |
display multicast routing-table static
Use display multicast routing-table static to display static multicast routing entries.
Syntax
display multicast [ vpn-instance vpn-instance-name ] routing-table static [ source-address { mask-length | mask } ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays static multicast routing entries on the public network.
source-address: Specifies a multicast source address.
mask-length: Specifies an address mask length in the range of 0 to 32.
mask: Specifies an address mask.
Usage guidelines
This command displays only valid static multicast routing entries.
Examples
# Display static multicast routing entries on the public network.
<Sysname> display multicast routing-table static
Destinations: 3 Routes: 4
Destination/Mask Pre RPF neighbor Interface
1.1.0.0/16 10 7.12.0.1 GE1/1/1
7.11.0.1 GE1/1/2
2.2.2.0/24 20 7.11.0.1 GE1/1/3
3.3.3.3/32 50 7.12.0.1 GE1/1/4
Table 10 Command output
|
Field |
Description |
|
Destinations |
Number of the multicast destination addresses. |
|
Routes |
Number of routes. |
|
Destination/Mask |
Destination address and its mask length. |
|
Pre |
Route preference. |
|
RPF neighbor |
IP address of the RPF neighbor to the reachable destination. |
|
Interface |
Outgoing interface to the reachable destination. |
display multicast rpf-info
Use display multicast rpf-info to display RPF information for a multicast source.
Syntax
display multicast [ vpn-instance vpn-instance-name ] rpf-info source-address [ group-address ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command displays RPF information for a multicast source on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.
Examples
# Display RPF information for multicast source 192.168.1.55 on the public network.
<Sysname> display multicast rpf-info 192.168.1.55
RPF information about source 192.168.1.55:
RPF interface: GigabitEthernet1/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 11 Command output
|
Description |
|
|
RPF neighbor |
IP address of the RPF neighbor. |
|
Referenced route/mask |
Referenced route and its mask length. |
|
Referenced route type |
Type of the referenced route: · igp—IGP unicast route. · egp—EGP unicast route. · unicast (direct)—Directly connected unicast route. · unicast—Other unicast routes, such as static unicast route. · multicast static—Static multicast route. · mbgp—MBGP route. |
|
Route selection rule |
Rule for RPF route selection: · Route preference. · Longest prefix match. |
|
Load splitting rule |
Status of the load splitting rule: enable or disable. |
display multicast forwarding-table
display multicast routing-table
ip rpf-route-static
Use ip rpf-route-static to configure a static multicast route.
Use undo ip rpf-route-static to delete a static multicast route.
Syntax
ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number } [ preference preference ]
undo ip rpf-route-static [ vpn-instance vpn-instance-name ] source-address { mask-length | mask } { rpf-nbr-address | interface-type interface-number }
Default
No static multicast routes exist.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command configures a static multicast route on the public network.
source-address: Specifies a multicast source address.
mask-length: Specifies an address mask length in the range of 0 to 32.
mask: Specifies an address mask.
rpf-nbr-address: Specifies an RPF neighbor by its IP address.
interface-type interface-number: Specifies an interface by its type and number. The interface connects the RPF neighbor.
preference: Sets a route preference in the range of 1 to 255. The default value is 1.
Usage guidelines
When you specify an RPF neighbor, follow these guidelines:
· If the RPF neighbor is a point-to-point interface, you must specify the type and number of the interface.
· If the RPF neighbor is not a point-to-point interface, you must specify the IP address of the interface. This type of interfaces includes Layer 3 Ethernet, Layer 3 aggregate, Loopback, and VLAN interfaces.
The configured static multicast route might not take effect when one of the following conditions exists:
· The outgoing interface iteration fails.
· The specified interface is not in the public network or the same VPN instance as the current interface.
· The specified interface is not a point-to-point interface.
· The specified interface is down.
If multiple static multicast routes within the same multicast source address range are available, only the one with the highest route preference can become active. You can use the display multicast routing-table static command to verify that the configured static multicast route has taken effect.
The undo ip rpf-route-static command deletes the specified static multicast route, but the delete ip rpf-route-static command deletes all static multicast routes.
Examples
# On the public network, configure a static multicast route to multicast source 10.1.1.1/24 and specify the interface with IP address 192.168.1.23 as the RPF neighbor.
<Sysname> system-view
[Sysname] ip rpf-route-static 10.1.1.1 24 192.168.1.23
Related commands
delete ip rpf-route-static
display multicast routing-table static
load-splitting (MRIB view)
Use load-splitting to enable multicast load splitting.
Use undo load-splitting to restore the default.
Syntax
load-splitting { source | source-group }
undo load-splitting
Default
Multicast load splitting is disabled.
Views
MRIB view
Predefined user roles
network-admin
mdc-admin
Parameters
source: Specifies load splitting on a per-source basis.
source-group: Specifies load splitting both on a per-source basis and on a per-group basis.
Usage guidelines
This command does not take effect on BIDIR-PIM.
Examples
# Enable multicast load splitting on a per-source basis on the public network.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] load-splitting source
longest-match (MRIB view)
Use longest-match to specify the longest prefix match principle for RPF route selection.
Use undo longest-match to restore the default.
Syntax
longest-match
undo longest-match
Default
Route preference is used for RPF route selection. The route with the highest preference is used as the RPF route.
Views
MRIB view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
This command enables the device to use the matching route with the longest prefix as the RPF route.
Examples
# Specify the longest prefix match principle for RPF route selection on the public network.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib] multicast longest-match
mac-address multicast
Use mac-address multicast to configure a static multicast MAC address entry.
Use undo mac-address multicast to delete a static multicast MAC address entry.
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 Layer 2 aggregate interface view or Layer 2 Ethernet interface view:
mac-address multicast mac-address vlan vlan-id
undo mac-address [ multicast ] mac-address vlan vlan-id
Default
No static multicast MAC address entries exist.
Views
System view
Layer 2 aggregate interface view
Layer 2 Ethernet interface view
Predefined user roles
network-admin
mdc-admin
Parameters
mac-address: Specifies a static multicast MAC address, in the format H-H-H. You must specify an unused multicast MAC address. A multicast MAC address is a MAC address in which the least significant bit of the most significant octet is 1.
interface interface-list: Specifies a space-separated list of up to four interface items. Each item specifies an interface or an interface list in the format of start-interface-type interface-number to end-interface-type interface-number. The interface-type interface-number argument specifies an interface by its type and number. The available interface types include Layer 2 Ethernet interfaces and Layer 2 aggregate interfaces.
vlan vlan-id: Specifies an existing VLAN by its VLAN ID in the range of 1 to 4094. The system gives a prompt if the specified interface does not belong to the VLAN.
Usage guidelines
You do not need to enable IP multicast routing before you execute this command.
You can configure static multicast MAC address entries for the specified interfaces in system view or for the current interface in interface view.
If you do not specify the multicast keyword in the undo mac-address command, all static unicast MAC address entries and static multicast MAC entries are deleted.
Examples
# Configure a static multicast MAC address entry. In the entry, the multicast MAC address is 0100-0001-0001 and the outgoing ports are GigabitEthernet 1/1/1 through GigabitEthernet 1/1/5 in VLAN 2.
<Sysname> system-view
[Sysname] mac-address multicast 0100-0001-0001 interface gigabitethernet 1/1/1 to gigabitethernet 1/1/5 vlan 2
# Configure a static multicast MAC address entry for multicast MAC address 0100-0001-0001 on GigabitEthernet 1/1/1 in VLAN 2.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/1/1
[Sysname-GigabitEthernet1/1/1] mac-address multicast 0100-0001-0001 vlan 2
Related commands
display mac-address multicast
multicast boundary
Use multicast boundary to configure a multicast forwarding boundary.
Use undo multicast boundary to delete a multicast forwarding boundary.
Syntax
multicast boundary group-address { mask-length | mask }
undo multicast boundary { group-address { mask-length | mask } | all }
Default
No multicast forwarding boundaries are configured on an interface.
Views
Interface view
Predefined user roles
network-admin
mdc-admin
Parameters
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
mask-length: Specifies an address mask length in the range of 4 to 32.
mask: Specifies an address mask.
all: Specifies all forwarding boundaries configured on the interface.
Usage guidelines
A multicast forwarding boundary sets the boundary condition for the multicast groups in the specified address range. If the destination address of a multicast packet matches the set boundary condition, the packet is not forwarded.
You can configure an interface as a multicast forwarding boundary for different multicast group ranges by executing this command multiple times on the interface.
You do not need to enable IP multicast routing before you execute this command.
Assume that both A and B are multicast group ranges, and B is a subnet of A. If you first configure an interface as the forwarding boundary of A, you cannot configure the interface as the forwarding boundary of B. If you configure an interface first as the forwarding boundary of B and then the forwarding boundary of A, the interface becomes the forwarding boundary of A.
Examples
# Configure GigabitEthernet 1/1/1 as the forwarding boundary of multicast groups in the range of 239.2.0.0/16.
<Sysname> system-view
[Sysname] interface gigabitethernet 1/1/1
[Sysname-GigabitEthernet1/1/1] multicast boundary 239.2.0.0 16
display multicast boundary
multicast routing
Use multicast routing to enable IP multicast routing and enter MRIB view.
Use undo multicast routing to disable IP multicast routing.
Syntax
multicast routing [ vpn-instance vpn-instance-name ]
undo multicast routing [ vpn-instance vpn-instance-name ]
Default
IP multicast routing is disabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command enables IP multicast routing on the public network.
Usage guidelines
Other Layer 3 multicast commands take effect only when IP multicast routing is enabled.
The device does not forward multicast packets before IP multicast routing is enabled.
Examples
# Enable IP multicast routing on the public network and enter MRIB view.
<Sysname> system-view
[Sysname] multicast routing
[Sysname-mrib]
# Enable IP multicast routing for VPN instance mvpn and enter MRIB view.
<Sysname> system-view
[Sysname] multicast routing vpn-instance mvpn
[Sysname-mrib-mvpn]
reset multicast fast-forwarding cache
Use reset multicast fast-forwarding cache to clear multicast fast forwarding entries.
Syntax
In standalone mode:
reset multicast [ vpn-instance vpn-instance-name ] fast-forwarding cache { { source-address | group-address } * | all } [ slot slot-number ]
In IRF mode:
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears multicast fast forwarding entries on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.1.0 to 239.255.255.255.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify an IRF member device, this command clears multicast fast forwarding entries on the master device. (In IRF mode.)
all: Specifies all multicast fast forwarding entries.
Examples
# Clear all multicast fast forwarding entries.
<Sysname> reset multicast fast-forwarding cache all
# Clear the multicast fast forwarding entry for the multicast source and group (20.0.0.2, 225.0.0.2).
<Sysname> reset multicast fast-forwarding cache 20.0.0.2 225.0.0.2
Related commands
display multicast fast-forwarding cache
reset multicast forwarding event
Use reset multicast forwarding event to clear statistics for multicast forwarding events.
Syntax
reset multicast [ vpn-instance vpn-instance-name ] forwarding event
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears statistics for the multicast forwarding events on the public network.
Examples
# Clear statistics for multicast forwarding events on the public network.
<Sysname> reset multicast forwarding event
Related commands
display multicast forwarding event
reset multicast forwarding-table
Use reset multicast forwarding-table to clear multicast forwarding entries.
Syntax
reset multicast [ vpn-instance vpn-instance-name ] forwarding-table { { source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | incoming-interface { interface-type interface-number } } * | all }
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears multicast forwarding entries on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.
mask: Specifies an address mask. The default is 255.255.255.255.
incoming-interface: Specifies the multicast forwarding entries that contain the specified incoming interface.
interface-type interface-number: Specifies an incoming interface by its type and number.
all: Specifies all multicast forwarding entries.
Usage guidelines
When you clear a multicast forwarding entry, the associated multicast routing entry is also cleared.
Examples
# Clear multicast forwarding entries for multicast group 225.5.4.3 on the public network.
<Sysname> reset multicast forwarding-table 225.5.4.3
Related commands
display multicast forwarding-table
reset multicast routing-table
Use reset multicast routing-table to clear multicast routing entries.
Syntax
reset multicast [ vpn-instance vpn-instance-name ] routing-table { { source-address [ mask { mask-length | mask } ] | group-address [ mask { mask | mask-length } ] | incoming-interface interface-type interface-number } * | all }
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command clears multicast routing entries on the public network.
source-address: Specifies a multicast source address.
group-address: Specifies a multicast group address in the range of 224.0.0.0 to 239.255.255.255.
mask-length: Specifies an address mask length. The default value is 32. For a multicast group address, the value range for this argument is 4 to 32. For a multicast source address, the value range for this argument is 0 to 32.
mask: Specifies an address mask. The default is 255.255.255.255.
incoming-interface: Specifies the routing entries that contain the specified incoming interface.
interface-type interface-number: Specifies an incoming interface by its type and number.
all: Specifies all multicast routing entries.
Usage guidelines
When you clear a multicast routing entry, the associated multicast forwarding entry is also cleared.
Examples
# Clear multicast routing entries for multicast group 225.5.4.3 on the public network.
<Sysname> reset multicast routing-table 225.5.4.3
Related commands
display multicast routing-table
