vlan vlan-id: Displays the IGMP Snooping forwarding table information in the specified VLAN, where vlan-id is in the range of 1 to 4094. If you do not specify a VLAN, this command will display the multicast group information in all VLANs.

verbose: Specifies to display the detailed IGMP Snooping forwarding table information.

Description

Use the display igmp-snooping group command to view the IGMP Snooping forwarding table information.

Examples

# View the detailed IGMP Snooping forwarding table information in VLAN 2.

<Sysname> display igmp-snooping group vlan 2 verbose

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Port flags: D-Dynamic port, S-Static port, A-Aggregation port, C-Copy port

Subvlan flags: R-Real VLAN, C-Copy VLAN

Vlan(id):2.

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Router port(s):total 1 port.

GE1/0/2 (D) ( 00:01:30 )

IP group(s):the following ip group(s) match to one mac group.

IP group address:224.1.1.1

(1.1.1.1, 224.1.1.1):

Attribute: Host Port

Host port(s):total 1 port.

GE1/0/1 (D) ( 00:03:23 )

MAC group(s):

MAC group address:0100-5e01-0101

Host port(s):total 1 port.

GE1/0/1

Table 1-1 Description of the fields of the display igmp-snooping group command

Field	Description
Total 1 IP Group(s).	Total number of IP multicast groups
Total 1 IP Source(s).	Total number of multicast sources
Total 1 MAC Group(s).	Total number of MAC multicast groups
Port flags: D-Dynamic port, S-Static port, A-Aggregation port, C-Copy port	Port flags: D for dynamic port, S for static port, A for aggregation port, C for port copied from a (*, G) entry to an (S, G) entry
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: R for real egress sub-VLAN under the current entry, C for sub-VLAN copied from a (*, G) entry to an (S, G) entry
Router port(s)	Number of router ports
IP group address	Address of IP multicast group
MAC group address	Address of MAC multicast group
Attribute	Attribute of IP multicast group
Host port(s)	Number of host member ports

1.1.2 display igmp-snooping statistics

Syntax

display igmp-snooping statistics

View

Any view

Parameters

None

Description

Use the display igmp-snooping statistics command to view the statistics information of IGMP messages learned by IGMP Snooping.

Examples

# View the statistics information of IGMP messages learned by IGMP Snooping.

<Sysname> display igmp-snooping statistics

Received IGMP general queries:0.

Received IGMPv1 reports:0.

Received IGMPv2 reports:19.

Received IGMP leaves:0.

Received IGMPv2 specific queries:0.

Sent IGMPv2 specific queries:0.

Received IGMPv3 reports:1.

Received IGMPv3 reports with right and wrong records:0.

Received IGMPv3 specific queries:0.

Received IGMPv3 specific sg queries:0.

Sent IGMPv3 specific queries:0.

Sent IGMPv3 specific sg queries:0.

Received error IGMP messages:19.

Table 1-2 Description of the fields of the display igmp-snooping statistics command

Field	Description
general queries	General query messages
specific queries	Group-specific query messages
reports	Report messages
leaves	Leave messages
reports with right and wrong records	Report messages with correct and incorrect records
specific sg query packet(s)	Group-and-source-specific query message(s)
error IGMP messages	IGMP messages with errors

1.1.3 fast-leave

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

View

IGMP-Snooping view

Parameters

vlan vlan-list: Defines one or multiple VLANs. You can provide up to 10 VLAN lists, by each of which you can specify an individual VLAN in the form of vlan-id, or a VLAN range in the form of start-vlan-id to end-vlan-id, where the end VLAN ID must be greater than the start VLAN ID. The effective range of a VLAN ID is 1 to 4094.

Description

Use the fast-leave command to enable the fast leave feature globally.

Use the undo fast-leave command to disable the fast leave feature globally.

By default, the fast leave feature is disabled.

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

l If you do not specify any VLAN, the command will take effect for all VLANs; if you specify a VLAN or multiple VLANs, the command will take effect for the specified VLAN(s) only.

Related commands: igmp-snooping fast-leave.

Examples

# Enable the fast leave feature globally in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] fast-leave vlan 2

1.1.4 group-policy

Syntax

group-policy acl-number [ vlan vlan-list ]

undo group-policy [ vlan vlan-list ]

View

IGMP-Snooping view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999.

Description

Use the group-policy command to configure a global multicast group filter.

Use the undo group-policy command to remove the configured global multicast group filter.

By default, no global multicast group filter is configured, namely a host can join any multicast group.

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

l If you do not specify any VLAN, the command will take effect for all VLANs; if you specify a VLAN or multiple VLANs, the command will take effect for the specified VLAN(s) only.

l If the specified ACL does not exist or the ACL rule is null, all multicast groups will be filtered out.

l You can configure different ACL rules for a port in different VLANs; for a given VLAN, a newly configured ACL rule will override the existing one.

Related commands: igmp-snooping group-policy.

Examples

# Configure ACL 2000 as the multicast group filter in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] group-policy 2000 vlan 2

1.1.5 host-aging-time

Syntax

host-aging-time interval

undo host-aging-time

View

IGMP-Snooping view

Parameters

interval: Member port aging time, in units of seconds. The effective range is 200 to 1,000.

Description

Use the host-aging-time command to configure the aging time of group member ports globally.

Use the undo host-aging-time command to restore the default setting.

By default, the aging time of group member ports is 260 seconds.

This command works only on IGMP Snooping–enabled VLANs, but not on VLANs with IGMP enabled on the corresponding VLAN interfaces.

Related commands: igmp-snooping host-aging-time.

Examples

# Set the aging time of group member ports globally to 300 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] host-aging-time 300

1.1.6 igmp-snooping

Syntax

igmp-snooping

undo igmp-snooping

View

System view

Parameters

None

Description

Use the igmp-snooping command to enable IGMP Snooping globally and enter IGMP-Snooping view.

Use the undo igmp-snooping command to disable IGMP Snooping globally.

By default, IGMP Snooping is disabled.

Related commands: igmp-snooping enable.

Examples

# Enable IGMP Snooping globally and enter IGMP-Snooping view.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping]

1.1.7 igmp-snooping drop-unknown

Syntax

igmp-snooping drop-unknown

undo igmp-snooping drop-unknown

View

VLAN view

Parameters

None

Description

Use the igmp-snooping drop-unknown command to enable the function of dropping unknown multicast data in the current VLAN.

Use the undo igmp-snooping drop-unknown command to disable the function of dropping unknown multicast data in the current VLAN.

By default, this function is disabled, that is, unknown multicast data is flooded.

This command takes effect only if IGMP Snooping is enabled in the VLAN.

Examples

# In VLAN 2, enable the function of dropping unknown multicast data.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping drop-unknown

1.1.8 igmp-snooping enable

Syntax

igmp-snooping enable

undo igmp-snooping enable

View

VLAN view

Parameters

None

Description

Use the igmp-snooping enable command to enable IGMP Snooping in the current VLAN.

Use the undo igmp-snooping enable command to disable IGMP Snooping in the current VLAN.

By default, IGMP Snooping is disabled in a VLAN.

IGMP Snooping must be enabled globally before it can be enabled in a VLAN.

Related commands: igmp-snooping.

Examples

# Enable IGMP Snooping in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

1.1.9 igmp-snooping fast-leave

Syntax

igmp-snooping fast-leave [ vlan vlan-list ]

undo igmp-snooping fast-leave [ vlan vlan-list ]

View

Ethernet port view, port group view

Parameters

Description

Use the igmp-snooping fast-leave command to enable the fast leave feature on the current port or group of ports.

Use the undo igmp-snooping fast-leave command to disable the fast leave feature on the current port or group of ports.

By default, the fast leave feature is disabled.

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

l If you do not specify any VLAN when you use this command in Ethernet port view, the command will take effect no matter which VLAN the port belongs to; if you specify a VLAN or multiple VLANs, the command will take effect only if the port belongs to the specified VLAN(s).

l If you do not specify any VLAN in manual port group view, the command will take effect on all the ports in this group no matter which VLANs these port belong to; if you specify a VLAN or multiple VLANs, the command will take effect on those ports in this group that belong to the specified VLAN(s).

l Configurations made in aggregation port group view are effective only for the master port in the group. If you do not specify any VLAN in aggregation port group view, the command will take effect no matter which VLAN the master port belongs to; if you specify a VLAN or multiple VLANs, the command will take effect only if the master port belongs to the specified VLAN(s).

Related commands: fast-leave.

Examples

# Enable the fast leave feature on GigabitEthernet 1/0/1, which belongs to VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitGigabitEthernet1/0/1] igmp-snooping fast-leave vlan 2

1.1.10 igmp-snooping general-query source-ip

Syntax

igmp-snooping general-query source-ip { current-interface | ip-address }

undo igmp-snooping general-query source-ip

View

VLAN view

Parameters

current-interface: Sets the source address of IGMP general queries to the address of the current VLAN interface. If the current VLAN interface does not have an IP address, the default IP address 0.0.0.0 will be used as the source IP address of IGMP general queries.

ip-address: Specifies the source address of IGMP general queries, which can be any legal IP address.

Description

Use the igmp-snooping general-query source-ip command to configure the source address of IGMP general queries.

Use the undo igmp-snooping general-query source-ip command to restore the default configuration.

By default, the source IP address of IGMP general queries is 0.0.0.0.

This command takes effect only if IGMP Snooping is enabled in the VLAN.

Examples

# Set the IP address of the interface of VLAN 2 to 10.1.1.1, with the subnet mask of 255.255.255.0, and specify this IP address as the source IP address of IGMP general queries.

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] ip address 10.1.1.1 255.255.255.0

[Sysname-Vlan-interface2] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping general-query source-ip current-interface

1.1.11 igmp-snooping group-limit

Syntax

igmp-snooping group-limit limit [ vlan vlan-list ]

undo igmp-snooping group-limit [ vlan vlan-list ]

View

Ethernet port view, port group view

Parameters

limit: Maximum number of multicast groups that can be joined on a port. The effective range is 1 to 1024.

Description

Use the igmp-snooping group-limit command to configure the maximum number of multicast groups that can be joined on a port.

Use the undo igmp-snooping group-limit command to restore the default setting.

The default setting is 1024.

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

l If you do not specify any VLAN in Ethernet port view, the command will take effect on the port no matter which VLAN the port belongs to; if you specify a VLAN or multiple VLANs, the command will take effect on the port only if the port belongs to the specified VLAN(s).

l If you do not specify any VLAN in port group view, the command will take effect on all the ports in this group no matter which VLANs these ports belong to; if you specify a VLAN or multiple VLANs, the command will take effect on those ports in this group that belong to the specified VLAN(s).

Examples

# Specify to allow a maximum of 10 multicast groups to be joined on GigabitEthernet 1/0/1, which belongs to VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping group-limit 10 vlan 2

1.1.12 igmp-snooping group-policy

Syntax

igmp-snooping group-policy acl-number [ vlan vlan-list ]

undo igmp-snooping group-policy [ vlan vlan-list ]

View

Ethernet port view, port group view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999.

Description

Use the igmp-snooping group-policy command to configure a multicast group filter on the current port(s).

Use the undo igmp-snooping group-policy command to remove a multicast group filter on the current port(s).

Be default, no multicast group filter is configured on an interface, namely a host can join any multicast group

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

l If you do not specify any VLAN in port group view, the command will take effect on all the ports in this group no matter which VLANs these port belong to; if you specify a VLAN or multiple VLANs, the command will take effect on those ports in this group that belong to the specified VLAN(s).

l If the specified ACL does not exist or the ACL rule is null, all multicast groups will be filtered out.

l You can configure different ACL rules for a port in different VLANs; for a given VLAN, a newly configured ACL rule will override the existing one.

Related commands: group-policy.

Examples

# Configure ACL 2000 as the multicast group filter on GigabitEthernet 1/0/1, which belongs to VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping group-policy 2000 vlan 2

1.1.13 igmp-snooping host-aging-time

Syntax

igmp-snooping host-aging-time interval

undo igmp-snooping host-aging-time

View

VLAN view

Parameters

interval: Member port aging time, in units of seconds. The effective range is 200 to 1,000.

Description

Use the igmp-snooping host-aging-time command to configure the aging time of group member ports in the current VLAN.

Use the undo igmp-snooping host-aging-time command to restore the default setting.

By default, the aging time of group member ports is 260 seconds.

This command takes effect only if IGMP Snooping is enabled in the VLAN.

Related commands: host-aging-time.

Examples

# Set the aging time of group member ports to 300 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping host-aging-time 300

1.1.14 igmp-snooping host-join

Syntax

igmp-snooping host-join group-address [ source-ip source-address ] vlan vlan-id

undo igmp-snooping host-join group-address [ source-ip source-address ] vlan vlan-id

View

Ethernet port view, port group view

Parameters

group-address: Address of the multicast group that the simulated host is to join, in the range of 224.0.1.0 to 239.255.255.255.

source-address: Address of the multicast source that the simulated host is to join. The value of this argument should be a valid unicast address or 0.0.0.0. If the value is 0.0.0.0, this means that no multicast source is specified.

vlan vlan-id: Specifies the VLAN that comprises the Ethernet port(s), where vlan-id is in the range of 1 to 4094.

Description

Use the igmp-snooping host-join command to configure the current port(s) as simulated multicast group member host(s).

Use the undo igmp-snooping host-join command to remove the current port(s) as simulated multicast group member host(s).

By default, this function is disabled.

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces. The version of IGMP on the simulated host depends on the version of IGMP Snooping running in the VLAN or the version of IGMP running on the VLAN interface.

l The source-ip source-address option in the command is meaningful only for IGMP Snooping version 3. If IGMP Snooping version 2 is running, although you can include source-ip source-address in the command, the simulated host does not respond to a query message.

l If configured in Ethernet port view, this feature takes effect on the port only if the port belongs to the specified VLAN.

l If configured in port group view, this feature takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 1/0/1 as a simulated member host in VLAN 2 for multicast source 1.1.1.1 and multicast group 224.0.0.1.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping host-join 224.1.1.1 source-ip 1.1.1.1 vlan 2

1.1.15 igmp-snooping last-member-query-interval

Syntax

igmp-snooping last-member-query-interval interval

undo igmp-snooping last-member-query-interval

View

VLAN view

Parameters

interval: Interval between IGMP last-member queries, in units of seconds. The effective range is 1 to 5.

Description

Use the igmp-snooping last-member-query-interval command to configure the interval between IGMP last-member queries in the VLAN.

Use the undo igmp-snooping last-member-query-interval command to restore the default setting.

By default, the IGMP last-member query interval is 1 second.

This command takes effect only if IGMP Snooping is enabled in the VLAN.

Related commands: last-member-query-interval.

Examples

# Set the interval between IGMP last-member queries to 3 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping last-member-query-interval 3

1.1.16 igmp-snooping max-response-time

Syntax

igmp-snooping max-response-time interval

undo igmp-snooping max-response-time

View

VLAN view

Parameters

interval: Maximum response time to IGMP general queries, in units of seconds. The effective range is 1 to 25.

Description

Use the igmp-snooping max-response-time command to configure the maximum response time to IGMP general queries in the VLAN.

Use the undo igmp-snooping max-response-time command to restore the default setting.

By default, the maximum response time to IGMP general queries is 10 seconds.

This command takes effect only if IGMP Snooping is enabled in the VLAN.

Related commands: max-response-time, igmp-snooping query-interval.

Examples

# Set the maximum response time to IGMP general queries to 5 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping max-response-time 5

1.1.17 igmp-snooping overflow-replace

Syntax

igmp-snooping overflow-replace [ vlan vlan-list ]

undo igmp-snooping overflow-replace [ vlan vlan-list ]

View

Ethernet port view, port group view

Parameters

Description

Use the igmp-snooping overflow-replace command to enable the multicast group replacement function on the current port(s).

Use the undo igmp-snooping overflow-replace command to disable the multicast group replacement function on the current port(s).

By default, the multicast group replacement function is disabled.

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

Related commands: overflow-replace.

Examples

# Enable the multicast group replacement function on GigabitEthernet 1/0/1, which belongs to VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping overflow-replace vlan 2

1.1.18 igmp-snooping querier

Syntax

igmp-snooping querier

undo igmp-snooping querier

View

VLAN view

Parameters

None

Description

Use the igmp-snooping querier command to enable the IGMP Snooping querier function.

Use the undo igmp-snooping querier command to disable the IGMP Snooping querier function.

By default, the IGMP Snooping querier function is disabled.

This command takes effect only if IGMP Snooping is enabled in the VLAN.

Examples

# Enable the IGMP Snooping querier function in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping querier

1.1.19 igmp-snooping query-interval

Syntax

igmp-snooping query-interval interval

undo igmp-snooping query-interval

View

VLAN view

Parameters

interval: Interval between IGMP general queries, in units of seconds. The effective range is 2 to 300.

Description

Use the igmp-snooping query-interval command to configure the interval between IGMP general queries.

Use the undo igmp-snooping query-interval command to restore the default setting.

By default, the IGMP general query interval is 60 seconds.

This command takes effect only if IGMP Snooping is enabled in the VLAN.

Related commands: igmp-snooping querier, igmp-snooping max-response-time, max-response-time.

Examples

# Set the interval between IGMP general queries to 20 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping query-interval 20

1.1.20 igmp-snooping router-aging-time

Syntax

igmp-snooping router-aging-time interval

undo igmp-snooping router-aging-time

View

VLAN view

Parameters

interval: Router port aging time, in units of seconds. The effective range is 1 to 1,000.

Description

Use the igmp-snooping router-aging-time command to configure the aging time of router ports in the current VLAN.

Use the undo igmp-snooping router-aging-time command to restore the default setting.

By default, the aging time of router ports is 105 seconds.

This command takes effect only if IGMP Snooping is enabled in the VLAN.

Related commands: router-aging-time.

Examples

# Set the aging time of router ports to 100 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping router-aging-time 100

1.1.21 igmp-snooping source-deny

Syntax

igmp-snooping source-deny

undo igmp-snooping source-deny

View

Ethernet port view, port group view

Parameters

None

Description

Use the igmp-snooping source-deny command to enable multicast source port filtering.

Use the undo igmp-snooping source-deny command to disable multicast source port filtering.

By default, multicast source port filtering is disabled.

This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

Examples

# Enable source port filtering for multicast data on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping source-deny

1.1.22 igmp-snooping special-query source-ip

Syntax

igmp-snooping special-query source-ip { current-interface | ip-address }

undo igmp-snooping special-query source-ip

View

VLAN view

Parameters

current-interface: Sets the source address of IGMP group-specific queries to the address of the current VLAN interface. If the current VLAN interface does not have an IP address, the default IP address 0.0.0.0 will be used as the source IP address of IGMP group-specific queries.

ip-address: Sets the source address of IGMP group-specific queries to the specified address.

Description

Use the igmp-snooping special-query source-ip command to configure the source IP address of IGMP group-specific queries.

Use the undo igmp-snooping special-query source-ip command to restore the default configuration.

By default, the source IP address of IGMP group-specific queries is 0.0.0.0.

This command takes effect only if IGMP Snooping is enabled in the VLAN.

Examples

# Set the IP address of the interface of VLAN 2 to 10.1.1.1, with the subnet mask of 255.255.255.0, and specify this IP address as the source IP address of IGMP group-specific queries.

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] ip address 10.1.1.1 255.255.255.0

[Sysname-Vlan-interface2] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping special-query source-ip current-interface

1.1.23 igmp-snooping static-group

Syntax

igmp-snooping static-group group-address [ source-ip source-address ] vlan vlan-id

undo igmp-snooping static-group group-address [ source-ip source-address ] vlan vlan-id

View

Ethernet port view, port group view

Parameters

group-address: Address of the multicast group to be statically joined, in the range of 224.0.0.0 to 239.255.255.255.

source-address: Address of multicast source to be statically joined. The value of this argument should be a valid unicast address or 0.0.0.0. If the value is 0.0.0.0, this means no multicast source is specified.

vlan vlan-id: Specifies the VLAN that comprises the Ethernet port(s), where vlan-id is in the range of 1 to 4094.

Description

Use the igmp-snooping static-group command to enable the static (*, G) or (S, G) joining function, namely to configure the current port or port group as static multicast group or source-group member(s).

Use the undo igmp-snooping static-group command to disable the static (*, G) or (S, G) joining function.

By default, this function is disabled.

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

l The source-ip source-address option in the command is meaningful only for IGMP Snooping version 3. If IGMP Snooping version 2 is running, although you can include the source-ip source-address option in your command, the configuration will not take effect.

l If configured in Ethernet port view, this feature takes effect on the port only if the port belongs to the specified VLAN.

l If configured in port group view, this feature takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 1/0/1 in VLAN 2 to be a static member port for (1.1.1.1, 224.1.1.1).

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

[Sysname-vlan2] quit

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping static-group 224.1.1.1 source-ip 1.1.1.1 vlan 2

1.1.24 igmp-snooping static-router-port

Syntax

igmp-snooping static-router-port vlan vlan-id

undo igmp-snooping static-router-port vlan vlan-id

View

Ethernet port view, port group view

Parameters

vlan vlan-id: Specifies a VLAN in which one or more static router ports are to be configured, where vlan-id is in the range of 1 to 4094.

Description

Use the igmp-snooping static-router-port command to enable the static router port function.

Use the undo igmp-snooping static-router-port command to disable the static router port function.

By default, the static router port function is not enabled.

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

l If configured in Ethernet port view, this feature takes effect on the port only if the port belongs to the specified VLAN.

l If configured in port group view, this feature takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Enable the static router port function on GigabitEthernet 1/0/1, which belongs to VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] igmp-snooping static-router-port vlan 2

1.1.25 igmp-snooping version

Syntax

igmp-snooping version version-number

undo igmp-snooping version

View

VLAN view

Parameters

version-number: IGMP snooping version, in the range of 2 to 3.

Description

Use the igmp-snooping version command to configure the IGMP Snooping version.

Use the undo igmp-snooping version command to restore the default setting.

By default, the IGMP version is 2.

This command can take effect only if IGMP Snooping is enabled in the VLAN.

Related commands: igmp-snooping enable.

Examples

# Enable IGMP Snooping in VLAN 2, and set the IGMP Snooping version to version 3.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping enable

[Sysname-vlan2] igmp-snooping version 3

1.1.26 last-member-query-interval

Syntax

last-member-query-interval interval

undo last-member-query-interval

View

IGMP-Snooping view

Parameters

interval: Interval between IGMP last-member queries, in units of seconds. The effective range is 1 to 5.

Description

Use the last-member-query-interval command to configure the interval between IGMP last-member queries globally.

Use the undo last-member-query-interval command to restore the default setting.

By default, the interval between IGMP last-member queries is 1 second.

This command works only on IGMP Snooping–enabled VLANs, but not on VLANs with IGMP enabled on the corresponding VLAN interfaces.

Related commands: igmp-snooping last-member-query-interval.

Examples

# Set the interval between IGMP last-member queries globally to 3 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] last-member-query-interval 3

1.1.27 max-response-time

Syntax

max-response-time interval

undo max-response-time

View

IGMP-Snooping view

Parameters

interval: Maximum response time to IGMP general queries, in units of seconds. The effective range is 1 to 25.

Description

Use the max-response-time command to configure the maximum response time to IGMP general queries globally.

Use the undo max-response-time command to restore the default value.

This command works only on IGMP Snooping–enabled VLANs, but not on VLANs with IGMP enabled on the corresponding VLAN interfaces.

Related commands: igmp-snooping max-response-time, igmp-snooping query-interval.

Examples

# Set the maximum response time to IGMP general queries globally to 5 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] max-response-time 5

1.1.28 overflow-replace

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

View

IGMP-Snooping view

Parameters

Description

Use the overflow-replace command to enable the multicast group replacement function globally.

Use the undo overflow-replace command to disable the multicast group replacement function globally.

By default, the multicast group replacement function is disabled.

Note that:

l This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

l If you do not specify any VLAN, the command will take effect for all VLANs; if you specify a VLAN or multiple VLANs, the command will take effect for the specified VLAN(s) only.

Related commands: igmp-snooping overflow-replace.

Examples

# Enable the multicast group replacement function globally in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] overflow-replace vlan 2

1.1.29 report-aggregation

Syntax

report-aggregation

undo report-aggregation

View

IGMP-Snooping view

Parameters

None

Description

Use the report-aggregation command to enable IGMP report suppression.

Use the undo report-aggregation command to disable IGMP report suppression.

By default, IGMP report suppression is enabled.

This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

Examples

# Disable IGMP report suppression.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] undo report-aggregation

1.1.30 reset igmp-snooping group

Syntax

reset igmp-snooping group { group-address | all } [ vlan vlan-id ]

View

User view

Parameters

group-address: Address of the multicast group for which the IGMP Snooping forwarding entries are to be cleared. The value range is 224.0.1.0 to 239.255.255.255.

all: Specifies to clear all IGMP Snooping forwarding entries.

vlan vlan-id: Specifies a VLAN in which all IGMP Snooping forwarding entries are to be cleared, where vlan-id is in the range of 1 to 4094.

Description

Use the reset igmp-snooping group command to clear IGMP Snooping forwarding entries.

Note that:

l This command works only on IGMP Snooping–enabled VLANs, but not on VLANs with IGMP enabled on the corresponding VLAN interfaces.

l This command cannot clear IGMP Snooping forwarding entries of static joins.

Examples

# Clear all IGMP Snooping forwarding entries saved in the switch.

<Sysname> reset igmp-snooping group all

1.1.31 reset igmp-snooping statistics

Syntax

reset igmp-snooping statistics

View

User view

Parameters

None

Description

Use the reset igmp-snooping statistics command to clear the statistics information of IGMP messages learned by IGMP Snooping.

Examples

# Clear the statistics information of all kinds of IGMP messages learned by IGMP Snooping.

<Sysname> reset igmp-snooping statistics

1.1.32 router-aging-time

Syntax

router-aging-time interval

undo router-aging-time

View

IGMP-Snooping view

Parameters

interval: Router port aging time, in units of seconds. The effective range is 1 to 1,000.

Description

Use the router-aging-time command to configure the aging time of router ports globally.

Use the undo router-aging-time command to restore the default setting.

By default, the aging time of router ports is 105 seconds.

This command works only on IGMP Snooping–enabled VLANs, but not on VLANs with IGMP enabled on the corresponding VLAN interfaces.

Related commands: igmp-snooping router-aging-time.

Examples

# Set the aging time of router ports globally to 100 seconds.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] router-aging-time 100

1.1.33 source-deny

Syntax

source-deny port interface-list

undo source-deny port interface-list

View

IGMP-Snooping view

Parameters

interface-list: Ethernet port list. You can specify multiple Ethernet ports or port ranges by providing the this argument in the form of interface-list = { interface-type interface-number [ to interface-type interface-number ] }, where interface-type is port type and interface-number is port number.

Description

Use the source-deny command to enable multicast source port filtering so that all multicast data packets are blocked.

Use the undo source-deny command to disable multicast source port filtering.

By default, multicast source port filtering is not enabled.

This command works on IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

Examples

# Enable source port filtering for multicast data on interfaces GigabitEthernet 1/0/1 through GigabitEthernet 1/0/5.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] source-deny port GigabitEthernet1/0/1 to GigabitEthernet1/0/5

Chapter 2 MLD Snooping Configuration Commands

2.1 MLD Snooping Configuration Commands

2.1.1 display mld-snooping group

Syntax

display mld-snooping group [ vlan vlan-id ] [ verbose ]

View

Any view

Parameters

vlan vlan-id: Displays the IPv6 multicast group information in the specified VLAN, where vlan-id is in the range of 1 to 4094. If you do not specify a VLAN, this command will display the information of IPv6 multicast groups in all VLANs.

verbose: Displays the detailed IPv6 multicast group information.

Description

Use the display mld-snooping group command to view the IPv6 multicast group information learned by MLD Snooping.

Examples

# View the detailed information of IPv6 multicast groups in VLAN 2 learned by MLD Snooping.

<Sysname> display mld-snooping group vlan 2 verbose

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Port flags: D-Dynamic port, S-Static port, A-Aggregation port, C-Copy port

Subvlan flags: R-Real VLAN, C-Copy VLAN

Vlan(id):2.

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Router port(s):total 1 port.

GE1/0/2 (D) ( 00:01:30 )

IP group(s):the following ip group(s) match to one mac group.

IP group address:FF1E::101

(::, FF1E::101):

Attribute: Host Port

Host port(s):total 1 port.

GE1/0/1 (D) ( 00:03:23 )

MAC group(s):

MAC group address:3333-0000-0101

Host port(s):total 1 port.

GE1/0/1

Table 2-1 Description on the fields of the display mld-snooping group command

Field	Description
Total 1 IP Group(s).	Total number of IPv6 multicast groups
Total 1 IP Source(s).	Total number of IPv6 multicast sources
Total 1 MAC Group(s).	Total number of MAC multicast groups
Port flags: D-Dynamic port, S-Static port, A-Aggregation port, C-Copy port	Port flags: D for dynamic port, S for static port, A for aggregation port, C for port copied from a (*, G) entry to an (S, G) entry
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: R for real egress sub-VLAN under the current entry, C for sub-VLAN copied from a (*, G) entry to an (S, G) entry
Router port(s)	Number of router ports
IP group address	Address of IPv6 multicast group
MAC group address	Address of MAC multicast group
Attribute	Attribute of IPv6 multicast group
Host port(s)	Number of host member ports

2.1.2 display mld-snooping statistics

Syntax

display mld-snooping statistics

View

Any view

Parameters

None

Description

Use the display mld-snooping statistics command to view the statistics information of MLD messages learned by MLD Snooping.

Examples

# View the statistics information of all kinds of MLD messages learned by MLD Snooping.

<Sysname> display mld-snooping statistics

Received MLD general queries:0.

Received MLDv1 specific queries:0.

Received MLDv1 reports:0.

Received MLD dones:0.

Sent MLDv1 specific queries:0.

Received MLDv2 reports:0.

Received MLDv2 reports with right and wrong records:0.

Received MLDv2 specific queries:0.

Received MLDv2 specific sg queries:0.

Sent MLDv2 specific queries:0.

Sent MLDv2 specific sg queries:0.

Received error MLD messages:0.

Table 2-2 Description on the fields of the display mld-snooping statistics command

Field	Description
general queries	General query messages
specific queries	Group-specific query messages
reports	Report messages
dones	Done messages
reports with right and wrong records	Reports containing correct and incorrect records
specific sg queries	Source-and-group-specific queries
error MLD messages	Error MLD messages

2.1.3 fast-leave

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

View

MLD-Snooping view

Parameters

Description

Use the fast-leave command to enable fast leave processing globally.

Use the undo fast-leave command to disable fast leave processing globally.

By default, fast leave processing is disabled globally.

Note that:

l If you do not specify any VLAN, the command will take effect for all VLANs; if you specify a VLAN or multiple VLANs, the command will take effect for the specified VLAN(s) only.

Related commands: mld-snooping fast-leave.

Examples

# Enable fast leave processing globally in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] fast-leave vlan 2

2.1.4 group-policy

Syntax

group-policy acl6-number [ vlan vlan-list ]

undo group-policy [ vlan vlan-list ]

View

MLD-Snooping view

Parameters

Acl6-number: Basic IPv6 ACL number, in the range of 2000 to 2999.

Description

Use the group-policy command to configure a global IPv6 multicast group filter.

Use the undo group-policy command to remove the configured global IPv6 multicast group filter.

By default, no IPv6 multicast group filter is configured globally, namely any host can join any IPv6 multicast group.

Note that:

l If you do not specify any VLAN, the command will take effect for all VLANs; if you specify a VLAN or multiple VLANs, the command will take effect for the specified VLAN(s) only.

l If the specified IPv6 ACL does not exist or the ACL rule is null, all IPv6 multicast groups will be filtered out.

l You can configure different IPv6 ACL rules for each port in different VLANs; for a given VLAN, a newly configured IPv6 ACL rule will override the existing one.

Related commands: mld-snooping group-policy.

Examples

# Configure ACL 2000 as the IPv6 multicast group filter in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] group-policy 2000 vlan 2

2.1.5 host-aging-time

Syntax

host-aging-time interval

undo host-aging-time

View

MLD-Snooping view

Parameters

interval: Member port aging time, in units of seconds. The effective range is 200 to 1,000.

Description

Use the host-aging-time command to configure the global aging time of group member ports.

Use the undo host-aging-time command to restore the default setting.

By default, the aging time of member ports is 260 seconds.

Related commands: mld-snooping host-aging-time.

Examples

# Set the aging time of group member ports globally to 300 seconds.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] host-aging-time 300

2.1.6 last-listener-query-interval

Syntax

last-listener-query-interval interval

undo last-listener-query-interval

View

MLD-Snooping view

Parameters

interval: MLD last listener query interval in units of seconds, namely the length of time the device waits between sending MLD multicast-address-specific queries. The effective range is 1 to 5.

Description

Use the last-listener-query-interval command to configure the MLD last listener query interval globally.

Use the undo last-listener-query-interval command to restore the system default.

By default, the MLD last listener query interval is 1 second.

Related commands: mld-snooping last-listener-query-interval.

Examples

# Set the MLD last listener query interval to 3 seconds globally.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] last-listener-query-interval 3

2.1.7 max-response-time

Syntax

max-response-time interval

undo max-response-time

View

MLD-Snooping view

Parameters

interval: Maximum response time for MLD general queries, in units of seconds. The effective range is 1 to 25.

Description

Use the max-response-time command to configure the maximum response time for MLD general queries globally.

Use the undo max-response-time command to restore the system default.

By default, the maximum response time for MLD general queries is 10 seconds.

Related commands: mld-snooping max-response-time, mld-snooping query-interval.

Examples

# Set the maximum response time for MLD general queries globally to 5 seconds.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] max-response-time 5

2.1.8 mld-snooping

Syntax

mld-snooping

undo mld-snooping

View

System view

Parameters

None

Description

Use the mld-snooping command to enable MLD Snooping globally and enter MLD-Snooping view.

Use the undo mld-snooping command to disable MLD Snooping globally.

By default, MLD Snooping is disabled.

Related commands: mld-snooping enable.

Examples

# Enable MLD Snooping globally and enter MLD-Snooping view.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping]

2.1.9 mld-snooping drop-unknown

Syntax

mld-snooping drop-unknown

undo mld-snooping drop-unknown

View

VLAN view

Parameters

None

Description

Use the mld-snooping drop-unknown command to enable dropping unknown IPv6 multicast data in the current VLAN.

Use the undo mld-snooping drop-unknown command to disable dropping unknown IPv6 multicast data in the current VLAN.

By default, this function is disabled, unknown IPv6 multicast data is flooded in the VLAN.

This command takes effect only if MLD Snooping is enabled in the VLAN.

Examples

# Enable dropping unknown IPv6 multicast data in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping drop-unknown

2.1.10 mld-snooping enable

Syntax

mld-snooping enable

undo mld-snooping enable

View

VLAN view

Parameters

None

Description

Use the mld-snooping enable command to enable MLD Snooping in the current VLAN.

Use the undo mld-snooping enable command to disable MLD Snooping in the current VLAN.

By default, MLD Snooping is disabled in a VLAN.

MLD Snooping must be enabled globally before it can be enabled in a VLAN

Related commands: mld-snooping.

Examples

# Enable MLD Snooping in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

2.1.11 mld-snooping fast-leave

Syntax

mld-snooping fast-leave [ vlan vlan-list ]

undo mld-snooping fast-leave [ vlan vlan-list ]

View

Ethernet port view, port group view

Parameters

Description

Use the mld-snooping fast-leave command to enable fast leave processing on the current port or group of ports.

Use the undo mld-snooping fast-leave command to disable fast leave processing on the current port or group of ports.

By default, fast leave processing is disabled.

Note that:

l If you do not specify any VLAN when you use this command in port group view, the command will take effect for all the ports in this group no matter which VLANs these port belong to; if you specify a VLAN or multiple VLANs, the command will take effect for those ports in this group that belong to the specified VLAN(s).

Related commands: fast-leave.

Examples

# Enable fast leave processing on GigabitEthernet 1/0/1, which belongs to VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping fast-leave vlan 2

2.1.12 mld-snooping general-query source-ip

Syntax

mld-snooping general-query source-ip { current-interface | ipv6-address }

undo mld-snooping general-query source-ip

View

VLAN view

Parameters

current-interface: Sets the source IPv6 link-local address of MLD general queries to the IPv6 address of the current VLAN interface. If the current VLAN interface does not have an IPv6 address, the default IPv6 address FE80::02FF:FFFF:FE00:0001 will be used as the source IPv6 address of MLD general queries.

ipv6-address: Specifies the source IPv6 address of MLD general queries, which can be any legal IPv6 link-local address.

Description

Use the mld-snooping general-query source-ip command to configure the source IPv6 address of MLD general queries.

Use the undo mld-snooping general-query source-ip command to restore the default configuration.

By default, the source IPv6 address of MLD general queries is FE80::02FF:FFFF:FE00:0001.

This command takes effect only if MLD Snooping is enabled in the VLAN.

Examples

# In VLAN 2, specify FE80:0:0:1::1 as the source IPv6 address of MLD general queries.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping general-query source-ip fe80:0:0:1::1

2.1.13 mld-snooping group-limit

Syntax

mld-snooping group-limit limit [ vlan vlan-list ]

undo mld-snooping group-limit [ vlan vlan-list ]

View

Ethernet port view, port group view

Parameters

limit: Maximum number of IPv6 multicast groups that can be joined on a port. The effective range is 1 to 512.

Description

Use the mld-snooping group-limit command to configure the maximum number of IPv6 multicast groups that can be joined on a port.

Use the undo mld-snooping group-limit command to restore the default setting.

By default, the default setting is 512.

Note that:

l If you do not specify any VLAN in Ethernet port view, the command will take effect for the port no matter which VLAN the port belongs to; if you specify a VLAN or multiple VLANs, the command will take effect for the port only if the port belongs to the specified VLAN(s).

l If you do not specify any VLAN in port group view, the command will take effect for all the ports in this group no matter which VLANs these ports belong to; if you specify a VLAN or multiple VLANs, the command will take effect for those ports in this group that belong to the specified VLAN(s).

Examples

# Specify to allow a maximum of 10 IPv6 multicast groups that can be joined on GigabitEthernet 1/0/1 in VLAN 2. GigabitEthernet 1/0/1 belongs to VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping group-limit 10 vlan 2

2.1.14 mld-snooping group-policy

Syntax

mld-snooping group-policy acl6-number [ vlan vlan-list ]

undo mld-snooping group-policy [ vlan vlan-list ]

View

Ethernet port view, port group view

Parameters

acl6-number: Basic IPv6 ACL number, in the range of 2000 to 2999.

Description

Use the mld-snooping group-policy command to configure an IPv6 multicast group filter on the current port(s).

Use the undo mld-snooping group-policy command to remove the configured IPv6 multicast group filter on the current port(s).

By default, no IPv6 multicast group filter is configured on a port, namely a host can join any IPv6 multicast group.

Note that:

l If you do not specify any VLAN in port group view, the command will take effect for all the ports in this group no matter which VLANs these port belong to; if you specify a VLAN or multiple VLANs, the command will take effect for those ports in this group that belong to the specified VLAN(s).

l If the specified ACL does not exist or the ACL rule is null, all IPv6 multicast groups will be filtered out.

l You can configure different IPv6 ACL rules for each port in different VLANs; for a given VLAN, a newly configured IPv6 ACL rule will override the existing one.

Related commands: group-policy.

Examples

# Configure ACL 2000 as the IPv6 multicast group filter on GigabitEthernet 1/0/1, which belongs to VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping group-policy 2000 vlan 2

2.1.15 mld-snooping host-aging-time

Syntax

mld-snooping host-aging-time interval

undo mld-snooping host-aging-time

View

VLAN view

Parameters

interval: Member port aging time, in units of seconds. The effective range is 200 to 1,000.

Description

Use the mld-snooping host-aging-time command to configure the aging time of group member ports in the current VLAN.

Use the undo mld-snooping host-aging-time command to restore the system default.

By default, the member port aging time is 260 seconds.

This command takes effect only if MLD Snooping is enabled in the VLAN.

Related commands: host-aging-time.

Examples

# Set the aging time of group member ports to 300 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping host-aging-time 300

2.1.16 mld-snooping host-join

Syntax

mld-snooping host-join ipv6-group-address [ source-ip ipv6-source-address ] vlan vlan-id

undo mld-snooping host-join ipv6-group-address [ source-ip ipv6-source-address ] vlan vlan-id

View

Ethernet port view, port group view

Parameters

ipv6-group-address: Address of IPv6 multicast group which the simulated host is to join. The effective range is FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16 and FF0y::), where x and y represent any hexadecimal number between 0 and F, inclusive.

ipv6-source-address: Address of the IPv6 multicast source that the simulated host is to join.

vlan vlan-id: Specifies a VLAN that comprises the Ethernet port(s), where vlan-id is in the range of 1 to 4094.

Description

Use the mld-snooping host-join command to enable the simulated IPv6 (*, G) or (S, G) joining function, namely to configure the current port or port group as simulated IPv6 multicast group or source-group member(s).

Use the undo mld-snooping host-join command to disable the simulated IPv6 (*, G) or (S, G) joining function.

By default, this function is disabled.

Note that:

l The source-ip ipv6-source-address option in the command is meaningful only for MLD Snooping version 2. If MLD Snooping version 1 is running, although you can include source-ip ipv6-source-address in your command, the simulated host responses with only an MLDv1 report when receiving a query message.

l If configured in Ethernet port view, this feature takes effect on the port only if the port belongs to the specified VLAN.

l If configured in port group view, this feature takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 1/0/1 in VLAN 2 to join (2002::22, FF1E::101) as a simulated host.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping version 2

[Sysname-vlan2] quit

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping host-join ff1e::101 source-ip 2002::22 vlan 2

2.1.17 mld-snooping last-listener-query-interval

Syntax

mld-snooping last-listener-query-interval interval

undo mld-snooping last-listener-query-interval

View

VLAN view

Parameters

interval: MLD last listener query interval in units of seconds, namely the length of time the device waits between sending IGMP multicast-address-specific queries. The effective range is 1 to 5.

Description

Use the mld-snooping last-listener-query-interval command to configure the MLD last-listener query interval in the VLAN.

Use the undo mld-snooping last-listener-query-interval command to restore the system default.

By default, the MLD last listener query interval is 1 second.

This command takes effect only if MLD Snooping is enabled in the VLAN.

Related commands: last-listener-query-interval.

Examples

# Set the MLD last-listener query interval to 3 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping last-listener-query-interval 3

2.1.18 mld-snooping max-response-time

Syntax

mld-snooping max-response-time interval

undo mld-snooping max-response-time

View

VLAN view

Parameters

interval: Maximum response time for MLD general queries, in units of seconds. The effective range is 1 to 25.

Description

Use the mld-snooping max-response-time command to configure the maximum response time for MLD general queries in the VLAN.

Use the undo mld-snooping max-response-time command to restore the default setting.

By default, the maximum response time for MLD general queries is 10 seconds.

This command takes effect only if MLD Snooping is enabled in the VLAN.

Related commands: max-response-time, mld-snooping query-interval.

Examples

# Set the maximum response time for MLD general queries to 5 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping max-response-time 5

2.1.19 mld-snooping overflow-replace

Syntax

mld-snooping overflow-replace [ vlan vlan-list ]

undo mld-snooping overflow-replace [ vlan vlan-list ]

View

Ethernet port view, port group view

Parameters

Description

Use the mld-snooping overflow-replace command to enable the IPv6 multicast group replacement function on the current port(s).

Use the undo mld-snooping overflow-replace command to disable the IPv6 multicast group replacement function on the current port(s).

By default, the IPv6 multicast group replacement function is disabled.

Note that:

Related commands: overflow-replace.

Examples

# Enable the IPv6 multicast group replacement function on GigabitEthernet 1/0/1, which belongs to VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping overflow-replace vlan 2

2.1.20 mld-snooping querier

Syntax

mld-snooping querier

undo mld-snooping querier

View

VLAN view

Parameters

None

Description

Use the mld-snooping querier command to enable the MLD Snooping querier function.

Use the undo mld-snooping querier command to disable the MLD Snooping querier function.

By default, the MLD Snooping querier function is disabled.

This command takes effect only if MLD Snooping is enabled in the VLAN.

Examples

# Enable the MLD Snooping querier function in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping querier

2.1.21 mld-snooping query-interval

Syntax

mld-snooping query-interval interval

undo mld-snooping query-interval

View

VLAN view

Parameters

interval: MLD query interval in seconds, namely the length of time the device waits between sending MLD general queries. The effective range is 2 to 300.

Description

Use the mld-snooping query-interval command to configure the MLD query interval.

Use the undo mld-snooping query-interval command to restore the system default.

By default, the MLD query interval is 125 seconds.

This command takes effect only if MLD Snooping is enabled in the VLAN.

Related commands: mld-snooping querier, mld-snooping max-response-time, max-response-time.

Examples

# Set the MLD query interval to 20 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping query-interval 20

2.1.22 mld-snooping router-aging-time

Syntax

mld-snooping router-aging-time interval

undo mld-snooping router-aging-time

View

VLAN view

Parameters

interval: Router port aging time, in units of seconds. The effective range is 1 to 1,000.

Description

Use the mld-snooping router-aging-time command to configure the aging time of router ports in the current VLAN.

Use the undo mld-snooping router-aging-time command to restore the default setting.

By default, the router port aging time is 260 seconds.

This command takes effect only if MLD Snooping is enabled in the VLAN.

Related commands: router-aging-time.

Examples

# Set the aging time of router ports to 100 seconds in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping router-aging-time 100

2.1.23 mld-snooping source-deny

Syntax

mld-snooping source-deny

undo mld-snooping source-deny

View

Ethernet port view, port group view

Parameters

None

Description

Use the mld-snooping source-deny command to enable IPv6 multicast source port filtering.

Use the undo mld-snooping source-deny command to disable IPv6 multicast source port filtering.

By default, IPv6 multicast source port filtering is disabled.

Examples

# Enable source port filtering for IPv6 multicast data on GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping source-deny

2.1.24 mld-snooping special-query source-ip

Syntax

mld-snooping special-query source-ip { current-interface | ipv6-address }

undo mld-snooping special-query source-ip

View

VLAN view

Parameters

current-interface: Specifies the source IPv6 link-local address of the VLAN interface of the current VLAN as the source IPv6 address of MLD multicast-address-specific queries. If the current VLAN interface does not have an IPv6 address, the default IPv6 address FE80::02FF:FFFF:FE00:0001 will be used as the source IPv6 address of MLD multicast-address-specific queries.

ipv6-address: Specifies an IPv6 link-local address as the source IPv6 address of MLD multicast-address-specific queries.

Description

Use the mld-snooping special-query source-ip command to configure the source IPv6 address of MLD multicast-address-specific queries.

Use the undo mld-snooping special-query source-ip command to restore the default configuration.

By default, the source IPv6 address of MLD multicast-address-specific queries is FE80::02FF:FFFF:FE00:0001.

This command takes effect only if MLD Snooping is enabled in the VLAN.

Examples

# In VLAN 2, specify FE80:0:0:1::1 as the source IPv6 address of MLD multicast-address-specific queries.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping special-query source-ip fe80:0:0:1::1

2.1.25 mld-snooping static-group

Syntax

mld-snooping static-group ipv6-group-address [ source-ip ipv6-source-address ] vlan vlan-id

undo mld-snooping static-group ipv6-group-address [ source-ip ipv6-source-address ] vlan vlan-id

View

Ethernet port view, port group view

Parameters

ipv6-group-address: Address of a IPv6 multicast group the port(s) will be configured to join as static member port(s). The effective range is FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16 and FF0y::), where x and y represent any hexadecimal number between 0 and F, inclusive.

ipv6-source-address: Address of the IPv6 multicast source the port(s) will be configured to join as static member port(s).

vlan vlan-id: Specifies the VLAN that comprises the Ethernet port(s), where vlan-id is in the range of 1 to 4094.

Description

Use the mld-snooping static-group command to enable the static IPv6 (*, G) or (S, G) joining function, namely to configure the port or port group as static IPv6 multicast group or source-group member(s).

Use the undo mld-snooping static-group command to disable the static member port function.

By default, the static member port function is disabled.

Note that:

l If configured in Ethernet port view, this feature takes effect on the port only if the port belongs to the specified VLAN.

l If configured in port group view, this feature takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Configure GigabitEthernet 1/0/1 in VLAN 2, to be a static member port for (2002::22, FF1E::101).

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping version 2

[Sysname-vlan2] quit

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping static-group ff1e::101 source-ip 2002::22 vlan 2

2.1.26 mld-snooping static-router-port

Syntax

mld-snooping static-router-port vlan vlan-id

undo mld-snooping static-router-port vlan vlan-id

View

Ethernet port view, port group view

Parameters

vlan vlan-id: Specifies a VLAN in which one or more static router ports are to be configured, where vlan-id is in the range of 1 to 4094.

Description

Use the mld-snooping static-router-port command to enable the static router port function.

Use the undo mld-snooping static-router-port command to disable the static router port function.

By default, the static router port function is disabled.

Note that:

l If configured in Ethernet port view, this feature takes effect on the port only if the port belongs to the specified VLAN.

l If configured in port group view, this feature takes effect only on those ports in this port group that belong to the specified VLAN.

Examples

# Enable the static router port function on GigabitEthernet 1/0/1, which belongs to VLAN 2.

<Sysname> system-view

[Sysname] interface GigabitEthernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mld-snooping static-router-port vlan 2

2.1.27 mld-snooping version

Syntax

mld-snooping version version-number

undo mld-snooping version

View

VLAN view

Parameters

version-number: MLD snooping version, in the range of 2 to 3.

Description

Use the mld-snooping version command to configure the MLD Snooping version.

Use the undo mld-snooping version command to restore the default setting.

By default, the MLD version is 1.

This command can take effect only if MLD Snooping is enabled in the VLAN.

Related commands: mld-snooping enable.

Examples

# Enable MLD Snooping in VLAN 2, and set the MLD Snooping version to version 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] quit

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping enable

[Sysname-vlan2] mld-snooping version 2

2.1.28 overflow-replace

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

View

MLD-Snooping view

Parameters

Description

Use the overflow-replace command to enable the IPv6 multicast group replacement function globally.

Use the undo overflow-replace command to disable the IPv6 multicast group replacement function globally.

By default, the IPv6 multicast group replacement function is disabled globally.

Note that:

If you do not specify any VLAN, the command will take effect for all VLANs; if you specify a VLAN or multiple VLANs, the command will take effect for the specified VLAN(s) only.

Related commands: mld-snooping overflow-replace.

Examples

# Enable the IPv6 multicast group replacement function globally in VLAN 2.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] overflow-replace vlan 2

2.1.29 report-aggregation

Syntax

report-aggregation

undo report-aggregation

View

MLD-Snooping view

Parameters

None

Description

Use the mld-snooping report-aggregation command to enable MLD report suppression.

Use the undo mld-snooping report-aggregation command to disable MLD report suppression.

By default, MLD report suppression is enabled.

Examples

# Disable MLD report suppression.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] undo mld-snooping report-aggregation

2.1.30 reset mld-snooping group

Syntax

reset mld-snooping group { ipv6-group-address | all } [ vlan vlan-id ]

View

User view

Parameters

ipv6-group-address: Address of the IPv6 multicast group of which the MLD Snooping forwarding entries are to be cleared. The effective range is FFxy::/16 (excluding FFx0::/16, FFx1::/16, FFx2::/16 and FF0y::), where x and y represent any hexadecimal number between 0 and F, inclusive.

all: Specifies to clear all MLD Snooping entries.

vlan vlan-id: Specifies a VLAN in which all MLD Snooping entries are to be cleared, where vlan-id is in the range of 1 to 4094.

Description

Use the reset mld-snooping group command to clear MLD Snooping entries.

Note that:

This command cannot clear MLD Snooping entries of static joins.

Examples

# Clear all MLD Snooping entries saved in the switch.

<Sysname> reset mld-snooping group all

2.1.31 reset mld-snooping statistics

Syntax

reset mld-snooping statistics

View

User view

Parameters

None

Description

Use the reset mld-snooping statistics command to clear the statistics information of MLD messages learned by MLD Snooping.

Examples

# Clear the statistics information of all kinds of MLD messages learned by MLD Snooping.

<Sysname> reset mld-snooping statistics

2.1.32 router-aging-time

Syntax

router-aging-time interval

undo router-aging-time

View

MLD-Snooping view

Parameters

interval: Router port aging time, in units of seconds. The effective range is 1 to 1,000.

Description

Use the router-aging-time command to configure the aging time of router ports globally.

Use the undo router-aging-time command to restore the default setting.

By default, the router port aging time is 260 seconds.

Related commands: mld-snooping router-aging-time.

Examples

# Set the aging time of router ports globally to 100 seconds.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] router-aging-time 100

2.1.33 source-deny

Syntax

source-deny port interface-list

undo source-deny port interface-list

View

MLD-Snooping view

Parameters

Description

Use the source-deny command to enable IPv6 multicast source port filtering, namely to filter out all the received IPv6 multicast packets.

Use the undo source-deny command to disable IPv6 multicast source port filtering.

By default, IPv6 multicast source port filtering is disabled.

Examples

# Enable source port filtering for IPv6 multicast data on interfaces GigabitEthernet 1/0/1 through GigabitEthernet 1/0/5.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping] source-deny port GigabitEthernet 1/0/1 to GigabitEthernet1/0/5

Chapter 3 Multicast VLAN Configuration Commands

3.1 Multicast VLAN Configuration Commands

3.1.1 display multicast-vlan

Syntax

display multicast-vlan [ vlan-id ]

View

Any view

Parameters

vlan-id: VLAN ID of a multicast VLAN, in the range of 1 to 4094. If this argument is not provided, the information about all multicast VLANs and their sub-VLANs will be displayed.

Description

Use the display multicast-vlan command to view the information about the specified multicast VLAN and its sub-VLANs.

Examples

# View the information about all multicast VLANs and their sub-VLANs.

<Sysname> display multicast-vlan

multicast vlan 100's subvlan list:

vlan 2 4-8

3.1.2 multicast-vlan enable

Syntax

multicast-vlan vlan-id enable

undo multicast-vlan vlan-id enable

View

System view

Parameters

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

Description

Use the multicast-vlan enable command to configure the specified VLAN as a multicast VLAN.

Use the undo multicast-vlan enable command to remove the specified VLAN as a multicast VLAN.

No VLAN is a multicast VLAN by default.

Note that:

l The specified VLAN must exist.

l The multicast VLAN feature cannot be enabled on a device with IP multicast routing enabled.

l After a VLAN is configured into a multicast VLAN, IGMP Snooping must be enabled in the VLAN before the multicast VLAN feature can be implemented, while it is not necessary to enable IGMP Snooping in the sub-VLANs of the multicast VLAN.

Examples

# Configure VLAN 100 as a multicast VLAN.

<Sysname> system-view

[Sysname] multicast-vlan 100 enable

3.1.3 multicast-vlan subvlan

Syntax

multicast-vlan vlan-id subvlan vlan-list

undo multicast-vlan vlan-id subvlan vlan-list

View

System view

Parameters

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

subvlan vlan-list: Defines one or multiple VLANs as sub-VLANs. You can provide up to 10 VLAN lists, by each of which you can specify an individual VLAN in the form of vlan-id, or a VLAN range in the form of start-vlan-id to end-vlan-id, where the end VLAN ID must be greater than the start VLAN ID. The effective range of a VLAN ID is 1 to 4094.

Description

Use the multicast-vlan subvlan command to configure sub-VLAN(s) for the specified multicast VLAN.

Use the undo multicast-vlan subvlan command to remove the specified sub-VLAN(s) from the specified multicast VLAN.

A multicast VLAN has no sub-VLANs by default.

Note that:

l The VLAN to be configured as the multicast VLAN and the VLANs to be configured as sub-VLANs of the multicast VLAN must exist.

l The number of sub-VLANs of the multicast VLAN must not exceed the system-defined limit (an S5500-EI series Ethernet switch supports a maximum of one multicast VLAN and 127 sub-VLANs).

Examples

# Configure VLAN 10 through VLAN 15 as sub-VLANs of multicast VLAN 100.

<Sysname> system-view

[Sysname] multicast-vlan 100 subvlan 10 to 15

Chapter 4 IPv6 Multicast VLAN Configuration Commands

4.1 IPv6 Multicast VLAN Configuration Commands

4.1.1 display multicast-vlan ipv6

Syntax

display multicast-vlan ipv6 [ vlan-id ]

View

Any view

Parameters

vlan-id: VLAN ID of an IPv6 multicast VLAN, in the range of 1 to 4094. If this argument is not provided, the information about all IPv6 multicast VLANs and their sub-VLANs will be displayed.

Description

Use the display multicast-vlan ipv6 command to view the information about the specified IPv6 multicast VLAN and its sub-VLANs.

Examples

# View the information about all IPv6 multicast VLANs and their sub-VLANs.

<Sysname> display multicast-vlan ipv6

IPv6 multicast vlan 100's subvlan list:

vlan 2 4-8

4.1.2 multicast-vlan ipv6 enable

Syntax

multicast-vlan ipv6 vlan-id enable

undo multicast-vlan ipv6 vlan-id enable

View

System view

Parameters

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

Description

Use the multicast-vlan ipv6 enable command to configure the specified VLAN as an IPv6 multicast VLAN.

Use the undo multicast-vlan ipv6 enable command to remove the specified VLAN as an IPv6 multicast VLAN.

By default, no VLAN is an IPv6 multicast VLAN.

Note that:

l The specified VLAN must exist.

l You cannot enable IPv6 multicast VLAN on a device with IPv6 multicast routing enabled.

l After a VLAN is configured into an IPv6 multicast VLAN, MLD Snooping must be enabled in the VLAN before the IPv6 multicast VLAN feature can be implemented, while it is not necessary to enable MLD Snooping in the sub-VLANs of the IPv6 multicast VLAN.

Examples

# Configure VLAN 100 as an IPv6 multicast VLAN.

<Sysname> system-view

[Sysname] multicast-vlan ipv6 100 enable

4.1.3 multicast-vlan ipv6 subvlan

Syntax

multicast-vlan ipv6 vlan-id subvlan vlan-list

undo multicast-vlan ipv6 vlan-id subvlan vlan-list

View

System view

Parameters

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

Description

Use the multicast-vlan ipv6 subvlan command to configure sub-VLAN(s) for the specified IPv6 multicast VLAN.

Use the undo multicast-vlan ipv6 subvlan command to remove the specified sub-VLAN(s) from the specified IPv6 multicast VLAN.

By default, an IPv6 multicast VLAN has no sub-VLANs.

Note that:

l The VLAN to be configured as an IPv6 multicast VLAN and the VLANs to be configured as sub-VLANs of the IPv6 multicast VLAN must exist.

l The total number of sub VLANs of an IPv6 multicast VLAN must not exceed the system-defined limit (an S5500-EI series Ethernet switch supports a maximum of one multicast VLAN and 127 sub-VLANs).

Examples

# Configure VLANs 10 through 15 as sub-VLANs of IPv6 multicast VLAN 100.

<Sysname> system-view

[Sysname] multicast-vlan ipv6 100 subvlan 10 to 15

Chapter 5 IGMP Configuration Commands

& Note:

The term “router” in this document refers to a router in a generic sense or a Layer 3 switch running IGMP.

5.1 IGMP Configuration Commands

5.1.1 display igmp group

Syntax

display igmp group [ group-address | interface interface-type interface-number ] [ static | verbose ]

View

Any view

Parameters

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

interface interface-type interface-number: Displays the IGMP multicast group information about a particular interface.

static: Displays the information of statically joined IGMP multicast groups

verbose: Displays the detailed information of IGMP multicast groups.

Description

Use the display igmp group command to view IGMP multicast group information.

Note that:

l If you do not specify group-address, this command will display the IGMP information of all the multicast groups.

l If you do not specify interface-type interface-number, this command will display the IGMP multicast group information on all the interfaces.

l If you do not specify the static keyword, this command will display the detailed information about the dynamically joined IGMP multicast groups.

Examples

# Display the information about dynamically joined IGMP multicast groups on all interfaces.

<Sysname> display igmp group

Total 3 IGMP Group(s).

Interface group report information

Vlan-interface1 (20.20.20.20):

Total 3 IGMP Groups reported

Group Address Last Reporter Uptime Expires

225.1.1.1 20.20.20.20 00:02:04 00:01:15

225.1.1.3 20.20.20.20 00:02:04 00:01:15

225.1.1.2 20.20.20.20 00:02:04 00:01:17

# Display the detailed information of multicast group 225.1.1.1.

<Sysname> display igmp group 225.1.1.1 verbose

Interface group report information

Vlan-interface1 (10.10.1.20):

Total 3 IGMP Groups reported

Group: 225.1.1.1

Uptime: 00:00:34

Expires: 00:00:40

Last reporter: 20.20.20.20

Last-member-query-counter: 0

Last-member-query-timer-expiry: off

Version1-host-present-timer-expiry: off

Table 5-1 Description on the fields of the display igmp group command

Field	Description
Group	Multicast group address
Uptime	Length of time since the multicast group was joined
Expires	Remaining time of the multicast group
Last reporter	Address of the last host that reported its membership for this multicast group
Last-member-query-counter	Number of group-specific queries sent
Last-member-query-timer-expiry	Remaining time of the last member query timer
Version1-host-present-timer-expiry	Remaining time of the IGMPv1 host present timer

5.1.2 display igmp group port-info

Syntax

display igmp group port-info [ vlan vlan-id ] [ verbose ]

View

Any view

Parameters

vlan-id: VLAN ID, in the range of 1 to 4094. If you do not specify a VLAN, this command will display the information of Layer 2 ports in all VLANs.

verbose: Displays the detailed information about Layer 2 ports.

Description

Use the display igmp group port-info command to view IGMP Layer 2 port information.

Examples

# View detailed information of IGMP Layer 2 ports.

<Sysname> display igmp group port-info verbose

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Port flags: D-Dynamic port, S-Static port, A-Aggregation port, C-Copy port

Subvlan flags: R-Real VLAN, C-Copy VLAN

Vlan(id):2.

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Router port(s):total 1 port.

GE1/0/2 (D) ( 00:01:30 )

IP group(s):the following ip group(s) match to one mac group.

IP group address:224.1.1.1

(1.1.1.1, 224.1.1.1):

Attribute: Host Port

Host port(s):total 1 port.

GE1/0/1 (D) ( 00:03:23 )

MAC group(s):

MAC group address:0100-5e01-0101

Host port(s):total 1 port.

Eth1/0

Table 5-2 Description on the fields of the display igmp group port-info command

Field	Description
Total1 IP Group(s).	Total number of IP multicast groups
Total 1 IP Source(s).	Total number of IP multicast sources
Total 1 MAC Group(s).	Total number of MAC multicast groups
Port flags: D-Dynamic port, S-Static port, A-Aggregation port, C-Copy port	Port flags: D for dynamic port, S for static port, A for aggregation port, C for port copied from a (*, G) entry to an (S, G) entry
Subvlan flags: R-Real VLAN, C-Copy VLAN	Sub-VLAN flags: R for real egress sub-VLAN under the current entry, C for sub-VLAN copied from a (*, G) entry to an (S, G) entry
Router port(s)	Number of router ports
IP group address	Address of IP multicast group
MAC group address	Address of MAC multicast group
Attribute	Attribute of IP multicast group
Host port(s)	Number of host member ports

5.1.3 display igmp interface

Syntax

display igmp interface [ interface-type interface-number ] [ verbose ]

View

Any view

Parameters

interface-type interface-number: Specifies an interface to display the IGMP information about. If no interface is specified, this command will display the related information of all IGMP-enabled interfaces.

verbose: Displays the detailed IGMP configuration and running information.

Description

Use the display igmp interface command to view IGMP configuration and running information of the specified interface or all IGMP-enabled interfaces.

Examples

# View the IGMP configuration and running status on VLAN-interface 1.

<Sysname> display igmp interface Vlan-interface1 verbose

Vlan-interface1 (10.10.1.20):

IGMP is enabled

Current IGMP version is 2

Value of query interval for IGMP(in seconds): 60

Value of other querier present interval for IGMP(in seconds): 125

Value of maximum query response time for IGMP(in seconds): 10

Value of last member query interval(in seconds): 1

Value of startup query interval(in seconds): 15

Value of startup query count: 2

General query timer expiry (hours:minutes:seconds): 00:00:54

Querier for IGMP: 10.10.1.10

IGMP activity: 0 joins, 0 leaves

Multicast routing on this interface: enabled

Robustness: 2

Require-router-alert: disabled

Fast-leave: disabled

Startup-query-timer-expiry: off

Other-querier-present-timer-expiry: off

Table 5-3 Description on the fields of the display igmp interface command

Field	Description
Vlan-interface1 (10.10.1.20)	Interface name (IP address)
Current IGMP version	Version of IGMP currently running on the interface
Value of query interval for IGMP(in seconds)	IGMP query interval, in seconds
Value of other querier present interval for IGMP(in seconds)	Other querier present interval, in seconds
Value of maximum query response time for IGMP(in seconds)	Maximum response time for IGMP general queries, in seconds
Value of last member query interval(in seconds)	IGMP last member query interval, in seconds
Value of startup query interval(in seconds)	IGMP startup query interval, in seconds
Value of startup query count	Number of IGMP general queries the device sends on startup
General query timer expiry	Remaining time of the IGMP general query timer
Querier for IGMP	IP address of the IGMP querier
IGMP activity	Statistics of IGMP activities (joins and leaves)
Robustness	Robustness variable of the IGMP querier
Require-router-alert	Whether IGMP messages without Router-Alert are dropped
Fast-leave	Fast leave processing status (without changing status)
Startup-query-timer-expiry	Remaining time of the startup query timer
Other-querier-present-timer-expiry	Remaining time of the other querier present timer

5.1.4 display igmp routing-table

Syntax

display igmp routing-table [ source-address [ mask { mask | mask-length } ] | group-address [ mask { mask | mask-length } ] ] *

View

Any view

Parameters

source-address: Multicast source address.

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

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

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

Description

Use the display igmp routing-table command to view the routing information of the IGMP routing table.

Examples

# View IGMP routing table information

<Sysname> display igmp routing-table

Routing table

Total 2 entries

00001. (*, 225.1.1.1)

List of 1 downstream interface

Vlan-interface1 (20.1.1.1),

Protocol: STATIC

00002. (*, 239.255.255.250)

List of 1 downstream interface

Vlan-interface1 (20.20.20.20),

Protocol: IGMP

Table 5-4 Description on the fields of the display igmp routing-table command

Field	Description
00001	Sequence number of this (*, G) entry
(*, 225.1.1.1)	An (*, G) entry of the IGMP routing table
List of 1 downstream interface	Downstream interface list, namely the interfaces to which multicast data for this group will be forwarded

5.1.5 fast-leave

Syntax

fast-leave [ group-policy acl-number ]

undo fast-leave

View

IGMP view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999. If you do not include this option in your command, this command will take effect for all multicast groups.

Description

Use the fast-leave command to configure fast leave processing globally.

Use the undo fast-leave command to disable fast leave processing globally.

By default, fast leave processing is disabled. Namely, the IGMP querier sends IGMP group-specific queries upon receiving an IGMP leave message from a host, instead of sending a leave notification directly to the upstream.

Related commands: igmp fast-leave, last-member-query-interval.

& Note:

This command takes effect only on Layer 3 interfaces other than VLAN interfaces when executed in IGMP view.

Examples

# Enable fast leave processing globally.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] fast-leave

5.1.6 igmp

Syntax

igmp

undo igmp

View

System view

Parameters

None

Description

Use the igmp command to enter IGMP view.

Use the undo igmp command to remove configurations performed in IGMP view.

IP multicast must be enabled on the device before this command can take effect.

Related commands: igmp enable.

Examples

# Enter IGMP view.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] igmp

[Sysname-igmp]

5.1.7 igmp enable

Syntax

igmp enable

undo igmp enable

View

Interface view

Parameters

None

Description

Use the igmp enable command to enable IGMP on the current interface.

Use the undo igmp enable command to disable IGMP on the current interface.

By default, IGMP is disabled on an interface.

Note that:

l IP multicast must be enabled on the device before this command is meaningful.

l Before IGMP is enabled on an interface, any other IGMP feature configured on the interface will not take effect.

Related commands: igmp.

Examples

# Enable IGMP on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp enable

5.1.8 igmp fast-leave

Syntax

igmp fast-leave [ group-policy acl-number ]

undo igmp fast-leave

View

Interface view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999. If you do not include this option in your command, this command will take effect for all multicast groups.

Description

Use the igmp fast-leave command to configure fast leave processing on the current interface.

Use the undo igmp fast-leave command to disable fast leave processing on the current interface.

& Note:

l The igmp fast-leave command cannot be used in VLAN interface view. To enable fast leave processing on a specific Layer 2 port or ports, use the igmp-snooping fast-leave command or the fast-leave (IGMP-Snooping view) command.

l The igmp-snooping fast-leave and fast-leave (IGMP-Snooping view) commands are effective for both IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

Related commands: fast-leave, igmp last-member-query-interval, igmp-snooping fast-leave, fast-leave (IGMP-Snooping view). For the last two commands, refer to IGMP Snooping Configuration Commands.

Examples

# Enable fast leave processing on LoopBack 2.

<Sysname> system-view

[Sysname] interface LoopBack 2

[Sysname-LoopBack2] igmp fast-leave

5.1.9 igmp group-policy

Syntax

igmp group-policy acl-number [ version-number ]

undo igmp group-policy

View

Interface view

Parameters

acl-number: Basic or advanced ACL number, in the range of 2000 to 3999.

version-number: IGMP version, in the range of 1 to 3. By default, the system supports IGMPv1, IGMPv2 and IGMPv3 concurrently.

Description

Use the igmp group-policy command to configure a multicast group filter on the current interface.

Use the undo igmp group-policy command to remove the configured multicast group filter.

Be default, no multicast group filter is configured, namely a host can join any multicast group.

& Note:

When you use an advanced ACL as a filter, the source address in the ACL rule is the multicast source address specified in IGMPv3 reports, rather than the source address in the IP packets.

l The igmp group-policy command cannot be used in VLAN interface view. To configure a multicast group filter on a specific Layer 2 port or ports, use the igmp-snooping group-policy command or the group-policy (IGMP-Snooping view) command.

l The igmp-snooping group-policy and group-policy (IGMP-Snooping view) commands are effective for both IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

Related commands: igmp-snooping group-policy, group-policy. Refer to IGMP Snooping Configuration Commands.

Examples

# Configure an ACL rule so that hosts on the subnet attached to LoopBack 2 can join multicast group 225.1.1.1 only.

<Sysname> system-view

[Sysname] acl number 2005

[Sysname-acl-basic-2005] rule permit source 225.1.1.1 0

[Sysname-acl-basic-2005] quit

[Sysname] interface LoopBack 2

[Sysname-LoopBack2] igmp group-policy 2005

5.1.10 igmp last-member-query-interval

Syntax

igmp last-member-query-interval interval

undo igmp last-member-query-interval

View

Interface view

Parameters

interval: IGMP last member query interval in seconds, with an effective range of 1 to 5.

Description

Use the igmp last-member-query-interval command to configure the last member query interval, namely the length of time the device waits between sending IGMP group-specific queries, on the current interface.

Use the undo igmp last-member-query-interval command to restore the system default.

By default, the IGMP last member query interval is 1 second.

Related commands: last-member-query-interval, igmp robust-count, display igmp interface.

Examples

# Set the IGMP last member query interval to 3 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp last-member-query-interval 3

5.1.11 igmp max-response-time

Syntax

igmp max-response-time interval

undo igmp max-response-time

View

Interface view

Parameters

interval: Maximum response time in seconds for IGMP general queries, with an effective range of 1 to 25.

Description

Use the igmp max-response-time command to configure the maximum response time for IGMP general queries on the current interface.

Use the undo igmp max-response-time command to restore the system default.

By default, the maximum response time for IGMP general queries is 10 seconds.

Related commands: max-response-time, igmp timer other-querier-present, display igmp interface.

Examples

# Set the maximum response time for IGMP general queries to 8 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp max-response-time 8

5.1.12 igmp require-router-alert

Syntax

igmp require-router-alert

undo igmp require-router-alert

View

Interface view

Parameters

None

Description

Use the igmp require-router-alert command to configure the interface to discard IGMP messages that do not carry the Router-Alert option.

Use the undo igmp require-router-alert command to restore the default configuration.

By default, the device does not check the Router-Alert option, namely it passes all the IGMP messages it receives to the upper layer protocol for processing.

Related commands: require-router-alert, igmp send-router-alert.

Examples

# Configure VLAN-interface 100 to discard IGMP messages that do not carry the Router-Alert option.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp require-router-alert

5.1.13 igmp robust-count

Syntax

igmp robust-count robust-value

undo igmp robust-count

View

Interface view

Parameters

robust-value: IGMP querier robustness variable, with an effective range of 2 to 5. The IGMP robustness variable determines the number of general queries the IGMP querier sends on startup and the number of IGMP group-specific queries the IGMP querier sends upon receiving an IGMP leave message.

Description

Use the igmp robust-count command to configure the IGMP querier robustness variable on the current interface.

Use the undo igmp robust-count command to restore the system default.

By default, the IGMP querier robustness variable is 2.

Related commands: robust-count, igmp timer query, igmp last-member-query-interval, igmp timer other-querier-present, display igmp interface.

Examples

# Set the IGMP querier robustness variable to 3 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp robust-count 3

5.1.14 igmp send-router-alert

Syntax

igmp send-router-alert

undo igmp send-router-alert

View

Interface view

Parameters

None

Description

Use the igmp send-router-alert command on the current interface to enable insertion of the Router-Alert option in IGMP messages to be sent.

Use the undo igmp send-router-alert command on the current interface to disable insertion of the Router-Alert option in IGMP messages to be sent.

By default, IGMP messages are sent with the Router-Alert option.

Related commands: send-router-alert, igmp require-router-alert.

Examples

# Disable insertion of the Router-Alert option into IGMP messages that leave VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] undo igmp send-router-alert

5.1.15 igmp static-group

Syntax

igmp static-group group-address [ source source-address ]

undo igmp static-group { all | group-address [ source source-address ] }

View

Interface view

Parameters

all: Specifies to remove all static multicast groups that the current interface has joined.

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

source-address: Multicast source address.

Description

Use the igmp static-group command to configure the current interface to be a statically connected member of the specified multicast group.

Use the undo igmp static-group command to remove the current interface as a statically connected member of the specified multicast group.

By default, an interface is not a static member of any multicast group.

If the specified multicast address is in the SSM multicast address range, and if a multicast source address is specified in the command, multicasts carrying the (S,G) entry, namely the source address information, can be sent out through this interface.

& Note:

l The igmp static-group command cannot be used in VLAN interface view. To configure a specific Layer 2 port or ports to join a multicast group as static member(s), use the igmp-snooping static-group command.

l The igmp-snooping static-group command is effective for both IGMP Snooping–enabled VLANs and VLANs with IGMP enabled on the corresponding VLAN interfaces.

Related commands: igmp-snooping static-group in IGMP Snooping Configuration Commands.

Examples

# Configure LoopBack 1 to be a statically connected member of multicast group 224.1.1.1.

<Sysname> system-view

[Sysname] interface LoopBack 1

[Sysname-LoopBack1] igmp static-group 224.1.1.1

5.1.16 igmp timer other-querier-present

Syntax

igmp timer other-querier-present interval

undo igmp timer other-querier-present

View

Interface view

Parameters

interval: IGMP other querier present interval in seconds, in the range of 60 to 300.

Description

Use the igmp timer other-querier-present command to configure the IGMP other querier present interval on the current interface.

Use the undo igmp timer other-querier-present command to restore the system default.

By default, the IGMP other querier present interval is [ IGMP query interval ] times [ IGMP querier robustness variable ] plus [ maximum response time for IGMP general queries ] divided by two.

& Note:

The three parameters in the above-mentioned formula default to 60 (seconds), 2 and 10 (seconds) respectively, so the default IGMP other querier present interval = 60 × 2 + 10 / 2 = 125 (seconds).

Related commands: timer other-querier-present, igmp timer query, igmp robust-count, igmp max-response-time, display igmp interface.

Examples

# Set the IGMP other querier present interval to 200 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp timer other-querier-present 200

5.1.17 igmp timer query

Syntax

igmp timer query interval

undo igmp timer query

View

Interface view

Parameters

interval: IGMP query interval in seconds, namely the interval between IGMP general queries sent by the querier, with an effective range of 1 to 18,000.

Description

Use the igmp timer query command to configure the IGMP query interval on the current interface.

Use the undo igmp timer query command to restore the system default.

By default, the IGMP query interval is 60 seconds.

Related commands: timer query, igmp timer other-querier-present, display igmp interface.

Examples

# Set the IGMP query interval to 125 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp timer query 125

5.1.18 igmp version

Syntax

igmp version version-number

undo igmp version

View

Interface view

Parameters

version-number: IGMP version, in the range of 1 to 3.

Description

Use the igmp version command to configure the IGMP version on the current interface.

Use the undo igmp version command to restore the default IGMP version.

The default IGMP version is version 2.

Related commands: version.

Examples

# Set the IGMP version to IGMPv1 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] igmp version 1

5.1.19 last-member-query-interval

Syntax

last-member-query-interval interval

undo last-member-query-interval

View

IGMP view

Parameters

interval: Last-member query interval in seconds, with an effective range of 1 to 5.

Description

Use the last-member-query-interval command to configure the global IGMP last-member query interval.

Use the undo last-member-query-interval command to restore the system default.

By default, the IGMP last-member query interval is 1 second.

Related commands: igmp last-member-query-interval, robust-count, display igmp interface.

Examples

# Set the global IGMP last-member interval to 3 seconds.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] last-member-query-interval 3

5.1.20 max-response-time

Syntax

max-response-time interval

undo igmp max-response-time

View

IGMP view

Parameters

interval: Maximum response time for IGMP general queries in seconds, with an effective range of 1 to 25.

Description

Use the max-response-time command to configure the maximum response time for IGMP general queries globally.

Use the undo max-response-time command to restore the system default.

By default, the maximum response time for IGMP general queries is 10 seconds.

Related commands: igmp max-response-time, timer other-querier-present, display igmp interface.

Examples

# Set the maximum response time for IGMP general queries to 8 seconds globally.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] max-response-time 8

5.1.21 require-router-alert

Syntax

require-router-alert

undo require-router-alert

View

IGMP view

Parameters

None

Description

Use the require-router-alert command to configure the router to discard IGMP messages that do not carry the Router-Alert option.

Use the undo require-router-alert command to restore the default configuration.

By default, the device does not check the Router-Alert option, namely it handles all the IGMP messages it received to the upper layer protocol for processing.

Related commands: igmp require-router-alert, send-router-alert.

Examples

# Configure the router to discard IGMP messages that do not carry the Router-Alert option.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] require-router-alert

5.1.22 reset igmp group

Syntax

reset igmp group { all | interface interface-type interface-number { all | group-address [ mask { mask | mask-length } ] [ source-address [ mask { mask | mask-length } ] ] } }

View

User view

Parameters

all: Specifies to clear all IGMP forwarding entries.

interface interface-type interface-number: Clears the IGMP forwarding entries on the specified interface.

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

source-address: Multicast source address.

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

mask-length: Subnet 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.

Description

Use the reset igmp group command to clear IGMP forwarding entries.

Note that:

When clearing the IGMP forwarding entries of a VLAN interface, this command also clears the IGMP Snooping forwarding entries for that VLAN.

Related commands: display igmp group.

Examples

# Clear all the IGMP and IGMP Snooping entries on all interfaces.

<Sysname> reset igmp group all

# Clear all IGMP forwarding entries on VLAN-interface 100 and all IGMP Snooping forwarding entries in VLAN 100.

<Sysname> reset igmp group interface vlan-interface 100 all

# Clear the IGMP forwarding entries of multicast group 225.0.0.1 on VLAN-interface 100 and all the IGMP Snooping forwarding entries of this multicast group in VLAN 100.

<Sysname> reset igmp group interface vlan-interface 100 225.0.0.1

# Clear the IGMP forwarding entries of multicast groups on subnet 225.1.1.0/24 on VLAN-interface 100 and the IGMP Snooping forwarding entries of multicast groups on this subnet in VLAN 100.

<Sysname> reset igmp group interface vlan-interface 100 225.1.1.0 mask 24

5.1.23 reset igmp group port-info

Syntax

reset igmp group port-info { all | group-address } [ vlan vlan-id ]

View

User view

Parameters

all: Clears Layer 2 port information of all the IGMP multicast groups.

group-address: Clears Layer 2 port information of the specified IGMP multicast group. The effective range of group-address is 224.0.1.0 to 239.255.255.255.

vlan-id: Clears Layer 2 port information of IGMP multicast groups in the specified VLAN. The effective range of vlan-id is 1 to 4094.

Description

Use the reset igmp group port-info command to clear Layer 2 port information of IGMP multicast groups.

Note that:

l Layer 2 ports for IGMP multicast groups include member ports and router ports.

l This command cannot clear Layer 2 port information about IGMP multicast groups of static joins.

Related commands: display igmp group port-info.

Examples

l # Clear Layer 2 port information of all IGMP multicast groups in all VLANs.

<Sysname> reset igmp group port-info all

# Clear Layer 2 port information of all IGMP multicast groups in VLAN 100.

<Sysname> reset igmp group port-info all vlan 100

# Clear Layer 2 port information about multicast group 225.0.0.1 in VLAN 100.

<Sysname> reset igmp group port-info 225.0.0.1 vlan 100

5.1.24 robust-count

Syntax

robust-count robust-value

undo robust-count

View

IGMP view

Parameters

Description

Use the robust-count command to configure the IGMP querier robustness variable globally.

Use the undo robust-count command to restore the system default.

By default, the IGMP querier robustness variable is 2.

Related commands: igmp robust-count, timer query, last-member-query-interval, timer other-querier-present, display igmp interface.

Examples

# Set the IGMP querier robustness variable to 3 globally.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] robust-count 3

5.1.25 send-router-alert

Syntax

send-router-alert

undo send-router-alert

View

IGMP view

Parameters

None

Description

Use the send-router-alert command to enable globally the insertion of the Router-Alert option into IGMP messages to be sent.

Use the undo send-router-alert command to disable globally the insertion of the Router-Alert option into IGMP messages to be sent.

By default, an IGMP message carries the Router-Alert option.

Related commands: igmp send-router-alert, require-router-alert.

Examples

# Globally disable the insertion of the Router-Alert option in IGMP messages to be sent.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] send-router-alert

5.1.26 timer other-querier-present

Syntax

timer other-querier-present interval

undo timer other-querier-present

View

IGMP view

Parameters

interval: IGMP other querier present interval, in the range of 60 to 300.

Description

Use the timer other-querier-present command to configure the IGMP other querier present interval globally.

Use the undo timer other-querier-present command to restore the system default.

By default, the IGMP other querier present interval is [ IGMP query interval ] times [ IGMP querier robustness variable ] plus [ maximum response time for IGMP general queries ] divided by two..

& Note:

The three parameters in the above-mentioned formula default to 60 (seconds), 2 (times) and 10 (seconds) respectively, so the default IGMP other querier present interval = 60 × 2 + 10 / 2 = 125 (seconds).

Related commands: igmp timer other-querier-present, timer query, robust-count, max-response-time, display igmp interface.

Examples

# Set the IGMP other querier present interval to 200 seconds globally.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] timer other-querier-present 200

5.1.27 timer query

Syntax

timer query interval

undo timer query

View

IGMP view

Parameters

interval: IGMP query interval in seconds, namely interval between IGMP general queries sent by the querier, with an effective range of 1 to 18,000.

Description

Use the timer query command to configure the IGMP query interval globally.

Use the undo timer query command to restore the default setting.

By default, IGMP query interval is 60 seconds.

Related commands: igmp timer query, timer other-querier-present, display igmp interface.

Examples

# Set the IGMP query interval to 125 seconds globally.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] timer query 125

5.1.28 version

Syntax

version version-number

undo version

View

IGMP view

Parameters

version-number: IGMP version, in the range of 1 to 3.

Description

Use the version command to configure the IGMP version globally.

Use the undo version command to restore the system default.

The default IGMP version is version 2.

Related commands: igmp version.

Examples

# Set the global IGMP version to IGMPv1.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] version 1

Chapter 6 PIM Configuration Commands

& Note:

The term “router” in this document refers to a router in a generic sense or a Layer 3 switch running the PIM protocol.

6.1 PIM Configuration Commands

6.1.1 auto-rp enable

Syntax

auto-rp enable

undo auto-rp enable

View

PIM view

Parameters

None

Description

Use the auto-rp enable command to enable auto-RP.

Use the undo auto-rp enable command to disable auto-RP.

By default, auto-RP is disabled.

Related commands: static-rp.

Examples

# Enable auto-RP.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] auto-rp enable

6.1.2 bsr-policy

Syntax

bsr-policy acl-number

undo bsr-policy

View

PIM view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999. When an ACL is defined, the source keyword in the rule command specifies a legal BSR source address range.

Description

Use the bsr-policy command to configure a legal BSR address range to guard against BSR spoofing.

Use the undo bsr-policy command to remove the restriction of the BSR address range.

By default, there are no restrictions on the BSR address range, namely all the received BSR messages are regarded to be valid.

Examples

# Configure a legal BSR address range so that only routers on the segment 10.1.1.0/24 can become the BSR.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 10.1.1.0 0.0.0.255

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] bsr-policy 2000

6.1.3 c-bsr

Syntax

c-bsr interface-type interface-number [ hash-length [ priority ] ]

undo c-bsr

View

PIM view

Parameters

interface-type interface-number: Specifies an interface by its type and number. This configuration can take effect only if PIM-SM is enabled on the interface.

hash-length: Hash mask length for RP selection calculation, in the range of 0 to 32. If you do not include this keyword in your command, the corresponding global setting will be used.

priority: Priority of the C-BSR, in the range of 0 to 255. If you do not include this keyword in your command, the corresponding global setting will be used. A larger value of this argument means a higher priority.

Description

Use the c-bsr command to configure the specified interface as a C-BSR.

Use the undo c-bsr command to remove the related C-BSR configuration.

No C-BSR is configured by default.

Related commands: pim sm, c-bsr hash-length, c-bsr priority, c-rp.

Examples

# Configure VLAN-interface 100 to be a C-BSR.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr vlan-interface 100

6.1.4 c-bsr admin-scope

Syntax

c-bsr admin-scope

undo c-bsr admin-scope

View

PIM view

Parameters

None

Description

Use the c-bsr admin-scope command to enable BSR administrative scoping to implement RP-Set distribution based on BSR admin-scope regions.

Use the undo c-bsr admin-scope command to disable BSR administrative scoping.

By default, BSR administrative scoping is disabled, namely there is only one BSR in a PIM-SM domain.

Related commands: c-bsr, c-bsr group, c-bsr global.

Examples

# Enable BSR administrative scoping.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr admin-scope

6.1.5 c-bsr global

Syntax

c-bsr global [ hash-length hash-length | priority priority ] *

undo c-bsr global

View

PIM view

Parameters

hash-length: Hash mask length for RP selection calculation in the global scope zone, in the range of 0 to 32. If you do not include this keyword in your command, the corresponding global setting will be used.

priority: Priority of the C-BSR in the global scope zone, in the range of 0 to 255. If you do not include this keyword in your command, the corresponding global setting will be used. A larger value of this argument means a higher priority.

Description

Use the c-bsr global command to configure a C-BSR for the global scope zone.

Use the undo c-bsr global command to remove the C-BSR configuration for the global scope zone.

By default, no C-BSRs are configured for the global scope zone.

Related commands: c-bsr group, c-bsr hash-length, c-bsr priority.

Examples

# Configure the router to be a C-BSR for the global scope zone, with the priority of 1.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr global priority 1

6.1.6 c-bsr group

Syntax

c-bsr group group-address { mask | mask-length } [ hash-length hash-length | priority priority ] *

undo c-bsr group group-address

View

PIM view

Parameters

group-address: Multicast group address, in the range of 239.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 8 to 32.

hash-length: Hash mask length for RP selection calculation in the BSR admin-scope region corresponding to the specified multicast group, in the range of 0 to 32. If you do not include this keyword in your command, the corresponding global setting will be used.

priority: Priority of the C-BSR in the BSR admin-scope region corresponding to a multicast group, in the range of 0 to 255. If you do not include this keyword in your command, the corresponding global setting will be used. A larger value of this argument means a higher priority.

Description

Use the c-bsr group command to configure a C-BSR for the BSR admin-scope region associated with the specified group.

Use the undo c-bsr group command to remove the C-BSR configuration for the BSR admin-scope region associated with the specified group.

By default, no C-BSRs are configured for BSR admin-scope regions.

Related commands: c-bsr global, c-bsr admin-scope, c-bsr hash-length, c-bsr priority.

Examples

# Configure the router to be a C-BSR in the BSR admin-scope region associated with the multicast group address 239.0.0.0/8, with the priority of 10.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr group 239.0.0.0 255.0.0.0 priority 10

6.1.7 c-bsr hash-length

Syntax

c-bsr hash-length hash-length

undo c-bsr hash-length

View

PIM view

Parameters

hash-length: Hash mask length for RP selection calculation, in the range of 0 to 32.

Description

Use the c-bsr hash-length command to configure the global Hash mask length for RP selection calculation.

Use the undo c-bsr hash-length command to restore the system default.

By default, the Hash mask length for RP selection calculation is 30.

Related commands: c-bsr, c-bsr global, c-bsr group.

Examples

# Set the global Hash mask length for RP selection calculation to 16.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr hash-length 16

6.1.8 c-bsr holdtime

Syntax

c-bsr holdtime interval

undo c-bsr holdtime

View

PIM view

Parameters

interval: Bootstrap timeout in seconds, with an effective range of 1 to 2,147,483,647.

Description

Use the c-bsr holdtime command to configure the bootstrap timeout time, namely the length of time a C-BSR waits before it must receive a bootstrap message from the BSR.

Use the undo c-bsr holdtime command to restore the system default.

By default, the bootstrap timeout value is determined by this formula: Bootstrap timeout = Bootstrap interval × 2 + 10.

& Note:

The default bootstrap interval is 60 seconds, so the default bootstrap timeout = 60 × 2 + 10 = 130 (seconds).

Related commands: c-bsr, c-bsr interval.

Examples

# Set the bootstrap timeout time to 150 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr holdtime 150

6.1.9 c-bsr interval

Syntax

c-bsr interval interval

undo c-bsr interval

View

PIM view

Parameters

interval: Bootstrap interval in seconds, with an effective range of 1 to 2,147,483,647.

Description

Use the c-bsr interval command to configure the bootstrap interval, namely the interval at which the BSR sends bootstrap messages.

Use the undo c-bsr interval command to restore the system default.

By default, the bootstrap interval value is determined by this formula: Bootstrap interval = (Bootstrap timeout – 10) ÷ 2.

& Note:

The default bootstrap timeout is 130 seconds, so the default bootstrap interval = (130 – 10) ÷ 2 = 60 (seconds).

Related commands: c-bsr, c-bsr holdtime.

Examples

# Set the bootstrap interval to 30 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr interval 30

6.1.10 c-bsr priority

Syntax

c-bsr priority priority

undo c-bsr priority

View

PIM view

Parameters

priority: Priority of the C-BSR, in the range of 0 to 255. A larger value of this argument means a higher priority.

Description

Use the c-bsr priority command to configure the global C-BSR priority.

Use the undo c-bsr priority command to restore the system default.

By default, the C-BSR priority is 0.

Related commands: c-bsr, c-bsr global, c-bsr group.

Examples

# Set the global C-BSR priority to 5.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr priority 5

6.1.11 c-rp

Syntax

c-rp interface-type interface-number [ group-policy acl-number | priority priority | holdtime hold-interval | advertisement-interval adv-interval ] *

undo c-rp interface-type interface-number

View

PIM view

Parameters

interface-type interface-number: Specifies an interface, the IP address of which will be advertised as a C-RP address.

acl-number: Basic ACL number, in the range of 2000 to 2999. This ACL defines a range of multicast groups the C-RP is going to serve, rather than defining a filtering rule. Any group range matching the permit statement in the ACL will be advertised as an RP served group, while configurations matching other statements like deny will not take effect.

priority: Priority of the C-RP, in the range of 0 to 255 and defaulting to 0. A larger value of this argument means a lower priority.

hold-interval: C-RP timeout time, in seconds. The effective range is 1 to 65,535. If you do not provide this argument in your command, the corresponding global setting will be used.

adv-interval: C-RP-Adv interval in seconds, with an effective range of 1 to 65,535. If you do not provide this argument in your command, the corresponding global setting will be used.

Description

Use the c-rp command to configure the specified interface as a C-RP.

Use the undo c-rp command to remove the related C-RP configuration.

No C-RPs are configured by default.

Note that:

l If you do not specify a group range for the C-RP, the C-RP will serve all multicast groups.

l If you wish a router to be a C-RP for multiple group ranges, you need to include these multiple group ranges in multiple rules in the ACL corresponding to the group-policy keyword.

l If you carry out this command repeatedly on the same interface, the last configuration will take effect.

Related commands: c-bsr.

Examples

# Configure VLAN-interface 100 to be a C-RP for multicast groups 225.1.0.0/16 and 226.2.0.0/16, with a priority of 10.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 225.1.0.0 0.0.255.255

[Sysname-acl-basic-2000] rule permit source 226.2.0.0 0.0.255.255

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] c-rp vlan-interface 100 group-policy 2000 priority 10

6.1.12 c-rp advertisement-interval

Syntax

c-rp advertisement-interval interval

undo c-rp advertisement-interval

View

PIM view

Parameters

interval: C-RP-Adv interval in seconds, with an effective range of 1 to 65,535.

Description

Use the c-rp advertisement-interval command to configure the interval at which C-RP-Adv messages are sent.

Use the undo c-rp advertisement-interval command to restore the system default.

By default, the C-RP-Adv interval is 60 seconds.

Related commands: c-rp.

Examples

# Set the global C-RP-Adv interval to 30 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-rp advertisement-interval 30

6.1.13 c-rp holdtime

Syntax

c-rp holdtime interval

undo c-rp holdtime

View

PIM view

Parameters

interval: C-RP timeout in seconds, with an effective range of 1 to 65,535.

Description

Use the c-rp holdtime command to configure the global C-RP timeout time, namely the length of time the BSR waits before it must receive a C-RP-Adv message.

Use the undo c-rp holdtime command to restore the system default.

By default, the C-RP timeout time is 150 seconds.

Because a non-BSR router refreshes its C-RP timeout time through BSR bootstrap messages, to prevent loss of BSR bootstrap messages, make sure that the C-RP timeout time is not smaller than the interval at which the BSR sends bootstrap messages. The recommended C-RP timeout setting is 2.5 times the bootstrap interval or longer.

Related commands: c-rp, c-bsr interval.

Examples

# Set the global C-RP timeout time to 200 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-rp holdtime 200

6.1.14 crp-policy

Syntax

crp-policy acl-number

undo crp-policy

View

PIM view

Parameters

acl-number: Advanced ACL number, in the range of 3000 to 3999. When the ACL is defined, the source keyword in the rule command specifies the address of a C-RP and the destination keyword specifies the address range of the multicast groups that the C-RP will serve.

Description

Use the crp-policy command to configure a legal C-RP address range and the range of served multicast groups, so as to guard against C-RP spoofing.

Use the undo crp-policy command to remove the restrictions in C-RP address ranges and the ranges of served multicast groups.

By default, there are no restrictions on C-RP address ranges and the address ranges of served groups, namely all received C-RP messages are accepted.

Examples

# Configure a C-RP address range and a range of served multicast groups so that only routers in the address range of 1.1.1.1/32 can be C-RPs and these C-RPs can serve only multicast groups in the address range of 225.1.0.0/16.

<Sysname> system-view

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule permit ip source 1.1.1.1 0 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3000] quit

[Sysname] pim

[Sysname-pim] crp-policy 3000

6.1.15 display pim bsr-info

Syntax

display pim bsr-info

View

Any view

Parameters

None

Description

Use the display pim bsr-info command to view the BSR information in the PIM domain and the locally configured C-RP information in effect.

Related commands: c-bsr, c-rp.

Examples

# View the BSR information in the PIM-SM domain and the locally configured C-RP information in effect.

<Sysname> display pim bsr-info

Elected BSR Address: 12.12.12.9

Priority: 0

Hash mask length: 30

State: Elected

Scope: Global

Uptime: 00:00:56

Next BSR message scheduled at: 00:01:14

Candidate BSR Address: 12.12.12.9

Priority: 0

Hash mask length: 30

State: Elected

Scope: Global

Candidate RP: 12.12.12.9(LoopBack1)

Priority: 0

HoldTime: 150

Advertisement Interval: 60

Next advertisement scheduled at: 00:00:48

Candidate RP: 3.3.3.3(Vlan-interface1)

Priority: 20

HoldTime: 90

Advertisement Interval: 50

Next advertisement scheduled at: 00:00:28

Candidate RP: 5.5.5.5(Vlan-interface2)

Priority: 0

HoldTime: 80

Advertisement Interval: 60

Next advertisement scheduled at: 00:00:48

Table 6-1 Description on the fields of the display pim bsr-info command

Field	Description
Elected BSR Address	Address of the elected BSR
Candidate BSR Address	Address of the candidate BSR
Priority	BSR priority
Hash mask length	Hash mask length for RP selection calculation
State	BSR state
Scope	Scope of the BSR
Uptime	Length of time for which this BSR has been up, in hours:minutes:seconds
Next BSR message scheduled at	Length of time in which the BSR will expire, in hours:minutes:seconds
Candidate RP	Address of the C-RP
Priority	Priority of the C-RP
HoldTime	Timeout time of the C-RP
Advertisement Interval	Interval at which the C-RP sends advertisement messages
Next advertisement scheduled at	Length of time in which the C-RP will send the next advertisement message, in hours:minutes:seconds

6.1.16 display pim claimed-route

Syntax

display pim claimed-route [ source-address ]

View

Any view

Parameters

source-address: Displays the information of the unicast route to a particular multicast source. If you do not provide this argument, this command will display the information about all unicast routes used by PIM.

Description

Use the display pim claimed-route command to view the information of unicast routes used by PIM.

If an (S, G) is marked SPT, this (S, G) entry uses a unicast route.

Examples

# View the information of all unicast routes used by PIM.

<Sysname> display pim claimed-route

RPF information about: 172.168.0.0

RPF interface: Vlan-interface2, RPF neighbor: 172.168.0.2

Referenced route/mask: 172.168.0.0/24

Referenced route type: unicast (direct)

RPF-route selecting rule: preference-preferred

The (S,G) or (*,G) list dependent on this route entry

(172.168.0.12, 227.0.0.1)

Table 6-2 Description on the fields of the display pim claimed-route command

Field	Description
RPF interface:	RPF interface type and number
RPF neighbor:	IP address of the RPF neighbor
Referenced route/mask:	Address/mask of the referenced route
Referenced route type:	Type of the referenced route
RPF-route selecting rule:	Rule of RPF route selection
The (S,G) or (*,G) list dependent on this route entry	(S,G) or (*, G) entries using this route

6.1.17 display pim control-message counters

Syntax

display pim control-message counters [ message-type { probe | register | register-stop } | [ interface interface-type interface-number | message-type { assert | bsr | crp | graft | graft-ack | hello | join-prune | state-refresh } ] * ]

View

Any view

Parameters

probe: Displays the number of null register messages.

register: Displays the number of register messages.

register-stop: Displays the number of register-stop messages.

interface interface-type interface-number: Displays the number of PIM control messages on the specified interface.

assert: Displays the number of assert messages.

bsr: Displays the number of Bootstrap messages.

crp: Displays the number of C-RP-Adv messages.

graft: Displays the number of Graft messages.

graft-ack: Displays the number of Graft-ack messages.

hello: Displays the number of Hello messages.

join-prune: Displays the number of Join/prune messages.

state-refresh: Displays the number of state refresh messages.

Description

Use the display pim control-message counters command to view the statistics information of PIM control messages.

Examples

# View the statistics information of all types of PIM control messages on all interfaces.

<Sysname> display pim control-message counters

PIM global control-message counters:

Received Sent Invalid

Probe 10 5 0

PIM control-message counters for interface: Vlan-interface1

Received Sent Invalid

Assert 10 5 0

Graft 20 37 2

Graft-Ack 25 20 1

Hello 1232 453 0

Join/Prune 15 30 21

State-Refresh 8 7 1

BSR 3243 589 1

C-RP 53 32 0

Table 6-3 Description on the fields of display pim control-message counters

Field	Description
Received	Number of messages received
Sent	Number of messages sent
Invalid	Number of invalid messages
Register	Register messages
Register-Stop	Register-stop messages
Probe	Null register messages
Assert	Assert messages
Graft	Graft messages
Graft-Ack	Graft-ack messages
Hello	Hello messages
Join/Prune	Join/prune messages
State Refresh	State refresh messages
BSR	Bootstrap messages
C-RP	C-RP-Adv messages

6.1.18 display pim grafts

Syntax

display pim grafts

View

Any view

Parameters

None

Description

Use the display pim grafts command to view the information about unacknowledged graft messages.

Examples

# View the information about unacknowledged graft messages.

<Sysname> display pim grafts

Source Group Age RetransmitIn

192.168.10.1 224.1.1.1 00:00:24 00:00:02

Table 6-4 Description on the fields of the display pim grafts command

Field	Description
Source	Multicast source address in the graft message
Group	Multicast group address in the graft message
Age	Time in which the graft message will get aged out, in hours:minutes:seconds
RetransmitIn	Time in which the graft message will be retransmitted, in hours:minutes:seconds

6.1.19 display pim interface

Syntax

display pim interface [ interface-type interface-number ] [ verbose ]

View

Any view

Parameters

interface-type interface-number: Displays the PIM information on a particular interface.

verbose: Displays the detailed PIM information.

Description

Use the display pim interface command to view the PIM information on the specified interface or all interfaces.

Examples

# View the PIM information on all interfaces.

<Sysname> display pim interface

Interface NbrCnt HelloInt DR-Pri DR-Address

Vlan1 1 30 1 10.1.1.2

Vlan2 0 30 1 172.168.0.2 (local)

Vlan3 1 30 1 20.1.1.2

Table 6-5 Description on the fields of the display pim interface command

Field	Description
Interface	Interface name
NbrCnt	Number of PIM neighbors
HelloInt	Hello interval
DR-Pri	Priority for DR election
DR-Address	DR IP address

# View the detailed PIM information on VLAN-interface 1.

<Sysname> display pim interface Vlan-interface1 verbose

Interface: Vlan-interface1, 10.1.1.1

PIM version: 2

PIM mode: Sparse

PIM DR: 10.1.1.2

PIM DR Priority (configured): 1

PIM neighbor count: 1

PIM hello interval: 30 s

PIM LAN delay (negotiated): 500 ms

PIM LAN delay (configured): 500 ms

PIM override interval (negotiated): 2500 ms

PIM override interval (configured): 2500 ms

PIM neighbor tracking (negotiated): disabled

PIM neighbor tracking (configured): disabled

PIM generation ID: 0XF5712241

PIM require generation ID: disabled

PIM hello hold interval: 105 s

PIM assert hold interval: 180 s

PIM triggered hello delay: 5 s

PIM J/P interval: 60 s

PIM J/P hold interval: 210 s

PIM BSR domain border: disabled

Number of routers on network not using DR priority: 0

Number of routers on network not using LAN delay: 0

Number of routers on network not using neighbor tracking: 2

Table 6-6 Description on the fields of the display pim interface verbose command

Field	Description
Interface	Interface name and its IP address
PIM version	Running PIM version
PIM mode	PIM mode, dense or sparse
PIM DR	DR IP address
PIM DR Priority (configured)	Configured priority for DR election
PIM neighbor count	Total number of PIM neighbors
PIM hello interval	Hello interval
PIM LAN delay (negotiated)	Negotiated prune delay
PIM LAN delay (configured)	Configured prune delay
PIM override interval (negotiated)	Negotiated prune override interval
PIM override interval (configured)	Configured prune override interval
PIM neighbor tracking (negotiated)	Negotiated neighbor tracking status (enabled/disabled)
PIM neighbor tracking (configured)	Configured neighbor tracking status (enabled/disabled)
PIM generation ID	Generation_ID value
PIM require generation ID	Rejection of Hello messages without Generation_ID (enabled/disabled)
PIM hello hold interval	PIM neighbor timeout time
PIM assert hold interval	Assert timeout time
PIM triggered hello delay	Maximum delay of sending hello messages
PIM J/P interval	Join/prune interval
PIM J/P hold interval	Join/prune timeout time
PIM BSR domain border	BSR administrative scoping status (enabled/disabled)
Number of routers on network not using DR priority	Number of routers not using the DR priority field on the subnet where the interface resides
Number of routers on network not using LAN delay	Number of routers not using the LAN delay field on the subnet where the interface resides
Number of routers on network not using neighbor tracking	Number of routers not using neighbor tracking on the subnet where the interface resides

6.1.20 display pim join-prune

Syntax

display pim join-prune mode { sm [ flags flag-value ] | ssm } [ interface interface-type interface-number | neighbor neighbor-address ] * [ verbose ]

View

Any view

Parameters

mode: Displays the information of join/prune messages to send in the specified PIM mode. PIM modes include sm and ssm, which represent PIM-SM and PIM-SSM respectively.

flags flag-value: Displays routing entries containing the specified flag. Values and meanings of flag-value are as follows:

l rpt: Specifies routing entries on the RPT.

l spt: Specifies routing entries on the SPT.

l wc: Specifies wildcard routing entries.

interface-type interface-number: Displays the information of join/prune messages to send on the specified interface.

neighbor-address: Displays the information of join/prune messages to send to the specified PIM neighbor.

verbose: Displays the detailed information of join/prune messages to send.

Description

Use the display pim join-prune command to view the information about the join/prune messages to send.

Examples

# View the information of join/prune messages to send in the PIM-SM mode.

<Sysname> display pim join-prune mode sm

Expiry Time: 22 sec

Upstream nbr: 192.168.1.55 (Vlan-interface1)

0 (*, G) join(s), 1 (S, G) join(s), 0 (S, G, rpt) prune(s)

Expiry Time: 50 sec

Upstream nbr: 10.1.1.1 (Vlan-interface2)

1 (*, G) join(s), 0 (S, G) join(s), 1 (S, G, rpt) prune(s)

-------------------------------------------------------------------------

Total (*, G) join(s): 1, (S, G) join(s): 1, (S, G, rpt) prune(s): 1

Table 6-7 Description on the fields of the display pim join-prune command

Field	Description
Expiry Time:	Expiry time of sending join/prune messages
Upstream nbr:	IP address of the upstream PIM neighbor and the interface connecting to it
(*, G) join(s)	Number of (*, G) joins to send
(S, G) join(s)	Number of (S, G) joins to send
(S, G, rpt) prune(s)	Number of (S, G, rpt) prunes

6.1.21 display pim neighbor

Syntax

display pim neighbor [ interface interface-type interface-number | neighbor-address | verbose ] *

View

Any view

Parameters

interface-type interface-number: Displays the PIM neighbor information on a particular interface.

neighbor-address: Displays the information of a particular PIM neighbor.

verbose: Displays the detailed PIM neighbor information.

Description

Use the display pim neighbor command to view the PIM neighbor information.

Examples

# View the information of all PIM neighbors.

<Sysname> display pim neighbor

Total Number of Neighbors = 2

Neighbor Interface Uptime Expires Dr-Priority

10.1.1.2 Vlan1 02:50:49 00:01:31 1

20.1.1.2 Vlan2 02:49:39 00:01:42 1

Table 6-8 Description on the fields of the display pim neighbor command

Field	Description
Total Number of Neighbors	Total number of PIM neighbors
Neighbor	IP address of the PIM neighbor
Interface	Interface connecting the PIM neighbor
Uptime	Length of time for which the PIM neighbor has been up, in hours:minutes:seconds
Expires	Length of time in which the PIM neighbor will expire, in hours:minutes:seconds
Dr-Priority	Designated router priority

# View the PIM neighbor information on VLAN-interface 1.

<Sysname> display pim neighbor interface Vlan-interface 1

Total Number of Neighbors on this interface = 3

Neighbor Interface Uptime Expires Dr-Priority

101.110.110.150 Vlan1 00:37:17 00:01:28 1

11.110.0.40 Vlan2 00:33:20 00:01:25 1

11.110.0.20 Vlan3 00:04:53 00:01:22 1

# View the detailed information of the PIM neighbor whose IP address is 11.110.0.20.

<Sysname> display pim neighbor 11.110.0.20 verbose

Neighbor: 11.110.0.20

Interface: Vlan-interface3

Uptime: 00:00:10

Expiry time: 00:00:30

DR Priority: 1

Generation ID: 0X2ACEFE15

Holdtime: 105 s

LAN delay: 500 ms

Override interval: 2500 ms

State refresh interval: 60 ms

Neighbor tracking: Disabled

6.1.22 display pim routing-table

Syntax

display pim routing-table [ group-address [ mask { mask-length | mask } ] | source-address [ mask { mask-length | mask } ] | incoming-interface [ interface-type interface-number | register ] | outgoing-interface { include | exclude | match } { interface-type interface-number | register } | mode mode-type | flags flag-value | fsm ] *

View

Any view

Parameters

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

source-address: Multicast source address.

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

mask-length: Mask length of the multicast group/source address, in the range of 0 to 32. The system default is 32.

incoming-interface: Displays routing entries that contain the specified interface as the incoming interface.

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

register: Specifies the register interface. This keyword is valid only if mode-type is not specified or is sm.

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

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

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

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

mode mode-type: Specifies a PIM mode, where mode-type can have the following values:

l dm: Specifies PIM-DM.

l sm: Specifies PIM-SM.

l ssm: Specifies PIM-SSM.

flags flag-value: Displays routing entries containing the specified flag(s). The values of flag-value and their meanings are as follows:

l 2msdp: Specifies routing entries to be contained in the next SA message to notify an MSDP peer.

l act: Specifies multicast routing entries to which actual data has arrived.

l del: Specifies multicast routing entries scheduled to be deleted.

l exprune: Specifies multicast routing entries containing outgoing interfaces pruned by other multicast routing protocols.

l ext: Specifies routing entries containing outgoing interfaces contributed by other multicast routing protocols.

l loc: Specifies multicast routing entries on routers directly connecting to the same subnet with the multicast source.

l msdp: Specifies routing entries learned from MSDP SA messages.

l niif: Specifies multicast routing entries containing unknown incoming interfaces.

l nonbr: Specifies routing entries with PIM neighbor searching failure.

l rpt: Specifies routing entries on RPT branches where (S, G) prunes have been sent to the RP.

l spt: Specifies routing entries on the SPT.

l swt: Specifies routing entries in the process of RPT-to-SPT switchover.

l wc: Specifies wildcard routing entries.

fsm: Displays the detailed information of the finite state machine (FSM).

Description

Use the display pim routing-table command to view PIM routing table information.

Examples

# View the content of the PIM routing table.

<Sysname> display pim routing-table

Total 0 (*, G) entry; 1 (S, G) entry

(172.168.0.12, 227.0.0.1)

RP: 2.2.2.2

Protocol: pim-sm, Flag: SPT LOC ACT

UpTime: 02:54:43

Upstream interface: Vlan-interface1

Upstream neighbor: NULL

RPF prime neighbor: NULL

Downstream interface(s) information:

Total number of downstreams: 1

1: Vlan-interface2

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

Table 6-9 Description on the fields of the display pim routing-table command

Field	Description
Total 0 (*, G) entry; 1 (S, G) entry	Number of (S,G) and (*, G) entries in the PIM routing table
(172.168.0.2, 227.0.0.1)	An (S, G) entry in the PIM routing table
Protocol	PIM mode, PIM-SM or PIM-DM
Flag	Flag bit of the (S, G) or (*, G) entry in the PIM routing table
Uptime	Length of time for which the (S, G) or (*, G) entry has been existing
Upstream interface	Upstream (incoming) interface of the (S, G) or (*, G) entry
Upstream neighbor	Upstream neighbor of the (S, G) or (*, G) entry
RPF prime neighbor	RPF neighbor of the (S, G) or (, G) entry l For a (, G) entry, if this router is the RP, the RPF neighbor of this (*, G) entry is NULL. l For a (S, G) entry, if this router directly connects to the multicast source, the RPF neighbor of this (S, G) entry is NULL.
Downstream interface(s) information	Information of the downstream interface(s), including: l Number of downstream interfaces l Downstream interface name l PIM mode on the downstream interface(s) l Uptime of the downstream interface(s) l Expiry time of the downstream interface(s)

6.1.23 display pim rp-info

Syntax

display pim rp-info [ group-address ]

View

Any view

Parameters

group-address: Address of the multicast group of which the RP information is to be displayed, in the range of 224.0.1.0 to 239.255.255.255. If you do not provide a group address, this command will display the RP information corresponding to all multicast groups.

Description

Use the display pim rp-info command to view the RP information.

Note that:

l The RP information includes the information of RPs dynamically found by the BSR mechanism and static RPs.

l Because a non-BSR router refreshes its local RP-Set only based on the received BSR bootstrap messages, the system does not delete an RP even if its expiry time is 0. Instead, the system waits for the next bootstrap message from the BSR: if the bootstrap message does not contain information of the RP, the system will delete it.

Examples

# View the RP information corresponding to the multicast group 224.0.1.1.

<Sysname> display pim rp-info 224.0.1.1

BSR RP Address is: 2.2.2.2

Priority: 0

HoldTime: 150

Uptime: 03:01:10

Expires: 00:02:30

RP mapping for this group is: 2.2.2.2

# View the RP information corresponding to all multicast groups.

<Sysname> display pim rp-info

PIM-SM BSR RP information:

Group/MaskLen: 224.0.0.0/4

RP: 2.2.2.2

Priority: 0

HoldTime: 150

Uptime: 03:01:36

Expires: 00:02:29

Table 6-10 Description on the fields of the display pim rp-info command

Field	Description
BSR RP Address is	IP address of the BSR RP
Group/MaskLen	The multicast group served by the RP
RP	IP address of the RP
Priority	RP priority
HoldTime	RP timeout time
Uptime	Length of time for which the RP has been up, in hours:minutes:seconds
Expires	Length of time in which the RP will expire, in hours:minutes:seconds
RP mapping for this group is: 2.2.2.2	The IP address of the RP serving the current multicast group is 2.2.2.2

6.1.24 hello-option dr-priority

Syntax

hello-option dr-priority priority

undo hello-option dr-priority

View

PIM view

Parameters

priority: Router priority for DR election, in the range of 0 to 4294967295. A larger value of this argument means a higher priority.

Description

Use the hello-option dr-priority command to configure the global value of the router priority for DR election.

Use the undo hello-option dr-priority command to restore the system default.

By default, the router priority for DR election is 1.

Related commands: pim hello-option dr-priority.

Examples

# Set the router priority for DR election to 3.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option dr-priority 3

6.1.25 hello-option holdtime

Syntax

hello-option holdtime interval

undo hello-option holdtime

View

PIM view

Parameters

interval: PIM neighbor timeout time in seconds, with an effective range of 1 to 65,535.

Description

Use the hello-option holdtime command to configure the PIM neighbor timeout time.

Use the undo hello-option holdtime command to restore the system default.

By default, the PIM neighbor timeout time is 105 seconds.

This command is effective for both PIM-DM and PIM-SM.

Related commands: pim hello-option holdtime.

Examples

# Set the global value of the PIM neighbor timeout time to 120 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option holdtime 120

6.1.26 hello-option lan-delay

Syntax

hello-option lan-delay interval

undo hello-option lan-delay

View

PIM view

Parameters

interval: LAN-delay time in milliseconds, with an effective range of 1 to 32,767.

Description

Use the hello-option lan-delay command to configure the global value of the LAN-delay time, namely the length of time the device waits between receiving a prune message from downstream and taking the prune action. Within this period of time, if the device receives a prune override message from that downstream device, the prune action will be overridden.

Use the undo hello-option lan-delay command to restore the system default.

By default, the LAN-delay time is 500 milliseconds.

This command is effective for both PIM-DM and PIM-SM.

Related commands: hello-option override-interval, pim hello-option override-interval, pim hello-option lan-delay.

Examples

# Set the LAN-delay time to 200 milliseconds globally.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option lan-delay 200

6.1.27 hello-option neighbor-tracking

Syntax

hello-option neighbor-tracking

undo hello-option neighbor-tracking

View

PIM view

Parameters

None

Description

Use the hello-option neighbor-tracking command to globally disable join suppression, namely enable neighbor tracking.

Use the undo hello-option neighbor-tracking command to enable join suppression.

By default, join suppression is enabled, namely neighbor tracking is disabled.

This command is effective for both PIM-DM and PIM-SM.

Related commands: pim hello-option neighbor-tracking.

Examples

# Disable join suppression globally.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option neighbor-tracking

6.1.28 hello-option override-interval

Syntax

hello-option override-interval interval

undo hello-option override-interval

View

PIM view

Parameters

interval: Prune override interval in milliseconds, with an effective range of 1 to 65,535.

Description

Use the hello-option override-interval command to configure the global value of the prune override interval.

Use the undo hello-option override-interval command to restore the system default.

By default, the prune override interval is 2,500 milliseconds.

This command is effective for both PIM-DM and PIM-SM.

Related commands: hello-option lan-delay, pim hello-option lan-delay, pim hello-option override-interval.

Examples

# Set the prune override interval to 2,000 milliseconds globally.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option override-interval 2000

6.1.29 holdtime assert

Syntax

holdtime assert interval

undo holdtime assert

View

PIM view

Parameters

interval: Assert timeout time in seconds, with an effective range of 7 to 2,147,483,647.

Description

Use the holdtime assert command to configure the global value of the assert timeout time.

Use the undo holdtime assert command to restore the system default.

By default, the assert timeout time is 180 seconds.

This command is effective for both PIM-DM and PIM-SM.

Related commands: holdtime join-prune, pim holdtime join-prune, pim holdtime assert.

Examples

# Set the global value of the assert timeout time to 100 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] holdtime assert 100

6.1.30 holdtime join-prune

Syntax

holdtime join-prune interval

undo holdtime join-prune

View

PIM view

Parameters

interval: Join/prune timeout time in seconds, with an effective range of 1 to 65,535.

Description

Use the holdtime join-prune command to configure the global value of the join/prune timeout time.

Use the undo holdtime join-prune command to restore the system default.

By default, the join/prune timeout time is 210 seconds.

Related commands: holdtime assert, pim holdtime assert, pim holdtime join-prune.

Examples

# Set the global value of the join/prune timeout time to 280 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] holdtime join-prune 280

6.1.31 jp-pkt-size

Syntax

jp-pkt-size packet-size

undo jp-pkt-size

View

PIM view

Parameters

packet-size: Maximum size of join/prune messages in bytes, with an effective range of 100 to 8,100.

Description

Use the jp-pkt-size command to configure the maximum size of join/prune messages.

Use the undo jp-pkt-size command to restore the system default.

By default, the maximum size of join/prune messages is 8,100 bytes.

Related commands: jp-queue-size.

Examples

# Set the maximum size of join/prune messages to 1,500 bytes.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] jp-pkt-size 1500

6.1.32 jp-queue-size

Syntax

jp-queue-size queue-size

undo jp-queue-size

View

PIM view

Parameters

queue-size: Maximum number of (S, G) entries in a join/prune message, in the range of 1 to 4,096.

Description

Use the jp-queue-size command to configure the maximum number of (S, G) entries in a join/prune message.

Use the undo jp-queue-size command to restore the system default.

By default, a join/prune messages contains a maximum of 1,020 (S, G) entries.

When you use this command, take the following into account:

l The size of the forwarding table. In a network that does not support packet fragmentation, if you configure a large queue-size, a join/prune message may contain a large number of groups, causing the message length to exceed the MTU of the network. As a result, the products that do not support fragmentation will drop the join/prune message.

l The (S, G) join/prune state hold time on the upstream device. If you configure a small queue size, the outgoing interface of the corresponding entry may have been pruned due to timeout before the last join/prune message in a queue reaches the upstream device.

Related commands: jp-pkt-size, holdtime join-prune, pim holdtime join-prune.

Examples

# Configure a join/prune messages to contain a maximum of 2,000 (S, G) entries.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] jp-queue-size 2000

6.1.33 pim

Syntax

pim

undo pim

View

System view

Parameters

None

Description

Use the pim command to enter PIM view.

Use the undo pim command to remove all configurations performed in PIM view.

IP multicast must be enabled on the device before this command can take effect.

Examples

# Enable IP multicast routing and enter PIM view.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim]

6.1.34 pim bsr-boundary

Syntax

pim bsr-boundary

undo pim bsr-boundary

View

Interface view

Parameters

None

Description

Use the pim bsr-boundary command to configure a BSR admin-scope region boundary on the current interface.

Use the undo pim bsr-boundary command to remove the configured BSR admin-scope region boundary.

By default, no BSR admin-scope region boundary is configured.

Examples

# Configure VLAN-interface 100 to be the boundary of the BSR admin-scope region.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim bsr-boundary

6.1.35 pim dm

Syntax

pim dm

undo pim dm

View

Interface view

Parameters

None

Description

Use the pim dm command to enable PIM-DM.

Use the undo pim dm command to disable PIM-DM.

By default, PIM-DM is disabled.

Note that PIM-DM cannot be used for multicast groups in the SSM group range.

Related commands: pim sm, ssm-policy.

Examples

# Enable PIM-DM on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim dm

6.1.36 pim hello-option dr-priority

Syntax

pim hello-option dr-priority priority

undo pim hello-option dr-priority

View

Interface view

Parameters

priority: Router priority for DR election, in the range of 0 to 4294967295. A larger value of this argument means a higher priority.

Description

Use the pim hello-option dr-priority command to configure the router priority for DR election on the current interface.

Use the undo pim hello-option dr-priority command to restore the system default.

By default, the router priority for DR election is 1.

Related commands: hello-option dr-priority.

Examples

# Set the router priority for DR election to 3 on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option dr-priority 3

6.1.37 pim hello-option holdtime

Syntax

pim hello-option holdtime interval

undo pim hello-option holdtime

View

Interface view

Parameters

interval: PIM neighbor timeout time in seconds, with an effective range of 1 to 65,535.

Description

Use the pim hello-option holdtime command to configure the PIM neighbor timeout time on the current interface.

Use the undo pim hello-option holdtime command to restore the system default.

By default, the PIM neighbor timeout time is 105 seconds.

Related commands: hello-option holdtime.

Examples

# Set the PIM neighbor timeout time to 120 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option holdtime 120

6.1.38 pim hello-option lan-delay

Syntax

pim hello-option lan-delay interval

undo pim hello-option lan-delay

View

Interface view

Parameters

interval: LAN-delay time in milliseconds, with an effective range of 1 to 32,767.

Description

Use the pim hello-option lan-delay command to configure the LAN-delay time, namely the length of time the device waits between receiving a prune message and taking a prune action, on the current interface.

Use the undo pim hello-option lan-delay command to restore the system default.

By default, the LAN-delay time to 500 milliseconds.

Related commands: pim hello-option override-interval, hello-option override-interval, hello-option lan-delay.

Examples

# Set the LAN-delay time to 200 milliseconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option lan-delay 200

6.1.39 pim hello-option neighbor-tracking

Syntax

pim hello-option neighbor-tracking

undo pim hello-option neighbor-tracking

View

Interface view

Parameters

None

Description

Use the pim hello-option neighbor-tracking command to disable join suppression, namely enable neighbor tracking, on the current interface.

Use the undo pim hello-option neighbor-tracking command to enable join suppression.

By default, join suppression is enabled, namely neighbor tracking is disabled.

Related commands: hello-option neighbor-tracking.

Examples

# Disable join suppression on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option neighbor-tracking

6.1.40 pim hello-option override-interval

Syntax

pim hello-option override-interval interval

undo pim hello-option override-interval

View

Interface view

Parameters

interval: Prune override interval in milliseconds, with an effective range of 1 to 65,535.

Description

Use the pim hello-option override-interval command to configure the prune override interval on the current interface.

Use the undo pim hello-option override-interval command to restore the system default.

By default, the prune override interval is 2,500 milliseconds.

Related commands: pim hello-option lan-delay, hello-option lan-delay, hello-option override-interval.

Examples

# Set the prune override interval to 2,000 milliseconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option override-interval 2000

6.1.41 pim holdtime assert

Syntax

pim holdtime assert interval

undo pim holdtime assert

View

Interface view

Parameters

interval: Assert timeout time in seconds, with an effective range of 7 to 2,147,483,647.

Description

Use the pim holdtime assert command to configure the assert timeout time on the current interface.

Use the undo pim holdtime assert command to restore the system default.

By default, the assert timeout time is 180 seconds.

Related commands: holdtime join-prune, pim holdtime join-prune, holdtime assert.

Examples

# Set the assert timeout time to 100 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim holdtime assert 100

6.1.42 pim holdtime join-prune

Syntax

pim holdtime join-prune interval

undo pim holdtime join-prune

View

Interface view

Parameters

interval: Join/prune timeout time in seconds, with an effective range of 1 to 65,535.

Description

Use the pim holdtime join-prune command to configure the join/prune timeout time on the interface.

Use the undo pim holdtime join-prune command to restore the system default.

By default, the join/prune timeout time is 210 seconds.

Related commands: holdtime assert, pim holdtime assert, holdtime join-prune.

Examples

# Set the join/prune timeout time to 280 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim holdtime join-prune 280

6.1.43 pim require-genid

Syntax

pim require-genid

undo pim require-genid

View

Interface view

Parameters

None

Description

Use the pim require-genid command enable rejection of hello messages without Generation_ID.

Use the undo pim require-genid command to restore the default configuration.

By default, hello messages without Generation_ID are accepted.

Examples

# Enable VLAN-interface 100 to reject hello messages without Generation_ID.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim require-genid

6.1.44 pim sm

Syntax

pim sm

undo pim sm

View

Interface view

Parameters

None

Description

Use the pim sm command to enable PIM-SM.

Use the undo pim sm command to disable PIM-SM.

By default, PIM-SM is disabled.

Related commands: pim dm.

Examples

# Enable PIM-SM on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim sm

6.1.45 pim state-refresh-capable

Syntax

pim state-refresh-capable

undo pim state-refresh-capable

View

Interface view

Parameters

None

Description

Use the pim state-refresh-capable command to enable the state fresh feature on the interface.

Use the undo pim state-refresh-capable command to disable the state fresh feature.

By default, the state refresh feature is enabled.

Related commands: state-refresh-interval, state-refresh-rate-limit, state-refresh-ttl.

Examples

# Disable state refresh on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] undo pim state-refresh-capable

6.1.46 pim timer graft-retry

Syntax

pim timer graft-retry interval

undo pim timer graft-retry

View

Interface view

Parameters

interval: Graft retry period in seconds, with an effective range of 1 to 65,535.

Description

Use the pim timer graft-retry command to configure the graft retry period.

Use the undo pim timer graft-retry command to restore the system default.

By default, the graft retry period is 3 seconds.

Examples

# Set the graft retry period to 80 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer graft-retry 80

6.1.47 pim timer hello

Syntax

pim timer hello interval

undo pim timer hello

View

Interface view

Parameters

interval: Hello interval in seconds, with an effective range of 1 to 2,147,483,647.

Description

Use the pim timer hello command to configure on the current interface the interval at which hello messages are sent.

Use the undo pim timer hello command to restore the system default.

By default, hello messages are sent at the interval of 30 seconds.

Related commands: timer hello.

Examples

# Set the hello interval to 40 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer hello 40

6.1.48 pim timer join-prune

Syntax

pim timer join-prune interval

undo pim timer join-prune

View

Interface view

Parameters

interval: Join/prune interval in seconds, with an effective range of 1 to 2,147,483,647.

Description

Use the pim timer join-prune command to configure on the current interface the interval at which join/prune messages are sent.

Use the undo pim timer join-prune command to restore the system default.

By default, the join/prune interval is 60 seconds.

Related commands: timer join-prune.

Examples

# Set the join/prune interval to 80 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer join-prune 80

6.1.49 pim triggered-hello-delay

Syntax

pim triggered-hello-delay interval

undo pim trigged-hello-delay

View

Interface view

Parameters

interval: Maximum delay in seconds between hello messages, with an effective range of 1 to 5.

Description

Use the pim triggered-hello-delay command to configure the maximum delay between hello messages.

Use the undo pim triggered-hello-delay command to restore the system default.

By default, the maximum delay between hello messages is 5 seconds.

Examples

# Set the maximum delay between hello messages to 3 seconds on VLAN-interface 100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim trigged-hello-delay 3

6.1.50 probe-interval

Syntax

probe-interval interval

undo probe-interval

View

PIM view

Parameters

interval: Probe time in seconds, with an effective range of 1 to 3,600.

Description

Use the probe-interval command to configure the probe time, namely the interval at which the DR sends null register messages before the register suppression timer expires.

Use the undo probe-interval command to restore the system default.

By default, the probe time is 5 seconds.

Related commands: register-suppression-timeout.

Examples

# Set the probe time to 6 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] probe-interval 6

6.1.51 register-policy

Syntax

register-policy acl-number

undo register-policy

View

PIM view

Parameters

acl-number: Advanced ACL number, in the range of 3000 to 3999. Only register messages that match the permit statement of the ACL can be accepted by the RP.

Description

Use the register-policy command to configure an ACL rule to filter register messages.

Use the undo register-policy command to remove the configured register filtering rule.

By default, no register filtering rule is configured.

Related commands: register-suppression-timeout.

Examples

# Configure the RP to accept only those register messages for multicast traffic from multicast sources in the range of 10.10.0.0/16 to multicast groups in the range of 225.1.0.0/16.

<Sysname> system-view

[Sysname] acl number 3000

[Sysname-acl-adv-3000] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3000] quit

[Sysname] pim

[Sysname-pim] register-policy 3000

6.1.52 register-suppression-timeout

Syntax

register-suppression-timeout interval

undo register-suppression-timeout

View

PIM view

Parameters

interval: Register suppression timeout in seconds, in the range of 1 to 3,600.

Description

Use the register-suppression-timeout command to configure the register suppression timeout time.

Use the undo register-suppression-timeout command to restore the system default.

By default, the register suppression timeout time is 60 seconds.

Related commands: probe-interval, register-policy.

Examples

# Set the register suppression timeout time to 70 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-suppression-timeout 70

6.1.53 register-whole-checksum

Syntax

register-whole-checksum

undo register-whole-checksum

View

PIM view

Parameters

None

Description

Use the register-whole-checksum command to configure the router to calculate the checksum based on the entire register message.

Use the undo register-whole-checksum command to restore the default configuration.

By default, the checksum is calculated based on the header in the register message.

Related commands: register-policy, register-suppression-timeout.

Examples

# Configure the router to calculate the checksum based on the entire register message.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-whole-checksum

6.1.54 reset pim control-message counters

Syntax

reset pim control-message counters [ interface interface-type interface-number ]

View

User view

Parameters

interface interface-type interface-number: Specifies to reset the PIM control message counter on a particular interface. If no interface is specified, this command will clear the statistics information of PIM control messages on all interfaces.

Description

Use the reset pim control-message counters command to reset PIM control message counters.

Examples

# Reset PIM control message counters on all interfaces.

<Sysname> reset pim control-message counters

6.1.55 source-lifetime

Syntax

source-lifetime interval

undo source-lifetime

View

PIM view

Parameters

interval: Multicast source lifetime in seconds, with an effective range of 1 to 65,535.

Description

Use the source-lifetime command to configure the multicast source lifetime.

Use the undo source-lifetime command to restore the system default.

By default, the lifetime of a multicast source is 210 seconds.

Related commands: state-refresh-interval.

Examples

# Set the multicast source lifetime to 200 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] source-lifetime 200

6.1.56 source-policy

Syntax

source-policy acl-number

undo source-policy

View

PIM view

Parameters

acl-number: Basic or advanced ACL number, in the range of 2000 to 3999.

Description

Use the source-policy command to configure a multicast data filter.

Use the undo source-policy command to remove the configured multicast data filter.

By default, no multicast data filter is configured.

Note that:

l If you specify a basic ACL, the device filters all the received multicast packets based on the source address, and discards packets that fail the source address match.

l If you specify an advanced ACL, the device filters all the received multicast packets based on the source and group addresses, and discards packets that fail the match.

l If this command is executed repeatedly, the last configuration will take effect.

Examples

# Configure the router to accept multicast packets originated from 10.10.1.2 and discard multicast packets originated from 10.10.1.1.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 10.10.1.2 0

[Sysname-acl-basic-2000] rule deny source 10.10.1.1 0

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] source-policy 2000

6.1.57 spt-switch-threshold

Syntax

spt-switch-threshold infinity [ group-policy acl-number [ order order-value ] ]

undo spt-switch-threshold [ group-policy acl-number ]

View

PIM view

Parameters

infinity: Disables RPT-to-SPT switchover.

group-policy acl-number: Uses this threshold for multicast groups matching the specified multicast policy. In this option, acl-number refers to a basic ACL number, in the range of 2000 to 2999. If you do not include this option in your command, the threshold will apply on all multicast groups.

order order-value: Specifies the order of the ACL in the group-policy list, where order-value has an effective range of 1 to (the largest order value in the existing group-policy list + 1), but the value range should not include the original order value of the ACL in the group-policy list. If you have assigned an order-value to a certain ACL, do not specify the same order-value for another ACL; otherwise the system will give error information. If you do not specify an order-value, the order value of the ACL will remain the same in the group-policy list.

Description

Use the spt-switch-threshold command to disable RPT-to-SPT switchover.

Use the undo spt-switch-threshold command to restore the system default.

By default, the device switches to the SPT immediately after it receives the first multicast packet from the RPT.

Note that:

l To adjust the order of an existing ACL in the group-policy list, you can use the acl-number argument to specify this ACL and set its order-value. This will insert the ACL to the position of order-value in the group-policy list. The order of the other existing ACLs in the group-policy list will remain unchanged.

l To use an ACL that does not exist in the group-policy list, you can use the acl-number argument to specify an ACL and set its order-value. This will insert the ACL to the position of order-value in the group-policy list. If you do not include the order order-value option in your command, the ACL will be appended to the end of the group-policy list.

l If you use this command multiple times on the same multicast group, the first traffic rate configuration matched in sequence will take effect.

l For a switch, once a multicast forwarding entry is created, subsequent multicast data will not be encapsulated in register messages before being forwarded even if a register outgoing interface is available. Therefore, to avoid forwarding failure, do not include the infinity keyword in the spt-switch-threshold command on a switch that may become an RP (namely, a static RP or a C-RP).

Examples

# Disable RPT-to-SPT switchover on a switch that will never become an RP.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] spt-switch-threshold infinity

6.1.58 ssm-policy

Syntax

ssm-policy acl-number

undo ssm-policy

View

PIM view

Parameters

acl-number: Basic ACL number, in the range of 2000 to 2999.

Description

Use the ssm-policy command to configure the SSM multicast group range.

Use the undo ssm-policy command to restore the system default.

By default, the SSM group range is 232.0.0.0/8.

This command allows you to define an address range of permitted or denied multicast sources or groups. If the match succeeds, the multicast mode will be PIM-SSM; otherwise the multicast mode will be PIM-SM.

Examples

# Configure the SSM group range to be 232.1.0.0/16.

<Sysname> system-view

[Sysname] acl number 2000

[Sysname-acl-basic-2000] rule permit source 232.1.0.0 0.0.255.255

[Sysname-acl-basic-2000] quit

[Sysname] pim

[Sysname-pim] ssm-policy 2000

6.1.59 state-refresh-interval

Syntax

state-refresh-interval interval

undo state-refresh-interval

View

PIM view

Parameters

interval: State refresh interval in seconds, with an effective range of 1 to 255.

Description

Use the state-refresh-interval command to configure the interval between state refresh messages.

Use the undo state-refresh-interval command to restore the system default.

By default, the state refresh interval is 60 seconds.

Related commands: pim state-refresh-capable, state-refresh-rate-limit, state-refresh-ttl.

Examples

# Set the state refresh interval to 70 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-interval 70

6.1.60 state-refresh-rate-limit

Syntax

state-refresh-rate-limit interval

undo state-refresh-rate-limit

View

PIM view

Parameters

interval: Time to wait before receiving a new refresh message, in seconds and with an effective range of 1 to 65535.

Description

Use the state-refresh-rate-limit command to configure the time the router must wait before receiving a new state refresh message.

Use the undo state-refresh-rate-limit command to restore the system default.

By default, the device waits 30 seconds before receiving a new state refresh message.

Related commands: pim state-refresh-capable, state-refresh-interval, state-refresh-ttl.

Examples

# Configure the state refresh interval to 45 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-rate-limit 45

6.1.61 state-refresh-ttl

Syntax

state-refresh-ttl ttl-value

undo state-refresh-ttl

View

PIM view

Parameters

ttl-value: TTL value of state refresh messages, in the range of 1 to 255.

Description

Use the state-refresh-ttl command to configure the TTL value of state refresh messages.

Use the undo state-refresh-ttl command to restore the system default.

By default, the TTL value of state refresh messages is 255.

Related commands: pim state-refresh-capable, state-refresh-interval, state-refresh-rate-limit.

Examples

# Configure the device to send PIM state refresh messages with a TTL of 45.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-ttl 45

6.1.62 static-rp

Syntax

static-rp rp-address [ acl-number ] [ preferred ]

undo static-rp rp-address

View

PIM view

Parameters

rp-address: IP address of the static RP to be configured. This address must be a legal unicast IP address, rather than an address on the 127.0.0.0/8 segment.

acl-number: Basic ACL number, in the range of 2000 to 2999. If you provide this argument, the configured static RP will serve only those groups that pass the ACL filtering; otherwise, the configured static RP will serve the all-system group 224.0.0.0/4.

preferred: Specifies to give priority to the static RP if the static RP conflicts with the dynamic RP. If you do not include the preferred keyword in your command, the dynamic RP will be given priority, and the static RP takes effect on if no dynamic RP exists in the network or when the dynamic RP fails.

Description

Use the static-rp command to configure a static RP.

Use the undo static-rp command to configure a static RP.

By default, no static RP is configured.

Note that:

l PIM-SM or PIM-DM cannot be enabled on an interface that serves as a static RP.

l When the ACL rule applied on a static RP changes, a new RP must be elected for all the multicast groups.

l You can configure multiple static RPs by using this command repeatedly. However, if you carry out this command multiple times and specify the same static RP address or reference the same ACL rule, the last configuration will override the previous one. If multiple static RPs have been configured for the same multicast group, the one with the highest IP address will be chosen to serve the multicast group.

l You can configure up to 50 static RPs on the same device.

Related commands: display pim rp-info, auto-rp enable.

Examples

# Configure the interface with the IP address 11.110.0.6 to be a static RP that serves the multicast groups defined in ACL 2001, and give priority to this static RP in the case of static/dynamic RP conflict.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] static-rp 11.110.0.6 2001 preferred

6.1.63 timer hello

Syntax

timer hello interval

undo timer hello

View

PIM view

Parameters

interval: Hello interval in seconds, with an effective range of 1 to 2,147,483,647.

Description

Use the timer hello command to configure the hello interval globally.

Use the undo timer hello command to restore the system default.

By default, hello messages are sent at the interval of 30 seconds.

Related commands: pim timer hello.

Examples

# Set the global hello interval to 40 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer hello 40

6.1.64 timer join-prune

Syntax

timer join-prune interval

undo timer join-prune

View

PIM view

Parameters

interval: Join/prune interval in seconds, with an effective range of 1 to 2,147,483,647.

Description

Use the timer join-prune command to configure the join/prune interval globally.

Use the undo timer join-prune command to restore the system default.

By default, the join/prune interval is 60 seconds.

Related commands: pim timer join-prune.

Examples

# Set the global join/prune interval to 80 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer join-prune 80

Chapter 7 MSDP Configuration Commands

& Note:

The term “router” in this document refers to a router in the generic sense or a Layer 3 switch running MSDP.

7.1 MSDP Configuration Commands

7.1.1 cache-sa-enable

Syntax

cache-sa-enable

undo cache-sa-enable

View

MSDP view

Parameters

None

Description

Use the cache-sa-enable command to enable the SA message cache mechanism.

Use the undo cache-sa-enable command to disable the SA message cache mechanism.

By default, the SA message cache mechanism is enabled.

Examples

# Enable the SA message cache mechanism.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] cache-sa-enable

7.1.2 display msdp brief

Syntax

display msdp brief [ state { connect | down | listen | shutdown | up } ]

View

Any view

Parameters

state: Displays the information of MSDP peers in the specified state.

connect: Displays the information of MSDP peers in the connecting state.

down: Displays the information of MSDP peers in the down state.

listen: Displays the information of MSDP peers in the listening state.

shutdown: Displays the information of MSDP peers in the deactivated state.

up: Displays the information of MSDP peers in the in-session state.

Description

Use the display msdp brief command to view the brief information of MSDP peers.

Examples

# View the brief information of MSDP peers in all states.

<Sysname> display msdp brief

MSDP Peer Brief Information

Configured Up Listen Connect Shutdown Down

1 1 0 0 0 0

Peer's Address State Up/Down time AS SA Count Reset Count

20.20.20.20 Up 00:00:13 100 0 0

Table 7-1 Description on the fields of the display msdp brief command

Field	Description
Peer's Address	MSDP peer address
State	MSDP peer status: l Up: Session set up; MSDP peer in session l Listen: Session set up; local device as server, in listening state l Connect: Session not set up; local device as client, in connecting state l Shutdown: Deactivated l Down: Connection failed
Up/Down time	Length of time since MSDP peer connection was established/failed
AS	Number of the AS where the MSDP peer is located. “?” indicates that the system was unable to obtain the AS number.
SA Count	Number of (S, G) entries
Reset Count	MSDP peer connection reset times

7.1.3 display msdp peer-status

Syntax

display msdp peer-status [ peer-address ]

View

Any view

Parameters

peer-address: Specifies an MSDP peer by its address. If you do not provide this argument, this command will display the detailed status information of all MSDP peers.

Description

Use the display msdp peer-status command to view the detailed MSDP peer status information.

Related commands: peer connect-interface, peer description, peer mesh-group, peer minimum-ttl, peer request-sa-enable, peer sa-cache-maximum, peer sa-policy, peer sa-request-policy.

Examples

# View the detailed status information of the MSDP peer with the address of 10.110.11.11.

<Sysname> display msdp peer-status 10.110.11.11

MSDP Peer 20.20.20.20, AS 100

Description:

Information about connection status:

State: Up

Up/down time: 14:41:08

Resets: 0

Connection interface: LoopBack0 (20.20.20.30)

Number of sent/received messages: 867/947

Number of discarded output messages: 0

Elapsed time since last connection or counters clear: 14:42:40

Information about (Source, Group)-based SA filtering policy:

Import policy: none

Export policy: none

Information about SA-Requests:

Policy to accept SA-Request messages: none

Sending SA-Requests status: disable

Minimum TTL to forward SA with encapsulated data: 0

SAs learned from this peer: 0, SA-cache maximum for the peer: none

Input queue size: 0, Output queue size: 0

Counters for MSDP message:

Count of RPF check failure: 0

Incoming/outgoing SA messages: 0/0

Incoming/outgoing SA requests: 0/0

Incoming/outgoing SA responses: 0/0

Incoming/outgoing data packets: 0/0

Table 7-2 Description on the fields of the display msdp peer-status command

Field	Description
MSDP Peer	MSDP peer address
AS	Number of the AS where the MSDP peer is located. “?” indicates that the system was unable to obtain the AS number.
State	MSDP peer status: l Up: Session set up; MSDP peer in session l Listen: Session set up; local device as server, in listening state l Connect: Session not set up; local device as client, in connecting state l Shutdown: Deactivated l Down: Connection failed
Resets	Number of times the MSDP peer connection is reset
Up/Down time	Length of time since MSDP peer connection was established/failed
Connection interface	Interface and its IP address used for setting up a TCP connection with the remote MSDP peer
Number of sent/received messages	Number of SA messages sent and received through this connection
Number of discarded output messages	Number of discarded outgoing messages
Elapsed time since last connection or counters clear	Time passed since the information of the MSDP peer was last cleared
Information about (Source, Group)-based SA filtering policy	SA message filtering list information l Import policy: Filter list for receiving SA messages from the specified MSDP peer l Export policy: Filter list for forwarding SA messages from the specified MSDP peer
Information about SA-Requests	SA requests information l Policy to accept SA-Request messages: Filtering rule for receiving or forwarding SA messages from the specified MSDP peer l Sending SA-Requests status: Whether enabled to send an SA request message to the designated MSDP peer upon receiving a new Join message
Minimum TTL to forward SA with encapsulated data	Minimum TTL of multicast packet encapsulated in SA messages
SAs learned from this peer	Number of cached SA messages
SA-cache maximum for the peer	Maximum number of SA messages from the specified MSDP peer that can be cached
Input queue size	Data size cached in the input queue
Output queue size	Data size cached in the output queue
Counters for MSDP message	MSDP peer statistics: l Count of RPF check failure: Number of SA messages discarded due to RPF check failure l Incoming/outgoing SA messages: Number of SA messages received and sent l Incoming/outgoing SA requests: Number of SA request received and sent l Incoming/outgoing SA responses: Number of SA responses received and sent l Incoming/outgoing data packets: Number of received and sent SA messages encapsulated with multicast data

7.1.4 display msdp sa-cache

Syntax

display msdp sa-cache [ group-address | source-address | as-number ] *

View

Any view

Parameters

group-address: Multicast group address in the (S, G) entry, in the range of 224.0.1.0 to 239.255.255.255.

source-address: Multicast source address in the (S, G) entry.

as-number: AS number, in the range of 1 to 65535.

Description

Use the display msdp sa-cache command to view the information of (S, G) entries in the MSDP cache.

Note that:

l This command gives the corresponding output only after the cache-sa-enable command is executed.

l If you do not provide a source address, this command will display the information of all sources in the specified multicast group.

l If you do not provide a group address and a source address, this command will display the information of all cached entries.

l If you do not provide an AS number, this command will display the information related to all ASs.

Related commands: cache-sa-enable.

Examples

# View the information of (S, G) entries in the MSDP cache.

<Sysname> display msdp sa-cache

MSDP Total Source-Active Cache - 5 entries

(Source, Group) Origin RP Pro AS Uptime Expires

(10.10.1.2, 225.1.1.1) 10.10.10.10 BGP 100 00:00:10 00:05:50

(10.10.1.3, 225.1.1.1) 10.10.10.10 BGP 100 00:00:11 00:05:49

(10.10.1.2, 225.1.1.2) 10.10.10.10 BGP 100 00:00:11 00:05:49

(10.10.2.1, 225.1.1.2) 10.10.10.10 BGP 100 00:00:11 00:05:49

(10.10.1.2, 225.1.2.2) 10.10.10.10 BGP 100 00:00:11 00:05:49

MSDP matched 5 entries

Table 7-3 Description on the fields of the display msdp sa-cache command

Field	Description
(Source, Group)	(S, G) entry: (source address, group address)
Origin RP	Address of the RP that generated the (S, G) entry
Pro	Type of protocol from which the AS number is originated. “?” indicates that the system was unable to obtain the protocol type.
AS	AS number of the origin RP. “?” indicates that the system was unable to obtain the AS number.
Uptime	Length of time for which the cached (S, G) entry has been existing, in hours:minutes:seconds
Expires	Length of time in which the cached (S, G) entry will expire, in hours:minutes:seconds

7.1.5 display msdp sa-count

Syntax

display msdp sa-count [ as-number ]

View

Any view

Parameters

as-number: AS number, in the range of 1 to 65535.

Description

Use the display msdp sa-count command to view the number of SA messages in the MSDP cache.

This command gives the corresponding output only after the cache-sa-enable command is executed.

Related commands: cache-sa-enable.

Examples

# View the number of SA messages in the MSDP cache.

<Sysname> display msdp sa-count

Number of cached Source-Active entries, counted by Peer

Peer's Address Number of SA

10.10.10.10 5

Number of source and group, counted by AS

AS Number of source Number of group

? 3 3

Total 5 Source-Active entries

Table 7-4 Description on the fields of the display msdp sa-count command

Field	Description
Number of cached Source-Active entries, counted by Peer	Number of SA messages per peer
Peer's Address	MSDP peer addresses
Number of SA	Number of SA messages from this peer
AS	Number of the AS where the MSDP peer is located. “?” indicates that the system was unable to obtain the AS number.
Number of source	Number of multicast sources from this AS
Number of group	Number of multicast groups from this AS

7.1.6 encap-data-enable

Syntax

encap-data-enable

undo encap-data-enable

View

MSDP view

Parameters

None

Description

Use the encap-data-enable command to enable register message encapsulation in SA messages.

Use the undo encap-data-enable command to disable register message encapsulation in SA messages.

By default, an SA message contains only an (S, G) entry. No register message is encapsulated in an SA message.

Examples

# Enable register message encapsulation in SA messages.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] encap-data-enable

7.1.7 import-source

Syntax

import-source [ acl acl-number ]

undo import-source

View

MSDP view

Parameters

acl-number: Basic or advanced ACL number, in the range of 2000 to 3999. A basic ACL is used to filter multicast sources, while an advanced ACL is used to filter multicast sources or multicast groups. If you do not provide this argument in your command, no multicast source information will be advertised.

& Note:

During ACL matching, the protocol ID in the ACL rule is not checked.

Description

Use the import-source command to configure a rule of creating (S, G) entries.

Use the undo import-source command to remove any rule of creating (S, G) entries.

By default, when an SA message is created, there are no restrictions on the (S, G) entries to be advertised in it, namely all the (S, G) entries within the domain are advertised in the SA message.

In addition to controlling SA message creation by using this command, you can also configure a filtering rule for forwarding and receiving SA messages by using the peer sa-policy command.

Related commands: peer sa-policy.

Examples

# Configure the MSDP peer to advertise only the (S, G) entries of multicast sources on the 10.10.0.0/16 subnet and with multicast group address of 225.1.0.0/16 when creating an SA message.

<Sysname> system-view

[Sysname] acl number 3101

[Sysname-acl-adv-3101] rule permit ip source 10.10.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3101] quit

[Sysname] msdp

[Sysname-msdp] import-source acl 3101

7.1.8 msdp

Syntax

msdp

undo msdp

View

System view

Parameters

None

Description

Use the msdp command to enable MSDP and enter MSDP view.

Use the undo msdp command to disable MSDP and remove the configurations performed in MSDP view to free the resources occupied by MSDP.

By default, MSDP is disabled.

Examples

# Enable MSDP and enter MSDP view.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] msdp

[Sysname-msdp]

7.1.9 originating-rp

Syntax

originating-rp interface-type interface-number

undo originating-rp

View

MSDP view

Parameters

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

Description

Use the originating-rp command to configure the address of the specified interface as the RP address of SA messages.

Use the undo originating-rp command to restore the system default.

Be default, the PIM RP address is used as the RP address of SA messages.

Examples

# Specify the IP address of VLAN-interface 100 as the RP address of SA messages.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] originating-rp vlan-interface 100

7.1.10 peer connect-interface

Syntax

peer peer-address connect-interface interface-type interface-number

undo peer peer-address

View

MSDP view

Parameters

peer-address: MSDP peer address.

interface-type interface-number: Specifies an interface by its type and number. The local device will use the IP address of the specified interface as the source IP address when setting up a TCP connection with the remote MSDP peer.

Description

Use the peer connect-interface command to create an MSDP peer connection.

Use the undo peer connect-interface command to remove an MSDP peer connection.

No MSDP peer connection is created by default.

Be sure to carry out this command before you use any other peer command; otherwise the system will prompt that the peer does not exist.

Related commands: static-rpf-peer.

Examples

# Configure the router with the IP address of 125.10.7.6 as the MSDP peer of the local router, with interface VLAN-interface 100 as the local connection port.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 connect-interface vlan-interface 100

7.1.11 peer description

Syntax

peer peer-address description text

undo peer peer-address description

View

MSDP view

Parameters

peer-address: MSDP peer address.

text: Descriptive string of 1 to 80 characters, case sensitive.

Description

Use the peer description command to configure the description information for the specified MSDP peer.

Use the undo peer description command to delete the configured description information of the specified MSDP peer.

By default, an MSDP peer has no description information.

Related commands: display msdp peer-status.

Examples

# Add the descriptive text “Router CstmrA” for the router with the IP address of 125.10.7.6 to indicate that this router is Customer A.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 description Router CstmrA

7.1.12 peer mesh-group

Syntax

peer peer-address mesh-group name

undo peer peer-address mesh-group

View

MSDP view

Parameters

peer-address: MSDP peer address.

name: Mesh group name, a case-sensitive string of 1 to 32 characters.

Description

Use the peer mesh-group command to configure an MSDP peer as a mesh group member.

Use the undo peer mesh-group command to remove an MSDP peer as a mesh group member.

By default, an MSDP peer does not belong to any mesh group.

Examples

# Configure the MSDP peer with the IP address of 125.10.7.6 as a member of the mesh group “Grp1”.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 mesh-group Grp1

7.1.13 peer minimum-ttl

Syntax

peer peer-address minimum-ttl ttl-value

undo peer peer-address minimum-ttl

View

MSDP view

Parameters

peer-address: MSDP peer address.

ttl-value: Time-to-Live (TTL) value, in the range of 0 to 255.

Description

Use the peer minimum-ttl command to configure the minimum TTL value of multicast packets encapsulated in SA messages.

Use the undo peer minimum-ttl command to restore the default setting.

By default, the minimum TTL value of a multicast packet encapsulated in an SA message is 0.

Related commands: display msdp peer-status.

Examples

# Set the minimum TTL value of multicast packets to be encapsulated in SA messages to 10 so that only multicast packets whose TTL value is larger than or equal to 10 can be forwarded to the MSDP peer 110.10.10.1.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] peer 110.10.10.1 minimum-ttl 10

7.1.14 peer request-sa-enable

Syntax

peer peer-address request-sa-enable

undo peer peer-address request-sa-enable

View

MSDP view

Parameters

peer-address: MSDP peer address.

Description

Use the peer request-sa-enable command to enable the device to send SA request messages.

Use the undo peer request-sa-enable command to disable the device from sending SA request messages.

By default, no SA request message is sent.

Note that before you can enable the device to send SA requests, you must disable the SA message cache mechanism.

Related commands: cache-sa-enable.

Examples

# Disable the SA message cache mechanism, and enable the router to send an SA request message to the MSDP peer 125.10.7.6 upon receiving a new Join message.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] undo cache-sa-enable

[Sysname-msdp] peer 125.10.7.6 request-sa-enable

7.1.15 peer sa-cache-maximum

Syntax

peer peer-address sa-cache-maximum sa-limit

undo peer peer-address sa-cache-maximum

View

MSDP view

Parameters

peer-address: MSDP peer address.

sa-limit: Maximum number of SA messages that the device can cache, in the range of 1 to 8,192.

Description

Use the peer sa-cache-maximum command to configure the maximum number of SA messages that the device can cache.

Use the undo peer sa-cache-maximum command to restore the default setting.

By default, the device can cache a maximum of 8,192 SA messages.

Related commands: display msdp sa-count, display msdp peer-status, display msdp brief.

Examples

# Allow the device to cache a maximum of 100 SA messages from the MSDP peer 125.10.7.6.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 sa-cache-maximum 100

7.1.16 peer sa-policy

Syntax

peer peer-address sa-policy { import | export } [ acl acl-number ]

undo peer peer-address sa-policy { import | export }

View

MSDP view

Parameters

import: Specifies to filter SA messages from the specified MSDP peer.

export: Specifies to filter SA messages forwarded to the specified MSDP peer.

peer-address: MSDP peer address.

acl-number: Advanced ACL number, in the range of 3000 to 3999. If you do not provide an ACL number, all SA messages carrying (S, G) entries will be filtered off.

Description

Use the peer sa-policy command to configure a filtering rule for receiving or forwarding SA messages.

Use the undo peer sa-policy command to restore the default setting.

By default, SA messages received or to be forwarded are not filtered, namely, all SA messages are accepted or forwarded.

In addition to controlling SA message receiving and forwarding by using this command, you can also configure a filtering rule for creating SA messages using the import-source command.

Related commands: display msdp peer-status, import-source.

Examples

# Configure a filtering rule so that SA messages will be forwarded to the MSDP peer 125.10.7.6 only if they match ACL 3100.

<Sysname> system-view

[Sysname] acl number 3100

[Sysname-acl-adv-3100] rule permit ip source 170.15.0.0 0.0.255.255 destination 225.1.0.0 0.0.255.255

[Sysname-acl-adv-3100] quit

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 connect-interface vlan-interface 100

[Sysname-msdp] peer 125.10.7.6 sa-policy export acl 3100

7.1.17 peer sa-request-policy

Syntax

peer peer-address sa-request-policy [ acl acl-number ]

undo peer peer-address sa-request-policy

View

MSDP view

Parameters

peer-address: MSDP peer address.

acl-number: Basic ACL number, in the range of 2000 to 2999. If you provide this argument, the SA requests of only the multicast groups that match the ACL will be accepted and other SA requests will be ignored; if you do not provide this argument, all SA requests will be ignored.

Description

Use the peer sa-request-policy command to configure a filtering rule for SA request messages.

Use the undo peer sa-request-policy command to remove the configured SA request filtering rule.

Be default, SA request messages are not filtered.

Related commands: display msdp peer-status.

Examples

# Configure an SA request filtering rule so that SA messages from the MSDP peer 175.58.6.5 will be accepted only if the multicast group address in the SA messages is in the range of 225.1.1.0/24.

<Sysname> system-view

[Sysname] acl number 2001

[Sysname-acl-basic-2001] rule permit source 225.1.1.0 0.0.0.255

[Sysname-acl-basic-2001] quit

[Sysname] msdp

[Sysname-msdp] peer 175.58.6.5 sa-request-policy acl 2001

7.1.18 reset msdp peer

Syntax

reset msdp peer [ peer-address ]

View

User view

Parameters

peer-address: Specifies an MSDP peer by its address. If you do not provide this argument, the TCP connections with all MSDP peers will be reset.

Description

Use the reset msdp peer command to reset the TCP connection with the specified MSDP peer or the TCP connections with all MSDP peers and clear all the statistics information of the MSDP peer(s).

Related commands: display msdp peer-status.

Examples

# Reset the TCP connection with the MSDP peer 125.10.7.6 and clear all the statistics information of this MSDP peer.

<Sysname> reset msdp peer 125.10.7.6

7.1.19 reset msdp sa-cache

Syntax

reset msdp sa-cache [ group-address ]

View

User view

Parameters

group-address: Address of the multicast group related to which the (S, G) entries are to be cleared from the MSDP cache. The effective range is 224.0.1.0 to 239.255.255.255. If you do not provide this argument, the command will clear all the cached (S, G) entries.

Description

Use the reset msdp sa-cache command to clear (S, G) entries from the MSDP cache.

Related commands: cache-sa-enable, display msdp sa-cache.

Examples

# Clear the (S, G) entries related to the multicast group 225.5.4.3 from the MSDP cache.

<Sysname> reset msdp sa-cache 225.5.4.3

7.1.20 reset msdp statistics

Syntax

reset msdp statistics [ peer-address ]

View

User view

Parameters

peer-address: Address of the MSDP peer of which the statistics information is to be cleared. If you do not provide this argument, the command will clear the statistics information of all MSDP peers.

Description

Use the reset msdp statistics command to clear the statistics information of the specified MSDP peer or all MSDP peers without resetting the MSDP peer(s).

Examples

# Clear the statistics information of the MSDP peer 125.10.7.6.

<Sysname> reset msdp statistics 125.10.7.6

7.1.21 shutdown

Syntax

shutdown peer-address

undo shutdown peer-address

View

MSDP view

Parameters

peer-address: MSDP peer address.

Description

Use the shutdown command to deactivate manually the connection with the specified MSDP peer.

Use the undo shutdown command to reactivate the connection with the specified MSDP peer.

By default, the connections with all MSDP peers are active.

Related commands: display msdp peer-status.

Examples

# Deactivate the connection with the MSDP peer 125.10.7.6.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] shutdown 125.10.7.6

7.1.22 static-rpf-peer

Syntax

static-rpf-peer peer-address [ rp-policy ip-prefix-name ]

undo static-rpf-peer peer-address

View

MSDP view

Parameters

peer-address: MSDP peer address.

rp-policy ip-prefix-name: Specifies a filtering policy based on the RP address in SA messages, where ip-prefix-name is the filtering policy name, a case sensitive string of 1 to 19 characters.

Description

Use the static-rpf-peer command to configure a static RPF peer.

Use the undo static-rpf-peer command to remove a static RPF peer.

No static RPF peer is configured by default.

When you configure multiple static RPF peers, observe the follow rules:

1) If you use the rp-policy keyword for all the static RPF peers, all the static RPF peers take effect concurrently. SA messages will be filtered as per the configured prefix list and only those SA messages whose RP addresses pass the filtering will be accepted. If multiple static RPF peers use the same filtering policy at the same time, when a peer receives an SA message, it will forward the SA message to the other peers.

2) If you use the rp-policy keyword for none of the static RPF peers, according to the configuration sequence, only the first static RPF peer whose connection is in the UP state will be activated, and all SA messages from this peer will be accepted while the SA messages from other static RPF peers will be discarded. When this active static RPF peer fails (for example, when the configuration is removed or when the connection is torn down), still the first RPF peer whose connection is in UP state will be selected as the activated RPF peer according to the configuration sequence.

Related commands: display msdp peer-status, ip prefix-list.

Examples

# Configure static RPF peers.

<Sysname> system-view

[Sysname] ip ip-prefix list1 permit 130.10.0.0 16 great-equal 16 less-equal 32

[Sysname] msdp

[Sysname-msdp] peer 130.10.7.6 connect-interface vlan-interface 100

[Sysname-msdp] static-rpf-peer 130.10.7.6 rp-policy list1

7.1.23 timer retry

Syntax

timer retry interval

undo timer retry

View

MSDP view

Parameters

interval: Interval between MSDP peer connection retries, in seconds. The effective range is 1 to 60.

Description

Use the timer retry command to configure the interval between MSDP peer connection retries.

Use the undo timer retry command to restore the default setting.

By default, the interval between MSDP peer connection retries is 30 seconds.

Related commands: display msdp peer-status.

Examples

# Set the MSDP peer connection retry interval to 60 seconds.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] timer retry 60

Chapter 8 Multicast Routing and Forwarding Configuration Commands

& Note:

The term “router” in this document refers to a router in the generic sense or a Layer 3 switch running an IP multicast routing protocol.

8.1 Multicast Routing and Forwarding Configuration Commands

8.1.1 display multicast boundary

Syntax

display multicast boundary [ group-address [ mask | mask-length ] ] [ interface interface-type interface-number ]

View

Any view

Parameters

group-address: Multicast group address, in the range of 224.0.1.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.

Description

Use the display multicast boundary command to view the multicast boundary information on the specified interface or all interfaces.

Related commands: multicast boundary.

Examples

# View the multicast boundary information on all interfaces.

<Sysname> display multicast boundary

Multicast boundary information

Boundary Interface

224.1.1.0/24 Vlan1

Table 8-1 Description on the fields of the display multicast boundary command

Field	Description
Boundary	Multicast group corresponding to the multicast boundary
Interface:	Boundary interface corresponding to the multicast boundary

8.1.2 display multicast forwarding-table

Syntax

display multicast 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 ] * [ port-info ]

View

Any view

Parameters

source-address: Multicast source address.

group-address: 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: Displays forwarding entries of which the incoming interface is the specified one.

register: Specifies the register interface.

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

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

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

match: Specifies the routing 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.

port-info: Specifies to display Layer 2 port information.

Description

Use the display multicast forwarding-table command to view the multicast forwarding table information.

Related commands: multicast forwarding-table downstream-limit, multicast forwarding-table route-limit, display multicast routing-table.

Examples

# View the multicast forwarding table information.

<Sysname> display multicast forwarding-table

Multicast Forwarding Table

Total 1 entry, 1 matched

00001. (172.168.0.2, 227.0.0.1), MID: 0, Flags: 0x0:0

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

Incoming interface: Vlan-interface1

List of 1 outgoing interfaces:

1: Vlan-interface2

Matched 38264 packets(1071392 bytes), Wrong If 0 packets

Forwarded 18696 packets(523488 bytes)

Table 8-2 Description on the fields of display multicast forwarding-table

Field	Description
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 8-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	Incoming interface of the (S, G) entry
List of 1 outgoing interface: 1: Vlan-interface2	Outgoing interface list Interface number: outgoing interface name and number
Matched 38264 packets (1071392 bytes), Wrong If 0 packets	(S, G)-matched packets (bytes), packets with incoming interface errors
Forwarded 18696 packets (523488 bytes)	(S, G)-forwarded packets (bytes)

Table 8-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 a packet 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

8.1.3 display multicast routing-table

Syntax

display multicast 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 } } ] *

View

Any view

Parameters

source-address: Multicast source address.

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

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: Specifies the register interface of PIM-SM.

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.

Description

Use the display multicast routing-table command to view the multicast routing table information.

Related commands: display multicast forwarding-table.

Examples

# View the routing information in the multicast routing table.

<Sysname> display multicast routing-table

Multicast routing table

Total 1 entry

00001. (172.168.0.2, 227.0.0.1)

Uptime: 00:00:28

Upstream Interface: Vlan-interface2

List of 2 downstream interfaces

1: Vlan-interface3

2: Vlan-interface1

Table 8-4 Description on the fields of display multicast routing-table

Field	Description
00001	Sequence number of the (S, G) entry
(172.168.0.2, 227.0.0.1)	An (S, G) entry of the multicast forwarding table
Uptime	Length of time for which the (S, G) entry has been up, in hours:minutes:seconds
Upstream interface	Upstream interface the (S, G) entry: multicast packets should arrive at this interface
List of 2 downstream interfaces	Downstream interface list: these interfaces need to forward multicast packets

8.1.4 display multicast routing-table static

Syntax

display multicast routing-table static [ config ] [ source-address { mask-length | mask } ]

View

Any view

Parameters

config: Displays the configuration information of static routes.

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.

Description

Use the display multicast routing-table static command to view the information of multicast static routes.

Examples

# View all the multicast static routes.

<Sysname> display multicast routing-table static

Multicast Routing Table

Routes : 1

Mroute 10.10.0.0/16

Interafce = Vlan-interface1 RPF Neighbor = 10.10.0.254

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

Preference = 1, Order = 1

Running Configuration = ip rpf-route-static 10.10.0.0 16 2.2.2.2 order 1

# View the configuration information of multicast static routes.

<Sysname> display multicast routing-table static config

Multicast Routing Table

Routes : 1

Mroute 10.10.0.0/16, interface = Vlan-interface1

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

Preference = 1, Order = 1

Table 8-5 Description on the fields of display multicast routing-table static

Field	Description
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
Matched routing protocol	If a protocol is configured, the multicast source address of the route should be the destination address of an entry in unicast routing table.
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

8.1.5 display multicast rpf-info

Syntax

display multicast rpf-info source-address [ group-address ]

View

Any view

Parameters

source-address: Multicast source address.

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

Description

Use the display multicast rpf-info command to view the RPF information of a multicast source.

Related commands: display multicast routing-table, display multicast forwarding-table.

Examples

# View the RPF information of multicast source 192.168.1.55.

<Sysname> display multicast rpf-info 192.168.1.55

RPF information about source 192.168.1.55:

RPF interface: Vlan-interface1, RPF neighbor: 10.1.1.1

Referenced route/mask: 192.168.1.0/24

Referenced route type: igp

Route selection rule: preference-preferred

Load splitting rule: disable

Table 8-6 Description on the fields of the display multicast rpf-info command

Field	Description
RPF information about source 192.168.1.55	Information of the RPF path to multicast source 192.168.1.55
RPF interface	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: l igp: unicast route (IGP) l egp: unicast route (BGP) l unicast (direct): unicast route (directly connected) l unicast: other unicast route (such as unicast static route) l 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)

8.1.6 ip rpf-route-static

Syntax

ip rpf-route-static 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 source-address { mask | mask-length } [ protocol [ process-id ] ] [ route-policy policy-name ]

View

System view

Parameters

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:

l bgp: Specifies the BGP protocol.

l isis: Specifies the IS-IS protocol.

l ospf: Specifies the OSPF protocol.

l rip: Specifies the RIP protocol.

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 multicast route match rule, a string of 1 to 19 characters.

rpf-nbr-address: Specifies an RPF neighbor by the IP address.

interface-type interface-number: Specifies an RPF neighbor by the interface type and interface number. The interface type must not be Ethernet, GigabitEthernet, Loopback or VLAN-interface.

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.

Note that:

l 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 three arguments results in a different configuration.

l In the configuration, you can use the display multicast routing-table static command to check whether the multicast static route information contains this configuration. If you find a match, modify the corresponding fields without changing the configuration sequence; otherwise, add a multicast static route.

l When configuring a multicast static route, you can specify an RPF neighbor only by providing an IP address (rpf-nbr-address) rather than an interface (interface-type interface-number) if the interface type of that router is Ethernet, GigabitEthernet, Loopback or VLAN-interface; instead, you can specify an RPF neighbor only by providing an address (rpf-nbr-address).

l Because outgoing interface iteration may fail or the specified interface may be in the down state, the multicast static route configured with this command may fail to take effect. Therefore, we recommend that you 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: display multicast routing-table static.

Examples

# Configure a multicast static route.

<Sysname> system-view

[Sysname] ip rpf-route-static 1.0.0.0 255.0.0.0 rip 1 route-policy map1 11.0.0.1

8.1.7 mtracert

Syntax

mtracert source-address [ [ last-hop-router-address ] group-address ]

View

Any view

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.

Note that 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 from the multicast source to the last-hop router with the (S, G) outgoing interface address of 5.5.5.8.

<Sysname> mtracert 6.6.6.6 5.5.5.8 225.2.1.1

Type Ctrl+C to quit mtrace facility

Tracing reverse path of (6.6.6.6, 225.2.1.1) from last-hop router (5.5.5.8) to source via multicast routing-table

-1 5.5.5.8

Incoming interface address: 4.4.4.8

Previous-hop router address: 4.4.4.7

Input packet count on incoming interface: 17837

Output packet count on outgoing interface: 0

Total number of packets for this source-group pair: 8000

Protocol: PIM

Forwarding TTL: 0

Forwarding code: No error

-2 4.4.4.7

Incoming interface address: 6.6.6.7

Previous-hop router address: 0.0.0.0

Input packet count on incoming interface: 2

Output packet count on outgoing interface: 259

Total number of packets for this source-group pair: 8100

Protocol: PIM

Forwarding TTL: 0

Forwarding code: No error

Table 8-7 Description on the fields of the mtracert command

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

8.1.8 multicast boundary

Syntax

multicast boundary group-address { mask | mask-length }

undo multicast boundary { group-address { mask | mask-length } | all }

View

Interface view

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.

Note that:

l A multicast forwarding boundary sets the boundary condition for the multicast groups in the specified range. If the destination address of a multicast packet matches the set boundary condition, the packet will not be forwarded.

l If an interface needs to act as a forwarding boundary for multiple multicast groups, just carry out this command on the interface once for each group.

l Assume that Set A and Set B are both multicast forwarding boundary sets to be configured, and B is a subset of A. If A has been configured on an interface, it is not allowed to configure B on the interface; if B has been configured on the interface before A is configured, the previously configured B will be removed.

Related commands: display multicast boundary.

Examples

# Configure VLAN-interface 100 to be the forwarding boundary of multicast group 239.2.0.0/16.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] multicast boundary 239.2.0.0 16

8.1.9 multicast forwarding-table downstream-limit

Syntax

multicast forwarding-table downstream-limit limit

undo multicast forwarding-table downstream-limit

View

System view

Parameters

limit: Maximum number of downstream nodes (namely, the maximum number of outgoing interfaces) for a single route in the multicast forwarding table. The effective range is 0 to 128.

Description

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

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

By default, the maximum number of downstream nodes for a single route in the multicast forwarding table is 128.

Related commands: display multicast forwarding-table.

Examples

# Set the maximum number of downstream nodes for a single route in the multicast forwarding table to 120.

<Sysname> system-view

[Sysname] multicast forwarding-table downstream-limit 120

8.1.10 multicast forwarding-table route-limit

Syntax

multicast forwarding-table route-limit limit

undo multicast forwarding-table route-limit

View

System view

Parameters

limit: Maximum number of route entries in the multicast forwarding table. The effective range is 0 to 1024.

Description

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

Use the undo multicast forwarding-table route-limit command to restore the maximum number of route entries in the multicast forwarding table to the system default.

By default, the maximum number of route entries in the multicast forwarding table is 1024.

Related commands: display multicast forwarding-table.

Examples

# Set the maximum number of routing entries in the multicast forwarding table to 200.

<Sysname> system-view

[Sysname] multicast forwarding-table route-limit 200

8.1.11 multicast load-splitting

Syntax

multicast load-splitting { source | source-group }

undo multicast load-splitting

View

System view

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.

<Sysname> system-view

[Sysname] multicast load-splitting source

8.1.12 multicast longest-match

Syntax

multicast longest-match

undo multicast longest-match

View

System view

Parameters

None

Description

Use the multicast longest-match command to configure route selection based on the longest match, namely based on the mask length.

Use the undo multicast longest-match command to remove the configuration of route selection based on the longest match.

By default, routes are selected according to the order of route entries.

Examples

# Configure route selection based on the longest match.

<Sysname> system-view

[Sysname] multicast longest-match

8.1.13 multicast routing-enable

Syntax

multicast routing-enable

undo multicast routing-enable

View

System view

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.

Note that:

l You must enable IP multicast routing before you can carry out other Layer 3 multicast commands.

l The device does not forward any multicast packets before IP multicast routing is enabled.

Examples

# Enable IP multicast routing.

<Sysname> system-view

[Sysname] multicast routing-enable

8.1.14 reset multicast forwarding-table

Syntax

reset multicast 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

Parameters

source-address: Multicast source address.

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

incoming-interface: Specifies to clear multicast forwarding entries of which the incoming interface is the specified one.

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

register: Specifies the register interface of PIM-SM.

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

Description

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

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: reset multicast routing-table, display multicast routing-table, display multicast forwarding-table.

Examples

# Clear the multicast forwarding entries related to multicast group 225.5.4.3 from the multicast forwarding table.

<Sysname> reset multicast forwarding-table 225.5.4.3

8.1.15 reset multicast routing-table

Syntax

reset multicast 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

Parameters

source-address: Multicast source address.

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

incoming-interface: Specifies the incoming interface of multicast routing entries.

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

register: Specifies the 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.

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: reset multicast forwarding-table, display multicast routing-table, display multicast forwarding-table.

Examples

# Clear the route entries related to multicast group 225.5.4.3 from the multicast routing table.

<Sysname> reset multicast routing-table 225.5.4.3

H3C S5500-EI Series Switches Command Manual-Release 2102(V1.01)

Chapter 1 IGMP Snooping Configuration Commands

1.1 IGMP Snooping Configuration Commands

1.1.3 fast-leave

1.1.4 group-policy

1.1.5 host-aging-time

1.1.6 igmp-snooping

1.1.7 igmp-snooping drop-unknown

1.1.8 igmp-snooping enable

1.1.9 igmp-snooping fast-leave

1.1.10 igmp-snooping general-query source-ip

1.1.12 igmp-snooping group-policy

1.1.13 igmp-snooping host-aging-time

1.1.15 igmp-snooping last-member-query-interval

1.1.16 igmp-snooping max-response-time

1.1.17 igmp-snooping overflow-replace

1.1.18 igmp-snooping querier

1.1.19 igmp-snooping query-interval

1.1.21 igmp-snooping source-deny

1.1.23 igmp-snooping static-group

1.1.27 max-response-time

1.1.28 overflow-replace

1.1.29 report-aggregation

1.1.32 router-aging-time

Chapter 2 MLD Snooping Configuration Commands

2.1.3 fast-leave

2.1.4 group-policy

2.1.8 mld-snooping

2.1.9 mld-snooping drop-unknown

2.1.10 mld-snooping enable

2.1.11 mld-snooping fast-leave

2.1.14 mld-snooping group-policy

2.1.15 mld-snooping host-aging-time

2.1.17 mld-snooping last-listener-query-interval

2.1.18 mld-snooping max-response-time

2.1.19 mld-snooping overflow-replace

2.1.20 mld-snooping querier

2.1.21 mld-snooping query-interval

2.1.23 mld-snooping source-deny

2.1.32 router-aging-time

5.1.3 display igmp interface

5.1.5 fast-leave

5.1.6 igmp

5.1.8 igmp fast-leave

5.1.9 igmp group-policy

5.1.10 igmp last-member-query-interval

5.1.11 igmp max-response-time

5.1.12 igmp require-router-alert

5.1.13 igmp robust-count

5.1.15 igmp static-group

5.1.16 igmp timer other-querier-present

5.1.17 igmp timer query

5.1.18 igmp version

5.1.20 max-response-time

5.1.21 require-router-alert

5.1.23 reset igmp group port-info

5.1.25 send-router-alert

5.1.26 timer other-querier-present

5.1.27 timer query

5.1.28 version

6.1.3 c-bsr

6.1.4 c-bsr admin-scope

6.1.5 c-bsr global

6.1.6 c-bsr group

6.1.7 c-bsr hash-length

6.1.8 c-bsr holdtime

6.1.9 c-bsr interval

6.1.10 c-bsr priority

6.1.11 c-rp

6.1.23 display pim rp-info

6.1.24 hello-option dr-priority

6.1.25 hello-option holdtime

6.1.26 hello-option lan-delay

6.1.27 hello-option neighbor-tracking

6.1.28 hello-option override-interval

6.1.29 holdtime assert

6.1.30 holdtime join-prune

6.1.31 jp-pkt-size

6.1.32 jp-queue-size

6.1.35 pim dm