Commit 00d1818b authored by Lennart Poettering's avatar Lennart Poettering
Browse files

man: we need to be more careful with the unit search paths we document

We generally document the suggested paths, not the paths possible in
weird, non-standard setups. We do this in order to not confuse
administrators/users unnecessarily and to push people to install things
into the same directories on all distributions.

We are PID 1 after all, the really basic building block of the OS.
Unlike for an app there's very little benefit in being entirely
relocatable.
parent 8af8afd6
...@@ -245,7 +245,7 @@ ...@@ -245,7 +245,7 @@
</refsect1> </refsect1>
<refsect1> <refsect1>
<title>Unit load path</title> <title>Unit Load Path</title>
<para>Unit files are loaded from a set of paths <para>Unit files are loaded from a set of paths
determined during compilation, described in the two determined during compilation, described in the two
...@@ -254,7 +254,7 @@ ...@@ -254,7 +254,7 @@
lower in the hierarchy, thus allowing overrides. lower in the hierarchy, thus allowing overrides.
</para> </para>
<para>When systemd is running in session mode <para>When systemd is running in user mode
(<option>--user</option>) and the variable (<option>--user</option>) and the variable
<varname>$SYSTEMD_UNIT_PATH</varname> is set, this <varname>$SYSTEMD_UNIT_PATH</varname> is set, this
contents of this variable overrides the unit load contents of this variable overrides the unit load
...@@ -278,14 +278,11 @@ ...@@ -278,14 +278,11 @@
<tbody> <tbody>
<row> <row>
<entry><filename>/run/systemd/generator.early</filename></entry> <entry><filename>/run/systemd/generator.early</filename></entry>
<entry>Generated units</entry> <entry>Generated units (early)</entry>
</row>
<row>
<entry><filename>&SYSTEM_CONFIG_UNIT_PATH;</filename></entry>
<entry morerows='1'>Local configuration</entry>
</row> </row>
<row> <row>
<entry><filename>/etc/systemd/system</filename></entry> <entry><filename>/etc/systemd/system</filename></entry>
<entry>Local configuration</entry>
</row> </row>
<row> <row>
<entry><filename>/run/systemd/systemd</filename></entry> <entry><filename>/run/systemd/systemd</filename></entry>
...@@ -293,26 +290,19 @@ ...@@ -293,26 +290,19 @@
</row> </row>
<row> <row>
<entry><filename>/run/systemd/generator</filename></entry> <entry><filename>/run/systemd/generator</filename></entry>
<entry>Generated units</entry> <entry>Generated units (middle)</entry>
</row> </row>
<row> <row>
<entry><filename>/usr/local/lib/systemd/system</filename></entry> <entry><filename>/usr/local/lib/systemd/system</filename></entry>
<entry>Units for local packages</entry> <entry>Units for local packages</entry>
</row> </row>
<row>
<entry><filename>&systemunitdir;</filename></entry>
<entry>Systemd package configuration</entry>
</row>
<row> <row>
<entry><filename>/usr/lib/systemd/system</filename></entry> <entry><filename>/usr/lib/systemd/system</filename></entry>
<entry morerows='1'>Units for installed packages</entry> <entry>Units for installed packages</entry>
</row>
<row>
<entry><filename>/lib/systemd/system</filename></entry>
</row> </row>
<row> <row>
<entry><filename>/run/systemd/generator.late</filename></entry> <entry><filename>/run/systemd/generator.late</filename></entry>
<entry>Generated units</entry> <entry>Generated units (late)</entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
...@@ -335,14 +325,11 @@ ...@@ -335,14 +325,11 @@
<tbody> <tbody>
<row> <row>
<entry><filename>/tmp/systemd-generator.early.<replaceable>XXXXXX</replaceable></filename></entry> <entry><filename>/tmp/systemd-generator.early.<replaceable>XXXXXX</replaceable></filename></entry>
<entry>Generated units</entry> <entry>Generated units (early)</entry>
</row>
<row>
<entry><filename>&USER_CONFIG_UNIT_PATH;</filename></entry>
<entry morerows='1'>Local configuration</entry>
</row> </row>
<row> <row>
<entry><filename>/etc/systemd/user</filename></entry> <entry><filename>/etc/systemd/user</filename></entry>
<entry>Local configuration</entry>
</row> </row>
<row> <row>
<entry><filename>/run/systemd/user</filename></entry> <entry><filename>/run/systemd/user</filename></entry>
...@@ -350,40 +337,24 @@ ...@@ -350,40 +337,24 @@
</row> </row>
<row> <row>
<entry><filename>/tmp/systemd-generator.<replaceable>XXXXXX</replaceable></filename></entry> <entry><filename>/tmp/systemd-generator.<replaceable>XXXXXX</replaceable></filename></entry>
<entry>Generated units</entry> <entry>Generated units (middle)</entry>
</row> </row>
<row> <row>
<entry><filename>/usr/local/lib/systemd/user</filename></entry> <entry><filename>/usr/local/lib/systemd/user</filename></entry>
<entry morerows='1'>Units for local packages</entry> <entry>Units for local packages</entry>
</row>
<row>
<entry><filename>/usr/local/share/systemd/user</filename></entry>
</row>
<row>
<entry><filename>&userunitdir;</filename></entry>
<entry>Systemd package configuration</entry>
</row> </row>
<row> <row>
<entry><filename>/usr/lib/systemd/user</filename></entry> <entry><filename>/usr/lib/systemd/user</filename></entry>
<entry morerows='1'>Units for installed packages</entry> <entry>Units for installed packages</entry>
</row>
<row>
<entry><filename>/usr/share/systemd/user</filename></entry>
</row> </row>
<row> <row>
<entry><filename>/tmp/systemd-generator.late.<replaceable>XXXXXX</replaceable></filename></entry> <entry><filename>/tmp/systemd-generator.late.<replaceable>XXXXXX</replaceable></filename></entry>
<entry>Generated units</entry> <entry>Generated units (late)</entry>
</row> </row>
</tbody> </tbody>
</tgroup> </tgroup>
</table> </table>
<para>Note: the paths listed above are set at
compilation time and differ between distributions. The
"authoritative" list is printed by
<command>systemd</command> at during start and daemon
reconfiguration.</para>
<para>Additional units might be loaded into systemd <para>Additional units might be loaded into systemd
("linked") from directories not on the unit load ("linked") from directories not on the unit load
path. See the <command>link</command> command for path. See the <command>link</command> command for
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment