resolvconf
Manage DNS resolver configuration dynamically
TLDR
Update DNS configuration
SYNOPSIS
resolvconf [-a interface] [-d interface] [-u] [options]
DESCRIPTION
resolvconf is a framework for dynamically managing the system's DNS resolver configuration in /etc/resolv.conf. Rather than allowing individual network tools to overwrite the file, resolvconf aggregates DNS information from multiple sources such as DHCP clients, VPN connections, and NetworkManager, then generates a unified resolv.conf based on priority ordering.
Each network interface registers its DNS servers and search domains through resolvconf using the -a flag, and removes them with -d when the connection terminates. The framework determines the final configuration by combining all registered inputs, with earlier-registered interfaces taking higher priority. Static entries can be added through head and tail configuration files that are prepended or appended to the generated output.
Several implementations exist, including openresolv and the Debian resolvconf package, each with slightly different features. On systemd-based systems, systemd-resolved may provide similar functionality and can coexist or conflict with resolvconf depending on configuration.
PARAMETERS
-a INTERFACE
Add/update interface config.-d INTERFACE
Delete interface config.-u
Update resolv.conf.-l
List interfaces.-i PATTERN
Include interfaces.-x PATTERN
Exclude interfaces.-p
Show head file.
CONFIGURATION
/etc/resolv.conf
Generated output file containing the aggregated DNS resolver configuration. Managed by resolvconf and should not be edited manually./etc/resolvconf/resolv.conf.d/head
Static content prepended to the generated resolv.conf./etc/resolvconf/resolv.conf.d/tail
Static content appended to the generated resolv.conf./etc/resolvconf/interface-order
Defines the priority ordering of network interfaces for DNS resolution.
CAVEATS
May conflict with systemd-resolved. Distribution implementations vary. Some use openresolv, others resolvconf.
HISTORY
resolvconf was created to handle dynamic DNS configuration from multiple network sources. Various implementations exist including openresolv and the Debian resolvconf package.
SEE ALSO
systemd-resolved(1), dhclient(1), nmcli(1)
