mirror of
				https://github.com/coredns/coredns.git
				synced 2025-11-03 02:33:21 -05:00 
			
		
		
		
	
		
			
				
	
	
		
			85 lines
		
	
	
		
			1.3 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			85 lines
		
	
	
		
			1.3 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
.\" 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
 | 
						|
 |