summaryrefslogtreecommitdiff
path: root/man/systemd.service.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2021-02-19 17:49:44 +0100
committerLennart Poettering <lennart@poettering.net>2021-02-19 17:51:31 +0100
commit5cfbe7452f023fc307374f306e26b5ee902889f0 (patch)
tree3457ede1566af7300c6da8df73421898fdd7ab6f /man/systemd.service.xml
parent82f306321808cac966e9bde20d3012a6ba9924bb (diff)
downloadsystemd-5cfbe7452f023fc307374f306e26b5ee902889f0.tar.gz
man: emphasize a bit more that PID files suck
Diffstat (limited to 'man/systemd.service.xml')
-rw-r--r--man/systemd.service.xml6
1 files changed, 5 insertions, 1 deletions
diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 25cca3d8d6..0e9fa3e732 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -292,7 +292,11 @@
will remove the file after the service has shut down if it still exists. The PID file does not need to be owned
by a privileged user, but if it is owned by an unprivileged user additional safety restrictions are enforced:
the file may not be a symlink to a file owned by a different user (neither directly nor indirectly), and the
- PID file must refer to a process already belonging to the service.</para></listitem>
+ PID file must refer to a process already belonging to the service.</para>
+
+ <para>Note that PID files should be avoided in modern projects. Use <option>Type=notify</option> or
+ <option>Type=simple</option> where possible, which does not require use of PID files to determine the
+ main process of a service and avoids needless forking.</para></listitem>
</varlistentry>
<varlistentry>