RESOLVCONF.CONF(5) File Formats Manual RESOLVCONF.CONF(5) resolvconf.conf - resolvconf (DESCRIPTION) resolvconf(8) . resolvconf(8) (source) . . (wildcards) (escaped). replace . resolvconf -u . (append) (prepend) . RESOLVCONF (RESOLVCONF OPTIONS) resolvconf resolvconf NO . YES . allow_keys . deny_keys . exclude / . / . : $keyword/$match[/$keyword/$match] : exclude="search/foo*/nameserver/1.2.3.4 search/bar.org" resolv.conf search foo nameserver 1.2.3.4 search bar.org . key_order . : lo lo[0-9]* dynamic_order (metric) . : tap[0-9]* tun[0-9]* vpn vpn[0-9]* wg[0-9]* ppp[0-9]* ippp[0-9]* inclusive_keys (exclusive) . resolvconf -x . local_nameservers : 127.* 0.0.0.0 255.255.255.255 ::1 search_domains (prepend). search_domains_append (append). domain_blacklist . foo.* . *.bar . name_servers (name servers) (prepend). libc 127.0.0.1 . name_servers_append (append). name_server_blacklist . 0.0.0.0 DHCP . 192.168.* . private_keys resolv.conf . VPN . private_keys="*" (root zone forwarding) (recursively) . libc . resolvconf -p . nosearch_keys / /etc/resolv.conf . public_keys private nosearch . resolvconf -p . replace . : $keyword/$match/$replacement resolv.conf: domain foo.org search foo.org dead.beef nameserver 1.2.3.4 nameserver 2.3.4.5 : replace="search/foo*/bar.com" replace="$replace nameserver/1.2.3.4/5.6.7.8" replace="$replace nameserver/2.3.4.5/" resolv.conf : domain foo.org search bar.com nameserver 5.6.7.8 replace_sub replace search . resolv.conf replace replace_sub resolv.conf : domain foo.org search bar.com dead.beef nameserver 5.6.7.8 state_dir /run/resolvconf . resolvconf . LIBC (LIBC OPTIONS) resolv.conf(5) : resolv_conf /etc/resolv.conf . /dev/null resolvconf(8) . resolv_conf_options libc resolv.conf(5) . resolv_conf_passthrough YES resolv.conf resolv_conf . /dev/null NULL resolv_conf_local_only NO local_nameservers resolvconf -u resolv_conf . resolv_conf_restore YES resolv.conf resolv.conf.bak . YES . resolv_conf_sortlist sortlist libc resolv.conf(5) . resolv_conf_local_only . NO . DNS . append_nameservers (append). prepend_nameservers (prepend). append_search (append). prepend_search (prepend). resolv_conf_mv NO . /etc/resolv.conf . (SUBSCRIBER OPTIONS) openresolv : dnsmasq(8) named(8) pdnsd(8) pdns_recursor(1) unbound(8). (include). NO . (dash) (underscore) . libc : libc=NO dnsmasq_conf dnsmasq . dnsmasq_resolv dnsmasq . resolvconf.conf dnsmasq: name_servers=127.0.0.1 dnsmasq_conf=/etc/dnsmasq-conf.conf dnsmasq_resolv=/etc/dnsmasq-resolv.conf dnsmasq.conf: listen-address=127.0.0.1 # If dnsmasq is compiled for DBus then we can take # advantage of not having to restart dnsmasq. enable-dbus conf-file=/etc/dnsmasq-conf.conf resolv-file=/etc/dnsmasq-resolv.conf named_options options named (include). named . named_zones (global scope) named options . named . resolvconf.conf named: name_servers=127.0.0.1 named_options=/etc/named-options.conf named_zones=/etc/named-zones.conf named.conf: options { listen-on { 127.0.0.1; }; include "/etc/named-options.conf"; }; include "/etc/named-zones.conf"; pdnsd_conf pdnsd (forward domains) . pdnsd pdnsd_resolv . pdnsd_resolv pdnsd . pdnsd_conf . resolvconf.conf pdnsd: name_servers=127.0.0.1 pdnsd_conf=/etc/pdnsd.conf # pdnsd_resolv=/etc/pdnsd-resolv.conf pdnsd.conf: global { server_ip = 127.0.0.1; status_ctl = on; } server { # A server definition is required, even if empty. label="empty"; proxy_only=on; # file="/etc/pdnsd-resolv.conf"; } pdns_zones pdns_recursor . resolvconf.conf pdns_recursor: name_servers=127.0.0.1 pdns_zones=/etc/pdns/recursor-zones.conf recursor.conf: allow-from=127.0.0.0/8, ::1/128 forward-zones-file=/etc/pdns/recursor-zones.conf resolvectl YES resolvectl(1) resolvconf(8) systemd-resolved(8) . . systemd- resolved DNS delegates (private) resolvconf(8) DNS resolvectl(1) . systemd-resolved . resolvconf.conf resolvectl: # Keep /etc/resolv.conf as systemd-resolved wants it libc=NO resolvectl=YES systemd_resolved YES DNS systemd_resolved_conf DNS delegates systemd_delegate_dir . systemd_resolved_conf /run/systemd/resolved.conf.d/60-resolvconf.conf . systemd_delegate_dir /run/systemd/dns-delegate.d . resolvconf.conf systemd-resolved: # Keep /etc/resolv.conf as systemd-resolved wants it libc=NO systemd_resolved=YES unbound_conf unbound . unbound_insecure YES unbound (insecure) DNSSEC . unbound_private YES unbound (private) . unbound_forward_zone_options forward zone . (newline) . resolvconf.conf unbound: name_servers=127.0.0.1 unbound_conf=/etc/unbound-resolvconf.conf unbound.conf: include: /etc/unbound-resolvconf.conf (SUBSCRIBER INTEGRATION) . named named bind rc.bind /etc/rc.d /etc/init.d . . bind8 bind9. . dnsmasq_service dnsmasq. dnsmasq_restart dnsmasq. dnsmasq_pid pid dnsmasq. libc_service libc. libc_restart libc. named_service named. named_restart named. pdnsd_restart pdnsd. pdns_service pdns_recursor. pdns_restart pdns_recursor. unbound_service unbound. unbound_restart unbound. unbound_pid pid unbound. (SEE ALSO) sh(1), resolv.conf(5), resolvconf(8) (AUTHORS) Roy Marples (BUGS) named. resolvectl systemd-resolved . systemd_resolved_conf systemd_delegate_dir . (reboot) . . https://roy.marples.name/projects/openresolv . Linux 6.12.107+deb13-amd64 May 15, 2025 Linux 6.12.107+deb13-amd64