coredns/man/coredns-header.7

.\" 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