timer hold

Function

The timer hold command configures the interval at which Keepalive messages are sent on an interface.

The undo timer hold command restores the default interval at which Keepalive messages are sent.

By default, the interval at which Keepalive messages are sent on an interface is 10 seconds.

Format

timer hold hold-time

undo timer hold

Parameters

Parameter	Description	Value
hold-time	Specifies the interval at which Keepalive messages are sent on an interface.	The value is an integer ranging from 0 to 32767, in seconds. If the interval is set to 0 seconds, no Keepalive packet is sent.

Views

VT interface view, Dialer interface view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Keepalive packets are used to monitor and maintain the link status. If an interface does not receive any Keepalive packet after five Keepalive intervals, it considers that the link fails.

Prerequisites

PPP has been configured as the link layer protocol of the interface.

Precautions

On a low-speed link, the hold-time parameter cannot be set to a small value because it may take a long time to transmit oversized packets on the link. If the interval for sending Keepalive packets is set to a small value, transmission of Keepalive packets is delayed. If an interface does not receive any Keepalive packet from the remote interface after five Keepalive intervals, the interface considers that the link fails.
The intervals at which Keepalive messages are sent at both ends must be set to the same value.
If the interval is set to 0 at both ends, the link detection is disabled. The local end cannot detect the status change of the link of the peer. If the physical status of the local end is Up, the status of the link layer protocol keeps Up.

Enabling the interval for sending Keepalive messages compromises PPPoE performance.

Example

# Set the interval at which Keepalive messages are sent on Dialer 0 to 5 seconds.

<sysname> system-view
[sysname] interface Dialer 0
[sysname-Dialer0] link-protocol ppp 
[sysname-Dialer0] timer hold 5