]> git.ipfire.org Git - people/ms/network.git/blob - man/network-dns-server.txt
Makefile: Fix typo in localstatedir
[people/ms/network.git] / man / network-dns-server.txt
1 = network-dns-server(8)
2
3 == NAME
4 network-dns-server - Controls the DNS settings
5
6 == SYNOPSIS
7 [verse]
8 `network dns-server add` SERVER [PRIORITY]
9 `network dns-server remove` SERVER
10 `network dns-server list`
11 `network dns-server update`
12
13 == DESCRIPTION
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
19 == COMMANDS
20 The following commands are understood:
21
22 `add SERVER [PRIORITY]`::
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.
26 +
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
32 `remove SERVER`::
33 The given server will be removed from the list of DNS servers.
34
35 `list`::
36 Shows a list of all servers that are currently in use.
37
38 `update`::
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
43 == SETTINGS
44 The following settings may be set using link:network-settings[8]:
45
46 `DNS_USE_LOCAL_RESOLVER = [true|false]`::
47 This option defines whether the local DNS resolver should
48 be used or not.
49 +
50 Basically, the option adds localhost to the list of nameservers
51 in link:resolv.conf[5].
52
53 `DNS_SEARCH_DOMAINS =`::
54 This setting configures the search domains for DNS queries
55 made by the local system.
56
57 `DNS_RANDOMIZE = [true|false]`::
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
62 == AUTHORS
63 Michael Tremer
64
65 == SEE ALSO
66 link:network[8],
67 link:network-settings[8]