From b772c4f678ace50280195d9691974dc41cb7ae58 Mon Sep 17 00:00:00 2001
From: currite <sll@disroot.org>
Date: Thu, 5 Nov 2020 21:52:44 +0100
Subject: system: add system dns page

---
 docs/system/basic-index.rst |  1 +
 docs/system/system-dns.rst  | 69 +++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 70 insertions(+)
 create mode 100644 docs/system/system-dns.rst

(limited to 'docs')

diff --git a/docs/system/basic-index.rst b/docs/system/basic-index.rst
index cb030089..b7bbf1c5 100644
--- a/docs/system/basic-index.rst
+++ b/docs/system/basic-index.rst
@@ -11,3 +11,4 @@ Basic System Tweaks
    host-information
    default-route
    time-zone
+   system-dns
diff --git a/docs/system/system-dns.rst b/docs/system/system-dns.rst
new file mode 100644
index 00000000..59cfdb5d
--- /dev/null
+++ b/docs/system/system-dns.rst
@@ -0,0 +1,69 @@
+.. _system-dns:
+
+##########
+System DNS
+##########
+
+
+This section describes configuring DNS on the system, namely:
+
+ * DNS name servers
+ * Domain search order
+
+
+DNS name servers
+================
+
+.. cfgcmd:: set system name-server <address>
+
+   Use this command to specify a DNS server for the system to be used
+   for DNS lookups. More than one DNS server can be added, configuring
+   one at a time. Both IPv4 and IPv6 addresses are supported.
+
+
+
+Example
+-------
+
+In this example, some *OpenNIC* servers are used, two IPv4 addresses
+and two IPv6 addresses:
+
+
+.. code-block:: none
+
+   set system name-server 176.9.37.132
+   set system name-server 195.10.195.195
+   set system name-server 2a01:4f8:161:3441::1
+   set system name-server 2a00:f826:8:2::195
+
+
+Domain search order
+===================
+
+In order for the system to use and complete unqualified host names, a
+list can be defined which will be used for domain searches.
+
+
+.. cfgcmd:: set system domain-search domain <domain>
+
+   Use this command to define domains, one at a time, so that the system
+   uses them to complete unqualified host names. Maximum: 6 entries.
+
+
+.. note:: Domain names can include letters, numbers, hyphens and periods
+   with a maximum length of 253 characters.
+
+
+Example
+-------
+
+The system is configured to attempt domain completion in the following
+order: vyos.io (first), vyos.net (second) and vyos.network (last):
+
+
+.. code-block:: none
+
+   set system domain-search domain vyos.io
+   set system domain-search domain vyos.net
+   set system domain-search domain vyos.network
+
-- 
cgit v1.2.3