systemd-delta.xml revision ff9b60f38bf68eba4a47cabff14547d92e083214
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd This file is part of systemd.
3f08db06526d6901aa08c110b5bc7dde6bc39905nd Copyright 2012 Lennart Poettering
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim systemd is free software; you can redistribute it and/or modify it
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim under the terms of the GNU Lesser General Public License as published by
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen the Free Software Foundation; either version 2.1 of the License, or
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen (at your option) any later version.
d29d9ab4614ff992b0e8de6e2b88d52b6f1f153erbowen systemd is distributed in the hope that it will be useful, but
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim WITHOUT ANY WARRANTY; without even the implied warranty of
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd Lesser General Public License for more details.
3f08db06526d6901aa08c110b5bc7dde6bc39905nd You should have received a copy of the GNU Lesser General Public License
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim along with systemd; If not, see <http://www.gnu.org/licenses/>.
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <refentryinfo>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <authorgroup>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd </authorgroup>
3f08db06526d6901aa08c110b5bc7dde6bc39905nd </refentryinfo>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <refnamediv>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <refpurpose>Find overridden configuration files</refpurpose>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd </refnamediv>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <refsynopsisdiv>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <cmdsynopsis>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <arg choice="opt" rep="repeat"><replaceable>PREFIX</replaceable><optional>/<replaceable>SUFFIX</replaceable></optional>|<replaceable>SUFFIX</replaceable></arg>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd </cmdsynopsis>
63581ee088272ef76aa8d053609dc1705c222deesf </refsynopsisdiv>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <refsect1>
0745f050c4e7b9eeac73c7f10a528ce5015854bcrbowen <para><command>systemd-delta</command> may be used to identify and
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd compare configuration files that override other configuration
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd files. Files in <filename>/etc</filename> have highest priority,
4af55bbfdbff2cae0cd3195876c93ea991523d1fcolm files in <filename>/run</filename> have the second highest
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd priority, ..., files in <filename>/lib</filename> have lowest
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd priority. Files in a directory with higher priority override files
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd with the same name in directories of lower priority. In addition,
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd certain configuration files can have <literal>.d</literal>
64f23d7fddbd8bacb8c18434baedb5f1f86b432aminfrin directories which contain "drop-in" files with configuration
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd snippets which augment the main configuration file. "Drop-in"
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd files can be overridden in the same way by placing files with the
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd same name in a directory of higher priority (except that in case
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd of "drop-in" files, both the "drop-in" file name and the name of
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd the containing directory, which corresponds to the name of the
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd main configuration file, must match). For a fuller explanation,
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
1844bb5f7939bd31f51dffaf8d8cf1c00657a681rbowen <para>The command line argument will be split into a prefix and a
1844bb5f7939bd31f51dffaf8d8cf1c00657a681rbowen suffix. Either is optional. The prefix must be one of the
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd directories containing configuration files
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <filename>/usr/lib</filename>, ...). If it is given, only
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd overriding files contained in this directory will be shown.
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd Otherwise, all overriding files will be shown. The suffix must be
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd a name of a subdirectory containing configuration files like
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <filename>tmpfiles.d</filename>, <filename>sysctl.d</filename> or
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <filename>systemd/system</filename>. If it is given, only
664e667e221a15fa5f456e73948c67710f43f1b4minfrin configuration files in this subdirectory (across all configuration
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd paths) will be analyzed. Otherwise, all configuration files will
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd be analyzed. If the command line argument is not given at all, all
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd configuration files will be analyzed. See below for some
c5ac4f57bfd156a62495b9c6a049f05bbcb69acarbowen examples.</para>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd </refsect1>
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <variablelist>
ed1d958582984a7c54a6ca859e15939a414fa733nd <varlistentry>
7add1372edb1ee95a2c4d1314df4c7567bda7c62jim <listitem><para>When listing the differences, only list those
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd that are asked for. The list itself is a comma-separated list
7f5b59ccc63c0c0e3e678a168f09ee6a2f51f9d0nd of desired difference types.</para>
d474d8ef01ec5c2a09341cd148851ed383c3287crbowen <para>Recognized types are:
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <variablelist>
5effc8b39fae5cd169d17f342bfc265705840014rbowen <varlistentry>
7fec19672a491661b2fe4b29f685bc7f4efa64d4nd </varlistentry>
29fb68cf24dbdb4985cbb4734cb6074ea4bbab26nd <varlistentry>