From 24d7eb66567fdb1f3a7a0b417a34149c5d22bd3d Mon Sep 17 00:00:00 2001 From: Tomas Korbar Date: Tue, 10 Oct 2023 15:06:59 +0200 Subject: [PATCH] Add README --- README.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..f63db40 --- /dev/null +++ b/README.md @@ -0,0 +1,34 @@ +# Dnsconfd + +Dnsconfd simplifies configuration of local dns caching services by +implementing DBus interface of systemd-resolved and translating its +use to dns service's configuration. + +## Testing + +You can verify your changes by executing: + +``` +$ tmt run +``` + +This executes all test plans currently present for the project. + +## Distribution + +Dnsconfd is distributed as an RPM package that can be build for testing +purposes by executing `$ ./tests/build_package.sh` + +## Currently supported DNS caching services + +- Unbound + +## Known limitations + + - Unfortunately, intergration with NetworkManager is now only possible + when Dnsconfd is allowed to own org.freedesktop.resolve1 DBus name, + as NetworkManager does not support use of any another. + + - Dnsconfd has to run as a root user, because NetworkManager forces us + to use one of currently known resolv.conf stub files locations and + we can not access them without root permission.