summaryrefslogtreecommitdiffstats
path: root/man/systemd.resource-control.xml
diff options
context:
space:
mode:
authorYu Watanabe <watanabe.yu+github@gmail.com>2024-10-26 18:24:49 +0200
committerYu Watanabe <watanabe.yu+github@gmail.com>2024-10-26 20:04:35 +0200
commit7354936ef71026a0ac7f5c592d065e91e5d9426f (patch)
treeb1f0faf868615ecd4a7aba02fb432c4f75cc77b1 /man/systemd.resource-control.xml
parenthwdb: add Stream Deck Neo (#34903) (diff)
downloadsystemd-7354936ef71026a0ac7f5c592d065e91e5d9426f.tar.xz
systemd-7354936ef71026a0ac7f5c592d065e91e5d9426f.zip
core/cgroup: rename CGROUP_PRESSURE_WATCH_ON/OFF -> CGROUP_PRESSURE_WATCH_YES/NO
No functional change, but let's print yes/no rather than on/off in systemd-analyze. Similar to 2e8a581b9cc1132743c2341fc334461096266ad4 and edd3f4d9b7a63dc9a142ef20119e80d1d9527f2f. (Note, the commit messages of those commits are wrong, as parse_boolean() supports on/off anyway.)
Diffstat (limited to 'man/systemd.resource-control.xml')
-rw-r--r--man/systemd.resource-control.xml27
1 files changed, 13 insertions, 14 deletions
diff --git a/man/systemd.resource-control.xml b/man/systemd.resource-control.xml
index 1f16052a33..ce4dfabfdd 100644
--- a/man/systemd.resource-control.xml
+++ b/man/systemd.resource-control.xml
@@ -1611,20 +1611,19 @@ DeviceAllow=/dev/loop-control
<varlistentry>
<term><varname>MemoryPressureWatch=</varname></term>
- <listitem><para>Controls memory pressure monitoring for invoked processes. Takes one of
- <literal>off</literal>, <literal>on</literal>, <literal>auto</literal> or <literal>skip</literal>. If
- <literal>off</literal> tells the service not to watch for memory pressure events, by setting the
- <varname>$MEMORY_PRESSURE_WATCH</varname> environment variable to the literal string
- <filename>/dev/null</filename>. If <literal>on</literal> tells the service to watch for memory
- pressure events. This enables memory accounting for the service, and ensures the
- <filename>memory.pressure</filename> cgroup attribute file is accessible for reading and writing by the
- service's user. It then sets the <varname>$MEMORY_PRESSURE_WATCH</varname> environment variable for
- processes invoked by the unit to the file system path to this file. The threshold information
- configured with <varname>MemoryPressureThresholdSec=</varname> is encoded in the
- <varname>$MEMORY_PRESSURE_WRITE</varname> environment variable. If the <literal>auto</literal> value
- is set the protocol is enabled if memory accounting is anyway enabled for the unit, and disabled
- otherwise. If set to <literal>skip</literal> the logic is neither enabled, nor disabled and the two
- environment variables are not set.</para>
+ <listitem><para>Controls memory pressure monitoring for invoked processes. Takes a boolean or one of
+ <literal>auto</literal> and <literal>skip</literal>. If <literal>no</literal>, tells the service not
+ to watch for memory pressure events, by setting the <varname>$MEMORY_PRESSURE_WATCH</varname>
+ environment variable to the literal string <filename>/dev/null</filename>. If <literal>yes</literal>,
+ tells the service to watch for memory pressure events. This enables memory accounting for the
+ service, and ensures the <filename>memory.pressure</filename> cgroup attribute file is accessible for
+ reading and writing by the service's user. It then sets the <varname>$MEMORY_PRESSURE_WATCH</varname>
+ environment variable for processes invoked by the unit to the file system path to this file. The
+ threshold information configured with <varname>MemoryPressureThresholdSec=</varname> is encoded in
+ the <varname>$MEMORY_PRESSURE_WRITE</varname> environment variable. If the <literal>auto</literal>
+ value is set the protocol is enabled if memory accounting is anyway enabled for the unit, and
+ disabled otherwise. If set to <literal>skip</literal> the logic is neither enabled, nor disabled and
+ the two environment variables are not set.</para>
<para>Note that services are free to use the two environment variables, but it's unproblematic if
they ignore them. Memory pressure handling must be implemented individually in each service, and