clear pppoe lockout vlan-identifier

Syntax

Description

Clear the lockout condition for the PPPoE client associated with the specified VLAN encapsulation type and, optionally, media access control (MAC) source address and agent circuit identifier (ACI) value. Because the lockout condition persists even in the absence of an underlying interface or after automatic removal of the VLAN or VLAN demux interface, using the clear pppoe lockout vlan-identifier command enables you to clear the lockout condition for PPPoE clients by specifying VLAN identifying characteristics rather than by specifying the underlying interface name.

The following characteristics comprise the VLAN encapsulation type identifier:

Device name (physical interface or aggregated Ethernet bundle)
Stacked VLAN (S-VLAN) ID (also known as the outer tag)
VLAN ID (also known as the inner tag)

You can configure PPPoE subscriber session lockout, also known as PPPoE short-cycle protection, for VLAN, VLAN demux, and PPPoE-over-ATM dynamic subscriber interfaces.

Options

`circuit-id`	(Optional) ACI value associated with the PPPoE client for which you want to clear lockout. To clear the lockout condition by a specified ACI value, you must specify the `filter aci` option in the `short-cycle-protection` statement when you configure PPPoE subscriber session lockout. If the `filter aci` option is missing from the `short-cycle-protection` statement, no PPPoE client sessions are cleared using the ACI filter. The `aci` option and the `mac-address` option are mutually exclusive.
`device-name`	Name of the Ethernet physical interface or aggregated Ethernet bundle associated with the PPPoE client for which you want to clear lockout.
`mac-address`	(Optional) MAC address value associated with the PPPoE client for which you want to clear lockout. The `mac-address` option and the `aci` option are mutually exclusive.
`svlan-identifier`	(Optional) A valid S-VLAN identifier associated with the PPPoE client for which you want to clear lockout. Range: 1 through 4094
`vlan-identifier`	(Optional) A valid VLAN identifier associated with the PPPoE client for which you want to clear lockout. Range: 1 through 4094

Required Privilege Level

clear

Sample Output

clear pppoe lockout vlan-identifier device-name (Untagged VLAN on Aggregated Ethernet Bundle)
clear pppoe lockout vlan-identifier device-name vlan-id (Single-Tagged VLAN on Gigabit Ethernet Interface)
clear pppoe lockout vlan-identifier device-name svlan-id vlan-id aci (Dual-Tagged VLAN on 10-Gigabit Ethernet Interface Where ACI Matches Regular Expression)
clear pppoe lockout vlan-identifier device-name svlan-id vlan-id mac-address (Dual-Tagged VLAN on Aggregated Ethernet Bundle with Specified MAC Address)