source-lifetime (IPv4)

Function

The source-lifetime command specifies the timeout period of (S, G) or (*, G) entries on the switch.

The undo source-lifetime command restores the default value of the timeout period.

By default, the timeout period is 210 seconds.

Format

source-lifetime { interval | infinity } [ group-policy acl-number ]

undo source-lifetime

undo source-lifetime { interval | infinity } [ group-policy acl-number ]

Parameters

Parameter	Description	Value
interval	Specifies the timeout period of (S, G) or (*, G) entries on the switch.	The value is an integer that ranges from 60 to 65535, in seconds.
infinity	Indicates that (S, G) entries on the switch will never age out.	-
group-policy	Specifies a group policy to determine to which the configured timeout period takes effect.	-
acl-number	Specifies the number of a basic or advanced ACL.	The value is an integer that ranges from 2000 to 3999.

Views

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

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

A switch starts a timer for each (S, G) or (*, G) entry. The source-lifetime command sets the timer value. After receiving a multicast packet from S, the interface resets the timer. If the timer times out, the (S, G) or (*, G) entry is considered invalid.

If you configure source-lifetime interval, the configured timeout period applies to all (S, G) entries.

If you configure source-lifetime interval { group-policy acl-number }:
- If you specify a basic ACL number in the command, the configured timeout period applies to the (S, G) entries in which the source addresses are permitted by the specified ACL.
- If you specify an advanced ACL number in the command, the configured timeout period applies to the (S, G) entries in which the source and group addresses are permitted by the specified ACL.
- If you specify an advanced ACL name in the command, the configured timeout period applies to the (S, G) entries in which the source and group addresses are permitted by the specified ACL.

If you configure source-lifetime infinity, all (S, G) entries will never age out.
If you configure source-lifetime infinity { group-policy acl-number }:
- If you specify a basic ACL number in the command, the (S, G) entries in which the source addresses are permitted by the specified ACL will never age out.
- If you specify an advanced ACL number in the command, the (S, G) entries in which the source and group addresses are permitted by the specified ACL will never age out.
- If you specify an advanced ACL name in the command, the (S, G) entries in which the source and group addresses are permitted by the specified ACL will never age out.

If you run this command multiple times for the same range of multicast forwarding entries and specify interval and infinity respectively in the commands, infinity takes precedence over interval.

Prerequisites

IP multicast routing has been enabled using the multicast routing-enable command.

Precautions

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

Example

# In the PIM view of public network instance, set the timeout period of an (S, G) or (*, G) entry of the switch to 200 seconds.

<HUAWEI> system-view
[HUAWEI] multicast routing-enable
[HUAWEI] pim
[HUAWEI-pim] source-lifetime 200