]>
Commit | Line | Data |
---|---|---|
39cfece8 | 1 | = network-dns-server(8) |
063089cb | 2 | |
39cfece8 | 3 | == NAME |
063089cb MT |
4 | network-dns-server - Controls the DNS settings |
5 | ||
39cfece8 | 6 | == SYNOPSIS |
063089cb | 7 | [verse] |
39cfece8 MT |
8 | `network dns-server add` SERVER [PRIORITY] |
9 | `network dns-server remove` SERVER | |
10 | `network dns-server list` | |
11 | `network dns-server update` | |
063089cb | 12 | |
39cfece8 | 13 | == DESCRIPTION |
063089cb MT |
14 | With this command, you will be able to configure the local DNS |
15 | configuration. | |
16 | ||
17 | You may add and remove DNS servers as well as view the settings. | |
18 | ||
39cfece8 | 19 | == COMMANDS |
063089cb MT |
20 | The following commands are understood: |
21 | ||
39cfece8 | 22 | `add SERVER [PRIORITY]`:: |
063089cb MT |
23 | A new DNS server may be added to the list by the |
24 | 'add' command. | |
25 | A priority that will rank the server my optionally be given. | |
39cfece8 | 26 | + |
063089cb MT |
27 | NOTE: SERVER must be a valid IP address and PRIORITY |
28 | must be a positive number. | |
29 | The smaller this number, the higher is is the rank of | |
30 | the server. | |
31 | ||
39cfece8 | 32 | `remove SERVER`:: |
063089cb MT |
33 | The given server will be removed from the list of DNS servers. |
34 | ||
39cfece8 | 35 | `list`:: |
063089cb MT |
36 | Shows a list of all servers that are currently in use. |
37 | ||
39cfece8 | 38 | `update`:: |
063089cb MT |
39 | This command will re-create the system's configuration |
40 | files. It should not be required to use this command | |
41 | very often. | |
42 | ||
39cfece8 | 43 | == SETTINGS |
063089cb MT |
44 | The following settings may be set using link:network-settings[8]: |
45 | ||
39cfece8 | 46 | `DNS_USE_LOCAL_RESOLVER = [true|false]`:: |
063089cb MT |
47 | This option defines whether the local DNS resolver should |
48 | be used or not. | |
39cfece8 | 49 | + |
063089cb MT |
50 | Basically, the option adds localhost to the list of nameservers |
51 | in link:resolv.conf[5]. | |
52 | ||
39cfece8 | 53 | `DNS_SEARCH_DOMAINS =`:: |
063089cb MT |
54 | This setting configures the search domains for DNS queries |
55 | made by the local system. | |
56 | ||
39cfece8 | 57 | `DNS_RANDOMIZE = [true|false]`:: |
063089cb MT |
58 | This option will break the DNS server ranks and will query |
59 | them in a random order which is useful to load-balance | |
60 | multiple DNS servers. | |
61 | ||
39cfece8 | 62 | == AUTHORS |
063089cb MT |
63 | Michael Tremer |
64 | ||
39cfece8 | 65 | == SEE ALSO |
063089cb MT |
66 | link:network[8], |
67 | link:network-settings[8] |