systemd-delta.xml revision 3f85ef0f05ffc51e19f86fb83a1c51e8e3cd6817
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering This file is part of systemd.
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering Copyright 2012 Lennart Poettering
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering systemd is free software; you can redistribute it and/or modify it
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering under the terms of the GNU Lesser General Public License as published by
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering the Free Software Foundation; either version 2.1 of the License, or
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering (at your option) any later version.
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering systemd is distributed in the hope that it will be useful, but
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering Lesser General Public License for more details.
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering You should have received a copy of the GNU Lesser General Public License
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering xmlns:xi="http://www.w3.org/2001/XInclude">
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <refentryinfo>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </authorgroup>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </refentryinfo>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <refentrytitle>systemd-delta</refentrytitle>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <refpurpose>Find overridden configuration files</refpurpose>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <refsynopsisdiv>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <arg choice="opt" rep="repeat">OPTIONS</arg>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <arg choice="opt" rep="repeat"><replaceable>PREFIX</replaceable><optional>/<replaceable>SUFFIX</replaceable></optional>|<replaceable>SUFFIX</replaceable></arg>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </cmdsynopsis>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </refsynopsisdiv>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <para><command>systemd-delta</command> may be used to
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering identify and compare configuration files that override
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering other configuration files. Files in
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <filename>/etc</filename> have highest priority, files
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering in <filename>/run</filename> have the second highest
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering priority, ..., files in <filename>/lib</filename> have
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering lowest priority. Files in a directory with higher
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering priority override files with the same name in
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering directories of lower priority. In addition, certain
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering configuration files can have <literal>.d</literal>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering directories which contain "drop-in" files with
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering configuration snippets which augment the main
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering configuration file. "Drop-in" files can be overriden
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering in the same way by placing files with the same name in
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering a directory of higher priority (except that in case of
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering "drop-in" files, both the "drop-in" file name and the
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering name of the containing directory, which corresponds to
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering the name of the main configuration file, must match).
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering For a fuller explanation, see
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <para>The command line argument will be split into a
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering prefix and a suffix. Either is optional. The prefix
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering must be one of the directories containing
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering configuration files (<filename>/etc</filename>,
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <filename>/usr/lib</filename>, ...). If it is given,
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering only overriding files contained in this directory will
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering be shown. Otherwise, all overriding files will be
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering shown. The suffix must be a name of a subdirectory
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering containing configuration files like
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <filename>systemd/system</filename>. If it is given,
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering only configuration files in this subdirectory (across
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering all configuration paths) will be analyzed. Otherwise,
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering all configuration files will be analyzed. If the
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering command line argument is not given at all, all
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering configuration files will be analyzed. See below for
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering some examples.</para>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <para>The following options are understood:</para>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <variablelist>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering differences, only list those that are
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering asked for. The list itself is a
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering comma-separated list of desired
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering difference types.</para>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <para>Recognized types are:
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <variablelist>
b8e1d4d183de0460a62b94f531b78e84ea6ef212Jakub Wilk <varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <listitem><para>Show masked files</para></listitem>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <term><varname>equivalent</varname></term>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering files that while overridden, do
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <term><varname>redirected</varname></term>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering are redirected to another.</para></listitem>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <term><varname>overridden</varname></term>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <term><varname>unchanged</varname></term>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </variablelist>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <varlistentry>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering files, when a file is overridden show a
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering diff as well. This option takes a
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering boolean argument. If omitted, it defaults
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering to <option>true</option>.</para></listitem>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering </varlistentry>
30c778094b90a637c6691c462a66df81eeb865b5Lennart Poettering <xi:include href="standard-options.xml" xpointer="help" />
30c778094b90a637c6691c462a66df81eeb865b5Lennart Poettering <xi:include href="standard-options.xml" xpointer="version" />
30c778094b90a637c6691c462a66df81eeb865b5Lennart Poettering <xi:include href="standard-options.xml" xpointer="no-pager" />
8a516214c4412e8a40544bd725a6d499a30cbbbfLennart Poettering </variablelist>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <para>To see all local configuration:</para>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <programlisting>systemd-delta</programlisting>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <para>To see all runtime configuration:</para>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <programlisting>systemd-delta /run</programlisting>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <para>To see all system unit configuration changes:</para>
8a516214c4412e8a40544bd725a6d499a30cbbbfLennart Poettering <programlisting>systemd-delta systemd/system</programlisting>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <para>To see all runtime "drop-in" changes for system units:</para>
b5a8703fdb8e16f760bfb730df64f07173bb881dLennart Poettering <programlisting>systemd-delta --type=extended /run/systemd/system</programlisting>