diff options
| author | Christian Poessinger <christian@poessinger.com> | 2021-01-31 15:52:40 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-01-31 15:52:40 +0100 |
| commit | f701d667e60c19dab328a8fce9b722ab46c0d73a (patch) | |
| tree | d8d98ccae9e9181cdc6786e4c21ab4a053272e81 /docs/configuration | |
| parent | c5272b18784c4476b693baf3bec2cc5a02d6cc85 (diff) | |
| parent | 4842a37b7a647eed76904c3fdd4ed706c47f014e (diff) | |
| download | vyos-documentation-f701d667e60c19dab328a8fce9b722ab46c0d73a.tar.gz vyos-documentation-f701d667e60c19dab328a8fce9b722ab46c0d73a.zip | |
Merge pull request #438 from samburney/master
pppoe: T3273: Add usage of each default-route mode
Diffstat (limited to 'docs/configuration')
| -rw-r--r-- | docs/configuration/interfaces/pppoe.rst | 15 |
1 files changed, 13 insertions, 2 deletions
diff --git a/docs/configuration/interfaces/pppoe.rst b/docs/configuration/interfaces/pppoe.rst index 9d10b91f..0fdbba42 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. |