man/network-dns.8.in

   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)