summaryrefslogtreecommitdiff
path: root/man/resolved.conf.xml
blob: 6e0185bf411f32030879adcad54b8c6d159b5343 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
<?xml version='1.0'?> <!--*-nxml-*-->
<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<!--
  This file is part of systemd.

  Copyright 2014 Tom Gundersen

  systemd is free software; you can redistribute it and/or modify it
  under the terms of the GNU Lesser General Public License as published by
  the Free Software Foundation; either version 2.1 of the License, or
  (at your option) any later version.

  systemd is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General Public License
  along with systemd; If not, see <http://www.gnu.org/licenses/>.
-->

<refentry id="resolved.conf" conditional='ENABLE_RESOLVED'>
        <refentryinfo>
                <title>resolved.conf</title>
                <productname>systemd</productname>

                <authorgroup>
                        <author>
                                <contrib>Developer</contrib>
                                <firstname>Tom</firstname>
                                <surname>Gundersen</surname>
                                <email>teg@jklm.no</email>
                        </author>
                </authorgroup>
        </refentryinfo>

        <refmeta>
                <refentrytitle>resolved.conf</refentrytitle>
                <manvolnum>5</manvolnum>
        </refmeta>

        <refnamediv>
                <refname>resolved.conf</refname>
                <refpurpose>Network Name Resolution configuration file</refpurpose>
        </refnamediv>

        <refsynopsisdiv>
                <para><filename>/etc/systemd/resolved.conf</filename></para>
        </refsynopsisdiv>

        <refsect1>
                <title>Description</title>

                <para>When starting, systemd-resolved will read the
                configuration file <filename>resolved.conf</filename>.
                This configuration file controls local DNS name
                resolving.</para>

        </refsect1>

        <refsect1>
                <title>Options</title>

                <variablelist class='network-directives'>

                        <varlistentry>
                                <term><varname>DNS=</varname></term>
                                <listitem><para>A space separated list
                                of IPv4 and IPv6 addresses to be used
                                as system DNS servers. DNS requests
                                are sent to one of the listed DNS
                                servers in parallel to any
                                per-interface DNS servers acquired
                                from
                                <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>. For
                                compatibility reasons, if set to the
                                empty list the DNS servers listed in
                                <filename>/etc/resolv.conf</filename>
                                are used, if any are
                                configured there. This setting
                                defaults to the empty
                                list.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>FallbackDNS=</varname></term>
                                <listitem><para>A space separated list
                                of IPv4 and IPv6 addresses to be used
                                as the fallback DNS servers. Any
                                per-interface DNS servers obtained
                                from
                                <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
                                take precedence over this setting, as
                                do any servers set via
                                <varname>DNS=</varname> above or
                                <filename>/etc/resolv.conf</filename>. This
                                setting is hence only used if no other
                                DNS server information is known. If
                                this option is not given, a
                                compiled-in list of DNS servers is
                                used instead.</para></listitem>
                        </varlistentry>

                        <varlistentry>
                                <term><varname>LLMNR=</varname></term>
                                <listitem><para>Takes a boolean
                                argument or
                                <literal>resolve</literal>. Controls
                                Link-Local Multicast Name Resolution support (<ulink
                                url="https://tools.ietf.org/html/rfc4795">RFC
                                4794</ulink>) on the local host. If
                                true enables full LLMNR responder and
                                resolver support. If false disable
                                both. If set to
                                <literal>resolve</literal> only
                                resolving support is enabled, but
                                responding is disabled. Note that
                                <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
                                also maintains per-interface LLMNR
                                settings. LLMNR will be enabled on an
                                interface only if the per-interface
                                and the global setting is
                                on.</para></listitem>
                        </varlistentry>

                </variablelist>
        </refsect1>

        <refsect1>
                  <title>See Also</title>
                  <para>
                        <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>systemd-resolved.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>resolv.conf</refentrytitle><manvolnum>4</manvolnum></citerefentry>
                  </para>
        </refsect1>

</refentry>