1 <?xml version='1.0'?> <!--*-nxml-*-->
2 <?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
4 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
7 This file is part of systemd.
9 Copyright 2014 Tom Gundersen
11 systemd is free software; you can redistribute it and/or modify it
12 under the terms of the GNU Lesser General Public License as published by
13 the Free Software Foundation; either version 2.1 of the License, or
14 (at your option) any later version.
16 systemd is distributed in the hope that it will be useful, but
17 WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 Lesser General Public License for more details.
21 You should have received a copy of the GNU Lesser General Public License
22 along with systemd; If not, see <http://www.gnu.org/licenses/>.
25 <refentry id="resolved.conf" conditional='ENABLE_RESOLVED'>
27 <title>resolved.conf</title>
28 <productname>systemd</productname>
32 <contrib>Developer</contrib>
33 <firstname>Tom</firstname>
34 <surname>Gundersen</surname>
35 <email>teg@jklm.no</email>
41 <refentrytitle>resolved.conf</refentrytitle>
42 <manvolnum>5</manvolnum>
46 <refname>resolved.conf</refname>
47 <refpurpose>Network Name Resolution configuration file</refpurpose>
51 <para><filename>/etc/systemd/resolved.conf</filename></para>
55 <title>Description</title>
57 <para>When starting, systemd-resolved will read the
58 configuration file <filename>resolved.conf</filename>.
59 This configuration file controls local DNS and LLMNR
60 name resolving.</para>
65 <title>Options</title>
67 <variablelist class='network-directives'>
70 <term><varname>DNS=</varname></term>
71 <listitem><para>A space separated list
72 of IPv4 and IPv6 addresses to be used
73 as system DNS servers. DNS requests
74 are sent to one of the listed DNS
75 servers in parallel to any
76 per-interface DNS servers acquired
78 <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>. For
79 compatibility reasons, if set to the
80 empty list the DNS servers listed in
81 <filename>/etc/resolv.conf</filename>
83 configured there. This setting
85 list.</para></listitem>
89 <term><varname>FallbackDNS=</varname></term>
90 <listitem><para>A space separated list
91 of IPv4 and IPv6 addresses to be used
92 as the fallback DNS servers. Any
93 per-interface DNS servers obtained
95 <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
96 take precedence over this setting, as
97 do any servers set via
98 <varname>DNS=</varname> above or
99 <filename>/etc/resolv.conf</filename>. This
100 setting is hence only used if no other
101 DNS server information is known. If
102 this option is not given, a
103 compiled-in list of DNS servers is
104 used instead.</para></listitem>
108 <term><varname>LLMNR=</varname></term>
109 <listitem><para>Takes a boolean
111 <literal>resolve</literal>. Controls
112 Link-Local Multicast Name Resolution support (<ulink
113 url="https://tools.ietf.org/html/rfc4795">RFC
114 4794</ulink>) on the local host. If
115 true enables full LLMNR responder and
116 resolver support. If false disable
118 <literal>resolve</literal> only
119 resolving support is enabled, but
120 responding is disabled. Note that
121 <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
122 also maintains per-interface LLMNR
123 settings. LLMNR will be enabled on an
124 interface only if the per-interface
125 and the global setting is
126 on.</para></listitem>
133 <title>See Also</title>
135 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
136 <citerefentry><refentrytitle>systemd-resolved.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
137 <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
138 <citerefentry><refentrytitle>resolv.conf</refentrytitle><manvolnum>4</manvolnum></citerefentry>