summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMartin Weinelt <mweinelt@users.noreply.github.com>2022-11-21 17:20:11 +0100
committerGitHub <noreply@github.com>2022-11-21 17:20:11 +0100
commitee2ab5b7f989310e234eaa3525f9ef0133c2625c (patch)
treedf5c0da1531805433f02aea2e57ac8d215de82d8
parentffe32899998ecd8a7c223c5a403aa763959a8824 (diff)
[Doc] Add example run command with cgroup support (#1752)
Adds an example command to launch processes via systemd-run into a dedicated systemd scope within the users slice, which allows using systemd-oomd, that evaluates memory consumption on a per cgroup basis. The systemd-run arguments are chosen in alignment with systemds desktop environment integration recommendations¹. [1] https://systemd.io/DESKTOP_ENVIRONMENTS/ Co-Authored-By: Dave Davenport <qball@blame.services> Co-authored-by: Dave Davenport <qball@blame.services>
-rw-r--r--doc/rofi.112
-rw-r--r--doc/rofi.1.markdown6
2 files changed, 18 insertions, 0 deletions
diff --git a/doc/rofi.1 b/doc/rofi.1
index b2eb5db2..20db729f 100644
--- a/doc/rofi.1
+++ b/doc/rofi.1
@@ -902,6 +902,18 @@ See \fIPATTERN\fP\&.
Default: \fI{cmd}\fP
.PP
+Example to run applications in a dedicated cgroup with systemd. Requires a shell to escape and interpolate the unit name correctly.
+
+.PP
+.RS
+
+.nf
+"bash -c 'systemd-run --user --unit=app-rofi-\\$(systemd-escape {cmd})-\\$RANDOM {cmd}'"
+
+.fi
+.RE
+
+.PP
\fB\fC-run-shell-command\fR \fIcmd\fP
.PP
diff --git a/doc/rofi.1.markdown b/doc/rofi.1.markdown
index 2f8a82e4..73d94af6 100644
--- a/doc/rofi.1.markdown
+++ b/doc/rofi.1.markdown
@@ -543,6 +543,12 @@ See *PATTERN*.
Default: *{cmd}*
+Example to run applications in a dedicated cgroup with systemd. Requires a shell to escape and interpolate the unit name correctly.
+
+```
+"bash -c 'systemd-run --user --unit=app-rofi-\$(systemd-escape {cmd})-\$RANDOM {cmd}'"
+```
+
`-run-shell-command` *cmd*
Set command to execute when running an application in a shell.