man: Convert network-dns-server(8) to asciidoc
[people/ms/network.git] / man / network-dns-server.txt
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]