From: Otto Moerbeek <otto.moerbeek@open-xchange.com>
Date: Tue, 17 Jun 2025 12:39:59 +0000 (+0200)
Subject: Add docs, typos
X-Git-Tag: dnsdist-2.0.0-beta1~3^2~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=25f7b98f9ca51c8b11df08f160c868d890c4d473;p=thirdparty%2Fpdns.git

Add docs, typos

Signed-off-by: Otto Moerbeek <otto.moerbeek@open-xchange.com>
---

diff --git a/pdns/recursordist/rec-rust-lib/docs-new-preamble-in.rst b/pdns/recursordist/rec-rust-lib/docs-new-preamble-in.rst
index 6469501d06..0becbd5667 100644
--- a/pdns/recursordist/rec-rust-lib/docs-new-preamble-in.rst
+++ b/pdns/recursordist/rec-rust-lib/docs-new-preamble-in.rst
@@ -274,6 +274,8 @@ As of version 5.1.0, a protobuf server is defined as
     exportTypes: [A, AAAA, CNAME] Sequence of QType names
     logMappedFrom: false
 
+.. versionchanged:: 5.3.0 The aliases ``max_queued_entries``, ``reconnect_wait_time``, ``tagged_only``, ``async_connect``, ``log_queries``, ``log_responses``, ``export_types``, ``log_mapped_from`` have been introduced.
+    
 An example of a ``protobuf_servers`` entry, which is a sequence of `ProtobufServer`_:
 
 .. code-block:: yaml
@@ -303,6 +305,8 @@ As of version 5.1.0, a dnstap framestream server is defined as
   queueNotifyThreshold: 0
   reopenInterval: 0
 
+.. versionchanged:: 5.3.0 The aliases ``log_queries``, ``log_responses``, ``buffer_hint``, ``flush_timeout``, ``input_queue_size``, ``output_queue_size``, ``queue_notify_threshold``, ``reopen_interval`` have been introduced.
+
 An example of a ``dnstap_framestream_servers`` entry, which is a sequence of `DNSTapFrameStreamServers`_:
 
 .. code-block:: yaml
@@ -329,6 +333,8 @@ As of version 5.1.0, an NOD dnstap framestream server is defined as
   queueNotifyThreshold: 0
   reopenInterval: 0
 
+.. versionchanged:: 5.3.0 The aliases ``log_nods``, ``log_udrs``, ``buffer_hint``, ``flush_timeout``, ``input_queue_size``, ``output_queue_size``, ``queue_notify_threshold``, ``reopen_interval`` have been introduced.
+
 An example of a ``dnstap_nod_framestream_servers`` entry, which is a sequence of `DNSTapNODFrameStreamServers`_:
 
 .. code-block:: yaml
@@ -399,11 +405,12 @@ As of version 5.1.0, an RPZ entry is defined as
     dumpFile: string
     seedFile: string
 
+.. versionchanged:: 5.3.0 The aliases ``defpol_override_local_data``, ``extended_error_code``, ``extended_error_extra``, ``include_soa``, ``ignore_duplicates``, ``policy_name``, ``overriddes_gettag``, ``zone_size_hint``, ``max_received_bytes``, ``local_address``, ``axfr_timeout``, ``dump_file``, ``seed_file`` have been introduced.
+
 If ``addresses`` is empty, the ``name`` field specifies the path name of the RPZ, otherwise the ``name`` field defines the name of the RPZ.
 Starting with version 5.2.0, names instead of IP addresess can be used for ``addresses`` if
 :ref:`setting-yaml-recursor.system_resolver_ttl` is set.
 
-
 An example of an ``rpzs`` entry, which is a sequence of `RPZ`_:
 
 .. code-block:: yaml
@@ -436,6 +443,8 @@ As of version 5.1.0, a ZoneToCache entry is defined as
    zonemd: One of ignore, validate, require
    dnssec: One of ignore, validate, require
 
+.. versionchanged:: 5.3.0 The aliases ``refresh_period``, ``retry_on_error``, ``max_received_mbytes``, ``local_address`` has been introduced.
+
 An example of an ``zonetocaches`` entry, which is a sequence of `ZoneToCache`_:
 
 .. code-block:: yaml
@@ -520,6 +529,8 @@ As of version 5.2.0, a forwarding catalog zone entry is defined as:
        recurse: bool, default false
        notify_allowed: bool, default false
 
+.. versionchanged:: 5.3.0 The aliases ``max_received_bytes``, ``local_address``, ``axfr_timeout`` have been introduced.
+
 While this setting has no equivalent old-style Lua configuration, it cannot appear together with :ref:`setting-lua-config-file` being set.
 If you want to use catalog zones to define forwards, you need to convert existing Lua configuration to YAML format.
 
diff --git a/pdns/recursordist/rec-rust-lib/rust-bridge-in.rs b/pdns/recursordist/rec-rust-lib/rust-bridge-in.rs
index 0c30afdaa2..3d76b84cf3 100644
--- a/pdns/recursordist/rec-rust-lib/rust-bridge-in.rs
+++ b/pdns/recursordist/rec-rust-lib/rust-bridge-in.rs
@@ -153,7 +153,7 @@ pub struct RPZ {
     extendedErrorExtra: String,
     #[serde(default, skip_serializing_if = "crate::is_default", alias = "include_soa")]
     includeSOA: bool,
-    #[serde(default, skip_serializing_if = "crate::is_default", alias = "ignore_suplicates")]
+    #[serde(default, skip_serializing_if = "crate::is_default", alias = "ignore_duplicates")]
     ignoreDuplicates: bool,
     #[serde(default = "crate::U32::<{u32::MAX}>::value", skip_serializing_if = "crate::U32::<{u32::MAX}>::is_equal", alias = "max_ttl")]
     maxTTL: u32,
@@ -173,7 +173,7 @@ pub struct RPZ {
     maxReceivedMBytes: u32,
     #[serde(default, skip_serializing_if = "crate::is_default", alias = "local_address")]
     localAddress: String,
-    #[serde(default = "crate::U32::<20>::value", skip_serializing_if = "crate::U32::<20>::is_equal", alias = "axfr_rimeout")]
+    #[serde(default = "crate::U32::<20>::value", skip_serializing_if = "crate::U32::<20>::is_equal", alias = "axfr_timeout")]
     axfrTimeout: u32,
     #[serde(default, skip_serializing_if = "crate::is_default", alias = "dump_file")]
     dumpFile: String,