PPPoE (PPP over Ethernet)

Last Updated : Jul 02, 2019 |
Table 1: PPPoE CLI commands

Root level command

First level command

Description

interface fastethernet

Enter the context of the FastEthernet interface

encapsulation pppoe

Change the encapsulation to PPPoE

ip address negotiated

Obtain an IP address via PPP/IPCP negotiation

keepalive (PPPoE)

Enable PPPoE keepalive in order to maintain a persistent connection

keepalive-track

Bind interface status to an object tracker to check whether the interface is up

mtu

Set the interface’s MTU to 1492 which ensures that overall packet size for the PPPoE interface does not exceed 1500, which is the MTU for Ethernet

ppp chap hostname

Override the device hostname for PPP CHAP authentication

ppp chap password

Set the CHAP password for authentication with a remote peer

ppp chap refuse

Prevent the device from authenticating with CHAP after the device is requested by the remote peer

ppp ipcp dns request

Request the list of available DNS servers from the remote peer during the PPP/IPCP session

ppp pap refuse

Prevent the device from authenticating with PAP after the device is requested by the remote peer

ppp pap sent-username

Set the Password Authentication Protocol (PAP) password for authentication with the remote peer

ppp timeout ncp

Set the maximum time, in seconds, that PPP allows for negotiation of a network layer protocol

ppp timeout retry

Set the maximum time to wait for a response during PPP negotiation

pppoe-client persistent delay

Set the interval between PPPoE client dial attempts

pppoe-client persistent max-attempts

Limit the number of consecutive connection establishment retries

pppoe-client service-name

Set the PPPoE client service-name

pppoe-client wait-for-ipcp

Set the amount of time (in seconds) between establishment of the PPPoE tunnel and establishment of the IPCP tunnel. If this time is exceeded, the PPPoE client terminates the PPPoE tunnel.

shutdown (interface)

Shut down the port, and the PPPoE client, if configured

show interfaces

Display interface configuration and statistics for a particular interface or all interfaces