man/resolved.conf.xml

   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">
   5
   6 <!--
   7   This file is part of systemd.
   8
   9   Copyright 2014 Tom Gundersen
  10
  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.
  15
  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.
  20
  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/>.
  23 -->
  24
  25 <refentry id="resolved.conf" conditional='ENABLE_RESOLVED'
  26     xmlns:xi="http://www.w3.org/2001/XInclude">
  27   <refentryinfo>
  28     <title>resolved.conf</title>
  29     <productname>systemd</productname>
  30
  31     <authorgroup>
  32       <author>
  33         <contrib>Developer</contrib>
  34         <firstname>Tom</firstname>
  35         <surname>Gundersen</surname>
  36         <email>teg@jklm.no</email>
  37       </author>
  38     </authorgroup>
  39   </refentryinfo>
  40
  41   <refmeta>
  42     <refentrytitle>resolved.conf</refentrytitle>
  43     <manvolnum>5</manvolnum>
  44   </refmeta>
  45
  46   <refnamediv>
  47     <refname>resolved.conf</refname>
  48     <refname>resolved.conf.d</refname>
  49     <refpurpose>Network Name Resolution configuration files</refpurpose>
  50   </refnamediv>
  51
  52   <refsynopsisdiv>
  53     <para><filename>/etc/systemd/resolved.conf</filename></para>
  54     <para><filename>/etc/systemd/resolved.conf.d/*.conf</filename></para>
  55     <para><filename>/run/systemd/resolved.conf.d/*.conf</filename></para>
  56     <para><filename>/usr/lib/systemd/resolved.conf.d/*.conf</filename></para>
  57   </refsynopsisdiv>
  58
  59   <refsect1>
  60     <title>Description</title>
  61
  62     <para>These configuration files control local DNS and LLMNR
  63     name resolving.</para>
  64
  65   </refsect1>
  66
  67   <xi:include href="standard-conf.xml" xpointer="confd" />
  68   <xi:include href="standard-conf.xml" xpointer="conf" />
  69
  70   <refsect1>
  71     <title>Options</title>
  72
  73     <variablelist class='network-directives'>
  74
  75       <varlistentry>
  76         <term><varname>DNS=</varname></term>
  77         <listitem><para>A space separated list of IPv4 and IPv6
  78         addresses to be used as system DNS servers. DNS requests are
  79         sent to one of the listed DNS servers in parallel to any
  80         per-interface DNS servers acquired from
  81         <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
  82         For compatibility reasons, if set to the empty list the DNS
  83         servers listed in <filename>/etc/resolv.conf</filename> are
  84         used, if any are configured there. This setting defaults to
  85         the empty list.</para></listitem>
  86       </varlistentry>
  87
  88       <varlistentry>
  89         <term><varname>FallbackDNS=</varname></term>
  90         <listitem><para>A space separated list of IPv4 and IPv6
  91         addresses to be used as the fallback DNS servers. Any
  92         per-interface DNS servers obtained from
  93         <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  94         take precedence over this setting, as do any servers set via
  95         <varname>DNS=</varname> above or
  96         <filename>/etc/resolv.conf</filename>. This setting is hence
  97         only used if no other DNS server information is known. If this
  98         option is not given, a compiled-in list of DNS servers is used
  99         instead.</para></listitem>
 100       </varlistentry>
 101
 102       <varlistentry>
 103         <term><varname>LLMNR=</varname></term>
 104         <listitem><para>Takes a boolean argument or
 105         <literal>resolve</literal>. Controls Link-Local Multicast Name
 106         Resolution support (<ulink
 107         url="https://tools.ietf.org/html/rfc4795">RFC 4794</ulink>) on
 108         the local host. If true enables full LLMNR responder and
 109         resolver support. If false disable both. If set to
 110         <literal>resolve</literal> only resolving support is enabled,
 111         but responding is disabled. Note that
 112         <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 113         also maintains per-interface LLMNR settings. LLMNR will be
 114         enabled on an interface only if the per-interface and the
 115         global setting is on.</para></listitem>
 116       </varlistentry>
 117
 118     </variablelist>
 119   </refsect1>
 120
 121   <refsect1>
 122       <title>See Also</title>
 123       <para>
 124       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 125       <citerefentry><refentrytitle>systemd-resolved.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 126       <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 127       <citerefentry><refentrytitle>resolv.conf</refentrytitle><manvolnum>4</manvolnum></citerefentry>
 128       </para>
 129   </refsect1>
 130
 131 </refentry>