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

mdc-admin

mdc-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):

GE1/0/1

GE1/0/2

GE1/0/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.

Multicast VLAN commands -- display multicast-vlan forwarding-table

Use display multicast-vlan forwarding-table to display multicast VLAN forwarding entries.

Syntax

Centralized devices:

display multicast-vlan forwarding-table [ group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] | subvlan vlan-id | vlan vlan-id ] *

Distributed devices in standalone mode:Centralized IRF devices:

display multicast-vlan forwarding-table [ group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] | slot slot-number [ cpu cpu-number ] | subvlan vlan-id | vlan vlan-id ] *

Distributed devices in IRF mode:

display multicast-vlan forwarding-table [ group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] | chassis chassis-number slot slot-number [ cpu cpu-number ] | subvlan vlan-id | vlan vlan-id ] *

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-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 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 a card by its slot number. If you do not specify a card, this command displays multicast VLAN forwarding entries for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays multicast VLAN forwarding entries for the master device. (Centralized IRF devices.) (IRF 3 incapable.)

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. (Centralized IRF devices.) (IRF 3 capable.)

chassis chassis-number slot slot-number: Specifies a card on 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 card. If you do not specify a card, this command displays multicast VLAN forwarding entries for the global active MPU. (Distributed devices in IRF mode.) (IRF 3 incapable.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device or specifies a PEX. The chassis-number argument represents the member ID of the IRF member device or the virtual chassis number of the PEX. The slot-number argument represents the slot number of the card or PEX. If you do not specify a card or PEX, this command displays multicast VLAN forwarding entries for the global active MPU. (Distributed devices in IRF mode.) (IRF 3 capable.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

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 2 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 commands -- display multicast-vlan group

Use display multicast-vlan group to display information about multicast groups in multicast VLANs.

Syntax

Centralized devices:

display multicast-vlan group [ source-address | group-address | verbose | vlan vlan-id ] *

Distributed devices in standalone mode:Centralized IRF devices:

display multicast-vlan group [ source-address | group-address | slot slot-number [ cpu cpu-number ] | verbose | vlan vlan-id ] *

Distributed devices in IRF mode:

display multicast-vlan group [ source-address | group-address | chassis chassis-number slot slot-number [ cpu cpu-number ] | verbose | vlan vlan-id ] *

Views

Any view

Predefined user roles

network-admin

network-operator

mdc-admin

mdc-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 a card by its slot number. If you do not specify a card, this command displays information about multicast groups in multicast VLANs for the MPU. (Distributed devices in standalone mode.)

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays information about multicast groups in multicast VLANs for the master device. (Centralized IRF devices.) (IRF 3 incapable.)

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. (Centralized IRF devices.) (IRF 3 capable.)

chassis chassis-number slot slot-number: Specifies a card on 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 card. If you do not specify a card, this command displays information about multicast groups in multicast VLANs for the global active MPU. (Distributed devices in IRF mode.) (IRF 3 incapable.)

chassis chassis-number slot slot-number: Specifies a card on an IRF member device or specifies a PEX. The chassis-number argument represents the member ID of the IRF member device or the virtual chassis number of the PEX. The slot-number argument represents the slot number of the card or PEX. If you do not specify a card or PEX, this command displays information about multicast groups in multicast VLANs for the global active MPU. (Distributed devices in IRF mode.) (IRF 3 capable.)

cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.

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 3 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: ?span style='font:7.0pt "Times New Roman"'> The entry is newly created. ?span style='font:7.0pt "Times New Roman"'> The device 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 device does not receive IGMPv2 or IGMPv3 reports that match the (S, G) entry within an IGMP general query interval. · 0x40000000—The device 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.

Related commands

reset multicast-vlan group

Multicast VLAN commands -- multicast-vlan

Use multicast-vlan to configure a multicast VLAN and enter its view, or enter the view of an existing multicast VLAN.

Use undo multicast-vlan to remove the configuration of multicast VLANs.

Syntax

multicast-vlan vlan-id

undo multicast-vlan { all | vlan-id }

Default

No multicast VLANs exist.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

vlan-id: Specifies an existing VLAN by its ID in the range of 1 to 4094.

all: Specifies all multicast VLANs.

Usage guidelines

The total number of multicast VLANs on a device cannot exceed the system upper limit, which varies by the device model.

You must enable IGMP snooping for the VLAN to be configured as a multicast VLAN.

As a best practice, do not configure a multicast VLAN on a device that is enabled with IP multicast routing.

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 commands -- 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 varies by device model.

Views

System view

Predefined user roles

network-admin

mdc-admin

Parameters

limit: Specifies the maximum number of multicast VLAN forwarding entries. The value range varies by device model.

Examples

# Set the maximum number of multicast VLAN forwarding entries to 128.

<Sysname> system-view

[Sysname] multicast-vlan entry-limit 128

Related commands

entry-limit (IGMP-snooping view)

Multicast VLAN commands -- port (multicast-VLAN view)

Use port to assign user ports to a multicast VLAN.

Use undo port to delete 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

mdc-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

You can assign only Layer 2 Ethernet ports, Layer 2 RPR logical interfaces, or Layer 2 aggregate interfaces to multicast VLANs. Additionally, you can assign a port to only one multicast VLAN.

For ports to be assigned to a multicast VLAN, you must enable IGMP snooping for the VLANs to which the ports belong.

Examples

# Assign GigabitEthernet 1/0/1 through GigabitEthernet 1/0/3 as user ports to multicast VLAN 100.

<Sysname> system-view

[Sysname] multicast-vlan 100

[Sysname-mvlan-100] port gigabitethernet 1/0/1 to gigabitethernet 1/0/3

Multicast VLAN commands -- port multicast-vlan

Use port multicast-vlan to assign a user 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

Layer 2 RPR logical interface view

Predefined user roles

network-admin

mdc-admin

Parameters

vlan-id: Specifies a multicast VLAN by its VLAN ID in the range of 1 to 4094.

Usage guidelines

You can assign a port to only one multicast VLAN.

For a port to be assigned to a multicast VLAN, you must enable IGMP snooping for the VLAN to which the port belongs.

Examples

# Assign GigabitEthernet 1/0/1 as a user port to multicast VLAN 100.

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port multicast-vlan 100

Multicast VLAN commands -- 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

mdc-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

Multicast VLAN commands -- subvlan (multicast-VLAN view)

Use subvlan to assign VLANs as sub-VLANs to a multicast VLAN.

Use undo subvlan to delete 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

mdc-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 other multicast VLANs.

all: Specifies all sub-VLANs of the current multicast VLAN.

Usage guidelines

You must enable IGMP snooping for VLANs to be configured as sub-VLANs.

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