[people/ms/network.git] / man / network-dns-server.txt

= network-dns-server(8)

== NAME
network-dns-server - Controls the DNS settings

== SYNOPSIS
[verse]
`network dns-server add` SERVER [PRIORITY]
`network dns-server remove` SERVER
`network dns-server list`
`network dns-server update`

== DESCRIPTION
With this command, you will be able to configure the local DNS
configuration.

You may add and remove DNS servers as well as view the settings.

== COMMANDS
The following commands are understood:

`add SERVER [PRIORITY]`::
	A new DNS server may be added to the list by the
	'add' command.
	A priority that will rank the server my optionally be given.
	+
	NOTE: SERVER must be a valid IP address and PRIORITY
	must be a positive number.
	The smaller this number, the higher is is the rank of
	the server.

`remove SERVER`::
	The given server will be removed from the list of DNS servers.

`list`::
	Shows a list of all servers that are currently in use.

`update`::
	This command will re-create the system's configuration
	files. It should not be required to use this command
	very often.

== SETTINGS
The following settings may be set using link:network-settings[8]:

`DNS_USE_LOCAL_RESOLVER = [true|false]`::
	This option defines whether the local DNS resolver should
	be used or not.
	+
	Basically, the option adds localhost to the list of nameservers
	in link:resolv.conf[5].

`DNS_SEARCH_DOMAINS =`::
	This setting configures the search domains for DNS queries
	made by the local system.

`DNS_RANDOMIZE = [true|false]`::
	This option will break the DNS server ranks and will query
	them in a random order which is useful to load-balance
	multiple DNS servers.

== AUTHORS
Michael Tremer

== SEE ALSO
link:network[8],
link:network-settings[8]
Commit	Line	Data
	1	= network-dns-server(8)
	2
	3	== NAME
	4	network-dns-server - Controls the DNS settings
	5
	6	== SYNOPSIS
	7	[verse]
	8	`network dns-server add` SERVER [PRIORITY]
	9	`network dns-server remove` SERVER
	10	`network dns-server list`
	11	`network dns-server update`
	12
	13	== DESCRIPTION
	14	With this command, you will be able to configure the local DNS
	15	configuration.
	16
	17	You may add and remove DNS servers as well as view the settings.
	18
	19	== COMMANDS
	20	The following commands are understood:
	21
	22	`add SERVER [PRIORITY]`::
	23	A new DNS server may be added to the list by the
	24	'add' command.
	25	A priority that will rank the server my optionally be given.
	26	+
	27	NOTE: SERVER must be a valid IP address and PRIORITY
	28	must be a positive number.
	29	The smaller this number, the higher is is the rank of
	30	the server.
	31
	32	`remove SERVER`::
	33	The given server will be removed from the list of DNS servers.
	34
	35	`list`::
	36	Shows a list of all servers that are currently in use.
	37
	38	`update`::
	39	This command will re-create the system's configuration
	40	files. It should not be required to use this command
	41	very often.
	42
	43	== SETTINGS
	44	The following settings may be set using link:network-settings[8]:
	45
	46	`DNS_USE_LOCAL_RESOLVER = [true\|false]`::
	47	This option defines whether the local DNS resolver should
	48	be used or not.
	49	+
	50	Basically, the option adds localhost to the list of nameservers
	51	in link:resolv.conf[5].
	52
	53	`DNS_SEARCH_DOMAINS =`::
	54	This setting configures the search domains for DNS queries
	55	made by the local system.
	56
	57	`DNS_RANDOMIZE = [true\|false]`::
	58	This option will break the DNS server ranks and will query
	59	them in a random order which is useful to load-balance
	60	multiple DNS servers.
	61
	62	== AUTHORS
	63	Michael Tremer
	64
	65	== SEE ALSO
	66	link:network[8],
	67	link:network-settings[8]