Imported Upstream version 219

[systemd.git] / man / resolved.conf.5

'\" t
.TH "RESOLVED\&.CONF" "5" "" "systemd 219" "resolved.conf"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
resolved.conf, resolved.conf.d \- Network Name Resolution configuration files
.SH "SYNOPSIS"
.PP
/etc/systemd/resolved\&.conf
.PP
/etc/systemd/resolved\&.conf\&.d/*\&.conf
.PP
/run/systemd/resolved\&.conf\&.d/*\&.conf
.PP
/usr/lib/systemd/resolved\&.conf\&.d/*\&.conf
.SH "DESCRIPTION"
.PP
These configuration files control local DNS and LLMNR name resolving\&.
.SH "CONFIGURATION DIRECTORIES AND PRECEDENCE"
.PP
Configuration files are read from directories in
/etc/,
/run/, and
/usr/lib/, in order of precedence\&. Each configuration file in these configuration directories shall be named in the style of
\fIfilename\fR\&.conf\&. Files in
/etc/
override files with the same name in
/run/
and
/usr/lib/\&. Files in
/run/
override files with the same name in
/usr/lib/\&.
.PP
Packages should install their configuration files in
/usr/lib/\&. Files in
/etc/
are reserved for the local administrator, who may use this logic to override the configuration files installed by vendor packages\&. All configuration files are sorted by their filename in lexicographic order, regardless of which of the directories they reside in\&. If multiple files specify the same option, the entry in the file with the lexicographically latest name will take precedence\&. It is recommended to prefix all filenames with a two\-digit number and a dash, to simplify the ordering of the files\&.
.PP
If the administrator wants to disable a configuration file supplied by the vendor, the recommended way is to place a symlink to
/dev/null
in the configuration directory in
/etc/, with the same filename as the vendor configuration file\&.
.SH "CONFIGURATION FILE"
.PP
Configuration is also read from a single configuration file in
/etc/\&. This file is read before any of the configuration directories, and has the lowest precedence; entries in a file in any configuration directory override entries in the single configuration file\&.
.SH "OPTIONS"
.PP
\fIDNS=\fR
.RS 4
A space separated list of IPv4 and IPv6 addresses to be used as system DNS servers\&. DNS requests are sent to one of the listed DNS servers in parallel to any per\-interface DNS servers acquired from
\fBsystemd-networkd.service\fR(8)\&. For compatibility reasons, if set to the empty list the DNS servers listed in
/etc/resolv\&.conf
are used, if any are configured there\&. This setting defaults to the empty list\&.
.RE
.PP
\fIFallbackDNS=\fR
.RS 4
A space separated list of IPv4 and IPv6 addresses to be used as the fallback DNS servers\&. Any per\-interface DNS servers obtained from
\fBsystemd-networkd.service\fR(8)
take precedence over this setting, as do any servers set via
\fIDNS=\fR
above or
/etc/resolv\&.conf\&. This setting is hence only used if no other DNS server information is known\&. If this option is not given, a compiled\-in list of DNS servers is used instead\&.
.RE
.PP
\fILLMNR=\fR
.RS 4
Takes a boolean argument or
"resolve"\&. Controls Link\-Local Multicast Name Resolution support (\m[blue]\fBRFC 4794\fR\m[]\&\s-2\u[1]\d\s+2) on the local host\&. If true enables full LLMNR responder and resolver support\&. If false disable both\&. If set to
"resolve"
only resolving support is enabled, but responding is disabled\&. Note that
\fBsystemd-networkd.service\fR(8)
also maintains per\-interface LLMNR settings\&. LLMNR will be enabled on an interface only if the per\-interface and the global setting is on\&.
.RE
.SH "SEE ALSO"
.PP
\fBsystemd\fR(1),
\fBsystemd-resolved.service\fR(8),
\fBsystemd-networkd.service\fR(8),
\fBresolv.conf\fR(4)
.SH "NOTES"
.IP " 1." 4
RFC 4794
.RS 4
\%https://tools.ietf.org/html/rfc4795
.RE