shaba/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd.git synced 2025-03-25 18:50:18 +03:00
Code

man: document that [Install] has no effect in unit file .d/*.conf drop-ins

Browse Source 
Fixes: #1774
Fixes: #1090
This commit is contained in:
Lennart Poettering 2016-02-10 21:39:36 +01:00
parent 41448597f2
commit be73bb486a
1 changed files with 15 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
man/systemd.unit.xml
View File

@ -178,18 +178,14 @@
directory suffix is <filename>.requires/</filename> in this
case.</para>
<para>Along with a unit file <filename>foo.service</filename>, a
directory <filename>foo.service.d/</filename> may exist. All files
with the suffix <literal>.conf</literal> from this directory will
be parsed after the file itself is parsed. This is useful to alter
or add configuration settings to a unit, without having to modify
their unit files. Make sure that the file that is included has the
appropriate section headers before any directive. Note that, for
instanced units, this logic will first look for the instance
<literal>.d/</literal> subdirectory and read its
<literal>.conf</literal> files, followed by the template
<literal>.d/</literal> subdirectory and reads its
<literal>.conf</literal> files.</para>
<para>Along with a unit file <filename>foo.service</filename>, a "drop-in" directory
<filename>foo.service.d/</filename> may exist. All files with the suffix <literal>.conf</literal> from this
directory will be parsed after the file itself is parsed. This is useful to alter or add configuration settings to
a unit, without having to modify their unit files. Make sure that the file that is included has the appropriate
section headers before any directive. Note that for instanced units, this logic will first look for the instance
<literal>.d/</literal> subdirectory and read its <literal>.conf</literal> files, followed by the template
<literal>.d/</literal> subdirectory and reads its <literal>.conf</literal> files. Also note that settings from the
<literal>[Install]</literal> section are not available in drop-in unit files, and have no effect.</para>
<para>In addition to <filename>/etc/systemd/system</filename>,
the drop-in <literal>.conf</literal> files for system services
@ -1093,15 +1089,13 @@
<refsect1>
<title>[Install] Section Options</title>
<para>Unit file may include an <literal>[Install]</literal>
section, which carries installation information for the unit. This
section is not interpreted by
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
during runtime. It is used exclusively by the
<command>enable</command> and <command>disable</command> commands
of the
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
tool during installation of a unit:</para>
<para>Unit files may include an <literal>[Install]</literal> section, which carries installation information for
the unit. This section is not interpreted by
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry> during runtime; it is
used by the <command>enable</command> and <command>disable</command> commands of the
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry> tool during
installation of a unit. Note that settings in the <literal>[Install]</literal> section may not appear in
<filename>.d/*.conf</filename> unit file drop-ins (see above).</para>
<variablelist class='unit-directives'>
<varlistentry>