man/resolved.conf.xml

   1 <?xml version='1.0'?> <!--*-nxml-*-->
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4
   5 <!--
   6   This file is part of systemd.
   7
   8   Copyright 2014 Tom Gundersen
   9
  10   systemd is free software; you can redistribute it and/or modify it
  11   under the terms of the GNU Lesser General Public License as published by
  12   the Free Software Foundation; either version 2.1 of the License, or
  13   (at your option) any later version.
  14
  15   systemd is distributed in the hope that it will be useful, but
  16   WITHOUT ANY WARRANTY; without even the implied warranty of
  17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18   Lesser General Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser General Public License
  21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  22 -->
  23
  24 <refentry id="resolved.conf" conditional='ENABLE_RESOLVED'
  25     xmlns:xi="http://www.w3.org/2001/XInclude">
  26   <refentryinfo>
  27     <title>resolved.conf</title>
  28     <productname>systemd</productname>
  29
  30     <authorgroup>
  31       <author>
  32         <contrib>Developer</contrib>
  33         <firstname>Tom</firstname>
  34         <surname>Gundersen</surname>
  35         <email>teg@jklm.no</email>
  36       </author>
  37     </authorgroup>
  38   </refentryinfo>
  39
  40   <refmeta>
  41     <refentrytitle>resolved.conf</refentrytitle>
  42     <manvolnum>5</manvolnum>
  43   </refmeta>
  44
  45   <refnamediv>
  46     <refname>resolved.conf</refname>
  47     <refname>resolved.conf.d</refname>
  48     <refpurpose>Network Name Resolution configuration files</refpurpose>
  49   </refnamediv>
  50
  51   <refsynopsisdiv>
  52     <para><filename>/etc/systemd/resolved.conf</filename></para>
  53     <para><filename>/etc/systemd/resolved.conf.d/*.conf</filename></para>
  54     <para><filename>/run/systemd/resolved.conf.d/*.conf</filename></para>
  55     <para><filename>/usr/lib/systemd/resolved.conf.d/*.conf</filename></para>
  56   </refsynopsisdiv>
  57
  58   <refsect1>
  59     <title>Description</title>
  60
  61     <para>These configuration files control local DNS and LLMNR
  62     name resolving.</para>
  63
  64   </refsect1>
  65
  66   <xi:include href="standard-conf.xml" xpointer="main-conf" />
  67
  68   <refsect1>
  69     <title>Options</title>
  70
  71     <variablelist class='network-directives'>
  72
  73       <varlistentry>
  74         <term><varname>DNS=</varname></term>
  75         <listitem><para>A space separated list of IPv4 and IPv6
  76         addresses to be used as system DNS servers. DNS requests are
  77         sent to one of the listed DNS servers in parallel to any
  78         per-interface DNS servers acquired from
  79         <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
  80         For compatibility reasons, if set to the empty list the DNS
  81         servers listed in <filename>/etc/resolv.conf</filename> are
  82         used, if any are configured there. This setting defaults to
  83         the empty list.</para></listitem>
  84       </varlistentry>
  85
  86       <varlistentry>
  87         <term><varname>FallbackDNS=</varname></term>
  88         <listitem><para>A space separated list of IPv4 and IPv6
  89         addresses to be used as the fallback DNS servers. Any
  90         per-interface DNS servers obtained from
  91         <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  92         take precedence over this setting, as do any servers set via
  93         <varname>DNS=</varname> above or
  94         <filename>/etc/resolv.conf</filename>. This setting is hence
  95         only used if no other DNS server information is known. If this
  96         option is not given, a compiled-in list of DNS servers is used
  97         instead.</para></listitem>
  98       </varlistentry>
  99
 100       <varlistentry>
 101         <term><varname>LLMNR=</varname></term>
 102         <listitem><para>Takes a boolean argument or
 103         <literal>resolve</literal>. Controls Link-Local Multicast Name
 104         Resolution support (<ulink
 105         url="https://tools.ietf.org/html/rfc4795">RFC 4794</ulink>) on
 106         the local host. If true enables full LLMNR responder and
 107         resolver support. If false disable both. If set to
 108         <literal>resolve</literal> only resolving support is enabled,
 109         but responding is disabled. Note that
 110         <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 111         also maintains per-interface LLMNR settings. LLMNR will be
 112         enabled on an interface only if the per-interface and the
 113         global setting is on.</para></listitem>
 114       </varlistentry>
 115
 116     </variablelist>
 117   </refsect1>
 118
 119   <refsect1>
 120       <title>See Also</title>
 121       <para>
 122       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 123       <citerefentry><refentrytitle>systemd-resolved.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 124       <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 125       <citerefentry><refentrytitle>resolv.conf</refentrytitle><manvolnum>4</manvolnum></citerefentry>
 126       </para>
 127   </refsect1>
 128
 129 </refentry>