From 29dbc28c4aca6a0ed953234df6b3e9dc1906913d Mon Sep 17 00:00:00 2001 From: =?utf8?q?Vladim=C3=ADr=20=C4=8Cun=C3=A1t?= Date: Tue, 3 Oct 2023 10:16:42 +0200 Subject: [PATCH] doc/config-local-data: begin with typical examples This doc page is relatively complex and it will only get longer in future, but I expect that 90% of users will be OK with just these simple examples. --- doc/config-local-data.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/config-local-data.rst b/doc/config-local-data.rst index 1e4520212..242931058 100644 --- a/doc/config-local-data.rst +++ b/doc/config-local-data.rst @@ -8,6 +8,21 @@ Local Data and RPZ Local overrides for DNS data may be defined in the :option:`local-data ` configuration tree. It provides various input formats described in following subsections. +.. code-block:: yaml + + # Some typical use cases: + local-data: + addresses: + a1.example.com: 2001:db8::1 + a2.example.org: [ 192.0.2.2, 192.0.2.3, 2001:db8::4 ] + addresses-files: + - /etc/hosts + records: | + www.google.com. CNAME forcesafesearch.google.com. + rpz: + - file: /tmp/blocklist.rpz + + .. option:: local-data: .. option:: ttl: