From b886969c20f038e307f6816620d08f4c7882a40c Mon Sep 17 00:00:00 2001
From: "coredns[bot]" <bot@coredns.io>
Date: Sun, 30 Aug 2026 10:27:40 +0000
Subject: [PATCH] auto make -f Makefile.doc

Signed-off-by: coredns[bot] <bot@coredns.io>
---
 man/coredns-siit.7 | 84 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 man/coredns-siit.7

diff --git a/man/coredns-siit.7 b/man/coredns-siit.7
new file mode 100644
index 000000000..b405e3d72
--- /dev/null
+++ b/man/coredns-siit.7
@@ -0,0 +1,84 @@
+.\" Generated by Mmark Markdown Processor - mmark.miek.nl
+.TH "COREDNS-SIIT" 7 "August 2026" "CoreDNS" "CoreDNS Plugins"
+
+.SH "NAME"
+.PP
+\fIsiit\fP \- enables AAAA\->A translation support for DNS records based on SIIT (IPv6\->IPv4 translation).
+
+.SH "DESCRIPTION"
+.PP
+The \fIsiit\fP plugin will when asked for a domain's A record,
+synthesizes it from a corresponding AAAA record if it belongs to a certain IP range.
+
+.PP
+It also supports arbitrary mapping IPv6\->IPv4.
+
+.PP
+It is useful when published services are IPv6\-only and emit their AAAA record accordingly
+but IPv4 clients reach them through a siit routing. This plugin generates the associated A records
+for these clients automatically.
+
+.SH "SYNTAX"
+.PP
+.RS
+
+.nf
+siit {
+    ipv6\_prefix IPV6PREFIX
+    eam IPV4 IPV6
+}
+
+.fi
+.RE
+
+.IP \(bu 4
+\fB\fCipv6_prefix\fR specifies any local IPv6 prefix to use, instead of the well known prefix (64:ff9b::/96)
+.IP \(bu 4
+\fB\fCeam\fR translates the ipv6 to the corresponding ipv4, it can be set multiple times
+
+
+.SH "EXAMPLES"
+.PP
+.RS
+
+.nf
+\&. {
+    siit {
+        ipv6\_prefix 64:1337::/96
+    }
+}
+
+.fi
+.RE
+
+.SH "METRICS"
+.PP
+If monitoring is enabled (via the \fIprometheus\fP plugin) then the following metrics are exported:
+
+.IP \(bu 4
+\fB\fCcoredns_siit_requests_translated_total{server}\fR \- counter of DNS requests translated
+
+
+.PP
+The \fB\fCserver\fR label is explained in the \fIprometheus\fP plugin documentation.
+
+.SH "BUGS"
+.IP \(bu 4
+Prefix matching in eam is not implemented yet.
+.IP \(bu 4
+DNSSEC support is not implemented yet. The problem is the same as DNS64. See: RFC 6147 Section 3
+\[la]https://tools.ietf.org/html/rfc6147#section-3\[ra]
+
+
+.SH "SEE ALSO"
+.PP
+See RFC 6052
+\[la]https://tools.ietf.org/html/rfc6052\[ra] for more information on the SIIT mechanism
+and RFC 7757
+\[la]https://tools.ietf.org/html/rfc7757\[ra] about the explicit address mappings (eam) mechanism
+
+.SH "NOTES"
+.PP
+This plugin is heavily based on dns64 plugin
+\[la]../dns64\[ra].
+