aboutsummaryrefslogtreecommitdiff
path: root/doc/river.1.scd
diff options
context:
space:
mode:
authorIsaac Freund <ifreund@ifreund.xyz>2021-02-21 22:03:03 +0100
committerIsaac Freund <ifreund@ifreund.xyz>2021-04-20 18:27:03 +0200
commit33fb7725c5a9d68d28bc2a30537210518aef3486 (patch)
treeed9ce858faefa089e4d3165ddc510a06f9c1aa5e /doc/river.1.scd
parentf72656b72e5822481a4bc15b75d19b61b1bb7bc8 (diff)
downloadriver-33fb7725c5a9d68d28bc2a30537210518aef3486.tar.gz
river-33fb7725c5a9d68d28bc2a30537210518aef3486.tar.xz
river: send SIGTERM to init command process group
Run the init command in a new process group and send SIGTERM to the entire group on exit. Without doing this, only the sh invocation used for the `sh -c` would receive SIGTERM. This is particularly useful when starting a per-session server manager as the init command.
Diffstat (limited to 'doc/river.1.scd')
-rw-r--r--doc/river.1.scd7
1 files changed, 3 insertions, 4 deletions
diff --git a/doc/river.1.scd b/doc/river.1.scd
index 9ca0c43..bd38fa1 100644
--- a/doc/river.1.scd
+++ b/doc/river.1.scd
@@ -39,10 +39,9 @@ following locations, checked in the order listed:
- $HOME/.config/river/init
- /etc/river/init
-This executable init file will be run after river's wayland server is
-initialized but before entering the main loop. If the process started by
-this flag is still running when river exits, river will send SIGTERM and
-and wait for it to terminate.
+The executable init file will be run as a process group leader after river's
+wayland server is initialized but before entering the main loop. On exit,
+river will send SIGTERM to this process group.
Usually this will be a shell script invoking *riverctl*(1) to create mappings,
start programs such as a status bar, and preform other configuration.