dnsconfd - Man Page

dnsconfd [options]

Dnsconfd is a local cache configuration daemon. It implements DBus interface of systemd-resolved and translates it's use to dns service's configuration.

-h,  --help

Show help message and exit

--dbus-name DBUS_NAME

DBUS name that dnsconfd should use, default com.redhat.dnsconfd

--log-level {DEBUG,INFO,WARN}

Log level of dnsconfd, default INFO

--resolv-conf-path RESOLV_CONF_PATH

Path to resolv.conf that the dnsconfd should manage, default /etc/resolv.conf

--prioritize-wire {yes,no}

If set to yes then wireless interfaces will have lower priority, default yes

--listen-address ADDRESS

Address on which local resolver listens, default 127.0.0.1

--config-file PATH

Path where config file is located, default /etc/dnsconfd.conf

--resolver-options options

Options to be used in resolv.conf for alteration of resolver, default "edns0 trust-ad"

--dnssec-enabled options

Enable dnssec record validation, default no

0

Graceful stop.

1

DNS caching service failure. Service crashed for example.

2

Failed communication through DBUS.

3

Failed interaction with resolv.conf

4

Failed to configure dns cache service

Environment variables have lower priority than command line options but higher than configuration file.

DBUS_NAME

DBUS name that dnsconfd should use, default com.redhat.dnsconfd

LOG_LEVEL

Log level of dnsconfd, default INFO

RESOLV_CONF_PATH

Path to resolv.conf that the dnsconfd should manage, default /etc/resolv.conf

PRIORITIZE_WIRE

If set to yes then wireless interfaces will have lower priority, default yes

LISTEN_ADDRESS

Address on which local resolver listens, default 127.0.0.1

CONFIG_FILE

Path where config file is located, default /etc/dnsconfd.conf

RESOLVER_OPTIONS

Options to be used in resolv.conf for alteration of resolver, default "edns0 trust-ad"

DNSSEC_ENABLED

Enable dnssec record validation, default no

Dnsconfd manages resolv.conf to route domain name resolution to local cache service. Default location of the configuration file is /etc/dnsconfd.conf.

The only currently supported backend is Unbound.

If you have systemd-resolved installed then you have to disable it first.

# systemctl disable --now systemd-resolved

Stop systemd-resolved and disable its start on boot.

# systemctl mask systemd-resolved

Mask the service so there are no conflicts.

# dnsconfd config install

Modifies NetworkManager to explicitly use systemd-resolved dbus API, and changes ownership of resolvconf so Dnsconfd does not need root privileges.

# systemctl enable --now dnsconfd

Starts Dnsconfd and enables its startup on boot.

Please for reporting bugs use Github repository https://github.com/InfrastructureServices/dnsconfd

dnsconfd-status(8) Checking status of dnsconfd dnsconfd-reload(8) Reload running cache service dnsconfd-config(8) Change configuration of service or host

Copyright (c) 2023 Red Hat, Inc.

dnsconfd-config(8), dnsconfd-reload(8), dnsconfd-status(8).