summaryrefslogtreecommitdiff
path: root/docs/configuration/interfaces/pppoe.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/configuration/interfaces/pppoe.rst')
-rw-r--r--docs/configuration/interfaces/pppoe.rst15
1 files changed, 13 insertions, 2 deletions
diff --git a/docs/configuration/interfaces/pppoe.rst b/docs/configuration/interfaces/pppoe.rst
index 9d10b91f..e6b1f3ef 100644
--- a/docs/configuration/interfaces/pppoe.rst
+++ b/docs/configuration/interfaces/pppoe.rst
@@ -113,7 +113,7 @@ PPPoE options
timeout period, after which an idle PPPoE link will be disconnected. A
non-zero idle timeout will never disconnect the link after it first came up.
-.. cfgcmd:: set interfaces pppoe <interface> default-route
+.. cfgcmd:: set interfaces pppoe <interface> default-route [auto | force | none]
Use this command to specify whether to automatically add a default route
pointing to the endpoint of the PPPoE when the link comes up. The default
@@ -122,6 +122,16 @@ PPPoE options
**default:** A default route to the remote endpoint is automatically added
when the link comes up (i.e. auto).
+ * auto: A default route is added if no other default route (From any
+ source) already exists.
+ * force: A default route is added after removing *all* existing default
+ routes.
+ * none: No default route is installed.
+
+.. note:: In all modes except 'none', all default routes using this interface will be
+ removed when the interface is torn down - even manually installed static
+ interface-routes.
+
.. cfgcmd:: set interfaces pppoe <interface> idle-timeout <time>
Use this command to set the idle timeout interval to be used with on-demand
@@ -240,7 +250,8 @@ Requirements:
* With the ``default-route`` option set to ``auto``, VyOS will only add the
default gateway you receive from your DSL ISP to the routing table if you
have no other WAN connections. If you wish to use a dual WAN connection,
- change the ``default-route`` option to ``force``.
+ change the ``default-route`` option to ``force``. You could also install
+ a static interface-route and set the ``default-route`` option to ``none``.
* With the ``name-server`` option set to ``none``, VyOS will ignore the
nameservers your ISP sens you and thus you can fully rely on the ones you
have configured statically.