pppoe-client

Function

The pppoe-client command establishes a PPPoE session and specifies the dialer bundle corresponding to the session.

The undo pppoe-client command deletes a PPPoE session.

Format

pppoe-client dial-bundle-number number [ no-hostuniq ] [ idle-timeout seconds [ queue-length packets ] ] [ ipv4 | ipv6 ]

undo pppoe-client dial-bundle-number number

Parameters

Parameter	Description	Value
number	Specifies the dialer bundle number corresponding to PPPoE session. The number argument can be used to uniquely specify a PPPoE session, or as a PPPoE number.	The value ranges from 1 to 255.
no-hostuniq	Indicates that the call originated from PPPoE client does not carry the Host-Uniq field. By default, no-hostuniq is not configured.	-
idle-timeout seconds	Specifies the Idle time of a PPPoE session. If the parameter is not configured, PPPoE session will work in permanent online mode. Otherwise, it works in packet trigger mode.	Its value ranges from 1 to 65535, in seconds.
queue-length packets	Specifies the packet number cached in the system before a PPPoE session is established.	The value ranges from 1 to 100. Only after idle-timeout is configured after the parameter be enabled. The default value is 10.
ipv4	Specifies the IPv4 PPPoE session.	-
ipv6	Specifies the IPv6 PPPoE session.	-

Views

Ethernet interface view

Default Level

2: Configuration level

Usage Guidelines

By default, no PPPoE session is configured.

Only one PPPoE session can be configured on an Ethernet interface. Each PPPoE session corresponds to a unique dialer bundle, and each dialer bundle corresponds to a unique dialer interface. That is, an Ethernet interface can be associated with only one dialer interface. If a dialer bundle at a certain dialer interface has had one Ethernet interface been used by PPPoE, other interfaces cannot be added to this dialer bundle. Likewise, if a dialer bundle has had interfaces other than the PPPoE Ethernet interface, this dialer bundle also cannot be added to the Ethernet interface used by PPPoE Client.

When PPPoE session works in permanent online mode, and the physical lines go UP, the device will immediately initiate PPPoE call to establish PPPoE session. This PPPoE connection will exist constantly unless users use the command undo pppoe-client to delete PPPoE session. When PPPoE session works in packet trigger mode, the device will not initiate PPPoE call to establish PPPoE session unless it has data to transmit. If there is no data transmission on the PPPoE link within seconds, the device will automatically terminate PPPoE session. Only after it has new data to transmit, PPPoE session will be re-established.

All models except USG6635E/6655E, USG6680E and USG6712E/6716E support this command.

Example

# Create a IPv4 PPPoE session on GigabitEthernet 0/0/1.

<sysname> system-view
[sysname] interface GigabitEthernet 0/0/1
[sysname-GigabitEthernet0/0/1] pppoe-client dial-bundle-number 1 ipv4