<para><command>systemd-install</command> enables or
disables systemd units, or checks whether they are
- enabled.</para>
+ enabled, according to the installation suggestions
+ included in the unit files.</para>
<para>This command is useful to apply or undo the
installation instructions encoded in the <literal>[Install]</literal>
files in the configuration tree, but does not start
them. The latter equals starting them, but does not
necessarily require them to be enabled.</para>
+
+ <para>Note that while
+ <command>systemd-install</command> is the recommended
+ tool to create or remove symlinks in the systemd
+ configuration directory the administrator can also
+ create links there manually, which is particularly
+ useful to use configurations that deviate from the
+ installation suggestions included in the unit
+ files.</para>
</refsect1>
<refsect1>
<option>--realize</option> is
specifieed but the mode value is
omitted defaults to
- <option>maybe</option>. This option
+ <option>minimal</option>. This option
has no effect when
<option>--global</option> or
<command>test</command> is used, or
the <command>realize</command> command
is used.</para></listitem>
</varlistentry>
+
+ <varlistentry>
+ <term><option>--all</option></term>
+
+ <listitem><para>If set makes sure that
+ all symlinks on the specified unit are
+ removed from the configuration
+ directory and its subdirectories, not
+ just those specified in the
+ <literal>[Install]</literal>
+ section.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--verbose</option></term>
+ <term><option>-v</option></term>
+
+ <listitem><para>Show what is done as
+ it is done.</para></listitem>
+ </varlistentry>
+
</variablelist>
<para>The following commands are understood:</para>
<option>--realize</option>. If
<option>--realize</option> is not
specified implies
- <option>maybe</option> mode. To
+ <option>minimal</option> mode. To
override this mode specify
<option>--realize=</option> in
addition to