vyos/vyos-documentation
1
0
Fork 0
mirror of https://github.com/vyos/vyos-documentation.git synced 2025-10-26 08:41:46 +01:00
Code Issues Packages Projects Releases Wiki Activity

pppoe: use documented section style guide

Browse Source
This commit is contained in:
Christian Poessinger 2019-12-21 19:26:41 +01:00
parent 554e5357b7
commit d778d022b3
1 changed files with 8 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/interfaces/pppoe.rst
View File

@ -1,7 +1,8 @@
.. _pppoe-interface: .. _pppoe-interface:
#####
PPPoE PPPoE
===== #####
:abbr:`PPPoE (Point-to-Point Protocol over Ethernet)` is a network protocol :abbr:`PPPoE (Point-to-Point Protocol over Ethernet)` is a network protocol
for encapsulating PPP frames inside Ethernet frames. It appeared in 1999, for encapsulating PPP frames inside Ethernet frames. It appeared in 1999,
@ -14,14 +15,14 @@ PPP facilities for authenticating the user with a username and password,
predominately via the PAP protocol and less often via CHAP. predominately via the PAP protocol and less often via CHAP.
Operating Modes Operating Modes
--------------- ===============
VyOS supports setting up PPPoE in two different ways to a PPPoE internet VyOS supports setting up PPPoE in two different ways to a PPPoE internet
connection. This is due to most ISPs provide a modem that is also a wireless connection. This is due to most ISPs provide a modem that is also a wireless
router. router.
Home Users Home Users
********** ----------
In this method, the DSL Modem/Router connects to the ISP for you with your In this method, the DSL Modem/Router connects to the ISP for you with your
credentials preprogrammed into the device. This gives you an :rfc:`1918` credentials preprogrammed into the device. This gives you an :rfc:`1918`
@ -34,7 +35,7 @@ few extra layers of complexity, particularly if you use some NAT or
tunnel features. tunnel features.
Business Users Business Users
************** --------------
In order to have full control and make use of multiple static public IP In order to have full control and make use of multiple static public IP
addresses, your VyOS will have to initiate the PPPoE connection and control addresses, your VyOS will have to initiate the PPPoE connection and control
@ -51,7 +52,7 @@ configure it to open the PPPoE session for you and your DSL Transceiver
vDSL/aDSL understands. vDSL/aDSL understands.
Configuration Example Configuration Example
~~~~~~~~~~~~~~~~~~~~~ ^^^^^^^^^^^^^^^^^^^^^
Requirements: Requirements:
@ -95,7 +96,7 @@ assigning it to the pppoe0 itself as shown here:
set interfaces ethernet eth0 pppoe 0 firewall out name NET-OUT set interfaces ethernet eth0 pppoe 0 firewall out name NET-OUT
VLAN Example VLAN Example
++++++++++++ """"""""""""
Some recent ISPs require you to build the PPPoE connection through a VLAN Some recent ISPs require you to build the PPPoE connection through a VLAN
interface. One of those ISPs is e.g. Deutsche Telekom in Germany. VyOS interface. One of those ISPs is e.g. Deutsche Telekom in Germany. VyOS
@ -116,7 +117,7 @@ which is the default VLAN for Deutsche Telekom:
set interfaces ethernet eth0 vif 7 pppoe 0 password 'secret' set interfaces ethernet eth0 vif 7 pppoe 0 password 'secret'
Troubleshooting Troubleshooting
--------------- ^^^^^^^^^^^^^^^
.. opcmd:: disconnect interface <interface> .. opcmd:: disconnect interface <interface>