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