holdtime join-prune (IPv4)

Function

The holdtime join-prune command sets the holdtime value in Join/Prune messages sent by all PIM interfaces. FWs that receive Join/Prune messages set the time during which the downstream interface keeps the Join or Prune state according to holdtime.

The undo holdtime join-prune command restores the default value.

Format

holdtime join-prune interval

undo holdtime join-prune

Parameters

Parameter	Description	Value
interval	Specifies the value of holdtime carried in Join/Prune messages sent by the local FW.	The value is an integer that ranges from 1 to 65535 , in seconds.

Views

PIM view

Default Level

2: Configuration level

Usage Guidelines

By default, the holdtime value in Join/Prune messages sent by all PIM interfaces is 210 seconds.

This command is valid for PIM-SM and PIM-DM.

When the Join/Prune message sent by the downstream FW carries holdtime, the FW that receives the message sets the timer for the downstream interface that joins the group or is pruned off. The timeout period of the timer is holdtime. After the timer times out, the downstream interface starts to forward packets. The value of holdtime is 3.5 times as long as the interval for sending Join/Prune messages.

This command functions in the same way as the pim holdtime join-prune command in the interface view, except for the view. By default, if no configuration is done on the interface, the value configured in the PIM view is used; otherwise, the value configured in the interface view is used.

Example

# Set the time during which the downstream interface of a FW keeps the Join or Prune state to 280 seconds.

<sysname> system-view
[sysname] multicast routing-enable
[sysname] pim
[sysname-pim] holdtime join-prune 280