2012-05-16 09:36:42 +08:00
|
|
|
<?xml version='1.0'?> <!--*-nxml-*-->
|
|
|
|
|
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
|
|
|
|
|
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
|
|
|
|
|
|
|
|
|
|
<!--
|
|
|
|
|
This file is part of systemd.
|
|
|
|
|
|
|
|
|
|
Copyright 2012 Lennart Poettering
|
|
|
|
|
|
|
|
|
|
systemd is free software; you can redistribute it and/or modify it
|
|
|
|
|
under the terms of the GNU Lesser General Public License as published by
|
|
|
|
|
the Free Software Foundation; either version 2.1 of the License, or
|
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
|
|
systemd is distributed in the hope that it will be useful, but
|
|
|
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
|
Lesser General Public License for more details.
|
|
|
|
|
|
|
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
|
|
|
|
along with systemd; If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
-->
|
|
|
|
|
|
2014-02-14 03:33:51 +08:00
|
|
|
<refentry id="systemd-delta"
|
|
|
|
|
xmlns:xi="http://www.w3.org/2001/XInclude">
|
2012-05-16 09:36:42 +08:00
|
|
|
|
|
|
|
|
<refentryinfo>
|
|
|
|
|
<title>systemd-delta</title>
|
|
|
|
|
<productname>systemd</productname>
|
|
|
|
|
|
|
|
|
|
<authorgroup>
|
|
|
|
|
<author>
|
|
|
|
|
<contrib>Developer</contrib>
|
|
|
|
|
<firstname>Lennart</firstname>
|
|
|
|
|
<surname>Poettering</surname>
|
|
|
|
|
<email>lennart@poettering.net</email>
|
|
|
|
|
</author>
|
|
|
|
|
</authorgroup>
|
|
|
|
|
</refentryinfo>
|
|
|
|
|
|
|
|
|
|
<refmeta>
|
|
|
|
|
<refentrytitle>systemd-delta</refentrytitle>
|
|
|
|
|
<manvolnum>1</manvolnum>
|
|
|
|
|
</refmeta>
|
|
|
|
|
|
|
|
|
|
<refnamediv>
|
|
|
|
|
<refname>systemd-delta</refname>
|
|
|
|
|
<refpurpose>Find overridden configuration files</refpurpose>
|
|
|
|
|
</refnamediv>
|
|
|
|
|
|
|
|
|
|
<refsynopsisdiv>
|
|
|
|
|
<cmdsynopsis>
|
2013-12-23 11:53:23 +08:00
|
|
|
<command>systemd-delta</command>
|
2014-02-15 11:07:22 +08:00
|
|
|
<arg choice="opt" rep="repeat">OPTIONS</arg>
|
|
|
|
|
<arg choice="opt" rep="repeat"><replaceable>PREFIX</replaceable><optional>/<replaceable>SUFFIX</replaceable></optional>|<replaceable>SUFFIX</replaceable></arg>
|
2012-05-16 09:36:42 +08:00
|
|
|
</cmdsynopsis>
|
|
|
|
|
</refsynopsisdiv>
|
|
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
|
<title>Description</title>
|
|
|
|
|
|
|
|
|
|
<para><command>systemd-delta</command> may be used to
|
2013-12-23 11:53:23 +08:00
|
|
|
identify and compare configuration files that override
|
|
|
|
|
other configuration files. Files in
|
|
|
|
|
<filename>/etc</filename> have highest priority, files
|
|
|
|
|
in <filename>/run</filename> have the second highest
|
|
|
|
|
priority, ..., files in <filename>/lib</filename> have
|
|
|
|
|
lowest priority. Files in a directory with higher
|
|
|
|
|
priority override files with the same name in
|
|
|
|
|
directories of lower priority. In addition, certain
|
|
|
|
|
configuration files can have <literal>.d</literal>
|
|
|
|
|
directories which contain "drop-in" files with
|
|
|
|
|
configuration snippets which augment the main
|
|
|
|
|
configuration file. "Drop-in" files can be overriden
|
|
|
|
|
in the same way by placing files with the same name in
|
|
|
|
|
a directory of higher priority (except that in case of
|
|
|
|
|
"drop-in" files, both the "drop-in" file name and the
|
|
|
|
|
name of the containing directory, which corresponds to
|
|
|
|
|
the name of the main configuration file, must match).
|
|
|
|
|
For a fuller explanation, see
|
|
|
|
|
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
|
2014-02-15 11:07:22 +08:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
<para>The command line argument will be split into a
|
|
|
|
|
prefix and a suffix. Either is optional. The prefix
|
|
|
|
|
must be one of the directories containing
|
|
|
|
|
configuration files (<filename>/etc</filename>,
|
|
|
|
|
<filename>/run</filename>,
|
|
|
|
|
<filename>/usr/lib</filename>, ...). If it is given,
|
|
|
|
|
only overriding files contained in this directory will
|
|
|
|
|
be shown. Otherwise, all overriding files will be
|
|
|
|
|
shown. The suffix must be a name of a subdirectory
|
|
|
|
|
containing configuration files like
|
|
|
|
|
<filename>tmpfiles.d</filename>,
|
|
|
|
|
<filename>sysctl.d</filename> or
|
|
|
|
|
<filename>systemd/system</filename>. If it is given,
|
|
|
|
|
only configuration files in this subdirectory (across
|
|
|
|
|
all configuration paths) will be analyzed. Otherwise,
|
|
|
|
|
all configuration files will be analyzed. If the
|
|
|
|
|
commandline argument is not given at all, all
|
|
|
|
|
configuration files will be analyzed. See below for
|
|
|
|
|
some examples.</para>
|
2012-05-16 09:36:42 +08:00
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
|
<title>Options</title>
|
|
|
|
|
|
|
|
|
|
<para>The following options are understood:</para>
|
|
|
|
|
|
|
|
|
|
<variablelist>
|
delta: Support filtering what type of deltas to show
Not everyone is interested in every kind of deltas (and some might
even be interested knowing which files do not have overrides), so this
here is an implementation of a --type=LIST... option for
systemd-delta, that makes it possible to filter what subset of deltas
we want.
The available modifiers are masked, equivalent, redirected, overriden,
and unchanged - they should be self explanatory, and the man page
explains them in a little more detail anyway.
As a side effect, in case of overriden files, the diff output was made
optional.
By default, everything is shown (with a diff, if appropriate) except
for completely unchanged files.
Signed-off-by: Gergely Nagy <algernon@balabit.hu>
2012-05-17 00:11:27 +08:00
|
|
|
<varlistentry>
|
|
|
|
|
<term><option>-t</option></term>
|
2013-02-13 17:39:22 +08:00
|
|
|
<term><option>--type=</option></term>
|
delta: Support filtering what type of deltas to show
Not everyone is interested in every kind of deltas (and some might
even be interested knowing which files do not have overrides), so this
here is an implementation of a --type=LIST... option for
systemd-delta, that makes it possible to filter what subset of deltas
we want.
The available modifiers are masked, equivalent, redirected, overriden,
and unchanged - they should be self explanatory, and the man page
explains them in a little more detail anyway.
As a side effect, in case of overriden files, the diff output was made
optional.
By default, everything is shown (with a diff, if appropriate) except
for completely unchanged files.
Signed-off-by: Gergely Nagy <algernon@balabit.hu>
2012-05-17 00:11:27 +08:00
|
|
|
|
|
|
|
|
<listitem><para>When listing the
|
|
|
|
|
differences, only list those that are
|
|
|
|
|
asked for. The list itself is a
|
|
|
|
|
comma-separated list of desired
|
|
|
|
|
difference types.</para>
|
|
|
|
|
|
2012-10-26 06:16:47 +08:00
|
|
|
<para>Recognized types are:
|
delta: Support filtering what type of deltas to show
Not everyone is interested in every kind of deltas (and some might
even be interested knowing which files do not have overrides), so this
here is an implementation of a --type=LIST... option for
systemd-delta, that makes it possible to filter what subset of deltas
we want.
The available modifiers are masked, equivalent, redirected, overriden,
and unchanged - they should be self explanatory, and the man page
explains them in a little more detail anyway.
As a side effect, in case of overriden files, the diff output was made
optional.
By default, everything is shown (with a diff, if appropriate) except
for completely unchanged files.
Signed-off-by: Gergely Nagy <algernon@balabit.hu>
2012-05-17 00:11:27 +08:00
|
|
|
|
|
|
|
|
<variablelist>
|
|
|
|
|
<varlistentry>
|
|
|
|
|
<term><varname>masked</varname></term>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Show masked files</para></listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
|
<term><varname>equivalent</varname></term>
|
|
|
|
|
|
2012-05-17 04:49:30 +08:00
|
|
|
<listitem><para>Show overridden
|
|
|
|
|
files that while overridden, do
|
delta: Support filtering what type of deltas to show
Not everyone is interested in every kind of deltas (and some might
even be interested knowing which files do not have overrides), so this
here is an implementation of a --type=LIST... option for
systemd-delta, that makes it possible to filter what subset of deltas
we want.
The available modifiers are masked, equivalent, redirected, overriden,
and unchanged - they should be self explanatory, and the man page
explains them in a little more detail anyway.
As a side effect, in case of overriden files, the diff output was made
optional.
By default, everything is shown (with a diff, if appropriate) except
for completely unchanged files.
Signed-off-by: Gergely Nagy <algernon@balabit.hu>
2012-05-17 00:11:27 +08:00
|
|
|
not differ in content.</para></listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
|
<term><varname>redirected</varname></term>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Show files that
|
|
|
|
|
are redirected to another.</para></listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
<varlistentry>
|
2012-05-17 04:49:30 +08:00
|
|
|
<term><varname>overridden</varname></term>
|
delta: Support filtering what type of deltas to show
Not everyone is interested in every kind of deltas (and some might
even be interested knowing which files do not have overrides), so this
here is an implementation of a --type=LIST... option for
systemd-delta, that makes it possible to filter what subset of deltas
we want.
The available modifiers are masked, equivalent, redirected, overriden,
and unchanged - they should be self explanatory, and the man page
explains them in a little more detail anyway.
As a side effect, in case of overriden files, the diff output was made
optional.
By default, everything is shown (with a diff, if appropriate) except
for completely unchanged files.
Signed-off-by: Gergely Nagy <algernon@balabit.hu>
2012-05-17 00:11:27 +08:00
|
|
|
|
2012-05-17 04:49:30 +08:00
|
|
|
<listitem><para>Show overridden,
|
delta: Support filtering what type of deltas to show
Not everyone is interested in every kind of deltas (and some might
even be interested knowing which files do not have overrides), so this
here is an implementation of a --type=LIST... option for
systemd-delta, that makes it possible to filter what subset of deltas
we want.
The available modifiers are masked, equivalent, redirected, overriden,
and unchanged - they should be self explanatory, and the man page
explains them in a little more detail anyway.
As a side effect, in case of overriden files, the diff output was made
optional.
By default, everything is shown (with a diff, if appropriate) except
for completely unchanged files.
Signed-off-by: Gergely Nagy <algernon@balabit.hu>
2012-05-17 00:11:27 +08:00
|
|
|
and changed files.</para></listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
2013-05-16 17:09:03 +08:00
|
|
|
<varlistentry>
|
|
|
|
|
<term><varname>extended</varname></term>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Show *.conf files in drop-in
|
|
|
|
|
directories for units.</para></listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
delta: Support filtering what type of deltas to show
Not everyone is interested in every kind of deltas (and some might
even be interested knowing which files do not have overrides), so this
here is an implementation of a --type=LIST... option for
systemd-delta, that makes it possible to filter what subset of deltas
we want.
The available modifiers are masked, equivalent, redirected, overriden,
and unchanged - they should be self explanatory, and the man page
explains them in a little more detail anyway.
As a side effect, in case of overriden files, the diff output was made
optional.
By default, everything is shown (with a diff, if appropriate) except
for completely unchanged files.
Signed-off-by: Gergely Nagy <algernon@balabit.hu>
2012-05-17 00:11:27 +08:00
|
|
|
<varlistentry>
|
|
|
|
|
<term><varname>unchanged</varname></term>
|
|
|
|
|
|
|
|
|
|
<listitem><para>Show unmodified
|
|
|
|
|
files too.</para></listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
</variablelist>
|
|
|
|
|
</para></listitem>
|
|
|
|
|
</varlistentry>
|
|
|
|
|
|
|
|
|
|
<varlistentry>
|
|
|
|
|
<term><option>--diff=</option></term>
|
|
|
|
|
|
|
|
|
|
<listitem><para>When showing modified
|
2012-05-17 04:49:30 +08:00
|
|
|
files, when a file is overridden show a
|
2012-07-15 16:41:40 +08:00
|
|
|
diff as well. This option takes a
|
2013-09-13 03:12:49 +08:00
|
|
|
boolean argument. If omitted, it defaults
|
2012-11-13 05:34:47 +08:00
|
|
|
to <option>true</option>.</para></listitem>
|
delta: Support filtering what type of deltas to show
Not everyone is interested in every kind of deltas (and some might
even be interested knowing which files do not have overrides), so this
here is an implementation of a --type=LIST... option for
systemd-delta, that makes it possible to filter what subset of deltas
we want.
The available modifiers are masked, equivalent, redirected, overriden,
and unchanged - they should be self explanatory, and the man page
explains them in a little more detail anyway.
As a side effect, in case of overriden files, the diff output was made
optional.
By default, everything is shown (with a diff, if appropriate) except
for completely unchanged files.
Signed-off-by: Gergely Nagy <algernon@balabit.hu>
2012-05-17 00:11:27 +08:00
|
|
|
</varlistentry>
|
|
|
|
|
|
2014-02-14 03:33:51 +08:00
|
|
|
<xi:include href="standard-options.xml" xpointer="help" />
|
|
|
|
|
<xi:include href="standard-options.xml" xpointer="version" />
|
|
|
|
|
<xi:include href="standard-options.xml" xpointer="no-pager" />
|
2012-05-16 09:36:42 +08:00
|
|
|
</variablelist>
|
|
|
|
|
</refsect1>
|
|
|
|
|
|
2014-02-15 11:07:22 +08:00
|
|
|
<refsect1>
|
|
|
|
|
<title>Examples</title>
|
2013-12-23 11:53:23 +08:00
|
|
|
|
2014-02-15 11:07:22 +08:00
|
|
|
<para>To see all local configuration:</para>
|
|
|
|
|
<programlisting>systemd-delta</programlisting>
|
2013-12-23 11:53:23 +08:00
|
|
|
|
2014-02-15 11:07:22 +08:00
|
|
|
<para>To see all runtime configuration:</para>
|
|
|
|
|
<programlisting>systemd-delta /run</programlisting>
|
2013-12-23 11:53:23 +08:00
|
|
|
|
2014-02-15 11:07:22 +08:00
|
|
|
<para>To see all system unit configuration changes:</para>
|
|
|
|
|
<programlisting>systemd-delta systemd/system</programlisting>
|
2013-12-23 11:53:23 +08:00
|
|
|
|
2014-02-15 11:07:22 +08:00
|
|
|
<para>To see all runtime "drop-in" changes for system units:</para>
|
|
|
|
|
<programlisting>systemd-delta --type=extended /run/systemd/system</programlisting>
|
|
|
|
|
</refsect1>
|
2013-12-23 11:53:23 +08:00
|
|
|
|
2012-05-16 09:36:42 +08:00
|
|
|
<refsect1>
|
|
|
|
|
<title>Exit status</title>
|
|
|
|
|
|
2013-12-26 09:47:44 +08:00
|
|
|
<para>On success, 0 is returned, a non-zero failure
|
2012-05-16 09:36:42 +08:00
|
|
|
code otherwise.</para>
|
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
|
|
<refsect1>
|
|
|
|
|
<title>See Also</title>
|
|
|
|
|
<para>
|
2013-12-23 11:53:23 +08:00
|
|
|
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
|
|
|
|
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
|
2012-05-16 09:36:42 +08:00
|
|
|
</para>
|
|
|
|
|
</refsect1>
|
|
|
|
|
|
|
|
|
|
</refentry>
|
