state-refresh-interval (IPv4)

Function

The state-refresh-interval command sets the interval for sending PIM State-Refresh messages.

The undo state-refresh-interval command restores the default value of the interval.

By default, the interval for sending PIM State-Refresh messages is 60 seconds.

Format

state-refresh-interval interval

undo state-refresh-interval

Parameters

Parameter	Description	Value
interval	Specifies the interval for sending PIM State-Refresh messages.	The value is an integer that ranges from 1 to 255, in seconds.

Views

PIM view of public network instance or PIM view of VPN instance

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

On the PIM-DM network, the device periodically sends State-Refresh messages to update the timeout interval of the prune timer on the downstream device. By doing this, the interface that has no multicast requirements retains in prune state. You can use the state-refresh-interval command to set the interval at which State-Refresh messages are sent.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command in the public network instance or VPN instance.

Precautions

To prevent a pruned interface from forwarding packets when the Prune status times out, the interval for sending State-Refresh messages is shorter than the period for keeping the Prune status.

You can run the holdtime join-prune (IPv4) command to set the period during which the device keeps the Prune status.

This command is valid for only PIM-DM.

This command takes effect only on the switch directly connected to a source.

Example

# Set the interval for sending PIM State-Refresh messages to 70s in the PIM view of public network instance.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] pim
[HUAWEI-pim] state-refresh-interval 70