man/systemd-delta.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   SPDX-License-Identifier: LGPL-2.1+
   7 -->
   8
   9 <refentry id="systemd-delta"
  10     xmlns:xi="http://www.w3.org/2001/XInclude">
  11
  12   <refentryinfo>
  13     <title>systemd-delta</title>
  14     <productname>systemd</productname>
  15
  16     <authorgroup>
  17       <author>
  18         <contrib>Developer</contrib>
  19         <firstname>Lennart</firstname>
  20         <surname>Poettering</surname>
  21         <email>lennart@poettering.net</email>
  22       </author>
  23     </authorgroup>
  24   </refentryinfo>
  25
  26   <refmeta>
  27     <refentrytitle>systemd-delta</refentrytitle>
  28     <manvolnum>1</manvolnum>
  29   </refmeta>
  30
  31   <refnamediv>
  32     <refname>systemd-delta</refname>
  33     <refpurpose>Find overridden configuration files</refpurpose>
  34   </refnamediv>
  35
  36   <refsynopsisdiv>
  37     <cmdsynopsis>
  38       <command>systemd-delta</command>
  39       <arg choice="opt" rep="repeat">OPTIONS</arg>
  40       <arg choice="opt" rep="repeat"><replaceable>PREFIX</replaceable><optional>/<replaceable>SUFFIX</replaceable></optional>|<replaceable>SUFFIX</replaceable></arg>
  41     </cmdsynopsis>
  42   </refsynopsisdiv>
  43
  44   <refsect1>
  45     <title>Description</title>
  46
  47     <para><command>systemd-delta</command> may be used to identify and
  48     compare configuration files that override other configuration
  49     files. Files in <filename>/etc</filename> have highest priority,
  50     files in <filename>/run</filename> have the second highest
  51     priority, …, files in <filename>/usr/lib</filename> have lowest
  52     priority. Files in a directory with higher priority override files
  53     with the same name in directories of lower priority. In addition,
  54     certain configuration files can have <literal>.d</literal>
  55     directories which contain "drop-in" files with configuration
  56     snippets which augment the main configuration file. "Drop-in"
  57     files can be overridden in the same way by placing files with the
  58     same name in a directory of higher priority (except that, in case
  59     of "drop-in" files, both the "drop-in" file name and the name of
  60     the containing directory, which corresponds to the name of the
  61     main configuration file, must match). For a fuller explanation,
  62     see
  63     <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
  64     </para>
  65
  66     <para>The command line argument will be split into a prefix and a
  67     suffix. Either is optional. The prefix must be one of the
  68     directories containing configuration files
  69     (<filename>/etc</filename>, <filename>/run</filename>,
  70     <filename>/usr/lib</filename>, …). If it is given, only
  71     overriding files contained in this directory will be shown.
  72     Otherwise, all overriding files will be shown. The suffix must be
  73     a name of a subdirectory containing configuration files like
  74     <filename>tmpfiles.d</filename>, <filename>sysctl.d</filename> or
  75     <filename>systemd/system</filename>. If it is given, only
  76     configuration files in this subdirectory (across all configuration
  77     paths) will be analyzed. Otherwise, all configuration files will
  78     be analyzed. If the command line argument is not given at all, all
  79     configuration files will be analyzed. See below for some
  80     examples.</para>
  81   </refsect1>
  82
  83   <refsect1>
  84     <title>Options</title>
  85
  86     <para>The following options are understood:</para>
  87
  88     <variablelist>
  89       <varlistentry>
  90         <term><option>-t</option></term>
  91         <term><option>--type=</option></term>
  92
  93         <listitem><para>When listing the differences, only list those
  94         that are asked for. The list itself is a comma-separated list
  95         of desired difference types.</para>
  96
  97         <para>Recognized types are:
  98
  99           <variablelist>
 100             <varlistentry>
 101               <term><varname>masked</varname></term>
 102
 103               <listitem><para>Show masked files</para></listitem>
 104             </varlistentry>
 105
 106             <varlistentry>
 107               <term><varname>equivalent</varname></term>
 108
 109               <listitem><para>Show overridden files that while
 110               overridden, do not differ in content.</para></listitem>
 111             </varlistentry>
 112
 113             <varlistentry>
 114               <term><varname>redirected</varname></term>
 115
 116               <listitem><para>Show files that are redirected to
 117               another.</para></listitem>
 118             </varlistentry>
 119
 120             <varlistentry>
 121               <term><varname>overridden</varname></term>
 122
 123               <listitem><para>Show overridden, and changed
 124               files.</para></listitem>
 125             </varlistentry>
 126
 127             <varlistentry>
 128               <term><varname>extended</varname></term>
 129
 130               <listitem><para>Show <filename>*.conf</filename> files
 131               in drop-in directories for units.</para></listitem>
 132             </varlistentry>
 133
 134             <varlistentry>
 135               <term><varname>unchanged</varname></term>
 136
 137               <listitem><para>Show unmodified files
 138               too.</para></listitem>
 139             </varlistentry>
 140           </variablelist>
 141         </para></listitem>
 142       </varlistentry>
 143
 144       <varlistentry>
 145         <term><option>--diff=</option></term>
 146
 147         <listitem><para>When showing modified files, when a file is
 148         overridden show a diff as well. This option takes a boolean
 149         argument. If omitted, it defaults to
 150         <option>true</option>.</para></listitem>
 151       </varlistentry>
 152
 153       <xi:include href="standard-options.xml" xpointer="help" />
 154       <xi:include href="standard-options.xml" xpointer="version" />
 155       <xi:include href="standard-options.xml" xpointer="no-pager" />
 156     </variablelist>
 157   </refsect1>
 158
 159   <refsect1>
 160     <title>Examples</title>
 161
 162     <para>To see all local configuration:</para>
 163     <programlisting>systemd-delta</programlisting>
 164
 165     <para>To see all runtime configuration:</para>
 166     <programlisting>systemd-delta /run</programlisting>
 167
 168     <para>To see all system unit configuration changes:</para>
 169     <programlisting>systemd-delta systemd/system</programlisting>
 170
 171     <para>To see all runtime "drop-in" changes for system units:</para>
 172     <programlisting>systemd-delta --type=extended /run/systemd/system</programlisting>
 173   </refsect1>
 174
 175   <refsect1>
 176     <title>Exit status</title>
 177
 178     <para>On success, 0 is returned, a non-zero failure code
 179     otherwise.</para>
 180   </refsect1>
 181
 182   <refsect1>
 183     <title>See Also</title>
 184     <para>
 185       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 186       <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
 187     </para>
 188   </refsect1>
 189
 190 </refentry>