From: Taylan Kammer <taylan.kammer@gmail.com>
Date: Fri, 10 Oct 2025 13:50:56 +0000 (+0200)
Subject: man/systemd.service: Improve OOMPolicy documentation (#39212)
X-Git-Tag: v259-rc1~349
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F33360%2Fhead;p=thirdparty%2Fsystemd.git

man/systemd.service: Improve OOMPolicy documentation (#39212)
---

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 68663e9ed81..125acae4d37 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -1271,11 +1271,13 @@
         <para>This setting takes one of <constant>continue</constant>, <constant>stop</constant> or
         <constant>kill</constant>. If set to <constant>continue</constant> and a process in the unit is
         killed by the OOM killer, this is logged but the unit continues running. If set to
-        <constant>stop</constant> the event is logged but the unit is terminated cleanly by the service
-        manager. If set to <constant>kill</constant> and one of the unit's processes is killed by the OOM
-        killer the kernel is instructed to kill all remaining processes of the unit too, by setting the
-        <filename>memory.oom.group</filename> attribute to <constant>1</constant>; also see kernel
-        page <ulink url="https://docs.kernel.org/admin-guide/cgroup-v2.html">Control Group v2</ulink>.
+        <constant>stop</constant> the event is logged and the unit's processes are terminated cleanly by the
+        service manager. If set to <constant>kill</constant> and one of the unit's processes is killed by the
+        OOM killer the kernel is instructed to kill all remaining processes of the unit too, by setting the
+        <filename>memory.oom.group</filename> attribute to <constant>1</constant>; also see kernel page
+        <ulink url="https://docs.kernel.org/admin-guide/cgroup-v2.html">Control Group v2</ulink>. In case of
+        both <constant>stop</constant> and <constant>kill</constant>, the service ultimately ends up in the
+        <constant>oom-kill</constant> failed state after which <varname>Restart=</varname> may apply.
         </para>
 
         <para>Defaults to the setting <varname>DefaultOOMPolicy=</varname> in