'\" t
.TH "SYSTEMD\&.DNS\-DELEGATE" "5" "" "systemd 258" "systemd.dns-delegate"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
systemd.dns-delegate \- DNS Server Delegation Configuration
.SH "SYNOPSIS"
.PP
.RS 4
/etc/systemd/dns\-delegate\&.d/*\&.dns\-delegate
.RE
.RS 4
/run/systemd/dns\-delegate\&.d/*\&.dns\-delegate
.RE
.RS 4
/usr/local/lib/systemd/dns\-delegate\&.d/*\&.dns\-delegate
.RE
.RS 4
/usr/lib/systemd/dns\-delegate\&.d/*\&.dns\-delegate
.RE
.SH "DESCRIPTION"
.PP
*\&.dns\-delegate
files may be used to delegate DNS lookups in specific domains to specific DNS servers\&. These files are read by
\fBsystemd-resolved.service\fR(8)\&. Each such file defines a combination of one or more DNS servers and one or more DNS domains\&. Each such definition synthesizes a DNS lookup scope that ensure lookups below the specified domains are sent to the specified DNS servers, possibly in addition to any per\-interface scopes and the global scope that
\fBsystemd\-resolved\fR
maintains anyway\&.
.SH "[DELEGATE] SECTION OPTIONS"
.PP
\fIDNS=\fR
.RS 4
Takes one or more DNS server specifications, in the same syntax as the option of the same name in
\fBresolved.conf\fR(5)\&.
.sp
Added in version 258\&.
.RE
.PP
\fIDomains=\fR
.RS 4
Takes one or more domain name specifications, in the same syntax as the option of the same name in
\fBresolved.conf\fR(5)\&.
.sp
Added in version 258\&.
.RE
.PP
\fIDefaultRoute=\fR
.RS 4
Takes a boolean value, defaults to off\&. Controls whether this DNS server is a candidate for looking up records for which no better route exists\&.
.sp
Added in version 258\&.
.RE
.SH "EXAMPLES"
.PP
\fBExample\ \&1.\ \&\fR
.sp
.if n \{\
.RS 4
.\}
.nf
# /etc/systemd/dns\-delegate\&.d/foobar\&.dns\-delegate
[Delegate]
DNS=203\&.0\&.113\&.47
Domains=foobar\&.com
.fi
.if n \{\
.RE
.\}
.PP
This ensures lookups of
"foobar\&.com"
and any domains below it are directed to DNS server 203\&.0\&.113\&.47\&.
.SH "SEE ALSO"
.PP
\fBsystemd\fR(1), \fBsystemd-resolved.service\fR(8), \fBresolved.conf\fR(5), \fBresolvectl\fR(1)