projects / network.git / blame
| Commit | Line | Data |
|---|---|---|
| acc9efd5 MT |
1 | .TH network-dns 8 "22 Jun 2012" "@VERSION@" "network man page" |
| 2 | ||
| 3 | .SH NAME | |
| 4 | network-dns \- Network Configuration Control Program | |
| 5 | ||
| 6 | .SH SYNOPSIS | |
| 7 | \fBnetwork [OPTIONS] dns [add|remove] <server> [<priority>]\fR | |
| 8 | .P | |
| 9 | \fBnetwork [OPTIONS] dns list\fR | |
| 10 | .P | |
| 11 | \fBnetwork [OPTIONS] dns update\fR | |
| 12 | ||
| 13 | .SH DESCRIPTION | |
| 14 | With help of the \fBdns\fR subcommand, you will be able to configure the | |
| 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 | |
| 20 | The \fBnetwork dns\fR command offers various commands: | |
| 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) |