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