diff options
| author | Christian Poessinger <christian@poessinger.com> | 2020-11-06 19:56:15 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-11-06 19:56:15 +0100 |
| commit | d4e2fbe8afd07f55496f21b88c026a30f689c0c8 (patch) | |
| tree | 9b5dc01f2718dba1411ee81f79a82e7eda06af43 | |
| parent | 77c7750bc9d223d9e6f30263f795fa6eea54827e (diff) | |
| parent | 6bb5345460384a0a9f0f034dbc65cc88caaa7144 (diff) | |
| download | vyos-documentation-d4e2fbe8afd07f55496f21b88c026a30f689c0c8.tar.gz vyos-documentation-d4e2fbe8afd07f55496f21b88c026a30f689c0c8.zip | |
Merge pull request #370 from currite/crux-system-dns
system: add system dns
| -rw-r--r-- | docs/system/index.rst | 1 | ||||
| -rw-r--r-- | docs/system/system-dns.rst | 68 |
2 files changed, 69 insertions, 0 deletions
diff --git a/docs/system/index.rst b/docs/system/index.rst index c273eaec..a0d470aa 100644 --- a/docs/system/index.rst +++ b/docs/system/index.rst @@ -19,6 +19,7 @@ should be ready for further configuration which is described in this chapter. proxy serialconsole syslog + system-dns task-scheduler time-zone boot-options diff --git a/docs/system/system-dns.rst b/docs/system/system-dns.rst new file mode 100644 index 00000000..70848f6d --- /dev/null +++ b/docs/system/system-dns.rst @@ -0,0 +1,68 @@ +.. _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 |