Difference between revisions of "Openresolv"

From ArchWiki
Jump to: navigation, search
m (Defining multiple name-servers: add "E.g.")
(add systemd-resolvconf to related articles)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{Lowercase title}}
 
{{Lowercase title}}
 
[[Category:Domain Name System]]
 
[[Category:Domain Name System]]
 +
{{Related articles start}}
 +
{{Related|systemd-resolvconf}}
 +
{{Related articles end}}
 
[[ja:Openresolv]]
 
[[ja:Openresolv]]
 
[[pt:Openresolv]]
 
[[pt:Openresolv]]
Line 14: Line 17:
  
 
Running {{ic|resolvconf -u}} will generate {{ic|/etc/resolv.conf}}.
 
Running {{ic|resolvconf -u}} will generate {{ic|/etc/resolv.conf}}.
 
Openresolv can additionally be configured to pass DNS server addresses to [[unbound]], [[dnsmasq]], [[BIND]] and [[pdnsd]] resolvers. See the [https://roy.marples.name/projects/openresolv/config official documentation] for instructions.
 
  
 
{{Expansion|Provide common usage examples.}}
 
{{Expansion|Provide common usage examples.}}
Line 21: Line 22:
 
== Users ==
 
== Users ==
  
Stand-alone DHCP clients:
+
Stand-alone [[DHCP]] clients:
  
 
* [[dhcpcd]] has a hook which uses ''resolvconf'' if it is installed.
 
* [[dhcpcd]] has a hook which uses ''resolvconf'' if it is installed.
Line 35: Line 36:
 
* [[strongSwan]]
 
* [[strongSwan]]
 
* [[WireGuard]]
 
* [[WireGuard]]
 +
 +
== Subscribers ==
 +
 +
Openresolv can be configured to pass name servers and search domains to DNS resolvers. The supported resolvers are:
 +
 +
* [[unbound]]
 +
* [[dnsmasq#openresolv]]
 +
* [[BIND]]
 +
* [[pdnsd]]
 +
 +
See the [https://roy.marples.name/projects/openresolv/config official documentation] for instructions.
  
 
== Tips and tricks ==
 
== Tips and tricks ==
  
=== Defining multiple name-servers ===
+
=== Defining multiple values for options ===
 
 
{{Expansion|This is not limited to {{ic|name_servers}}, it applies to almost all options.}}
 
  
The man page does not mention it, but to define multiple name-servers in {{ic|/etc/resolvconf.conf}} you need to write them space separated inside quotes. E.g.:
+
The man page does not mention it, but to define multiple values, for options that support it (e.g. {{ic|name-servers}}, {{ic|resolv_conf_options}} etc.) in {{ic|/etc/resolvconf.conf}}, you need to write them space separated inside quotes. E.g.:
  
 
{{hc|/etc/resolvconf.conf|2=
 
{{hc|/etc/resolvconf.conf|2=
 +
resolv_conf_options="edns0 single-request"
 
name_servers="dns1.example.com dns2.example.com dns3.example.com"
 
name_servers="dns1.example.com dns2.example.com dns3.example.com"
 
}}
 
}}

Latest revision as of 04:39, 14 August 2018

Openresolv is a resolvconf implementation, i.e. a resolv.conf management framework.

Installation

Install the openresolv package.

Usage

Openresolv provides resolvconf(8) and is configured in /etc/resolvconf.conf. See resolvconf.conf(5) for supported options.

Running resolvconf -u will generate /etc/resolv.conf.

Tango-view-fullscreen.pngThis article or section needs expansion.Tango-view-fullscreen.png

Reason: Provide common usage examples. (Discuss in Talk:Openresolv#)

Users

Stand-alone DHCP clients:

  • dhcpcd has a hook which uses resolvconf if it is installed.

Network managers:

VPN clients:

Subscribers

Openresolv can be configured to pass name servers and search domains to DNS resolvers. The supported resolvers are:

See the official documentation for instructions.

Tips and tricks

Defining multiple values for options

The man page does not mention it, but to define multiple values, for options that support it (e.g. name-servers, resolv_conf_options etc.) in /etc/resolvconf.conf, you need to write them space separated inside quotes. E.g.:

/etc/resolvconf.conf
resolv_conf_options="edns0 single-request"
name_servers="dns1.example.com dns2.example.com dns3.example.com"