From 2386e4981a7e2d28b8970fcf3716c26485332cf2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig?= Date: Wed, 13 Nov 2024 09:13:55 +0100 Subject: [PATCH 1/6] docs/backends: Fix title of the Autosecondary column Each backend that provides support for Primary also can do Autoprimary, so listing that separately isn't sensible. Before commit 45675c556970 ("auth: catalog zone documentation") this column was titled "Super slave". Said commit then changed it wrongly to "Autoprimary". The right new term for "Super slave" is "Autosecondary". Adapt accordingly. Fixes: 45675c556970 ("auth: catalog zone documentation") --- docs/backends/index.rst | 58 ++++++++++++++++++++--------------------- 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/docs/backends/index.rst b/docs/backends/index.rst index 266f45befa2d..08c460485a10 100644 --- a/docs/backends/index.rst +++ b/docs/backends/index.rst @@ -3,35 +3,35 @@ Backends The following table describes the supported backends and some of their capabilities. -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| Name | Native | Primary | Secondary | Producer | Consumer | Autoprimary | :doc:`DNS Update <../dnsupdate>` | :doc:`DNSSEC <../dnssec/index>` | Launch | -+================================================+========+=========+===========+==========+==========+==============+==================================+=================================+==============+ -| :doc:`BIND ` | Yes | Yes | Yes | No | No | Yes | No | Yes | ``bind`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`Generic Mysql/Mariadb ` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ``gmysql`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`Generic ODBC ` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ``godbc`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`Generic Postgresql ` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ``gpgsql`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`Generic SQLite3 ` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ``gsqlite3`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`GeoIP ` | Yes | No | No | No | No | No | No | Yes | ``geoip`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`LDAP ` | Yes | Yes | No | No | No | No | No | No | ``ldap`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`LMDB ` | Yes | Yes | Yes | Yes | Yes | No | No | Yes | ``lmdb`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`Lua2 ` | Yes | Yes | No | No | No | No | No | Yes | ``lua2`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`Pipe ` | Yes | No | No | No | No | No | No | No | ``pipe`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`Random ` | Yes | No | No | No | No | No | No | No | ``random`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`Remote ` | Yes | Yes\* | Yes\* | No | No | Yes\* | No | Yes\* | ``remote`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ -| :doc:`TinyDNS ` | Yes | Yes | No | No | No | No | No | No | ``tinydns`` | -+------------------------------------------------+--------+---------+-----------+----------+----------+--------------+----------------------------------+---------------------------------+--------------+ ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| Name | Native | Primary | Secondary | Producer | Consumer | Autosecondary | :doc:`DNS Update <../dnsupdate>` | :doc:`DNSSEC <../dnssec/index>` | Launch | ++================================================+========+=========+===========+==========+==========+===============+==================================+=================================+==============+ +| :doc:`BIND ` | Yes | Yes | Yes | No | No | Yes | No | Yes | ``bind`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`Generic Mysql/Mariadb ` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ``gmysql`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`Generic ODBC ` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ``godbc`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`Generic Postgresql ` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ``gpgsql`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`Generic SQLite3 ` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ``gsqlite3`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`GeoIP ` | Yes | No | No | No | No | No | No | Yes | ``geoip`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`LDAP ` | Yes | Yes | No | No | No | No | No | No | ``ldap`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`LMDB ` | Yes | Yes | Yes | Yes | Yes | No | No | Yes | ``lmdb`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`Lua2 ` | Yes | Yes | No | No | No | No | No | Yes | ``lua2`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`Pipe ` | Yes | No | No | No | No | No | No | No | ``pipe`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`Random ` | Yes | No | No | No | No | No | No | No | ``random`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`Remote ` | Yes | Yes\* | Yes\* | No | No | Yes\* | No | Yes\* | ``remote`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ +| :doc:`TinyDNS ` | Yes | Yes | No | No | No | No | No | No | ``tinydns`` | ++------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ All the generic SQL backends have similar functionality, apart from the database they communicate with. These backends have :doc:`features unique ` to the generic SQL backends. From a7b9b69028646cf6252ffbf09fa810ff664c0774 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig?= Date: Tue, 12 Nov 2024 10:27:25 +0100 Subject: [PATCH 2/6] docs/backends: Use * consistently for the per backend feature list Nearly all backend docs use * for their feature list. Upgrade that to "all". --- docs/backends/random.rst | 22 +++++++++++----------- docs/backends/tinydns.rst | 18 +++++++++--------- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs/backends/random.rst b/docs/backends/random.rst index 61c36011aa85..886d1d064290 100644 --- a/docs/backends/random.rst +++ b/docs/backends/random.rst @@ -4,17 +4,17 @@ Random Backend .. deprecated:: 4.6.0 This backend has been removed in 4.6.0 -- Native: Yes -- Master: No -- Slave: No -- Superslave: No -- Case: Depends -- DNSSEC: Yes, no key storage -- Disabled data: No -- Comments: No -- Zone caching: No -- Module name: built in -- Launch: ``random`` +* Native: Yes +* Master: No +* Slave: No +* Superslave: No +* Case: Depends +* DNSSEC: Yes, no key storage +* Disabled data: No +* Comments: No +* Zone caching: No +* Module name: built in +* Launch: ``random`` This is a very silly backend which is discussed in the :doc:`Backends writer's guide <../appendices/backend-writers-guide>`. diff --git a/docs/backends/tinydns.rst b/docs/backends/tinydns.rst index 9ab90282e7b8..fa9b07fe6ba7 100644 --- a/docs/backends/tinydns.rst +++ b/docs/backends/tinydns.rst @@ -1,15 +1,15 @@ TinyDNS Backend =============== -- Native: Yes -- Master: Yes -- Slave: No -- Superslave: No -- DNSSEC: No -- Zone caching: Yes -- Multiple Instances: Yes -- Module name: tinydns -- Launch: ``tinydns`` +* Native: Yes +* Master: Yes +* Slave: No +* Superslave: No +* DNSSEC: No +* Zone caching: Yes +* Multiple Instances: Yes +* Module name: tinydns +* Launch: ``tinydns`` The TinyDNS backend allows you to use `djbdns's `__ ``data.cdb`` file format as From b995665abdf51ddb10a6dc82a4a759104fa143cf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig?= Date: Tue, 12 Nov 2024 11:48:15 +0100 Subject: [PATCH 3/6] docs/backends: Don't document Case handling Users shouldn't have to care about case handling and if a need is hit this is handled as a bug. So drop this documentation bit. --- docs/backends/generic-mysql.rst | 1 - docs/backends/generic-odbc.rst | 1 - docs/backends/generic-postgresql.rst | 1 - docs/backends/lmdb.rst | 1 - docs/backends/pipe.rst | 1 - docs/backends/random.rst | 1 - 6 files changed, 6 deletions(-) diff --git a/docs/backends/generic-mysql.rst b/docs/backends/generic-mysql.rst index d997f9633adb..778b20867af7 100644 --- a/docs/backends/generic-mysql.rst +++ b/docs/backends/generic-mysql.rst @@ -5,7 +5,6 @@ Generic MySQL/MariaDB backend * Master: Yes * Slave: Yes * Superslave: Yes -* Case: All lower * DNSSEC: Yes (set ``gmysql-dnssec``) * Disabled data: Yes * Comments: Yes diff --git a/docs/backends/generic-odbc.rst b/docs/backends/generic-odbc.rst index 1f47d3e23b51..8fac98d97b63 100644 --- a/docs/backends/generic-odbc.rst +++ b/docs/backends/generic-odbc.rst @@ -5,7 +5,6 @@ Generic ODBC Backend * Master: Yes * Slave: Yes * Superslave: Yes -* Case: All lower * DNSSEC: Yes * Disabled data: Yes * Comments: Yes diff --git a/docs/backends/generic-postgresql.rst b/docs/backends/generic-postgresql.rst index b092f59d9841..da74cd69c0db 100644 --- a/docs/backends/generic-postgresql.rst +++ b/docs/backends/generic-postgresql.rst @@ -5,7 +5,6 @@ Generic PostgreSQL backend * Master: Yes * Slave: Yes * Superslave: Yes -* Case: All lower * DNSSEC: Yes (set ``gpgsql-dnssec``) * Disabled data: Yes * Comments: Yes diff --git a/docs/backends/lmdb.rst b/docs/backends/lmdb.rst index ffde491f6bdb..9f5bb70a6a81 100644 --- a/docs/backends/lmdb.rst +++ b/docs/backends/lmdb.rst @@ -5,7 +5,6 @@ LMDB backend * Master: Yes * Slave: Yes * Superslave: No -* Case: All lower * DNSSEC: Yes * Disabled data: Yes * Comments: No diff --git a/docs/backends/pipe.rst b/docs/backends/pipe.rst index d857624bb464..77bd18955780 100644 --- a/docs/backends/pipe.rst +++ b/docs/backends/pipe.rst @@ -5,7 +5,6 @@ Pipe Backend * Master: No * Slave: No * Superslave: No -* Case: Depends * DNSSEC: Partial, no delegation, no key storage * Disabled data: No * Comments: No diff --git a/docs/backends/random.rst b/docs/backends/random.rst index 886d1d064290..b48f215175ad 100644 --- a/docs/backends/random.rst +++ b/docs/backends/random.rst @@ -8,7 +8,6 @@ Random Backend * Master: No * Slave: No * Superslave: No -* Case: Depends * DNSSEC: Yes, no key storage * Disabled data: No * Comments: No From ee8995d82d47d849a6f06184fd5e2ec011e319cc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig?= Date: Mon, 11 Nov 2024 17:08:17 +0100 Subject: [PATCH 4/6] docs: List the same properties for all backends Make all the tables at the beginning of the backend detail descriptions describe the same properties in the same order. Stick to the order used in the overview table in index.rst. Also use the more politically correct names (i.e. Master -> Primary; Slave -> Secondary; Superslave -> Autosecondary). --- docs/backends/bind.rst | 12 ++++++++---- docs/backends/generic-mysql.rst | 11 ++++++++--- docs/backends/generic-odbc.rst | 11 ++++++++--- docs/backends/generic-postgresql.rst | 11 ++++++++--- docs/backends/generic-sqlite3.rst | 11 ++++++++--- docs/backends/geoip.rst | 11 ++++++++--- docs/backends/ldap.rst | 11 ++++++++--- docs/backends/lmdb.rst | 10 +++++++--- docs/backends/lua2.rst | 15 +++++++++++---- docs/backends/pipe.rst | 13 +++++++++---- docs/backends/random.rst | 15 ++++++++++----- docs/backends/remote.rst | 16 ++++++++++++---- docs/backends/tinydns.rst | 14 ++++++++++---- 13 files changed, 115 insertions(+), 46 deletions(-) diff --git a/docs/backends/bind.rst b/docs/backends/bind.rst index e4ab8a577945..0af16c246a28 100644 --- a/docs/backends/bind.rst +++ b/docs/backends/bind.rst @@ -2,14 +2,18 @@ BIND zone file backend ====================== * Native: Yes -* Master: Yes -* Slave: Yes -* Superslave: Experimental +* Primary: Yes +* Secondary: Yes +* Producer: No +* Consumer: No +* Autosecondary: Experimental +* DNS Update: No * DNSSEC: Yes * Disabled data: No * Comments: No * API: Read-only -* Zone caching: Yes (except in hybrid mode) +* Multiple instances: No +* Zone caching: Yes * Module name: bind * Launch: ``bind`` diff --git a/docs/backends/generic-mysql.rst b/docs/backends/generic-mysql.rst index 778b20867af7..c9edb5ecf54a 100644 --- a/docs/backends/generic-mysql.rst +++ b/docs/backends/generic-mysql.rst @@ -2,12 +2,17 @@ Generic MySQL/MariaDB backend ============================== * Native: Yes -* Master: Yes -* Slave: Yes -* Superslave: Yes +* Primary: Yes +* Secondary: Yes +* Producer: Yes +* Consumer: Yes +* Autosecondary: Yes +* DNS Update: Yes * DNSSEC: Yes (set ``gmysql-dnssec``) * Disabled data: Yes * Comments: Yes +* API: Read-Write +* Multiple instances: yes * Zone caching: Yes * Module name: gmysql * Launch name: ``gmysql`` diff --git a/docs/backends/generic-odbc.rst b/docs/backends/generic-odbc.rst index 8fac98d97b63..b37f5766ef32 100644 --- a/docs/backends/generic-odbc.rst +++ b/docs/backends/generic-odbc.rst @@ -2,12 +2,17 @@ Generic ODBC Backend ==================== * Native: Yes -* Master: Yes -* Slave: Yes -* Superslave: Yes +* Primary: Yes +* Secondary: Yes +* Producer: Yes +* Consumer: Yes +* Autosecondary: Yes +* DNS Update: Yes * DNSSEC: Yes * Disabled data: Yes * Comments: Yes +* API: Read-Write +* Multiple instances: yes * Zone caching: Yes * Module name: godbc * Launch name: ``godbc`` diff --git a/docs/backends/generic-postgresql.rst b/docs/backends/generic-postgresql.rst index da74cd69c0db..4d0d519db3c2 100644 --- a/docs/backends/generic-postgresql.rst +++ b/docs/backends/generic-postgresql.rst @@ -2,12 +2,17 @@ Generic PostgreSQL backend ========================== * Native: Yes -* Master: Yes -* Slave: Yes -* Superslave: Yes +* Primary: Yes +* Secondary: Yes +* Producer: Yes +* Consumer: Yes +* Autosecondary: Yes +* DNS Update: Yes * DNSSEC: Yes (set ``gpgsql-dnssec``) * Disabled data: Yes * Comments: Yes +* API: Read-Write +* Multiple instances: yes * Zone caching: Yes * Module name: gpgsql * Launch name: ``gpgsql`` diff --git a/docs/backends/generic-sqlite3.rst b/docs/backends/generic-sqlite3.rst index b6a02b132429..d12ebe3f8963 100644 --- a/docs/backends/generic-sqlite3.rst +++ b/docs/backends/generic-sqlite3.rst @@ -2,12 +2,17 @@ Generic SQLite 3 backend ======================== * Native: Yes -* Master: Yes -* Slave: Yes -* Superslave: Yes +* Primary: Yes +* Secondary: Yes +* Producer: Yes +* Consumer: Yes +* Autosecondary: Yes +* DNS Update: Yes * DNSSEC: Yes * Disabled data: Yes * Comments: Yes +* API: Read-Write +* Multiple instances: yes * Zone caching: Yes * Module name: gsqlite3 * Launch name: ``gsqlite3`` diff --git a/docs/backends/geoip.rst b/docs/backends/geoip.rst index 539d16767fa4..551e57678326 100644 --- a/docs/backends/geoip.rst +++ b/docs/backends/geoip.rst @@ -2,12 +2,17 @@ GeoIP backend ============= * Native: Yes -* Master: No -* Slave: No -* Superslave: No +* Primary: No +* Secondary: No +* Producer: No +* Consumer: No +* Autosecondary: No +* DNS Update: No * DNSSEC: Yes * Disabled data: No * Comments: No +* API: Read-only +* Multiple instances: Yes * Zone caching: Yes * Module name: geoip * Launch name: ``geoip`` diff --git a/docs/backends/ldap.rst b/docs/backends/ldap.rst index bc7616b538a2..9ea798e98de1 100644 --- a/docs/backends/ldap.rst +++ b/docs/backends/ldap.rst @@ -2,12 +2,17 @@ LDAP backend ============ * Native: Yes -* Master: Yes -* Slave: No -* Superslave: No +* Primary: Yes +* Secondary: No +* Producer: No +* Consumer: No +* Autosecondary: No +* DNS Update: No * DNSSEC: No * Disabled data: No * Comments: No +* API: Read-only +* Multiple instances: Yes * Zone caching: No * Module name: ldap * Launch name: ``ldap`` diff --git a/docs/backends/lmdb.rst b/docs/backends/lmdb.rst index 9f5bb70a6a81..c4750b8fb73e 100644 --- a/docs/backends/lmdb.rst +++ b/docs/backends/lmdb.rst @@ -2,12 +2,16 @@ LMDB backend ============ * Native: Yes -* Master: Yes -* Slave: Yes -* Superslave: No +* Primary: Yes +* Secondary: Yes +* Producer: Yes +* Consumer: Yes +* Autosecondary: No +* DNS Update: No * DNSSEC: Yes * Disabled data: Yes * Comments: No +* API: Read-Write * Multiple instances: No * Zone caching: Yes * Module name: lmdb diff --git a/docs/backends/lua2.rst b/docs/backends/lua2.rst index f0793318e6b1..db1a74a914b9 100644 --- a/docs/backends/lua2.rst +++ b/docs/backends/lua2.rst @@ -2,16 +2,23 @@ Lua2 Backend ============ * Native: Yes -* Master: Yes -* Slave: No -* Superslave: No +* Primary: Yes +* Secondary: No +* Producer: No +* Consumer: No +* Autosecondary: No +* DNS Update: No * DNSSEC: Yes * Disabled data: No * Comments: No -* Zone caching: Yes +* API: Read-Write +* Multiple instances: Yes +* Zone caching: Yes\* * Module name: lua2 * Launch name: ``lua2`` +\* If provided by the responder (your script). + This is a rewrite of existing Lua backend. This backend is stub between your Lua script and PowerDNS authoritative server. The backend uses AuthLua4 base class, and you can use same functions and types as in any other Lua script. diff --git a/docs/backends/pipe.rst b/docs/backends/pipe.rst index 77bd18955780..029f9cbd1c6a 100644 --- a/docs/backends/pipe.rst +++ b/docs/backends/pipe.rst @@ -2,12 +2,17 @@ Pipe Backend ============ * Native: Yes -* Master: No -* Slave: No -* Superslave: No -* DNSSEC: Partial, no delegation, no key storage +* Primary: No +* Secondary: No +* Producer: No +* Consumer: No +* Autosecondary: No +* DNS Update: No +* DNSSEC: No * Disabled data: No * Comments: No +* API: Read-only +* Multiple instances: Yes * Zone caching: No * Module name: pipe * Launch name: ``pipe`` diff --git a/docs/backends/random.rst b/docs/backends/random.rst index b48f215175ad..016c0a2c49c8 100644 --- a/docs/backends/random.rst +++ b/docs/backends/random.rst @@ -5,14 +5,19 @@ Random Backend This backend has been removed in 4.6.0 * Native: Yes -* Master: No -* Slave: No -* Superslave: No -* DNSSEC: Yes, no key storage +* Primary: No +* Secondary: No +* Producer: No +* Consumer: No +* Autosecondary: No +* DNS Update: No +* DNSSEC: No * Disabled data: No * Comments: No +* API: No +* Multiple instances: No * Zone caching: No -* Module name: built in +* Module name: random * Launch: ``random`` This is a very silly backend which is discussed in the :doc:`Backends diff --git a/docs/backends/remote.rst b/docs/backends/remote.rst index d2e6f62ed5d4..f121035a8d55 100644 --- a/docs/backends/remote.rst +++ b/docs/backends/remote.rst @@ -2,12 +2,20 @@ Remote Backend ============== * Native: Yes -* Master: Yes\* -* Slave: Yes\* -* Superslave: Yes\* +* Primary: Yes\* +* Secondary: Yes\* +* Producer: No +* Consumer: No +* Autosecondary: Yes\* +* DNS Update: No * DNSSEC: Yes\* -* Zone caching: Yes\* +* Disabled data: No +* Comments: No +* API: Read-Write * Multiple instances: Yes +* Zone caching: Yes\* +* Module name: remote +* Launch: ``remote`` \* If provided by the responder (your script). diff --git a/docs/backends/tinydns.rst b/docs/backends/tinydns.rst index fa9b07fe6ba7..5d2f27ccd791 100644 --- a/docs/backends/tinydns.rst +++ b/docs/backends/tinydns.rst @@ -2,12 +2,18 @@ TinyDNS Backend =============== * Native: Yes -* Master: Yes -* Slave: No -* Superslave: No +* Primary: Yes +* Secondary: No +* Producer: No +* Consumer: No +* Autosecondary: No +* DNS Update: No * DNSSEC: No -* Zone caching: Yes +* Disabled data: No +* Comments: No +* API: Read-only * Multiple Instances: Yes +* Zone caching: Yes * Module name: tinydns * Launch: ``tinydns`` From aefd0c95a01450a976ed66b7e8998e53df50fd5c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig?= Date: Mon, 10 Feb 2025 13:57:07 +0100 Subject: [PATCH 5/6] docs/backends: Update overview from bind.rst According to bind.rst support for Autosecondary is "Experimental". Claim the same in the overview table. --- docs/backends/index.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/backends/index.rst b/docs/backends/index.rst index 08c460485a10..8ff4ca25d73f 100644 --- a/docs/backends/index.rst +++ b/docs/backends/index.rst @@ -6,7 +6,7 @@ The following table describes the supported backends and some of their capabilit +------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ | Name | Native | Primary | Secondary | Producer | Consumer | Autosecondary | :doc:`DNS Update <../dnsupdate>` | :doc:`DNSSEC <../dnssec/index>` | Launch | +================================================+========+=========+===========+==========+==========+===============+==================================+=================================+==============+ -| :doc:`BIND ` | Yes | Yes | Yes | No | No | Yes | No | Yes | ``bind`` | +| :doc:`BIND ` | Yes | Yes | Yes | No | No | Experimental | No | Yes | ``bind`` | +------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ | :doc:`Generic Mysql/Mariadb ` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | ``gmysql`` | +------------------------------------------------+--------+---------+-----------+----------+----------+---------------+----------------------------------+---------------------------------+--------------+ From b95155c0666c5f9893916c364ee8fc81c51b53d4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig?= Date: Tue, 12 Nov 2024 11:22:28 +0100 Subject: [PATCH 6/6] docs: random: Use past tense as this backend is long gone For an event that happend at a definite time in the past, past simple is the right tense. Suggested-by: Josh Soref (josref) --- docs/backends/random.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/backends/random.rst b/docs/backends/random.rst index 016c0a2c49c8..045a71c11655 100644 --- a/docs/backends/random.rst +++ b/docs/backends/random.rst @@ -2,7 +2,7 @@ Random Backend ============== .. deprecated:: 4.6.0 - This backend has been removed in 4.6.0 + This backend was removed in 4.6.0 * Native: Yes * Primary: No @@ -20,14 +20,14 @@ Random Backend * Module name: random * Launch: ``random`` -This is a very silly backend which is discussed in the :doc:`Backends -writer's guide <../appendices/backend-writers-guide>`. -as a demonstration on how to write a PowerDNS backend. +This used to be a very silly backend which is still discussed in the +:doc:`Backends writer's guide <../appendices/backend-writers-guide>`. as a +demonstration on how to write a PowerDNS backend. -This backend knows about only one hostname, and only about its IP -address at that. With every query, a new random IP address is generated. +This backend knew about only one hostname, and only about its IP +address at that. With every query, a new random IP address was generated. -It only makes sense to load the random backend in combination with a +It only made sense to load the random backend in combination with a regular backend. This can be done by prepending it to the :ref:`setting-launch` instruction, such as ``launch=random,gmysql``.