show pppoe lockout
Syntax
show pppoe lockout <underlying-interface-name>
Description
Display summary information about PPPoE clients currently undergoing lockout or currently in a lockout grace period on all PPPoE underlying logical interfaces or on a specified PPPoE underlying logical interface. You can configure PPPoE subscriber session lockout, also known as short-cycle protection, for VLAN, VLAN demux, and PPPoE-over-ATM dynamic subscriber interfaces.
Options
none | Display information about the lockout condition and the lockout grace period for PPPoE clients on all PPPoE underlying logical interfaces. |
underlying-interface-name | (Optional) Name of the PPPoE underlying logical interface. If you do not specify an underlying interface, the router iteratively displays output for all existing clients undergoing lockout per PPPoE underlying logical interface. |
Required Privilege Level
view
Output Fields
Table 1 lists the output fields for the show pppoe lockout
command. Output fields are listed in the approximate order in which they appear.
Field Name |
Field Description |
---|---|
|
Name of the PPPoE underlying logical interface. |
|
Index number of the logical interface, which reflects its initialization sequence. |
|
Name of the physical interface or aggregated Ethernet bundle. |
|
Stacked VLAN ID, also known as the outer tag. |
|
VLAN ID, also know as the inner tag. |
|
Virtual path identifier value for the PPPoE client. |
|
Virtual circuit identifier value for the PPPoE client. |
|
State of PPPoE short-cycle protection, also known as PPPoE subscriber session lockout, on the underlying interface:
Enabling short-cycle protection temporarily prevents (locks out) a failed or short-lived (short-cycle) PPPoE subscriber session from reconnecting to the router for a default or configurable period of time. |
|
Displays the PPPoE lockout time range, the number of PPPoE clients in lockout condition, and the number of PPPoE clients in a lockout grace period:
|
|
MAC source address or agent circuit idenfiier (ACI) value of the PPPoE client. |
|
Current lockout time, in seconds; displays |
|
Time elapsed into the lockout period, in seconds; displays |
|
Lockout time, in seconds, that the router uses for the next lockout event; displays a nonzero value if the PPPoE client is currently in a lockout grace period. |
Sample Output
- show pppoe lockout (ACI-Based Short-Cycle Protection)
- show pppoe lockout (MAC Address-Based Short-Cycle Protection)
- show pppoe lockout (Short-Cycle Protection Not Configured)
show pppoe lockout (ACI-Based Short-Cycle Protection)
user@host> show pppoe lockout at-1.0.0.30 at-1/0/0.30 Index 10305 Device: at-1/0/0, VPI: 1, VCI: 30 Short Cycle Protection: circuit-id, Lockout Time (seconds): Min: 1, Max: 300 Total clients in lockout: 1 Total clients in lockout grace period: 1 Client Address Current Elapsed Next Relay-identifier atm 3/0:100.33 64 22 128 00:00:5e:00:53:ab 00:00:5e:00:53:21
show pppoe lockout (MAC Address-Based Short-Cycle Protection)
user@host> show pppoe lockout demux0.100 demux0.100 Index 10305 Device: xe-1/0/0, SVLAN: 100, VLAN: 100, Short-Cycle Protection: mac-address, Lockout Time (seconds): Min: 1, Max: 300 Total clients in lockout: 3 Total clients in lockout grace period: 1 Client Address Current Elapsed Next 00:00:5e:00:53:15 16 10 32 00:00:5e:00:53:ab 256 168 300 00:00:5e:00:53:23 0 0 8
show pppoe lockout (Short-Cycle Protection Not Configured)
user@host> show pppoe lockout xe-1/0/0.1 xe-1/0/0.0 Index 10305 Device: xe-1/0/0, Short-Cycle Protection: Off,