summaryrefslogtreecommitdiff
path: root/docs/services
diff options
context:
space:
mode:
authorkroy <kroy@kroy.io>2020-03-31 12:50:26 -0500
committerkroy <kroy@kroy.io>2020-03-31 12:50:26 -0500
commit451cec098b695357e75b809cf1c471e6cc9f248f (patch)
treef398940399623acaeca3a0720e4fc368949e1c3b /docs/services
parent14cf1f452da7b1958415b1bc2beaad43316bb729 (diff)
downloadvyos-documentation-451cec098b695357e75b809cf1c471e6cc9f248f.tar.gz
vyos-documentation-451cec098b695357e75b809cf1c471e6cc9f248f.zip
router-advert: Porting over router-advert documentation
Diffstat (limited to 'docs/services')
-rw-r--r--docs/services/router-advert.rst77
1 files changed, 76 insertions, 1 deletions
diff --git a/docs/services/router-advert.rst b/docs/services/router-advert.rst
index 95bd429c..ca11548f 100644
--- a/docs/services/router-advert.rst
+++ b/docs/services/router-advert.rst
@@ -8,7 +8,82 @@ Router Advertisements
They are part of what is known as :abbr:`SLAAC (Stateless Address
Autoconfiguration)`.
-.. note:: placeholder section - fill me with content.
+
+Supported interface types:
+
+ * bonding
+ * bridge
+ * ethernet
+ * l2tpv3
+ * openvpn
+ * psuedo-ethernet
+ * tunnel
+ * vxlan
+ * wireguard
+ * wireless
+ * wirelessmodem
+
+
+Enabling Advertisments
+~~~~~~~~~~~~~~~~~~~~~~~
.. cfgcmd:: set service router-advert interface <interface> ....
+.. csv-table::
+ :header: "Field", "VyOS Option", "Description"
+ :widths: 10, 10, 20
+
+ "Cur Hop Limit", "hop-limit", "Hop count field of the outgoing RA packets"
+ """Managed address configuration"" flag", "managed-flag", "Tell hosts to use the administered stateful protocol (i.e. DHCP) for autoconfiguration"
+ """Other configuration"" flag", "other-config-flag", "Tell hosts to use the administered (stateful) protocol (i.e. DHCP) for autoconfiguration of other (non-address) information"
+ "MTU","link-mtu","Link MTU value placed in RAs, exluded in RAs if unset"
+ "Router Lifetime","default-lifetime","Lifetime associated with the default router in units of seconds"
+ "Reachable Time","reachable-time","Time, in milliseconds, that a node assumes a neighbor is reachable after having received a reachability confirmation"
+ "Retransmit Timer","retrans-timer","Time in milliseconds between retransmitted Neighbor Solicitation messages"
+ "Default Router Preference","default-preference","Preference associated with the default router"
+ "Interval", "interval", "Min and max intervals between unsolicited multicast RAs"
+ "DNSSL", "dnssl", "DNS search list to advertise"
+ "Name Server", "name-server", "Advertise DNS server per https://tools.ietf.org/html/rfc6106"
+
+Advertising a Prefix
+''''''''''''''''''''
+
+.. cfgcmd:: set service router-advert interface <interface> prefix 2001:DB8::/32
+
+.. csv-table::
+ :header: "VyOS Field", "Description"
+ :widths: 10,30
+
+ "no-autonomous-flag","Prefix can not be used for stateless address auto-configuration"
+ "no-on-link-flag","Prefix can not be used for on-link determination"
+ "preferred-lifetime","Time in seconds that the prefix will remain preferred (default 4 hours)"
+ "valid-lifetime","Time in seconds that the prefix will remain valid (default: 30 days)"
+
+
+Disabling Advertisements
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+To disable advertisements without deleting the configuration:
+
+.. cfgcmd:: set service router-advert interface <interface> no-send-advert
+
+Example Configuration
+~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: none
+
+ interface eth0.2 {
+ default-preference high
+ hop-limit 64
+ interval {
+ max 600
+ }
+ name-server 2001:4860:4860::8888
+ name-server 2001:4860:4860::8844
+ other-config-flag
+ prefix 2001:DB8:beef:2::/64 {
+ valid-lifetime 2592000
+ }
+ reachable-time 0
+ retrans-timer 0
+ } \ No newline at end of file