vlan vlan-id: Displays the 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 multicast group information in all VLANs.

verbose: Specifies to display the detailed information of multicast groups.

Description

Use the display igmp-snooping group command to view the multicast group information learned by IGMP Snooping.

Example

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

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

Ethernet1/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.

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

MAC group(s):

MAC group address:0100-5e01-0101

Host port(s):total 1 port.

Ethernet1/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

Parameter

None

Description

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

Example

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

<Sysname> display igmp-snooping statistics

Received IGMP general query packet(s) number:0.

Received IGMP V1 report packet(s) number:0.

Received IGMP V2 report packet(s) number:19.

Received IGMP leave packet(s) number:0.

Received IGMP V2 specific query packet(s) number:0.

Sent IGMP V2 specific query packet(s) number:0.

Received IGMP V3 report packet(s) number:1.

Received IGMP V3 specific query packet(s) number:0.

Received IGMP V3 specific sg query packet(s) number:0.

Sent IGMP V3 specific query packet(s) number:0.

Sent IGMP V3 specific sg query packet(s) number:0.

Received error IGMP packet(s) number:19.

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

Field	Description
general query packet(s)	General query message(s)
specific query packet(s)	Group-specific query message(s)
report packet(s)	Report message(s)
leave packet(s)	Leave message(s)
specific sg query packet(s)	Group- and source-specific query message(s)

1.1.3 fast-leave

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

View

IGMP Snooping view

Parameter

vlan vlan-list: Configures the fast leave feature in the specified VLAN. Here vlan-list is a VLAN list. You can specify multiple VLANs or VLAN ranges by providing this argument in the form of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094, and &<1-10> means that you can specify up to 10 VLANs or VLAN ranges for this argument.

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 an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its VLAN interface.

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 command: igmp-snooping fast-leave.

Example

# 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

Parameter

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

vlan vlan-list: Configures a multicast group filter in the specified VLAN(s). Here vlan-list is a VLAN list. You can specify multiple VLANs or VLAN ranges by providing this argument in the form of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094, and &<1-10> means that you can specify up to 10 VLANs or VLAN ranges for this argument.

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 an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its VLAN interface.

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 has no rule, all multicast groups will be filtered out.

l You can configure different ACL rules for a port in different VLANs, and the newly configured ACL rules will override the existing ones.

Related command: igmp-snooping group-policy.

Example

# 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

Parameter

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 an IGMP Snooping–enabled VLAN, but not on a VLAN with IGMP enabled on its VLAN interface.

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

Example

# 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

Parameter

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 command: igmp-snooping enable.

Example

Enable IGMP Snooping globally and enter IGMP Snooping view

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping]

1.1.7 igmp-snooping enable

Syntax

igmp-snooping enable

undo igmp-snooping enable

View

VLAN view

Parameter

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 command: igmp-snooping.

Example

# 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.8 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

Parameter

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 an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its VLAN interface.

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 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 command: fast-leave.

Example

# Enable the fast leave feature on Ethernet 1/0/1 belonging to VLAN 2.

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

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

1.1.9 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

Parameter

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.

Example

# 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.10 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

Parameter

limit: Maximum number of multicast groups that can pass the port(s), in the range of 1 to 1,000.

vlan vlan-list: Configures the maximum number of multicast groups that can pass the ports in the specified VLAN(s). Here vlan-list is a VLAN list. You can specify multiple VLANs or VLAN ranges by providing this argument in the form of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094, and &<1-10> means that you can specify up to 10 VLANs or VLAN ranges for this argument.

Description

Use the igmp-snooping group-limit command to configure the maximum number of multicast groups that can pass the port(s).

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

By default, the maximum number of multicast groups that can pass a port is 1,000.

Note that:

l This command works on an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its VLAN interface.

Example

# Specify to allow a maximum of 10 multicast groups to pass Ethernet 1/0/1 belonging to VLAN 2.

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

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

1.1.11 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

Parameter

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 an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its VLAN interface.

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

l You can configure different ACL rules for a port in different VLANs, and the newly configured ACL rules will override the existing ones.

Related command: group-policy.

Example

# Configure ACL 2000 as the multicast group filter on Ethernet 1/0/1 belonging to VLAN 2.

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

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

1.1.12 igmp-snooping host-aging-time

Syntax

igmp-snooping host-aging-time interval

undo igmp-snooping host-aging-time

View

VLAN view

Parameter

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 command: host-aging-time.

Example

# 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.13 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

Parameter

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 enable the simulated (*, G) or (S, G) joining function.

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

By default, this function is disabled.

Note that:

l This command works on an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its VLAN interface.

l The source-ip source-address statement 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 statement in your command, the simulated host responses with only an IGMPv2 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.

Example

# Enable the simulated (S, G) joining function on Ethernet 1/0/1 belonging to VLAN 2, so that the simulated host can receive multicast data that multicast source 1.1.1.1 sends to multicast group 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 Ethernet 1/0/1

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

1.1.14 igmp-snooping last-member-query-interval

Syntax

igmp-snooping last-member-query-interval interval

undo igmp-snooping last-member-query-interval

View

VLAN view

Parameter

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 command: last-member-query-interval.

Example

# 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.15 igmp-snooping max-response-time

Syntax

igmp-snooping max-response-time interval

undo igmp-snooping max-response-time

View

VLAN view

Parameter

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 command: max-response-time and igmp-snooping query-interval.

Example

# 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.16 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

Parameter

vlan vlan-list: Configures the multicast group replacement function in the specified VLAN(s). Here vlan-list is a VLAN list. You can specify multiple VLANs or VLAN ranges by providing this argument in the form of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094, and &<1-10> means that you can specify up to 10 VLANs or VLAN ranges for this argument.

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 an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its VLAN interface.

Related command: overflow-replace.

Example

# Enable the multicast group replacement function on Ethernet 1/0/1 belonging to VLAN 2.

<Sysname> system-view

[Sysname] interface Ethernet1/0/1

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

1.1.17 igmp-snooping querier

Syntax

igmp-snooping querier

undo igmp-snooping querier

View

VLAN view

Parameter

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.

Example

# Enable the IGMP Snooping querier function in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] igmp-snooping querier

1.1.18 igmp-snooping query-interval

Syntax

igmp-snooping query-interval interval

undo igmp-snooping query-interval

View

VLAN view

Parameter

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 command: igmp-snooping querier, igmp-snooping max-response-time and max-response-time.

Example

# 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.19 igmp-snooping router-aging-time

Syntax

igmp-snooping router-aging-time interval

undo igmp-snooping router-aging-time

View

VLAN view

Parameter

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 command: router-aging-time.

Example

# 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.20 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

Parameter

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.

Example

# 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.21 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

Parameter

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.

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 an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its 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 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.

Example

# Configure Ethernet 1/0/1 belonging to VLAN 2 to be a static member port of (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 Ethernet 1/0/1

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

1.1.22 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

Parameter

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 an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its VLAN interface.

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.

Example

# Enable the static router port function on Ethernet 1/0/1 belonging to VLAN 2.

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

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

1.1.23 igmp-snooping version

Syntax

igmp-snooping version version-number

undo igmp-snooping version

View

VLAN view

Parameter

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 takes effect only if IGMP Snooping is enabled in the VLAN.

Related command: igmp-snooping enable.

Example

# 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.24 last-member-query-interval

Syntax

last-member-query-interval interval

undo last-member-query-interval

View

IGMP Snooping view

Parameter

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 an IGMP Snooping–enabled VLAN, but not on a VLAN with IGMP enabled on its VLAN interface.

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

Example

# 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.25 max-response-time

Syntax

max-response-time interval

undo max-response-time

View

IGMP Snooping view

Parameter

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.

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

This command works only on an IGMP Snooping–enabled VLAN, but not on a VLAN with IGMP enabled on its VLAN interface.

Related command: igmp-snooping max-response-time and igmp-snooping query-interval.

Example

# 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.26 overflow-replace

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

View

IGMP Snooping view

Parameter

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 an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its VLAN interface.

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 command: igmp-snooping overflow-replace.

Example

# Enable the multicast group replacement function in VLAN 2.

<Sysname> system-view

[Sysname] igmp-snooping

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

1.1.27 report-aggregation

Syntax

report-aggregation

undo report-aggregation

View

IGMP Snooping view

Parameter

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 an IGMP Snooping–enabled VLAN or on a VLAN with IGMP enabled on its VLAN interface.

Example

# Disable IGMP report suppression.

<Sysname> system-view

[Sysname] igmp-snooping

[Sysname-igmp-snooping] undo report-aggregation

1.1.28 reset igmp-snooping group

Syntax

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

View

User view

Parameter

group-address: Address of the multicast group of which the IGMP Snooping 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 entries.

vlan vlan-id: Specifies a VLAN in which all IGMP Snooping 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 entries.

Note that:

l This command works only on an IGMP Snooping–enabled VLAN, but not on a VLAN with IGMP enabled on its VLAN interface.

l This command cannot clear IGMP Snooping forwarding entries derived from static configuration.

Example

# Clear all IGMP Snooping entries saved in the switch.

<Sysname> reset igmp-snooping group all

1.1.29 reset igmp-snooping statistics

Syntax

reset igmp-snooping statistics

View

User view

Parameter

None

Description

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

Example

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

<Sysname> reset igmp-snooping statistics

1.1.30 router-aging-time

Syntax

router-aging-time interval

undo router-aging-time

View

IGMP Snooping view

Parameter

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 an IGMP Snooping–enabled VLAN, but not on a VLAN with IGMP enabled on its VLAN interface.

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

Example

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

<Sysname> system-view

[Sysname] igmp-snooping

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

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

Parameter

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.

Example

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

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

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

IP group address:FF1E::1

(::, FF1E::1):

Attribute: Host Port

Host port(s):total 1 port.

Ethernet1/0/1 (D) ( 00:03:57 )

MAC group(s):

MAC group address:3333-0000-0001

Host port(s):total 1 port.

Ethernet1/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

Parameter

None

Description

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

Example

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

<Sysname> display mld-snooping statistics

Received MLD general query packet(s) number:0.

Received MLD specific query packet(s) number:0.

Received MLD V1 report packet(s) number:0.

Received MLD done packet(s) number:1.

Sent MLD specific query packet(s) number:1.

Received error MLD packet(s) number:0.

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

Field	Description
general query packet(s)	General query message(s)
specific query packet(s)	Group-specific query message(s)
report packet(s)	Report message(s)
done packet(s)	Done message(s)
error MLD packet(s)	Error MLD message(s)

2.1.3 fast-leave

Syntax

fast-leave [ vlan vlan-list ]

undo fast-leave [ vlan vlan-list ]

View

MLD Snooping view

Parameter

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 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 command: mld-snooping fast-leave.

Example

# Enable the fast leave feature 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

Parameter

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

vlan vlan-list: Configures an IPv6 multicast group filter in the specified VLAN(s). Here vlan-list is a VLAN list. You can specify multiple VLANs or VLAN ranges by providing this argument in the form of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094, and &<1-10> means that you can specify up to 10 VLANs or VLAN ranges for this argument.

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 is null, all IPv6 multicast groups will be filtered out.

l You can configure different IPv6 ACL rules for each port in different VLANs, and the newly configured IPv6 ACL rules will override the existing ones.

Related command: mld-snooping group-policy.

Example

# 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

Parameter

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 command: mld-snooping host-aging-time.

Example

# 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-member-query-interval

Syntax

last-member-query-interval interval

undo last-member-query-interval

View

MLD Snooping view

Parameter

interval: Interval between MLD 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 MLD last-member queries globally.

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

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

Related command: mld-snooping last-member-query-interval.

Example

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

<Sysname> system-view

[Sysname] mld-snooping

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

2.1.7 max-response-time

Syntax

max-response-time interval

undo max-response-time

View

MLD Snooping view

Parameter

interval: Maximum response time to 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 to MLD general queries globally.

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

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

Related command: mld-snooping max-response-time and mld-snooping query-interval.

Example

# Set the maximum response time to 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

Parameter

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 command: mld-snooping enable.

Example

# Enable MLD Snooping globally and enter MLD Snooping view.

<Sysname> system-view

[Sysname] mld-snooping

[Sysname-mld-snooping]

2.1.9 mld-snooping enable

Syntax

mld-snooping enable

undo mld-snooping enable

View

VLAN view

Parameter

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 command: mld-snooping.

Example

# 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.10 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

Parameter

Description

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

Use the undo mld-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:

Example

# Enable the fast leave feature on Ethernet 1/0/1 belonging to VLAN 2.

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

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

2.1.11 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

Parameter

current-interface: Sets the source IPv6 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 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.

Example

# Set the IPv6 address of the interface of VLAN 2 to fec0:0:0:1::1/64 and specify this IPv6 address as the source IPv6 address of MLD general queries.

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] ipv6 address fec0:0:0:1::1/64

[Sysname-Vlan-interface2] quit

[Sysname] vlan 2

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

2.1.12 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

Parameter

limit: Maximum number of IPv6 multicast groups that can pass the port(s). The effective range is 1 to 1,000.

vlan vlan-list: Configures the maximum number of IPv6 multicast groups that can pass the ports in the specified VLAN(s). Here vlan-list is a VLAN list. You can specify multiple VLANs or VLAN ranges by providing this argument in the form of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094, and &<1-10> means that you can specify up to 10 VLANs or VLAN ranges for this argument.

Description

Use the mld-snooping group-limit command to configure the maximum number of IPv6 multicast groups that can pass the port(s).

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

By default, the maximum number of multicast groups that can pass a port is 1,000.

Note that:

Example

# Specify to allow a maximum of 10 IPv6 multicast groups to pass Ethernet 1/0/1 belonging to VLAN 2.

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

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

2.1.13 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

Parameter

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 Ethernet interface 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 the specified ACL does not exist or is null, all IPv6 multicast groups will be filtered out.

l You can configure different IPv6 ACL rules for each port in different VLANs, and the newly configured IPv6 ACL rules will override the existing ones.

Related command: group-policy.

Example

# Configure ACL 2000 as the IPv6 multicast group filter on Ethernet 1/0/1 belonging to VLAN 2.

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

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

2.1.14 mld-snooping host-aging-time

Syntax

mld-snooping host-aging-time interval

undo mld-snooping host-aging-time

View

VLAN view

Parameter

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 current VLAN.

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

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

Related command: host-aging-time.

Example

# 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.15 mld-snooping host-join

Syntax

mld-snooping host-join ipv6-group-address vlan vlan-id

undo mld-snooping host-join ipv6-group-address vlan vlan-id

View

Ethernet port view, port group view

Parameter

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.

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 host-join command to enable the function of simulated joining an IPv6 multicast group.

Use the undo mld-snooping host-join command to disable the function of simulated joining an IPv6 multicast group.

By default, this function is disabled.

Note that:

l If configured in Ethernet interface 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.

Example

# Configure Ethernet 1/0/1 belonging to VLAN 2 to be a simulated member of IPv6 multicast group ff1e::1.

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] mld-snooping host-join ff1e::1 vlan 2

2.1.16 mld-snooping last-member-query-interval

Syntax

mld-snooping last-member-query-interval interval

undo mld-snooping last-member-query-interval

View

VLAN view

Parameter

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

Description

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

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

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

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

Related command: last-member-query-interval.

Example

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

<Sysname> system-view

[Sysname] vlan 2

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

2.1.17 mld-snooping max-response-time

Syntax

mld-snooping max-response-time interval

undo mld-snooping max-response-time

View

VLAN view

Parameter

interval: Maximum response time to 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 to 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 to MLD general queries is 10 seconds.

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

Related command: max-response-time and mld-snooping query-interval.

Example

# Set the maximum response time to 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.18 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

Parameter

vlan vlan-list: Configures the IPv6 multicast group replacement function in the specified VLAN(s). Here vlan-list is a VLAN list. You can specify multiple VLANs or VLAN ranges by providing this argument in the form of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is in the range of 1 to 4094, and &<1-10> means that you can specify up to 10 VLANs or VLAN ranges for this argument.

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 command: overflow-replace.

Example

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

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

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

2.1.19 mld-snooping querier

Syntax

mld-snooping querier

undo mld-snooping querier

View

VLAN view

Parameter

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.

Example

# Enable the MLD Snooping querier function in VLAN 2.

<Sysname> system-view

[Sysname] vlan 2

[Sysname-vlan2] mld-snooping querier

2.1.20 mld-snooping query-interval

Syntax

mld-snooping query-interval interval

undo mld-snooping query-interval

View

VLAN view

Parameter

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

Description

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

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

By default, the interval between MLD general queries is 125 seconds.

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

Related command: mld-snooping querier, mld-snooping max-response-time and max-response-time.

Example

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

<Sysname> system-view

[Sysname] vlan 2

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

2.1.21 mld-snooping router-aging-time

Syntax

mld-snooping router-aging-time interval

undo mld-snooping router-aging-time

View

VLAN view

Parameter

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 command: router-aging-time.

Example

# 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.22 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

Parameter

current-interface: Sets the source IPv6 address of MLD group-specific 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 group-specific queries.

ipv6-address: Sets the source IPv6 address of MLD group-specific queries to the specified IPv6 address.

Description

Use the mld-snooping special-query source-ip command to configure the source IPv6 address of MLD group-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 group-specific queries is fe80::02ff:ffff:fe00:0001.

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

Example

# Set the IPv6 address of the interface of VLAN 2 to fec0:0:0:1::1/64 and specify this IPv6 address as the source IPv6 address of MLD group-specific queries.

<Sysname> system-view

[Sysname] interface vlan-interface 2

[Sysname-Vlan-interface2] ipv6 address fec0:0:0:1::1/64

[Sysname-Vlan-interface2] quit

[Sysname] vlan 2

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

2.1.23 mld-snooping static-group

Syntax

mld-snooping static-group ipv6-group-address vlan vlan-id

undo mld-snooping static-group ipv6-group-address vlan vlan-id

View

Ethernet port view, port group view

Parameter

ipv6-group-address: Information of statically joined IPv6 multicast groups. 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.

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 member port function, namely to configure a port or ports as static member port(s) of an IPv6 multicast group.

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

Example

# Configure Ethernet 1/0/1 belonging to VLAN 2 to be a static member port of IPv6 multicast group ff1e::1.

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

[Sysname-Ethernet1/0/1] mld-snooping static-group ff1e::1 vlan 2

2.1.24 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

Parameter

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

Example

# Enable the static router port function on Ethernet 1/0/1 belonging to VLAN 2.

<Sysname> system-view

[Sysname] interface Ethernet 1/0/1

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

2.1.25 overflow-replace

Syntax

overflow-replace [ vlan vlan-list ]

undo overflow-replace [ vlan vlan-list ]

View

MLD Snooping view

Parameter

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 command: mld-snooping overflow-replace.

Example

# 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.26 report-aggregation

Syntax

report-aggregation

undo report-aggregation

View

MLD Snooping view

Parameter

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.

Example

# Disable MLD report suppression.

<Sysname> system-view

[Sysname] mld-snooping

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

2.1.27 reset mld-snooping group

Syntax

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

View

User view

Parameter

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 derived from static configuration.

Example

# Clear all MLD Snooping entries saved in the switch.

<Sysname> reset mld-snooping group all

2.1.28 reset mld-snooping statistics

Syntax

reset mld-snooping statistics

View

User view

Parameter

None

Description

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

Example

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

<Sysname> reset mld-snooping statistics

2.1.29 router-aging-time

Syntax

router-aging-time interval

undo router-aging-time

View

MLD Snooping view

Parameter

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 command: mld-snooping router-aging-time.

Example

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

<Sysname> system-view

[Sysname] mld-snooping

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

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

Parameter

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 display the information about the specified multicast VLAN and its sub VLANs.

Example

# Display information about all multicast VLANs and their sub VLANs

<Sysname> display multicast-vlan

multicast vlan 100's subvlan list:

vlan 2 4-8

multicast vlan 200's subvlan list:

no subvlan

multicast vlan 300's subvlan list:

no subvlan

multicast vlan 400's subvlan list:

no subvlan

3.1.2 multicast-vlan enable

Syntax

multicast-vlan vlan-id enable

undo multicast-vlan vlan-id enable

View

System view

Parameter

vlan-id: VLAN ID, in the range 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 multicast VLAN by default.

Note that:

l The specified VLAN must exist.

l The multicast VLAN feature cannot be enabled on a Layer 3 multicast–enabled device.

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

Example

# Configure VLAN 2 as a multicast VLAN.

<Sysname> system-view

[Sysname] multicast-vlan 2 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

Parameter

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

vlan-list: Sub-VLAN list, representing multiple sub-VLANs, in the form of vlan-list = { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id is the VLAN ID if a sub-VLAN, in the range of 1 to 4094, and &<1-10> means that you can specify up to 10 sub-VLANs or sub-VLAN ranges for this argument.

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-VLAN 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 VLANs to be configured as sub-VLANs of the multicast VLAN must not be multicast VLANs.

l The VLANs to be configured as the sub-VLANs of the multicast VLAN must not be sub-VLANs of another multicast VLAN.

l The number of sub-VLANs of multicast VLANs must not exceed the system limit. A S3610&S5510 switch supports 16 multicast VLANs, with each VLAN supporting up to 1,000 sub-VLANs. But the total number of sub-VLANs cannot exceed 1000.

Example

# Configure VLAN1 through VLAN5 as sub-VLANs of multicast VLAN10.

<Sysname> system-view

[Sysname] multicast-vlan 10 subvlan 1 to 5

Chapter 4 IGMP Configuration Commands

4.1 IGMP Configuration Commands

4.1.1 display igmp group

Syntax

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

View

Any view

Parameter

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 an interface and a multicast group address, this command will display the IGMP multicast group information on all interfaces.

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

Example

# 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-interface 2(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-interface 2(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 4-1 Description on the fields of the display igmp group command

Field	Description
Group	Multicast group address
Uptime	Length of time for which the multicast group has been up (hours:minutes:seconds)
Expires	Length of time in which the multicast group will expire (hours:minutes:seconds)
Last reporter	Address of the last host that reported its multicast membership
Last-member-query-counter	Last-member query count
Last-member-query-timer-expiry	Last-member query timeout time
Version1-host-present-timer-expiry	Timeout time for an IGMPv1 host

4.1.2 display igmp group port-info

Syntax

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

View

Any view

Parameter

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 of Layer 2 ports.

Description

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

Example

# 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):100.

Total 1 IP Group(s).

Total 1 IP Source(s).

Total 1 MAC Group(s).

Router port(s):total 1 port.

Ethernet1/0/2 (D) ( 00:02:42 )

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.

Ethernet1/0/3 (D) ( 00:02:43 )

MAC group(s):

MAC group address:0100-5e7f-fffa

Host port(s):total 1 port.

Ethernet1/0/3

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

4.1.3 display igmp interface

Syntax

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

View

Any view

Parameter

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.

Example

# View the IGMP configuration and running status on all IGMP-enabled interfaces.

<Sysname> display igmp interface

Interface information

Vlan-interface 2 (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

Querier for IGMP: 10.10.1.10

Total 2 IGMP Groups reported

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

Field	Description
Vlan-interface 2 (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 general query interval, in units of seconds
Value of other querier present interval for IGMP(in seconds)	Other querier present interval, in units of seconds
Value of maximum query response time for IGMP(in seconds)	Maximum response time for IGMP general queries, in units of seconds
Querier for IGMP	IP address of the querier
Total 2 IGMP Groups reported	Total number of groups recorded on the interface. Two groups are reported in this example

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

Parameter

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

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.

Description

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

Example

# 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

Vlan1 (20.1.1.1),

Protocol: STATIC

00002. (*, 239.255.255.250)

List of 1 downstream interface

Vlan2 (20.20.20.20), Protocol: IGMP

Protocol: IGMP

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

Field	Description
00001	Sequence number the (*, G) entry
(*, 225.1.1.1)	An (*, G) entry of the IGMP routing table
List of 1 downstream interface	Downstream interface list: these interfaces need to forward multicast packets

4.1.5 igmp

Syntax

igmp

undo igmp

View

System view

Parameter

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 command: igmp enable, and multicast routing-enable.

Example

# Enter IGMP view.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] igmp

[Sysname-igmp]

4.1.6 igmp enable

Syntax

igmp enable

undo igmp enable

View

Interface view

Parameter

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

Example

# Enable IGMP on Vlan-interface 2.

<Sysname> system-view

[Sysname]interface Vlan-interface 2

[Sysname-Vlan-interface2]igmp enable

4.1.7 igmp lastmember-queryinterval

Syntax

igmp lastmember-queryinterval interval

undo igmp lastmember-queryinterval

View

Interface view

Parameter

interval: IGMP last-member query interval, namely the length of time that must pass before the IGMP querier sends an IGMP group-specific query after it receives a leave-group message from a host, in units of seconds, with an effective range of 1 to 5.

Description

Use the igmp lastmember-queryinterval command to configure the interface-level last-member query interval.

Use the undo igmp lastmember-queryinterval command to restore the interface-level last member query interval to the system default.

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

Related command: lastmember-queryinterval, igmp robust-count, display igmp interface.

Example

# Set the last member query interval to 3 seconds on Vlan-interface 2.

<Sysname> system-view

[Sysname]interface Vlan-interface 2

[Sysname-Vlan-interface2]igmp lastmember-queryinterval 3

4.1.8 igmp max-response-time

Syntax

igmp max-response-time interval

undo igmp max-response-time

View

Interface view

Parameter

interval: Maximum response time to IGMP general queries, in units of seconds, 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 interface.

Use the undo igmp max-response-time command to restore the maximum response time to IGMP general queries to the system default.

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

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

Example

# Set the maximum response time to IGMP general queries to 8 seconds on Vlan-interface 2.

<Sysname> system-view

[Sysname] interface Vlan-interface 2

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

4.1.9 igmp require-router-alert

Syntax

igmp require-router-alert

undo igmp require-router-alert

View

Interface view

Parameter

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 command: require-router-alert, igmp send-router-alert.

Example

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

<Sysname> system-view

[Sysname]interface Vlan-interface 2

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

4.1.10 igmp robust-count

Syntax

igmp robust-count robust-value

undo igmp robust-count

View

Interface view

Parameter

robust-value: IGMP robustness variable, namely the IGMP last-member query count, with an effective range of 2 to 5.

Description

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

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

By default, the IGMP robustness variable is 2.

Related command: robust-count, igmp lastmember-queryinterval, igmp timer other-querier-present, display igmp interface.

Example

# Set the IGMP robustness variable to 3 on Vlan-interface 2.

<Sysname> system-view

[Sysname] interface Vlan-interface 2

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

4.1.11 igmp send-router-alert

Syntax

igmp send-router-alert

undo igmp send-router-alert

View

Interface view

Parameter

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 command: send-router-alert, igmp require-router-alert.

Example

# Enable insertion of the Router-Alert option into IGMP messages to be sent from Vlan-interface 2.

<Sysname> system-view

[Sysname]interface Vlan-interface 2

[Sysname-Vlan-interface2]igmp send-router-alert

4.1.12 igmp timer other-querier-present

Syntax

igmp timer other-querier-present interval

undo igmp timer other-querier-present

View

Interface view

Parameter

interval: 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 other querier present interval on the current interface.

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

By default, the other querier present interval is (IGMP general query interval) times (IGMP last member query count) plus (maximum response time to IGMP general queries) divided by 2.

& Note:

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

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

Example

# Set the other querier present interval to 200 seconds on Vlan-interface 2.

<Sysname> system-view

[Sysname]interface Vlan-interface 2

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

4.1.13 igmp timer query

Syntax

igmp timer query interval

undo igmp timer query

View

Interface view

Parameter

interval: IGMP query interval, namely the interval between IGMP general queries sent by the querier, in units of seconds, 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 command: timer query, igmp timer other-querier-present, display igmp interface.

Example

# Set the IGMP general query interval to 125 seconds on Vlan-interface 2.

<Sysname> system-view

[Sysname]interface Vlan-interface 2

[Sysname-Vlan-interface2] igmp timer query 125

4.1.14 igmp version

Syntax

igmp version version-number

undo igmp version

View

Interface view

Parameter

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 IGMP version to the system default.

The default IGMP version is version 2.

Related command: version.

Example

# Set the IGMP version to IGMPv3 on Vlan-interface 2.

<Sysname> system-view

[Sysname]interface Vlan-interface 2

[Sysname-Vlan-interface2]igmp version 3

4.1.15 lastmember-queryinterval

Syntax

lastmember-queryinterval interval

undo lastmember-queryinterval

View

IGMP view

Parameter

interval: Last-member query interval, namely the length of time that must pass before the IGMP querier sends an IGMP group-specific query after it receives a leave-group message from a host, in units of seconds, with an effective range of 1 to 5.

Description

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

Use the undo lastmember-queryinterval command to restore the global IGMP last member query interval to the system default.

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

Related command: igmp lastmember-queryinterval, robust-count, display igmp interface.

Example

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

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] lastmember-queryinterval 3

4.1.16 max-response-time

Syntax

max-response-time interval

undo igmp max-response-time

View

IGMP view

Parameter

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

Description

Use the max-response-time command to configure the global value of the maximum response time to IGMP general queries.

Use the undo max-response-time command to restore the global maximum response time to IGMP general queries to the system default.

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

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

Example

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

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] max-response-time 8

4.1.17 prompt-leave

Syntax

prompt-leave [ group-policy acl-number ]

undo prompt-leave

View

IGMP view

Parameter

acl-number: Number of a basic ACL, in the range of 2,000 to 2,999.

Description

Use the prompt-leave command to enable the fast leave of multicast group members globally.

Use the undo prompt-leave command to disable the fast leave of multicast group members.

By default, this feature is disabled. In this case, an IGMP querier sends IGMP group-specific messages after it receives an IGMP leave message from a host instead of immediately sending a leave notification to the upstream.

Related command: lastmember-queryinterval.

Example

# Enable the fast leave of multicast group members globally.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] prompt-leave

4.1.18 require-router-alert

Syntax

require-router-alert

undo require-router-alert

View

IGMP view

Parameter

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 command: igmp require-router-alert, send-router-alert.

Example

# 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

4.1.19 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

Parameter

all: (Used in the undo form of this command) 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

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.

Description

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

Note that:

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

l This command cannot clear statically configured IGMP forwarding entries

Related command: display igmp group.

Example

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

<Sysname> reset igmp group all

# Clear all IGMP forwarding entries on Vlan-interface100 and all IGMP Snooping forwarding entries in VLAN100.

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

# Clear the IGMP forwarding entries of multicast group 225.0.0.1 on Vlan-interface100 and all the IGMP Snooping forwarding entries of this multicast group in VLAN100.

<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-interface100 and the IGMP Snooping forwarding entries of multicast groups on this subnet in VLAN100.

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

4.1.20 robust-count

Syntax

robust-count robust-value

undo robust-count

View

IGMP view

Parameter

robust-value: IGMP robustness variable, namely the last-member query count, in the range of 2 to 5.

Description

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

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

By default, the IGMP robustness variable is 2.

Related command: igmp robust-count, lastmember-queryinterval, timer other-querier-present, display igmp interface.

Example

# Set the global value of the IGMP robustness variable to 3.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] robust-count 3

4.1.21 send-router-alert

Syntax

send-router-alert

undo send-router-alert

View

IGMP view

Parameter

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 command: igmp send-router-alert, require-router-alert.

Example

# 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

4.1.22 timer other-querier-present

Syntax

timer other-querier-present interval

undo timer other-querier-present

View

IGMP view

Parameter

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

Description

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

Use the undo timer other-querier-present command to restore the global other querier present interval to the default setting.

By default, the other querier present interval is (IGMP general query interval) times (IGMP last member query count) plus (maximum response time to IGMP general queries) divided by 2.

& Note:

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

Example

# Set the global value of the other querier present interval to 200 seconds.

<Sysname> system-view

[Sysname] igmp

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

4.1.23 timer query

Syntax

timer query interval

undo timer query

View

IGMP view

Parameter

interval: IGMP query interval, namely interval between IGMP general queries sent by the querier, in units of seconds, 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 command: igmp timer query, timer other-querier-present, display igmp interface.

Example

# Set the global value of the IGMP query interval to 125 seconds.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] timer query 125

4.1.24 version

Syntax

version version-number

undo version

View

IGMP view

Parameter

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

Description

Use the version command to configure the global IGMP version.

Use the undo version command to restore the global IGMP version to the system default.

The default IGMP version is version 2.

Related command: igmp version.

Example

# Set the global IGMP version to IGMPv3.

<Sysname> system-view

[Sysname] igmp

[Sysname-igmp] version 3

Chapter 5 PIM Configuration Commands

5.1 PIM Configuration Commands

5.1.1 auto-rp enable

Syntax

auto-rp enable

undo auto-rp enable

View

PIM view

Parameter

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 command: static-rp.

Example

# Enable auto-RP.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] auto-rp enable

5.1.2 bsr-policy

Syntax

bsr-policy acl-number

undo bsr-policy

View

PIM view

Parameter

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.

Example

# 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

5.1.3 c-bsr

Syntax

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

undo c-bsr

View

PIM view

Parameter

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 a C-BSR.

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

No C-BSR is configured by default.

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

Example

# Configure Vlan-interface100 to be an C-BSR.

<Sysname> system-view

[Sysname] pim

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

5.1.4 c-bsr admin-scope

Syntax

c-bsr admin-scope

undo c-bsr admin-scope

View

PIM view

Parameter

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 only one BSR can present in each PIM-SM domain.

Related command: c-bsr, c-bsr group, and c-bsr global.

Example

# Enable BSR administrative scoping.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr admin-scope

5.1.5 c-bsr global

Syntax

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

undo c-bsr global

View

PIM view

Parameter

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 command: c-bsr group, c-bsr hash-length, and c-bsr priority.

Example

# 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

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

Parameter

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 command: c-bsr global, c-bsr admin-scope, c-bsr hash-length, and c-bsr priority.

Example

# 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

5.1.7 c-bsr hash-length

Syntax

c-bsr hash-length hash-length

undo c-bsr hash-length

View

PIM view

Parameter

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 command: c-bsr, c-bsr global, and c-bsr group.

Example

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

<Sysname> system-view

[Sysname] pim

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

5.1.8 c-bsr holdtime

Syntax

c-bsr holdtime interval

undo c-bsr holdtime

View

PIM view

Parameter

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 for which the C-BSRs wait for a bootstrap message from the BSR.

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

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 command: c-bsr and c-bsr interval.

Example

# Set the bootstrap timeout time to 150 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr holdtime 150

5.1.9 c-bsr interval

Syntax

c-bsr interval interval

undo c-bsr interval

View

PIM view

Parameter

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 default setting.

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 command: c-bsr and c-bsr holdtime.

Example

# Set the bootstrap interval to 30 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr interval 30

5.1.10 c-bsr priority

Syntax

c-bsr priority priority

undo c-bsr priority

View

PIM view

Parameter

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 default setting.

By default, the C-BSR priority is 0.

Related command: c-bsr, c-bsr global, and c-bsr group.

Example

# Set the global C-BSR priority to 5.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-bsr priority 5

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

Parameter

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 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 command: c-bsr.

Example

# Configure Vlan-interface100 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

5.1.12 c-rp advertisement-interval

Syntax

c-rp advertisement-interval interval

undo c-rp advertisement-interval

View

PIM view

Parameter

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 default setting.

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

Related command: c-rp.

Example

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

<Sysname> system-view

[Sysname] pim

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

5.1.13 c-rp holdtime

Syntax

c-rp holdtime interval

undo c-rp holdtime

View

PIM view

Parameter

interval: Length of time the BSR waits for a C-RP-Adv message from C-RPs., 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 for a C-RP-Adv message from C-RPs.

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

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 command: c-rp and c-bsr interval.

Example

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

<Sysname> system-view

[Sysname] pim

[Sysname-pim] c-rp holdtime 200

5.1.14 crp-policy

Syntax

crp-policy acl-number

undo crp-policy

View

PIM view

Parameter

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.

Example

# 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

5.1.15 display pim bsr-info

Syntax

display pim bsr-info

View

Any view

Parameter

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 command: c-bsr and c-rp.

Example

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

<Sysname> display pim bsr-info

Vpn-instance: public net

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:00:35

Candidate BSR Address: 12.12.12.9

Priority: 0

Hash mask length: 30

State: Elected

Scope: Global

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

Field	Description
Vpn-instance	VPN instance name
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	Remaining time before the next BSR message is sent

5.1.16 display pim claimed-route

Syntax

display pim claimed-route [ source-address ]

View

Any view

Parameter

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.

Example

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

<Sysname> display pim claimed-route

Vpn-instance: public net

RPF information about: 172.168.0.0

RPF interface: Vlan-interface 1, 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 5-2 Description on the fields of the display pim claimed-route command

Field	Description
Vpn-instance	VPN instance name
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

5.1.17 display pim control-message counters

Syntax

display pim control-message counters [ interface interface-type interface-number | message-type message-type ]

View

Any view

Parameter

interface interface-type interface-number: Displays the number of PIM control messages on the specified interface.

message-type message-type: Displays the number of PIM control messages of a particular type. Values and meanings of message-type are as follows:

l assert: Assert message

l bsr: Bootstrap message

l crp: C-RP-Adv message

l graft: Graft message

l graft-ack: Graft-ack message

l hello: Hello message

l join-prune: Join/prune message

l probe: Null register message

l register: Register message

l register-stop: Register-stop message

l state-refresh: State refresh message

Description

Use the display pim control-message counters command to view the statistics information of PIM control messages.

Example

# View the statistics information of all types of PIM control messages on all interfaces.

<Sysname> display pim control-message counters

Vpn-instance: public net

PIM global control-message counters:

Received Sent Invalid

Probe 10 5 0

PIM control-message counters for interface: Vlan-interface 1

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 5-3 Description on the fields of display pim control-message counters

Field	Description
Vpn-instance	VPN instance name
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

5.1.18 display pim grafts

Syntax

display pim grafts

View

Any view

Parameter

None

Description

Use the display pim grafts command to view the information about unacknowledged graft messages.

Example

# View the information about unacknowledged graft messages.

<Sysname> display pim grafts

Vpn-instance: public net

Source Group Age RetransmitIn

192.168.10.1 224.1.1.1 00:00:24 00:00:02

Table 5-4 Description on the fields of the display pim grafts command

Field	Description
Vpn-instance	VPN instance name
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

5.1.19 display pim interface

Syntax

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

View

Any view

Parameter

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.

Example

# View the PIM information on all interfaces.

<Sysname> display pim interface

Vpn-instance: public net

Interface NbrCnt HelloInt DR-Pri DR-Address

Vlan-interface 100 1 30 1 10.1.1.2

Vlan-interface 101 0 30 1 172.168.0.2 (local)

Vlan-interface 102 1 30 1 20.1.1.2

Table 5-5 Description on the fields of the display pim interface command

Field	Description
Vpn-instance	VPN instance name
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-interface 1 verbose

Vpn-instance: public net

Interface: Vlan-interface 1, 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 5-6 Description on the fields of the display pim interface verbose command

Field	Description
Vpn-instance	VPN instance name
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

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

Parameter

mode: Displays the information of joint/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(s). 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 joint/prune messages to send on the specified interface.

neighbor-address: Displays the information of joint/prune messages to send to the specified PIM neighbor.

verbose: Displays the detailed information of joint/prune messages to send.

Description

Use the display pim join-prune command to view the information about the join/prune messages to send.

Example

# View the information of joint/prune messages to send in the PIM-SM mode.

<Sysname> display pim join-prune mode sm

Vpn-instance: public net

Expiry Time: 22 sec

Upstream nbr: 192.168.1.55 (Vlan-interface 1)

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-interface 2)

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 5-7 Description on the fields of the display pim join-prune command

Field	Description
Vpn-instance	VPN instance name
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

5.1.21 display pim neighbor

Syntax

display pim neighbor [ interface interface-type interface-number | neighbor-address ] [ verbose ]

View

Any view

Parameter

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.

Example

# View the information of all PIM neighbors.

<Sysname> display pim neighbor

Vpn-instance: public net

Total Number of Neighbors = 2

Neighbor Interface Uptime Expires Dr-Priority

10.1.1.2 Vlan-interface 101 02:50:49 00:01:31 1

20.1.1.2 Vlan-interface 102 02:49:39 00:01:42 1

Table 5-8 Description on the fields of the display pim neighbor command

Field	Description
Vpn-instance	VPN instance name
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

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

Parameter

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.

mask-length: Mask length of the multicast group/source address, in the range of 0 to 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 OIL includes the specified interface.

exclude: Displays routing entries of which the OIL does not includes the specified interface.

match: Displays routing entries of which the OIL 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 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 segment with the multicast source

l msdp: Specifies to 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.

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.

Related command: display multicast routing-table.

Example

# View the content of the PIM routing table.

<Sysname> display pim routing-table

Vpn-instance: public net

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

Upstream neighbor: NULL

RPF prime neighbor: NULL

Downstream interface(s) information:

Total number of downstreams: 1

1: Vlan-interface 3

Protocol: pim-sm, UpTime: 02:54:43, Expires: 00:02:47

Table 5-9 Description on the fields of the display pim routing-table command

Field	Description
Vpn-instance	VPN instance name
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 of an (S,G) or (, G) entry in the PIM routing table l SPT: indicates the (S, G) routing entry is on the SPT. l RPT: indicates the (S, G) or (, G) routing entry is on the RPT. l WC: Indicates a (*, G) entry l LOC: Indicates this router directly connects to the multicast source
Uptime	Length of time for which the (S, G) or (*, G) entry has existed, in hours:minutes:seconds
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)

5.1.23 display pim rp-info

Syntax

display pim rp-info [ group-address ]

View

Any view

Parameter

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.

Example

# View the RP information corresponding to the multicast group 224.0.1.1.

<Sysname> display pim rp-info 224.0.1.1

Vpn-instance: public net

BSR RP Address is: 2.2.2.2

Priority: 0

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

Vpn-instance: public net

PIM-SM BSR RP information:

Group/MaskLen: 224.0.0.0/4

RP: 2.2.2.2

Priority: 0

Uptime: 03:01:36

Expires: 00:02:29

Table 5-10 Description on the fields of the display pim rp-info command

Field	Description
Vpn-instance	VPN instance name
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
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

5.1.24 hello-option dr-priority

Syntax

hello-option dr-priority priority

undo hello-option dr-priority

View

PIM view

Parameter

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 default setting.

By default, the router priority for DR election is 1.

Related command: pim hello-option dr-priority.

Example

# Set the router priority for DR election to 3.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option dr-priority 3

5.1.25 hello-option holdtime

Syntax

hello-option holdtime interval

undo hello-option holdtime

View

PIM view

Parameter

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 default setting.

By default, the PIM neighbor timeout time is 105 seconds.

This command is effective for both PIM-DM and PIM-SM.

Related command: pim hello-option holdtime.

Example

# Set the global value of the PIM neighbor timeout time to 120 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option holdtime 120

5.1.26 hello-option lan-delay

Syntax

hello-option lan-delay interval

undo hello-option lan-delay

View

PIM view

Parameter

interval: Prune delay 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 prune delay time, namely the length of time the device must wait upon receiving a prune message from downstream before 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 cancelled.

Use the undo hello-option lan-delay command to restore the default setting.

By default, the prune delay to 500 milliseconds.

This command is effective for both PIM-DM and PIM-SM.

Related command: hello-option override-interval, pim hello-option override-interval, and pim hello-option lan-delay.

Example

# Set the prune delay to 200 milliseconds globally.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option lan-delay 200

5.1.27 hello-option neighbor-tracking

Syntax

hello-option neighbor-tracking

undo hello-option neighbor-tracking

View

PIM view

Parameter

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 command: pim hello-option neighbor-tracking.

Example

# Disable join suppression globally.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option neighbor-tracking

5.1.28 hello-option override-interval

Syntax

hello-option override-interval interval

undo hello-option override-interval

View

PIM view

Parameter

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 default setting.

By default, the prune override interval is 2,500 milliseconds.

This command is effective for both PIM-DM and PIM-SM.

Related command: hello-option lan-delay, pim hello-option lan-delay, and pim hello-option override-interval.

Example

# Set the prune override interval to 2,000 milliseconds globally.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] hello-option override-interval 2000

5.1.29 holdtime assert

Syntax

holdtime assert interval

undo holdtime assert

View

PIM view

Parameter

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 default setting.

By default, the assert timeout time is 180 seconds.

This command is effective for both PIM-DM and PIM-SM.

Related command: holdtime join-prune, pim holdtime join-prune, and pim holdtime assert.

Example

# Set the global value of the assert timeout time to 100 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] holdtime assert 100

5.1.30 holdtime join-prune

Syntax

holdtime join-prune interval

undo holdtime join-prune

View

PIM view

Parameter

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 default setting.

By default, the join/prune timeout time is 210 seconds.

Related command: holdtime assert, pim holdtime assert, and pim holdtime join-prune.

Example

# Set the global value of the join/prune timeout time to 280 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] holdtime join-prune 280

5.1.31 jp-pkt-size

Syntax

jp-pkt-size packet-size

undo jp-pkt-size

View

PIM view

Parameter

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 default setting.

By default, the maximum size of join/prune messages is 8,100 bytes.

Related command: jp-queue-size.

Example

# Set the maximum size of join/prune messages to 1,500 bytes.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] jp-pkt-size 1500

5.1.32 jp-queue-size

Syntax

jp-queue-size queue-size

undo jp-queue-size

View

PIM view

Parameter

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 default setting.

By default, a join/prune messages contains a maximum of 1,020 (S, G) entries.

Related command: jp-pkt-size.

Example

# 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

5.1.33 pim

Syntax

pim

undo pim

View

System view

Parameter

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.

Related command: multicast routing-enable.

Example

# Enable IP multicast routing and enter PIM view.

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] pim

[Sysname-pim]

5.1.34 pim bsr-boundary

Syntax

pim bsr-boundary

undo pim bsr-boundary

View

Interface view

Parameter

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.

Related command: c-bsr, and multicast boundary.

Example

# Configure Vlan-interface100 to be the boundary of the BSR admin-scope region.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim bsr-boundary

5.1.35 pim dm

Syntax

pim dm

undo pim dm

View

Interface view

Parameter

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.

Related command: pim sm.

Example

# Enable PIM-DM on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim dm

5.1.36 pim hello-option dr-priority

Syntax

pim hello-option dr-priority priority

undo pim hello-option dr-priority

View

Interface view

Parameter

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 default setting.

By default, the router priority for DR election is 1.

Related command: hello-option dr-priority.

Example

# Set the router priority for DR election to 3 on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option dr-priority 3

5.1.37 pim hello-option holdtime

Syntax

pim hello-option holdtime interval

undo pim hello-option holdtime

View

Interface view

Parameter

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 default setting.

By default, the PIM neighbor timeout time is 105 seconds.

Related command: hello-option holdtime.

Example

# Set the PIM neighbor timeout time to 120 seconds on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option holdtime 120

5.1.38 pim hello-option lan-delay

Syntax

pim hello-option lan-delay interval

undo pim hello-option lan-delay

View

Interface view

Parameter

interval: Prune delay in milliseconds, with an effective range of 1 to 32,767.

Description

Use the pim hello-option lan-delay command to configure the prune delay time on the current interface.

Use the undo pim hello-option lan-delay command to restore the default setting.

By default, the prune delay to 500 milliseconds.

Related command: pim hello-option override-interval, hello-option override-interval, and hello-option lan-delay.

Example

# Set the prune delay time to 200 milliseconds on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option lan-delay 200

5.1.39 pim hello-option neighbor-tracking

Syntax

pim hello-option neighbor-tracking

undo pim hello-option neighbor-tracking

View

Interface view

Parameter

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 command: hello-option neighbor-tracking.

Example

# Disable join suppression on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option neighbor-tracking

5.1.40 pim hello-option override-interval

Syntax

pim hello-option override-interval interval

undo pim hello-option override-interval

View

Interface view

Parameter

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 default setting.

By default, the prune override interval is 2,500 milliseconds.

Related command: pim hello-option lan-delay, hello-option lan-delay, and hello-option override-interval.

Example

# Set the prune override interval to 2,000 milliseconds on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim hello-option override-interval 2000

5.1.41 pim holdtime assert

Syntax

pim holdtime assert interval

undo pim holdtime assert

View

Interface view

Parameter

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 default setting.

By default, the assert timeout time is 180 seconds.

Related command: holdtime join-prune, pim holdtime join-prune, and holdtime assert.

Example

# Set the assert timeout time to 100 seconds on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim holdtime assert 100

5.1.42 pim holdtime join-prune

Syntax

pim holdtime join-prune interval

undo pim holdtime join-prune

View

Interface view

Parameter

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 default setting.

By default, the join/prune timeout time is 210 seconds.

Related command: holdtime assert, pim holdtime assert, and holdtime join-prune.

Example

# Set the join/prune timeout time to 280 seconds on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim holdtime join-prune 280

5.1.43 pim require-genid

Syntax

pim require-genid

undo pim require-genid

View

Interface view

Parameter

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.

Example

# Enable Vlan-interface100 to reject hello messages without Generation_ID.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim require-genid

5.1.44 pim sm

Syntax

pim sm

undo pim sm

View

Interface view

Parameter

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 command: pim dm.

Example

# Enable PIM-SM on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim sm

5.1.45 pim state-refresh-capable

Syntax

pim state-refresh-capable

undo pim state-refresh-capable

View

Interface view

Parameter

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 command: state-refresh-interval, state-refresh-rate-limit, and state-refresh-ttl.

Example

# Disable state refresh on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] undo pim state-refresh-capable

5.1.46 pim timer graft-retry

Syntax

pim timer graft-retry interval

undo pim timer graft-retry

View

Interface view

Parameter

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 default setting.

By default, the graft retry period is 3 seconds.

Example

# Set the graft retry period to 80 seconds on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer graft-retry 80

5.1.47 pim timer hello

Syntax

pim timer hello interval

undo pim timer hello

View

Interface view

Parameter

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 default setting.

By default, hello messages are sent at the interval of 30 seconds.

Related command: timer hello.

Example

# Set the hello interval to 40 seconds on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer hello 40

5.1.48 pim timer join-prune

Syntax

pim timer join-prune interval

undo pim timer join-prune

View

Interface view

Parameter

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 default setting.

By default, the join/prune interval is 60 seconds.

Related command: timer join-prune.

Example

# Set the join/prune interval to 80 seconds on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim timer join-prune 80

5.1.49 pim triggered-hello-delay

Syntax

pim triggered-hello-delay interval

undo pim trigged-hello-delay

View

Interface view

Parameter

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 default setting.

By default, the maximum delay between hello messages is 5 seconds.

Example

# Set the maximum delay between hello messages to 3 seconds on Vlan-interface100.

<Sysname> system-view

[Sysname] interface vlan-interface 100

[Sysname-Vlan-interface100] pim trigged-hello-delay 3

5.1.50 probe-interval

Syntax

probe-interval interval

undo probe-interval

View

PIM view

Parameter

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 default setting.

By default, the probe time is 5 seconds.

Related command: register-suppression-timeout.

Example

# Set the probe time to 6 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] probe-interval 6

5.1.51 register-header-checksum

Syntax

register-header-checksum

undo register-header-checksum

View

PIM view

Parameter

None

Description

Use the register-header-checksum command to configure to calculate the checksum based on the register message header only.

Use the undo register-header-checksum command to restore the default setting.

By default, checksum is calculated based on contents of the whole register message.

Related command: register-policy, and register-suppression-timeout.

Example

# Configure to calculate the checksum based on the register message header only.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-header-checksum

5.1.52 register-policy

Syntax

register-policy acl-number

undo register-policy

View

PIM view

Parameter

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 command: register-suppression-timeout.

Example

# Configure to receive register messages from the multicast sources on the subnet 10.10.0.0/16 to the multicast groups on the subnet 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

5.1.53 register-suppression-timeout

Syntax

register-suppression-timeout interval

undo register-suppression-timeout

View

PIM view

Parameter

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 default setting.

By default, the register suppression timeout time is 60 seconds.

Related command: probe-interval and register-policy.

Example

# Set the register suppression timeout time to 70 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] register-suppression-timeout 70

5.1.54 reset pim control-message counters

Syntax

reset pim control-message counters [ interface interface-type interface-number ]

View

User view

Parameter

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.

Example

# Reset PIM control message counters on all interfaces.

<Sysname> reset pim control-message counters

5.1.55 source-lifetime

Syntax

source-lifetime interval

undo source-lifetime

View

PIM view

Parameter

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 default setting.

By default, the lifetime of a multicast source is 210 seconds.

Related command: state-refresh-interval.

Example

# Set the multicast source lifetime to 200 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] source-lifetime 200

5.1.56 source-policy

Syntax

source-policy acl-number

undo source-policy

View

PIM view

Parameter

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.

Example

# 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

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

Parameter

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 configure the RPT-to-SPT switchover parameters.

Use the undo spt-switch-threshold command to restore the default configuration.

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

Example

# 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

5.1.58 ssm-policy

Syntax

ssm-policy acl-number

undo ssm-policy

View

PIM view

Parameter

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

Description

Use the ssm-policy command to configure the address range of PIM-SSM multicast groups.

Use the undo ssm-policy command to restore the system default.

By default, the PIM-SSM range of group addresses is 232.0.0.0/8.

Note that:

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

l This command does not takes effect when IGMPv3 is used for (S, G) entry joining.

Example

# Configure 232.1.0.0/16 as the permitted group address range in the PIM-SSM domain.

<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

5.1.59 state-refresh-interval

Syntax

state-refresh-interval interval

undo state-refresh-interval

View

PIM view

Parameter

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 default setting.

By default, the state refresh interval is 60 seconds.

Related command: pim state-refresh-capable, state-refresh-rate-limit, and state-refresh-ttl.

Example

# Set the state refresh interval to 70 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-interval 70

5.1.60 state-refresh-rate-limit

Syntax

state-refresh-rate-limit interval

undo state-refresh-rate-limit

View

PIM view

Parameter

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 default setting.

By default, the device waits 30 seconds before receiving a new state refresh message.

Related command: pim state-refresh-capable, state-refresh-interval, and state-refresh-ttl.

Example

Configure the device to wait 45 seconds before receiving a new state refresh message.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-rate-limit 45

5.1.61 state-refresh-ttl

Syntax

state-refresh-ttl ttl-value

undo state-refresh-ttl

View

PIM view

Parameter

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 default setting.

By default, the TTL value of state refresh messages is 255.

Related command: pim state-refresh-capable, state-refresh-interval, and state-refresh-rate-limit.

Example

# Set the TTL value of state refresh messages to 45.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] state-refresh-ttl 45

5.1.62 static-rp

Syntax

static-rp rp-address [ acl-number ] [ preferred ]

undo static-rp rp-address

View

PIM view

Parameter

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 carrying out this command repeatedly and specifying different static RP addresses. 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. If you carry out this command multiple times and specify the same static RP address, the last configuration will take effect.

Related command: display pim rp-info and auto-rp enable.

Example

# 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

5.1.63 timer hello

Syntax

timer hello interval

undo timer hello

View

PIM view

Parameter

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 default setting.

By default, hello messages are sent at the interval of 30 seconds.

Related command: pim timer hello.

Example

# Set the global hello interval to 40 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer hello 40

5.1.64 timer join-prune

Syntax

timer join-prune interval

undo timer join-prune

View

PIM view

Parameter

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 default setting.

By default, the join/prune interval is 60 seconds.

Related command: pim timer join-prune.

Example

# Set the global join/prune interval to 80 seconds.

<Sysname> system-view

[Sysname] pim

[Sysname-pim] timer join-prune 80

Chapter 6 MSDP Configuration Commands

6.1 MSDP Configuration Commands

6.1.1 cache-sa-enable

Syntax

cache-sa-enable

undo cache-sa-enable

View

MSDP view

Parameter

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.

Example

# Enable the SA message cache mechanism.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] cache-sa-enable

6.1.2 display msdp brief

Syntax

display msdp brief [ state { connect | down | listen | shutdown | up } ]

View

Any view

Parameter

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.

Example

# 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 6-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	Time of MSDP peer connection setup/failure
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

6.1.3 display msdp peer-status

Syntax

display msdp peer-status [ peer-address ]

View

Any view

Parameter

peer-address: Specifies an MSDP peer to view the detailed status information about. 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 command: peer connect-interface, peer description, peer mesh-group, peer minimum-ttl, peer request-sa-enable, peer sa-cache-maximum, peer sa-policy, and peer sa-request-policy.

Example

# 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 6-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	Time of MSDP peer connection setup/failure
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 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

6.1.4 display msdp sa-cache

Syntax

display msdp sa-cache [ group-address | source-address | as-number ] *

View

Any view

Parameter

group-address: Multicast group address in a (S, G) entry, in the range of 224.0.1.0 to 239.255.255.255.

source-address: Multicast source address in a (S, G) entry.

as-number: Number of an AS, 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 command: cache-sa-enable.

Example

# View the status information of (S, G) entries 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 6-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

6.1.5 display msdp sa-count

Syntax

display msdp sa-count [ as-number ]

View

Any view

Parameter

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 command: cache-sa-enable.

Example

# 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 6-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 counted by 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

6.1.6 encap-data-enable

Syntax

encap-data-enable

undo encap-data-enable

View

MSDP view

Parameter

None

Description

Used the encap-data-enable command to enable encapsulation of the first multicast packet within an SA message.

Used the undo encap-data-enable command to disable encapsulation of the first multicast packet within an SA message.

By default, the first multicast packet is not encapsulated within an SA message.

Example

# Enable encapsulation of the first multicast packet within an SA message.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] encap-data-enable

6.1.7 import-source

Syntax

import-source [ acl acl-number ]

undo import-source

View

MSDP view

Parameter

acl-number: Basic or advanced ACL number, in the range of 2000 to 3999. A basic ACL is used to filter the multicast sources; while an advanced ACL is used to the 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 command: peer sa-policy.

Example

# 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

6.1.8 msdp

Syntax

msdp

undo msdp

View

System view

Parameter

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.

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

Example

# Enable MSDP and enter MSDP view

<Sysname> system-view

[Sysname] multicast routing-enable

[Sysname] msdp

[Sysname-msdp]

6.1.9 originating-rp

Syntax

originating-rp interface-type interface-number

undo originating-rp

View

MSDP view

Parameter

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 remove the configuration of using the interface address as the RP address of SA messages.

Be default, the PIM RP address is used as the RP address of SA messages.

Example

# Specify the IP address of Vlan-interface100 as the RP address of SA messages.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] originating-rp vlan-interface 100

6.1.10 peer connect-interface

Syntax

peer peer-address connect-interface interface-type interface-number

undo peer peer-address

View

MSDP view

Parameter

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.

No MSDP peer connection 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 command: static-rpf-peer.

Example

# Configure the router with the IP address of 125.10.7.6 as the MSDP peer of the local router, with interface Vlan-interface100 as the local connection port.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] peer 125.10.7.6 connect-interface vlan-interface 100

6.1.11 peer description

Syntax

peer peer-address description text

undo peer peer-address description

View

MSDP view

Parameter

peer-address: MSDP peer address.

text: Descriptive text, a string of a 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 command: display msdp peer-status.

Example

# 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

6.1.12 peer mesh-group

Syntax

peer peer-address mesh-group name

undo peer peer-address mesh-group

View

MSDP view

Parameter

peer-address: MSDP peer address.

name: Mesh group name, a string of 1 to 32 characters (case sensitive).

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.

Example

# 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

6.1.13 peer minimum-ttl

Syntax

peer peer-address minimum-ttl ttl-value

undo peer peer-address minimum-ttl

View

MSDP view

Parameter

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 command: display msdp peer-status.

Example

# 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

6.1.14 peer request-sa-enable

Syntax

peer peer-address request-sa-enable

undo peer peer-address request-sa-enable

View

MSDP view

Parameter

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.

Related command: cache-sa-enable.

Example

# 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] peer 125.10.7.6 request-sa-enable

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

Parameter

peer-address: MSDP peer address.

sa-limit: Maximum number of SA messages that can 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 command: display msdp sa-count, display msdp peer-status, and display msdp brief.

Example

# 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

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

Parameter

import: Specifies to receive SA messages from the specified MSDP peer.

export: Specifies to forward SA messages from 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 command: display msdp peer-status and import-source.

Example

# Configure a filtering rule so that SA messages from the MSDP peer 125.10.7.6 will be forwarded 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

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

Parameter

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 command: display msdp peer-status.

Example

# 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

6.1.18 reset msdp peer

Syntax

reset msdp peer [ peer-address ]

View

User view

Parameter

peer-address: Address of the MSDP peer with which the TCP connection is to be reset. 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 MSDP peer and clear all the statistics information of the MSDP peer

Related command: display msdp peer-status.

Example

# Reset 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

6.1.19 reset msdp sa-cache

Syntax

reset msdp sa-cache [ group-address ]

View

User view

Parameter

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 command: cache-sa-enable and display msdp sa-cache.

Example

# 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

6.1.20 reset msdp statistics

Syntax

reset msdp statistics [ peer-address ]

View

User view

Parameter

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

Example

# Clear the statistics information of the MSDP peer 125.10.7.6.

<Sysname> reset msdp statistics 125.10.7.6

6.1.21 shutdown

Syntax

shutdown peer-address

undo shutdown peer-address

View

MSDP view

Parameter

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 command: display msdp peer-status.

Example

# Deactivate the connection with the MSDP peer 125.10.7.6.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] shutdown 125.10.7.6

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

Parameter

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 string of 1 to 19 characters (case sensitive).

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 command: display msdp peer-status and ip prefix-list.

Example

# 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

6.1.23 timer retry

Syntax

timer retry interval

undo timer retry

View

MSDP view

Parameter

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 command: display msdp peer-status.

Example

# Set the MSDP peer connection retry interval to 60 seconds.

<Sysname> system-view

[Sysname] msdp

[Sysname-msdp] timer retry 60

Chapter 7 Multicast Policy Configuration Commands

7.1 Multicast Policy Configuration Commands

7.1.1 display multicast boundary

Syntax

display multicast boundary [ group-address [ mask | mask-length ] ] [ interface interface-type interface-number ]

View

Any view

Parameter

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

mask-length: Mask length of the multicast group address, in the range of 4 to 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 command: multicast boundary.

Example

# View the multicast boundary information configured on all interfaces.

<Sysname> display multicast boundary

Multicast boundary information

Boundary Interface

239.0.0.1/16 Vlan-interface4

7.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 ] [ verbose ]

View

Any view

Parameter

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.

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.

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 (OIL) excludes the specified interface.

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

match: Specifies the routing entries of which the OIL includes and includes only the specified interface.

statistics: Displays the statistics information of multicast forwarding table.

port-info: Displays Layer 2 port information.

verbose: Displays detailed information about multicast group.

Description

Use the display multicast forwarding-table command to view the multicast forwarding table information.

Related command: multicast forwarding-table downstream-limit, multicast forwarding-table route-limit and display multicast routing-table.

Example

# 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 7-1 Description on the fields of display multicast forwarding-table

Field	Description
00001	Sequence number 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 an 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 7-2.
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 outgoing interface: 1: Vlan-interface2 Matched 38264 packets (1071392 bytes), Wrong If 0 packets Forwarded 18696 packets (523488 bytes)	Outgoing interface list (OIL) Interface number: outgoing interface type and number (S, G)-matched packets (bytes), packets with incoming interface errors (S, G)-forwarded packets (bytes)

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

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

Parameter

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.

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 outing interface is the specified one.

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

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

match: Displays routing entries of which the OIL includes only the specified interface.

Description

Use the display multicast routing-table command to view the multicast routing table information.

Related command: display multicast forwarding-table.

Example

# 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-interface1

List of 2 downstream interfaces

1: Vlan-interface2

2: Vlan-interface3

Table 7-3 Description on the fields of display multicast routing-table

Field	Description
00001	Sequence number 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
List of 2 downstream interfaces: 1: Vlan-interface2 2: Vlan-interface3	Downstream interface list: outbound interface number, and outbound interface name

7.1.4 display multicast routing-table static

Syntax

display multicast routing-table static [ config ] [ source-address { mask-length | mask } ]

View

Any view

Parameter

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.

Example

# 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 = 0

Table 7-4 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 a 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

7.1.5 display multicast rpf-info

Syntax

display multicast rpf-info source-address [ group-address ]

View

Any view

Parameter

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 command: display multicast routing-table and display multicast forwarding-table.

Example

# 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

Referenced route/mask: 192.168.1.0/24

Referenced route type: igp

Route selection rule: preference-preferred

Load splitting rule: disable

Table 7-5 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
Referenced route/mask	Referenced route and its mask length
Referenced route type	Type of the referenced route, which can be a unicast route, an MBGP route or a 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)

7.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 } [ order order-number | preference preference ]

undo ip rpf-route-static source-address { mask | mask-length } [ protocol [ process-id ] ] [ route-policy policy-name ]

View

System view

Parameter

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 BGP, ISIS 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: IP address of the RPF neighbor.

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

preference: Route preference, in the range of 1 to 255 and defaulting to 1.

order-number: Match order for routes on the same segment, in the range of 1 to 100.

Description

Use the ip rpf-route-static command to configure a multicast static route.

Use the undo ip rpf-route-static command to delete a multicast static route from the multicast static routing table.

By default, no multicast static route is configured.

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 using this command to configure a static route, you can configure the interface to the RPF neighbor in the command if the next hop interface is on a point-to-point link; otherwise, you must provide the address of the RPF neighbor.

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 command: display multicast routing-table static.

Example

# 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

7.1.7 multicast boundary

Syntax

multicast boundary group-address { mask | mask-length }

undo multicast boundary { group-address { mask | mask-length } | all }

View

Interface view

Parameter

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 the forwarding boundary configuration on all interfaces.

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 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 command: display multicast boundary.

Example

# Configure Vlan-interface100 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

7.1.8 multicast forwarding-table downstream-limit

Syntax

multicast forwarding-table downstream-limit limit

undo multicast forwarding-table downstream-limit

View

System view

Parameter

limit: Maximum number of downstream nodes (namely, the maximum number of outgoing interfaces) for a single route in the multicast forwarding table. The value ranges 0 to the maximum allowable number.

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 limit command to restore maximum number of downstream nodes for a single route to the system default.

By default, the maximum number of downstream nodes for a single route in the multicast forwarding table is 128.

Related command: display multicast forwarding-table.

Example

# 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

7.1.9 multicast forwarding-table route-limit

Syntax

multicast forwarding-table route-limit limit

undo multicast forwarding-table route-limit

View

System view

Parameter

limit: Maximum number of route entries in the multicast forwarding table. The value ranges 0 to the maximum allowable number.

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 1,000.

Related command: display multicast forwarding-table.

Example

# Set the maximum number of routing entries in the multicast forwarding table to 200.

<Sysname> system-view

[Sysname] multicast forwarding-table route-limit 200

7.1.10 multicast load-splitting

Syntax

multicast load-splitting { source | source-group }

undo multicast load-splitting

View

System view

Parameter

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.

Example

# Enable per-source load splitting of multicast traffic.

<Sysname> system-view

[Sysname] multicast load-splitting source

7.1.11 multicast longest-match

Syntax

multicast longest-match

undo multicast longest-match

View

System view

Parameter

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.

Example

# Configure route selection based on the longest match.

<Sysname> system-view

[Sysname] multicast longest-match

7.1.12 multicast routing-enable

Syntax

multicast routing-enable

undo multicast routing-enable

View

System view

Parameter

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.

Example

# Enable IP multicast routing.

<Sysname> system-view

[Sysname] multicast routing-enable

7.1.13 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

Parameter

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.

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.

incoming-interface: Clears multicast forwarding entries of which the incoming interface is the specified one.

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

register: 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 command: reset multicast routing-table, display multicast routing-table, and display multicast forwarding-table.

Example

# 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

7.1.14 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

Parameter

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.

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 command: reset multicast forwarding-table, display multicast routing-table and display multicast forwarding-table.

Example

# 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 S3610[S5510] Series Ethernet Switches Command Manual-Release 0001-(V1.02)

Chapter 1 IGMP Snooping Configuration Commands

1.1.3 fast-leave

1.1.6 igmp-snooping

1.1.7 igmp-snooping enable

1.1.8 igmp-snooping fast-leave

1.1.9 igmp-snooping general-query source-ip

1.1.11 igmp-snooping group-policy

1.1.12 igmp-snooping host-aging-time

1.1.14 igmp-snooping last-member-query-interval

1.1.15 igmp-snooping max-response-time

1.1.16 igmp-snooping overflow-replace

1.1.17 igmp-snooping querier

1.1.18 igmp-snooping query-interval

1.1.20 igmp-snooping special-query source-ip

1.1.21 igmp-snooping static-group

1.1.22 igmp-snooping static-router-port

1.1.23 igmp-snooping version

1.1.26 overflow-replace

2.1.3 fast-leave

2.1.4 group-policy

2.1.5 host-aging-time

2.1.6 last-member-query-interval

2.1.8 mld-snooping

2.1.9 mld-snooping enable

2.1.10 mld-snooping fast-leave

2.1.13 mld-snooping group-policy

2.1.14 mld-snooping host-aging-time

2.1.16 mld-snooping last-member-query-interval

2.1.17 mld-snooping max-response-time

2.1.18 mld-snooping overflow-replace

2.1.19 mld-snooping querier

2.1.20 mld-snooping query-interval

2.1.22 mld-snooping special-query source-ip

2.1.26 report-aggregation

2.1.29 router-aging-time

5.1 PIM Configuration Commands

5.1.3 c-bsr

5.1.4 c-bsr admin-scope

5.1.5 c-bsr global

5.1.6 c-bsr group

5.1.7 c-bsr hash-length

5.1.8 c-bsr holdtime

5.1.9 c-bsr interval

5.1.10 c-bsr priority

5.1.11 c-rp

5.1.22 display pim routing-table

5.1.23 display pim rp-info

5.1.24 hello-option dr-priority

5.1.25 hello-option holdtime

5.1.26 hello-option lan-delay

5.1.27 hello-option neighbor-tracking

5.1.28 hello-option override-interval

5.1.29 holdtime assert

5.1.30 holdtime join-prune

5.1.31 jp-pkt-size

5.1.32 jp-queue-size

5.1.35 pim dm

5.1.36 pim hello-option dr-priority

5.1.37 pim hello-option holdtime

5.1.38 pim hello-option lan-delay

5.1.39 pim hello-option neighbor-tracking

5.1.40 pim hello-option override-interval

5.1.41 pim holdtime assert

5.1.42 pim holdtime join-prune

5.1.44 pim sm

5.1.45 pim state-refresh-capable

5.1.47 pim timer hello

5.1.48 pim timer join-prune

5.1.50 probe-interval

5.1.53 register-suppression-timeout