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="confd" />
  67   <xi:include href="standard-conf.xml" xpointer="conf" />
  68
  69   <refsect1>
  70     <title>Options</title>
  71
  72     <variablelist class='network-directives'>
  73
  74       <varlistentry>
  75         <term><varname>DNS=</varname></term>
  76         <listitem><para>A space separated list of IPv4 and IPv6
  77         addresses to be used as system DNS servers. DNS requests are
  78         sent to one of the listed DNS servers in parallel to any
  79         per-interface DNS servers acquired from
  80         <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
  81         For compatibility reasons, if set to the empty list the DNS
  82         servers listed in <filename>/etc/resolv.conf</filename> are
  83         used, if any are configured there. This setting defaults to
  84         the empty list.</para></listitem>
  85       </varlistentry>
  86
  87       <varlistentry>
  88         <term><varname>FallbackDNS=</varname></term>
  89         <listitem><para>A space separated list of IPv4 and IPv6
  90         addresses to be used as the fallback DNS servers. Any
  91         per-interface DNS servers obtained from
  92         <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  93         take precedence over this setting, as do any servers set via
  94         <varname>DNS=</varname> above or
  95         <filename>/etc/resolv.conf</filename>. This setting is hence
  96         only used if no other DNS server information is known. If this
  97         option is not given, a compiled-in list of DNS servers is used
  98         instead.</para></listitem>
  99       </varlistentry>
 100
 101       <varlistentry>
 102         <term><varname>LLMNR=</varname></term>
 103         <listitem><para>Takes a boolean argument or
 104         <literal>resolve</literal>. Controls Link-Local Multicast Name
 105         Resolution support (<ulink
 106         url="https://tools.ietf.org/html/rfc4795">RFC 4794</ulink>) on
 107         the local host. If true enables full LLMNR responder and
 108         resolver support. If false disable both. If set to
 109         <literal>resolve</literal> only resolving support is enabled,
 110         but responding is disabled. Note that
 111         <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
 112         also maintains per-interface LLMNR settings. LLMNR will be
 113         enabled on an interface only if the per-interface and the
 114         global setting is on.</para></listitem>
 115       </varlistentry>
 116
 117     </variablelist>
 118   </refsect1>
 119
 120   <refsect1>
 121       <title>See Also</title>
 122       <para>
 123       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 124       <citerefentry><refentrytitle>systemd-resolved.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 125       <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 126       <citerefentry><refentrytitle>resolv.conf</refentrytitle><manvolnum>4</manvolnum></citerefentry>
 127       </para>
 128   </refsect1>
 129
 130 </refentry>