civodul pushed a commit to branch master
in repository guix.
commit bcb772d7d00346f97557040469d2d5021f5e80ba
Author: Ludovic Courtès <[email protected]>
AuthorDate: Sat Feb 22 23:20:45 2025 +0100
doc: Write about depending on the ‘user-processes’ Shepherd service.
* doc/guix.texi (Shepherd Services): Add paragraph on ‘user-processes’.
Suggested-by: Dariqq <[email protected]>
Change-Id: I76fb11779eefc90d13dbc11368ddf64f7450f5e6
---
doc/guix.texi | 7 +++++++
1 file changed, 7 insertions(+)
diff --git a/doc/guix.texi b/doc/guix.texi
index 1bfe76f016..b525913c15 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -46142,6 +46142,13 @@ shepherd, The GNU Shepherd Manual}, for details.
@item @code{requirement} (default: @code{'()})
List of symbols denoting the Shepherd services this one depends on.
+@cindex @code{user-processes} Shepherd service
+With very few exceptions, services that start a daemon must depend at
+least on the @code{user-processes} service; this ensures that these
+daemons are started after all the file systems have been mounted and
+that, during shutdown, they are stopped before attempting to terminate
+remaining user processes.
+
@cindex one-shot services, for the Shepherd
@item @code{one-shot?} (default: @code{#f})
Whether this service is @dfn{one-shot}. One-shot services stop immediately
