pppoe: T3273: Add usage of each default-route mode

This commit is contained in:
Sam Burney 2021-01-30 09:39:42 +00:00
parent 83c82dee8b
commit a531335929

View File

@ -113,7 +113,7 @@ PPPoE options
timeout period, after which an idle PPPoE link will be disconnected. A 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. 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 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 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 **default:** A default route to the remote endpoint is automatically added
when the link comes up (i.e. auto). 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> .. cfgcmd:: set interfaces pppoe <interface> idle-timeout <time>
Use this command to set the idle timeout interval to be used with on-demand 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 * 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 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, 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 * 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 nameservers your ISP sens you and thus you can fully rely on the ones you
have configured statically. have configured statically.