Document v6 scoped syntax

Closes: #3430

diff --git a/docs/markdown/authoritative/backend-pipe.md b/docs/markdown/authoritative/backend-pipe.md
index 3bb4139708625eaf366e2d1fed34d18c8925a9f3..e44b63e5459dfd7bddbf43363c988bcbcb756479 100644 (file)
--- a/docs/markdown/authoritative/backend-pipe.md
+++ b/docs/markdown/authoritative/backend-pipe.md
@@ -98,6 +98,11 @@ Type is the tag above, `qname` is the domain the question is about. `qclass` is
 
 **Note**: Queries for wildcard names should be answered literally, without expansion. So, if a backend gets a question for "*.powerdns.com", it should only answer with data if there is an actual "*.powerdns.com" name
 
+**Note**: In some (broken) network setups, the `remote-ip-address` and/or
+`local-ip-address`, when it is an IPv6 address, may be suffixed with a `%` and
+the name of the network interface (e.g. `%eth1`). Keep this in mind when checking
+the IP addresses.
+
 ### `AXFR`: List an entire zone
 
 AXFR-queries look like this:

diff --git a/docs/markdown/authoritative/backend-remote.md b/docs/markdown/authoritative/backend-remote.md
index ec25ad7824993273fea92ae0dae87eda537c69d4..9c64c17bfe76819fc8d4c512135a6f10ce30906e 100644 (file)
--- a/docs/markdown/authoritative/backend-remote.md
+++ b/docs/markdown/authoritative/backend-remote.md
@@ -20,6 +20,10 @@ Please do not use remotebackend shipped before version 3.3. This version has sev
 
 There is a breaking change on v4.0 and later. Before version 4.0, the DNS names passed in queries were without trailing dot, after version 4.0 the DNS names are sent with trailing dot. F.ex. example.org is now sent as example.org.
 
+In some (broken) network setups, the IP addresses provided in the request (when
+this is an IPv6 address) may be suffixed with a `%` and the name of the network
+interface (e.g. `%eth1`). Keep this in mind when checking the IP addresses.
+
 ## Compiling
 To compile this backend, you need to configure `--with-modules="remote"`.