Debian Codegraph @

upstream/mageia-cauldron/man5/systemd.dns-delegate.5

raw
1 '\" t
2 .TH "SYSTEMD\&.DNS\-DELEGATE" "5" "" "systemd 258.7" "systemd.dns-delegate"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd.dns-delegate \- DNS Server Delegation Configuration
24 .SH "SYNOPSIS"
25 .PP
26 .RS 4
27 /etc/systemd/dns\-delegate\&.d/*\&.dns\-delegate
28 .RE
29 .RS 4
30 /run/systemd/dns\-delegate\&.d/*\&.dns\-delegate
31 .RE
32 .RS 4
33 /usr/local/lib/systemd/dns\-delegate\&.d/*\&.dns\-delegate
34 .RE
35 .RS 4
36 /usr/lib/systemd/dns\-delegate\&.d/*\&.dns\-delegate
37 .RE
38 .SH "DESCRIPTION"
39 .PP
40 *\&.dns\-delegate
41 files may be used to delegate DNS lookups in specific domains to specific DNS servers\&. These files are read by
42 \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
43 \fBsystemd\-resolved\fR
44 maintains anyway\&.
45 .SH "[DELEGATE] SECTION OPTIONS"
46 .PP
47 \fIDNS=\fR
48 .RS 4
49 Takes one or more DNS server specifications, in the same syntax as the option of the same name in
50 \fBresolved.conf\fR(5)\&.
51 .sp
52 Added in version 258\&.
53 .RE
54 .PP
55 \fIDomains=\fR
56 .RS 4
57 Takes one or more domain name specifications, in the same syntax as the option of the same name in
58 \fBresolved.conf\fR(5)\&.
59 .sp
60 Added in version 258\&.
61 .RE
62 .PP
63 \fIDefaultRoute=\fR
64 .RS 4
65 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\&.
66 .sp
67 Added in version 258\&.
68 .RE
69 .SH "EXAMPLES"
70 .PP
71 \fBExample\ \&1.\ \&\fR
72 .sp
73 .if n \{\
74 .RS 4
75 .\}
76 .nf
77 # /etc/systemd/dns\-delegate\&.d/foobar\&.dns\-delegate
78 [Delegate]
79 DNS=203\&.0\&.113\&.47
80 Domains=foobar\&.com
81 .fi
82 .if n \{\
83 .RE
84 .\}
85 .PP
86 This ensures lookups of
87 "foobar\&.com"
88 and any domains below it are directed to DNS server 203\&.0\&.113\&.47\&.
89 .SH "SEE ALSO"
90 .PP
91 \fBsystemd\fR(1), \fBsystemd-resolved.service\fR(8), \fBresolved.conf\fR(5), \fBresolvectl\fR(1)