auto make -f Makefile.doc

Signed-off-by: coredns[bot] <bot@bot.coredns.io>

man/coredns-header.7

@@ -0,0 +1,84 @@
+.\" Generated by Mmark Markdown Processer - mmark.miek.nl
+.TH "COREDNS-HEADER" 7 "July 2021" "CoreDNS" "CoreDNS Plugins"
+
+.SH "NAME"
+.PP
+\fIheader\fP - modifies the header for responses.
+
+.SH "DESCRIPTION"
+.PP
+\fIheader\fP ensures that the flags are in the desired state for responses. The modifications are made transparently for
+the client.
+
+.SH "SYNTAX"
+.PP
+.RS
+
+.nf
+header {
+    ACTION FLAGS...
+    ACTION FLAGS...
+}
+
+.fi
+.RE
+
+.IP \(bu 4
+\fBACTION\fP defines the state for DNS message header flags. Actions are evaluated in the order they are defined so last one has the
+most precedence. Allowed values are:
+
+.RS
+.IP \(en 4
+\fB\fCset\fR
+.IP \(en 4
+\fB\fCclear\fR
+
+.RE
+.IP \(bu 4
+\fBFLAGS\fP are the DNS header flags that will be modified. Current supported flags include:
+
+.RS
+.IP \(en 4
+\fB\fCaa\fR - Authoritative(Answer)
+.IP \(en 4
+\fB\fCra\fR - RecursionAvailable
+.IP \(en 4
+\fB\fCrd\fR - RecursionDesired
+
+.RE
+
+
+.SH "EXAMPLES"
+.PP
+Make sure recursive available \fB\fCra\fR flag is set in all the responses:
+
+.PP
+.RS
+
+.nf
+\&. {
+    header {
+        set ra
+    }
+}
+
+.fi
+.RE
+
+.PP
+Make sure "recursion available" \fB\fCra\fR and "authoritative answer" \fB\fCaa\fR flags are set and "recursion desired" is cleared in all responses:
+
+.PP
+.RS
+
+.nf
+\&. {
+    header {
+        set ra aa
+        clear rd
+    }
+}
+
+.fi
+.RE
+