2 <!DOCTYPE refentry PUBLIC
"-//OASIS/DTD DocBook XML V4.2//EN"
3 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
5 <refentry id=
"network-dns-server">
7 <title>network-dns-server
</title>
8 <productname>network
</productname>
12 <contrib>Developer
</contrib>
13 <firstname>Michael
</firstname>
14 <surname>Tremer
</surname>
15 <email>michael.tremer@ipfire.org
</email>
21 <refentrytitle>network-dns-server
</refentrytitle>
22 <manvolnum>8</manvolnum>
26 <refname>network-dns-server
</refname>
27 <refpurpose>Network Configuration Control Program
</refpurpose>
32 <command>network dns-server
<arg choice=
"plain">[add|remove]
</arg> <arg choice=
"plain">SERVER
</arg> [
<arg choice=
"plain">PRIORITY
</arg>]
</command>
36 <command>network dns-server
<arg choice=
"plain">[list|update]
</arg></command>
41 <title>Description
</title>
44 With help of the
<command>dns-server
</command> subcommand, you will
45 be able to configure the local DNS configuration.
46 DNS is short for Domain Name System.
49 You may add and remove DNS servers as well as view the settings.
54 <title>Commands
</title>
57 The following commands are understood:
65 <replaceable>SERVER
</replaceable>
66 [
<replaceable>PRIORITY
</replaceable>]
72 A new DNS server may be added to the list by the
73 <command>add
</command> command. A priority that will
74 rank the server my optionally be given.
77 <replaceable>SERVER
</replaceable> must be a valid IP address
78 and
<replaceable>PRIORITY
</replaceable> must be a positive
79 integer number. The smaller this number, the higher is
80 is the rank of the server.
89 <replaceable>SERVER
</replaceable>
95 The given server will be removed from the list of
103 <command>list
</command>
108 Shows a list of all servers that are currently in use.
115 <command>update
</command>
120 This command will re-create the system's configuration
121 files. It should not be required to use this command
130 <title>Variables
</title>
133 These variables may be set by using the
<citerefentry>
134 <refentrytitle>network-settings
</refentrytitle>
135 <manvolnum>8</manvolnum>
136 </citerefentry> command.
142 <varname>DNS_USE_LOCAL_RESOLVER
</varname>=[
<emphasis>true
</emphasis>|false]
147 This option defines whether the local DNS resolver should
151 Basically, the option adds localhost to the list of
152 nameservers in
<citerefentry>
153 <refentrytitle>resolv.conf
</refentrytitle>
154 <manvolnum>5</manvolnum>
162 <varname>DNS_RANDOMIZE
</varname>=[true|
<emphasis>false
</emphasis>]
167 This option will break the DNS server ranks and will query
168 them in a random order which is useful to load-balance
169 multiple DNS servers.
177 <title>See Also
</title>
181 <refentrytitle>network
</refentrytitle>
182 <manvolnum>8</manvolnum>
185 <refentrytitle>network-settings
</refentrytitle>
186 <manvolnum>8</manvolnum>