Debian Codegraph @

upstream/debian-unstable/man5/systemd.dns-delegate.5

raw
1 '\" t
2 .TH "SYSTEMD\&.DNS\-DELEGATE" "5" "" "systemd 261~rc3" "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 .PP
70 \fIFirewallMark=\fR
71 .RS 4
72 Takes a 32 bit unsigned integer value\&. Controls the firewall mark of packets generated by the socket used to make DNS requests for this DNS delegate\&. This can be used in the firewall logic to filter packets from this socket\&. This sets the
73 \fBSO_MARK\fR
74 socket option\&. See
75 \fBiptables\fR(8)
76 for details\&.
77 .sp
78 Added in version 260\&.
79 .RE
80 .SH "EXAMPLES"
81 .PP
82 \fBExample\ \&1.\ \&\fR
83 .sp
84 .if n \{\
85 .RS 4
86 .\}
87 .nf
88 # /etc/systemd/dns\-delegate\&.d/foobar\&.dns\-delegate
89 [Delegate]
90 DNS=203\&.0\&.113\&.47
91 Domains=foobar\&.com
92 FirewallMark=42
93 .fi
94 .if n \{\
95 .RE
96 .\}
97 .PP
98 This ensures lookups of
99 "foobar\&.com"
100 and any domains below it are directed to DNS server 203\&.0\&.113\&.47 and any packets related to this lookup have a firewall mark set to 42\&.
101 .SH "SEE ALSO"
102 .PP
103 \fBsystemd\fR(1), \fBsystemd-resolved.service\fR(8), \fBresolved.conf\fR(5), \fBresolvectl\fR(1)