- Table of Contents
-
- 07-IP Multicast Command Reference
- 00-Preface
- 01-IGMP snooping commands
- 02-PIM snooping commands
- 03-Multicast VLAN commands
- 04-Multicast routing and forwarding commands
- 05-IGMP commands
- 06-PIM commands
- 07-MSDP commands
- 08-Multicast VPN commands
- 09-MLD snooping commands
- 10-IPv6 PIM snooping commands
- 11-IPv6 multicast VLAN commands
- 12-IPv6 multicast routing and forwarding commands
- 13-MLD commands
- 14-IPv6 PIM commands
- Related Documents
-
Title | Size | Download |
---|---|---|
03-Multicast VLAN commands | 62.46 KB |
Multicast VLAN commands
display multicast-vlan
Use display multicast-vlan to display information about multicast VLANs.
Syntax
display multicast-vlan [ vlan-id ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vlan-id: Specifies a multicast VLAN ID in the range of 1 to 4094. If you do not specify a multicast VLAN ID, this command displays information about all multicast VLANs.
Examples
# Display information about all multicast VLANs.
<Sysname> display multicast-vlan
Total 2 multicast VLANs.
Multicast VLAN 100:
Sub-VLAN list(3 in total):
2-3, 6
Port list(3 in total):
XGE1/1/1
XGE1/1/2
XGE1/1/3
Multicast VLAN 200:
Sub-VLAN list(0 in total):
Port list(0 in total):
Table 1 Command output
Field |
Description |
Total 2 multicast VLANs |
Total number of multicast VLANs. |
Sub-VLAN list(3 in total) |
Sub-VLAN list of the multicast VLAN, and the total number of the sub-VLANs. |
Port list(3 in total) |
Port list of the multicast VLAN, and the total number of the ports. |
display multicast-vlan group
Use display multicast-vlan group to display information about multicast groups in multicast VLANs.
Syntax
display multicast-vlan group [ source-address | group-address | slot slot-number ] | verbose | vlan vlan-id ] *
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays information about multicast groups for all multicast sources in multicast VLANs.
group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, this command displays information for all multicast groups in multicast VLANs.
slot slot-number: Specifies an IRF member device by its member ID or specifies a PEX by its virtual slot number. If you do not specify a member device or PEX, this command displays information about multicast groups in multicast VLANs for the master device.
verbose: Displays detailed information.
vlan vlan-id: Specifies a multicast VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a multicast VLAN, this command displays information about multicast groups for all multicast VLANs.
Examples
# Display detailed information about all multicast groups in multicast VLANs.
<Sysname> display multicast-vlan group verbose
Total 6 entries.
Multicast VLAN 10: Total 3 entries.
(2.2.2.2, 225.1.1.2)
Flags: 0x70000020
Sub-VLANs (1 in total):
VLAN 40
(111.112.113.115, 225.1.1.4)
Flags: 0x70000030
Sub-VLANs (1 in total):
VLAN 40
(0.0.0.0, 226.1.1.6)
Flags: 0x60000020
Sub-VLANs (1 in total):
VLAN 40
Multicast VLAN 20: Total 3 entries.
(2.2.2.2, 225.1.1.2)
Flags: 0x70000010
Sub-VLANs (0 in total):
(111.112.113.115, 225.1.1.4)
Flags: 0x70000010
Sub-VLANs (0 in total):
(0.0.0.0, 226.1.1.6)
Flags: 0x50000010
Sub-VLANs (0 in total):
Table 2 Command output
Field |
Description |
Total 6 entries |
Total number of (S, G) entries. |
Multicast VLAN 10: Total 3 entries |
Total number of (S, G) entries in multicast VLAN 10. |
(0.0.0.0, 226.1.1.6) |
(S, G) entry, where 0.0.0.0 in the S position means all multicast sources. |
Flags |
Entry flag. This field displays one flag or the sum of multiple flags. For example, the value 0x70000020 means that the entry has flags 0x20, 0x10000000, 0x20000000, and 0x40000000. The following flags are available for an entry: · 0x10—The entry is created by the multicast VLAN. · 0x20—The entry is created by the sub-VLAN of the multicast VLAN. · 0x40—The entry is to be deleted. · 0x10000000—This value represents one of the following situations: ¡ The entry is newly created. ¡ The switch receives an IGMP query that matches the (S, G) entry but does not receive any matching IGMPv1 reports within an IGMP general query interval. · 0x20000000—The switch does not receive IGMPv2 or IGMPv3 reports that match the (S, G) entry within an IGMP general query interval. · 0x40000000—The switch does not receive IGMPv3 IS_EX (NULL) reports that match the (S, G) entry within an IGMP general query interval. |
Sub-VLANs (1 in total) |
Sub-VLAN list of the multicast VLAN, and the total number of the sub-VLANs. |
reset multicast-vlan group
display multicast-vlan forwarding-table
Use display multicast-vlan forwarding-table to display multicast VLAN forwarding entries.
Syntax
display multicast-vlan forwarding-table [ group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] | slot slot-number ] | subvlan vlan-id | vlan vlan-id ] *
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
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 VLAN forwarding entries for all multicast groups.
mask { mask-length | mask }: Specifies a mask length or subnet mask for the multicast group address. The value range for the mask-length argument is 4 to 32 (default), and the default value for the mask argument is 255.255.255.255.
source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command displays information about multicast VLAN forwarding entries for all multicast sources.
mask { mask-length | mask }: Specifies a mask length or subnet mask for the multicast source address. The value range for the mask-length argument is 0 to 32 (default), and the default value for the mask argument is 255.255.255.255.
slot slot-number: Specifies an IRF member device by its member ID or specifies a PEX by its virtual slot number. If you do not specify a member device or PEX, this command displays multicast VLAN forwarding entries for the master device.
subvlan vlan-id: Specifies a sub-VLAN by its VLAN ID. If you do not specify a sub-VLAN, this command displays multicast VLAN forwarding entries for all sub-VLANs.
vlan vlan-id: Specifies a multicast VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a multicast VLAN, this command displays multicast VLAN forwarding entries for all multicast VLANs.
Examples
# Display all multicast VLAN forwarding entries.
<Sysname> display multicast-vlan forwarding-table
Multicast VLAN 100 Forwarding Table
Total 1 entries, 1 matched
00001. (1.1.1.1, 225.0.0.1)
Flags: 0x10000
Multicast VLAN: 100
List of sub-VLANs (3 in total):
1: VLAN 10
2: VLAN 20
3: VLAN 30
Table 3 Command output
Field |
Description |
Multicast VLAN 100 Forwarding Table |
Forwarding entries for multicast VLAN 100. |
Total 1 entries, 1 matched |
Total number of (S, G) entries, and the number of matching entries. |
00001 |
Sequence number of the (S, G) entry. |
(1.1.1.1, 255.0.0.1) |
(S, G) entry, where 0.0.0.0 in the S position means all multicast sources. |
Flags |
Entry flag. This field displays one flag or the sum of multiple flags. In this example, the value 0x10000 means that the entry has only one flag 0x10000. The following flags are available for an entry: · 0x1—The entry is in inactive state. · 0x4—The entry fails to update. · 0x8—The sub-VLAN information fails to update for the entry. · 0x200—The entry is in GR state. · 0x10000—The entry is a multicast VLAN forwarding entry. |
List of sub-VLANs (3 in total) |
Sub-VLAN list of the multicast VLAN, and the total number of the sub-VLANs. |
multicast-vlan
Use multicast-vlan to configure a multicast VLAN and enter multicast VLAN view.
Use undo multicast-vlan to remove a multicast VLAN.
Syntax
multicast-vlan vlan-id
undo multicast-vlan { all | vlan-id }
Default
A VLAN is not configured as a multicast VLAN.
Views
System view
Predefined user roles
network-admin
Parameters
vlan-id: Specifies an existing VLAN by its VLAN ID in the range of 1 to 4094.
all: Specifies all multicast VLANs.
Usage guidelines
As a best practice, do not configure a multicast VLAN on a device that is enabled with IP multicast routing.
For a sub-VLAN-based multicast VLAN, you must enable IGMP snooping for the multicast VLAN and all its sub-VLANs. For a port-based multicast VLAN, you must enable IGMP snooping for the multicast VLAN and all user VLANs to which the user ports are connected.
Examples
# Enable IGMP snooping for VLAN 100. Configure VLAN 100 as a multicast VLAN and enter its view.
<Sysname> system-view
[Sysname] igmp-snooping
[Sysname-igmp-snooping] quit
[Sysname] vlan 100
[Sysname-vlan100] igmp-snooping enable
[Sysname-vlan100] quit
[Sysname] multicast-vlan 100
[Sysname-mvlan-100]
Related commands
· igmp-snooping enable
· multicast routing
multicast-vlan entry-limit
Use multicast-vlan entry-limit to set the maximum number of multicast VLAN forwarding entries.
Use undo multicast-vlan entry-limit to restore the default.
Syntax
multicast-vlan entry-limit limit
undo multicast-vlan entry-limit
Default
The maximum number of multicast VLAN forwarding entries is not set.
Views
System view
Predefined user roles
network-admin
Parameters
limit: Specifies the maximum number of multicast VLAN forwarding entries, in the range of 0 to 8192.
Examples
# Set the maximum number of multicast VLAN forwarding entries to 512.
<Sysname> system-view
[Sysname] multicast-vlan entry-limit 512
entry-limit (IGMP-snooping view)
port (multicast-VLAN view)
Use port to assign user ports to a multicast VLAN.
Use undo port to remove user ports from a multicast VLAN.
Syntax
port interface-list
undo port { all | interface-list }
Default
A multicast VLAN does not have user ports.
Views
Multicast VLAN view
Predefined user roles
network-admin
Parameters
interface-list: Specifies a port in the form of interface-type interface-number, or a port range in the form of interface-type interface-number to interface-type interface-number.
all: Specifies all user ports in the current multicast VLAN.
Usage guidelines
A port can be assigned to only one multicast VLAN.
You can assign only Layer 2 Ethernet interfaces or Layer 2 aggregate interfaces as user ports to a multicast VLAN.
Examples
# Assign Ten-GigabitEthernet 1/1/1 through Ten-GigabitEthernet 1/1/5 as user ports to multicast VLAN 100.
<Sysname> system-view
[Sysname] multicast-vlan 100
[Sysname-mvlan-100] port ten-gigabitethernet 1/1/1 to ten-gigabitethernet 1/1/5
port multicast-vlan
Use port multicast-vlan to assign a port to a multicast VLAN.
Use undo port multicast-vlan to restore the default.
Syntax
port multicast-vlan vlan-id
undo port multicast-vlan
Default
A port does not belong to a multicast VLAN.
Views
Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles
network-admin
Parameters
vlan-id: Specifies a multicast VLAN by its VLAN ID in the range of 1 to 4094.
Usage guidelines
A port can be assigned to only one multicast VLAN.
Examples
# Assign Ten-GigabitEthernet 1/1/1 as a user port to multicast VLAN 100.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/1/1
[Sysname-Ten-GigabitEthernet1/1/1] port multicast-vlan 100
reset multicast-vlan group
Use reset multicast-vlan group to clear multicast groups in multicast VLANs.
Syntax
Use reset multicast-vlan group [ source-address [ mask { mask-length | mask } ] | group-address [ mask { mask-length | mask } ] | vlan vlan-id ] *
Views
User view
Predefined user roles
network-admin
Parameters
source-address: Specifies a multicast source by its IP address. If you do not specify a multicast source, this command clears multicast groups for all multicast sources in multicast VLANs.
mask { mask-length | mask }: Specifies a mask length or subnet mask for the multicast source address. The value range for the mask-length argument is 0 to 32 (default), and the default value for the mask argument is 255.255.255.255.
group-address: Specifies a multicast group by its IP address in the range of 224.0.1.0 to 239.255.255.255. If you do not specify a multicast group, this command clears all multicast groups in multicast VLANs.
mask { mask-length | mask }: Specifies a mask length or subnet mask for the multicast group address. The value range for the mask-length argument is 4 to 32 (default), and the default value for the mask argument is 255.255.255.255.
vlan vlan-id: Specifies a multicast VLAN by its VLAN ID in the range of 1 to 4094. If you do not specify a multicast VLAN, this command clears multicast groups for all multicast VLANs.
Examples
# Clear multicast groups for all multicast VLANs.
<Sysname> reset multicast-vlan group
Related commands
display multicast-vlan group
subvlan (multicast-VLAN view)
Use subvlan to assign sub-VLANs to a multicast VLAN.
Use undo subvlan to remove sub-VLANs from a multicast VLAN.
Syntax
subvlan vlan-list
undo subvlan { all | vlan-list }
Default
A multicast VLAN does not have sub-VLANs.
Views
Multicast VLAN view
Predefined user roles
network-admin
Parameters
vlan-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN by its ID or a range of VLANs in the form of start-vlan-id to end-vlan-id. The value range for the VLAN ID is 1 to 4094. The specified VLANs must exist and cannot be multicast VLANs or sub-VLANs of any other multicast VLAN.
all: Specifies all sub-VLANs of the current multicast VLAN.
Examples
# Assign VLAN 10 through VLAN 15 as sub-VLANs to multicast VLAN 100.
<Sysname> system-view
[Sysname] multicast-vlan 100
[Sysname-mvlan-100] subvlan 10 to 15