From: Pali Rohár Date: Sun, 5 Jul 2020 13:41:09 +0000 (+0200) Subject: Document PPPoE options in pppd.8 manpage X-Git-Tag: ppp-2.4.9~44^2 X-Git-Url: https://git.ozlabs.org/?p=ppp.git;a=commitdiff_plain;h=9463ee80e45bc2b75969826e1c616ca6a619b49b;ds=inline Document PPPoE options in pppd.8 manpage Signed-off-by: Pali Rohár --- diff --git a/pppd/pppd.8 b/pppd/pppd.8 index 540d62a..f8c6fb9 100644 --- a/pppd/pppd.8 +++ b/pppd/pppd.8 @@ -1157,6 +1157,43 @@ overridden by a non-privileged user. .B xonxoff Use software flow control (i.e. XON/XOFF) to control the flow of data on the serial port. +.SH PPPOE OPTIONS +To establish PPP link over Ethernet (PPPoE) it is needed to load pppd's +\fBplugin rp-pppoe.so\fR and then specify option \fBnic-\fIinterface\fR +instead of modem options \fIttyname\fR and \fIspeed\fR. +Recognized pppd's PPPoE options are: +.TP +.B nic-\fIinterface +Use the ethernet device \fIinterface\fR to communicate with the peer. +For example, establishing PPPoE link on \fIeth0\fR interface is done +by specifying ppp'd option \fBnic-eth0\fR. Prefix \fBnic-\fR for this +option may be avoided if interface name is unambiguous and does not +look like any other pppd's option. +.TP +.B rp_pppoe_service \fIname +Connect to specified PPPoE service name. +.TP +.B rp_pppoe_ac \fIname +Connect to specified PPPoE access concentrator name. +.TP +.B rp_pppoe_sess \fIsessid\fP:\fImacaddr +Attach to existing PPPoE session. +.TP +.B rp_pppoe_verbose \fIn +Be verbose about discovered access concentrators. +.TP +.B pppoe-mac \fImacaddr +Connect to specified MAC address. +.TP +.B host-uniq \fIstring +Set the PPPoE Host-Uniq tag to the supplied hex string. +By default PPPoE Host-Uniq tag is set to the pppd's process PID. +.TP +.B pppoe-padi-timeout \fIn +Initial timeout for discovery packets in seconds (default 5). +.TP +.B pppoe-padi-attempts \fIn +Number of discovery attempts (default 3). .SH OPTIONS FILES Options can be taken from files as well as the command line. Pppd reads options from the files /etc/ppp/options, ~/.ppprc and