resolved.conf.xml revision b975b0d514321f169b3c4599a8ea92e13741b4e4
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering This file is part of systemd.
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering Copyright 2014 Tom Gundersen
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering systemd is free software; you can redistribute it and/or modify it
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering under the terms of the GNU Lesser General Public License as published by
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering the Free Software Foundation; either version 2.1 of the License, or
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering (at your option) any later version.
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering systemd is distributed in the hope that it will be useful, but
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering Lesser General Public License for more details.
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering You should have received a copy of the GNU Lesser General Public License
a8eedf4953d379dc09ee2b04e69a0a54ba247a02Lennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
6a70f3aa63a3b7a6a30448c48322ad38b719cdceZbigniew Jędrzejewski-Szmek<refentry id="resolved.conf" conditional='ENABLE_RESOLVED'
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek xmlns:xi="http://www.w3.org/2001/XInclude">
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <productname>systemd</productname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>resolved.conf</refentrytitle>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refname>resolved.conf</refname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refname>resolved.conf.d</refname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refpurpose>Network Name Resolution configuration files</refpurpose>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>/etc/systemd/resolved.conf</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>/etc/systemd/resolved.conf.d/*.conf</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>/run/systemd/resolved.conf.d/*.conf</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>/usr/lib/systemd/resolved.conf.d/*.conf</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>These configuration files control local DNS and LLMNR
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek name resolving.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <xi:include href="standard-conf.xml" xpointer="confd" />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <xi:include href="standard-conf.xml" xpointer="conf" />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>DNS=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>A space separated list of IPv4 and IPv6
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek addresses to be used as system DNS servers. DNS requests are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek sent to one of the listed DNS servers in parallel to any
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek per-interface DNS servers acquired from
eb86030ec0e53ef3834d1b230440e88fdf020e9dLennart Poettering <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
eb86030ec0e53ef3834d1b230440e88fdf020e9dLennart Poettering For compatibility reasons, if set to the empty list the DNS
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek servers listed in <filename>/etc/resolv.conf</filename> are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek used, if any are configured there. This setting defaults to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the empty list.</para></listitem>
39fd5b08a73f144a20202a665bd25cad51d8a90bJan Synacek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>A space separated list of IPv4 and IPv6
39fd5b08a73f144a20202a665bd25cad51d8a90bJan Synacek addresses to be used as the fallback DNS servers. Any
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek per-interface DNS servers obtained from
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek take precedence over this setting, as do any servers set via
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varname>DNS=</varname> above or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/etc/resolv.conf</filename>. This setting is hence
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek only used if no other DNS server information is known. If this
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek option is not given, a compiled-in list of DNS servers is used
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>LLMNR=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Takes a boolean argument or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>resolve</literal>. Controls Link-Local Multicast Name
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Resolution support (<ulink
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek url="https://tools.ietf.org/html/rfc4795">RFC 4794</ulink>) on
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the local host. If true enables full LLMNR responder and
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek resolver support. If false disable both. If set to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>resolve</literal> only resolving support is enabled,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek but responding is disabled. Note that
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek also maintains per-interface LLMNR settings. LLMNR will be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek enabled on an interface only if the per-interface and the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek global setting is on.</para></listitem>
eb86030ec0e53ef3834d1b230440e88fdf020e9dLennart Poettering </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-resolved.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
39fd5b08a73f144a20202a665bd25cad51d8a90bJan Synacek <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
39fd5b08a73f144a20202a665bd25cad51d8a90bJan Synacek <citerefentry><refentrytitle>resolv.conf</refentrytitle><manvolnum>4</manvolnum></citerefentry>