]>
Commit | Line | Data |
---|---|---|
6b34112f | 1 | .TH network-dns-server 8 "22 Jun 2012" "@VERSION@" "network man page" |
acc9efd5 MT |
2 | |
3 | .SH NAME | |
6b34112f | 4 | network-dns-server \- Network Configuration Control Program |
acc9efd5 MT |
5 | |
6 | .SH SYNOPSIS | |
6b34112f | 7 | \fBnetwork [OPTIONS] dns-server [add|remove] <server> [<priority>]\fR |
acc9efd5 | 8 | .P |
6b34112f | 9 | \fBnetwork [OPTIONS] dns-server list\fR |
acc9efd5 | 10 | .P |
6b34112f | 11 | \fBnetwork [OPTIONS] dns-server update\fR |
acc9efd5 MT |
12 | |
13 | .SH DESCRIPTION | |
6b34112f | 14 | With help of the \fBdns-server\fR subcommand, you will be able to configure the |
acc9efd5 MT |
15 | local DNS configuration. DNS is short for \fBDomain Name System\fR. |
16 | .PP | |
17 | You may add and remove DNS servers as well as view the settings. | |
18 | ||
19 | .SH OPTIONS | |
6b34112f | 20 | The \fBnetwork dns-server\fR command offers various commands: |
acc9efd5 MT |
21 | |
22 | \fBadd <server> [<priority>]\fR | |
23 | .RS 4 | |
24 | A new DNS server may be added to the list by the \fBadd\fR command. A priority that | |
25 | will rank the server may optionally be given. | |
26 | .PP | |
27 | \fB<server>\fR must be a valid IP address and \fB<priority>\fR must be an integer. | |
28 | The smaller the number, the higher is the rank of the server. | |
29 | .RE | |
30 | .PP | |
31 | ||
32 | \fBremove <server>\fR | |
33 | .RS 4 | |
34 | A server may be removed by this command where \fB<server>\fR must an IP address. | |
35 | .RE | |
36 | .PP | |
37 | ||
38 | \fBlist\fR | |
39 | .RS 4 | |
40 | Outputs a list of all servers that are currently in use. | |
41 | .RE | |
42 | .PP | |
43 | ||
44 | \fBupdate\fR | |
45 | .RS 4 | |
46 | This command will recreate the system's configuration file. It should not be | |
47 | required to use this command very often. | |
48 | .RE | |
49 | .PP | |
50 | ||
51 | .SH CONFIG OPTIONS | |
52 | These options may be set with the \fBnetwork-config\fR(8) command: | |
53 | ||
54 | \fBDNS_USE_LOCAL_RESOLVER\fR = [\fBtrue\fR|false] | |
55 | .RS 4 | |
56 | This option defines whether the local DNS resolver should be used or not. | |
57 | .PP | |
58 | Basically, the option adds localhost to the list of nameservers in | |
59 | \fBresolv.conf\fR(5). | |
60 | .RE | |
61 | .PP | |
62 | ||
63 | \fBDNS_RANDOMIZE\fR = [true|\fBfalse\fR] | |
64 | .RS 4 | |
65 | This option will break the DNS server ranks and will query them in a | |
66 | random order which is useful to load-balance multiple DNS servers. | |
67 | .RE | |
68 | .PP | |
69 | ||
70 | .SH SEE ALSO | |
71 | network(8), network-config(8) | |
72 | ||
73 | .SH AUTHOR | |
74 | Michael Tremer (michael.tremer@ipfire.org) |