From 9463ee80e45bc2b75969826e1c616ca6a619b49b Mon Sep 17 00:00:00 2001 From: =?utf8?q?Pali=20Roh=C3=A1r?= Date: Sun, 5 Jul 2020 15:41:09 +0200 Subject: [PATCH 1/1] Document PPPoE options in pppd.8 manpage MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit Signed-off-by: Pali Rohár --- pppd/pppd.8 | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) 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 -- 2.39.2