Difference between revisions of "Openresolv"

From ArchWiki
Jump to: navigation, search
m (Users: plural)
(Undo revision 547379 by Regid (talk): Was looking at man 1 resolvconf)
(Tag: Undo)
 
(18 intermediate revisions by 4 users 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]]
[https://roy.marples.name/projects/openresolv Openresolv] is a [[resolv.conf]] management framework.
+
[https://roy.marples.name/projects/openresolv Openresolv] is a [[Wikipedia:resolvconf|resolvconf]] implementation, i.e. a [[resolv.conf]] management framework.
  
 
== Installation ==
 
== Installation ==
Line 14: Line 17:
  
 
Running {{ic|resolvconf -u}} will generate {{ic|/etc/resolv.conf}}.
 
Running {{ic|resolvconf -u}} will generate {{ic|/etc/resolv.conf}}.
 +
 +
{{Expansion|Provide common usage examples.}}
  
 
== 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.
  
 
[[Network manager]]s:
 
[[Network manager]]s:
Line 29: Line 34:
  
 
* [[OpenVPN#DNS]]
 
* [[OpenVPN#DNS]]
 +
* [[strongSwan]]
 +
* [[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 ==
 +
 +
=== Defining multiple values for options ===
 +
 +
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=
 +
resolv_conf_options="edns0 single-request"
 +
name_servers="192.168.35.1 fd7b:d0bd:7a6e::1"
 +
}}

Latest revision as of 20:40, 12 October 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="192.168.35.1 fd7b:d0bd:7a6e::1"