man/systemd-delta.html

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>systemd-delta</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><style>
   2     a.headerlink {
   3       color: #c60f0f;
   4       font-size: 0.8em;
   5       padding: 0 4px 0 4px;
   6       text-decoration: none;
   7       visibility: hidden;
   8     }
   9
  10     a.headerlink:hover {
  11       background-color: #c60f0f;
  12       color: white;
  13     }
  14
  15     h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
  16       visibility: visible;
  17     }
  18   </style><a href="index.html">Index </a>·
  19   <a href="systemd.directives.html">Directives </a>·
  20   <a href="../python-systemd/index.html">Python </a>·
  21   <a href="../libudev/index.html">libudev </a>·
  22   <a href="../libudev/index.html">gudev </a><span style="float:right">systemd 218</span><hr><div class="refentry"><a name="systemd-delta"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>systemd-delta — Find overridden configuration files</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="command">systemd-delta</code>  [OPTIONS...] [<em class="replaceable"><code>PREFIX</code></em>[<span class="optional">/<em class="replaceable"><code>SUFFIX</code></em></span>]|<em class="replaceable"><code>SUFFIX</code></em>...]</p></div></div><div class="refsect1"><a name="idm140392342739136"></a><h2 id="Description">Description<a class="headerlink" title="Permalink to this headline" href="#Description">¶</a></h2><p><span class="command"><strong>systemd-delta</strong></span> may be used to
  23                 identify and compare configuration files that override
  24                 other configuration files. Files in
  25                 <code class="filename">/etc</code> have highest priority, files
  26                 in <code class="filename">/run</code> have the second highest
  27                 priority, ..., files in <code class="filename">/lib</code> have
  28                 lowest priority. Files in a directory with higher
  29                 priority override files with the same name in
  30                 directories of lower priority. In addition, certain
  31                 configuration files can have "<code class="literal">.d</code>"
  32                 directories which contain "drop-in" files with
  33                 configuration snippets which augment the main
  34                 configuration file. "Drop-in" files can be overriden
  35                 in the same way by placing files with the same name in
  36                 a directory of higher priority (except that in case of
  37                 "drop-in" files, both the "drop-in" file name and the
  38                 name of the containing directory, which corresponds to
  39                 the name of the main configuration file, must match).
  40                 For a fuller explanation, see
  41                 <a href="systemd.unit.html"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a>.
  42                 </p><p>The command line argument will be split into a
  43                 prefix and a suffix. Either is optional. The prefix
  44                 must be one of the directories containing
  45                 configuration files (<code class="filename">/etc</code>,
  46                 <code class="filename">/run</code>,
  47                 <code class="filename">/usr/lib</code>, ...). If it is given,
  48                 only overriding files contained in this directory will
  49                 be shown. Otherwise, all overriding files will be
  50                 shown. The suffix must be a name of a subdirectory
  51                 containing configuration files like
  52                 <code class="filename">tmpfiles.d</code>,
  53                 <code class="filename">sysctl.d</code> or
  54                 <code class="filename">systemd/system</code>. If it is given,
  55                 only configuration files in this subdirectory (across
  56                 all configuration paths) will be analyzed. Otherwise,
  57                 all configuration files will be analyzed. If the
  58                 command line argument is not given at all, all
  59                 configuration files will be analyzed. See below for
  60                 some examples.</p></div><div class="refsect1"><a name="idm140392343595552"></a><h2 id="Options">Options<a class="headerlink" title="Permalink to this headline" href="#Options">¶</a></h2><p>The following options are understood:</p><div class="variablelist"><dl class="variablelist"><dt id="-t"><span class="term"><code class="option">-t</code>, </span><span class="term"><code class="option">--type=</code></span><a class="headerlink" title="Permalink to this term" href="#-t">¶</a></dt><dd><p>When listing the
  61                                 differences, only list those that are
  62                                 asked for. The list itself is a
  63                                 comma-separated list of desired
  64                                 difference types.</p><p>Recognized types are:
  65
  66                                         </p><div class="variablelist"><dl class="variablelist"><dt id="masked"><span class="term"><code class="varname">masked</code></span><a class="headerlink" title="Permalink to this term" href="#masked">¶</a></dt><dd><p>Show masked files</p></dd><dt id="equivalent"><span class="term"><code class="varname">equivalent</code></span><a class="headerlink" title="Permalink to this term" href="#equivalent">¶</a></dt><dd><p>Show overridden
  67                                                         files that while overridden, do
  68                                                         not differ in content.</p></dd><dt id="redirected"><span class="term"><code class="varname">redirected</code></span><a class="headerlink" title="Permalink to this term" href="#redirected">¶</a></dt><dd><p>Show files that
  69                                                         are redirected to another.</p></dd><dt id="overridden"><span class="term"><code class="varname">overridden</code></span><a class="headerlink" title="Permalink to this term" href="#overridden">¶</a></dt><dd><p>Show overridden,
  70                                                         and changed files.</p></dd><dt id="extended"><span class="term"><code class="varname">extended</code></span><a class="headerlink" title="Permalink to this term" href="#extended">¶</a></dt><dd><p>Show *.conf files in drop-in
  71                                                         directories for units.</p></dd><dt id="unchanged"><span class="term"><code class="varname">unchanged</code></span><a class="headerlink" title="Permalink to this term" href="#unchanged">¶</a></dt><dd><p>Show unmodified
  72                                                         files too.</p></dd></dl></div><p>
  73                                 </p></dd><dt id="--diff="><span class="term"><code class="option">--diff=</code></span><a class="headerlink" title="Permalink to this term" href="#--diff=">¶</a></dt><dd><p>When showing modified
  74                                 files, when a file is overridden show a
  75                                 diff as well. This option takes a
  76                                 boolean argument. If omitted, it defaults
  77                                 to <code class="option">true</code>.</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="#-h">¶</a></dt><dd><p><a name="help-text"></a>Print a short help text and exit.
  78     </p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="#--version">¶</a></dt><dd><p><a name="version-text"></a>Print a short version string and exit.</p></dd><dt id="--no-pager"><span class="term"><code class="option">--no-pager</code></span><a class="headerlink" title="Permalink to this term" href="#--no-pager">¶</a></dt><dd><p>Do not pipe output into a pager.</p></dd></dl></div></div><div class="refsect1"><a name="idm140392342190752"></a><h2 id="Examples">Examples<a class="headerlink" title="Permalink to this headline" href="#Examples">¶</a></h2><p>To see all local configuration:</p><pre class="programlisting">systemd-delta</pre><p>To see all runtime configuration:</p><pre class="programlisting">systemd-delta /run</pre><p>To see all system unit configuration changes:</p><pre class="programlisting">systemd-delta systemd/system</pre><p>To see all runtime "drop-in" changes for system units:</p><pre class="programlisting">systemd-delta --type=extended /run/systemd/system</pre></div><div class="refsect1"><a name="idm140392343603264"></a><h2 id="Exit status">Exit status<a class="headerlink" title="Permalink to this headline" href="#Exit%20status">¶</a></h2><p>On success, 0 is returned, a non-zero failure
  79                 code otherwise.</p></div><div class="refsect1"><a name="idm140392343403744"></a><h2 id="See Also">See Also<a class="headerlink" title="Permalink to this headline" href="#See%20Also">¶</a></h2><p>
  80                         <a href="systemd.html"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
  81                         <a href="systemd.unit.html"><span class="citerefentry"><span class="refentrytitle">systemd.unit</span>(5)</span></a>
  82                 </p></div></div></body></html>