aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAnna (navi) Figueiredo Gomes <navi@vlhl.dev>2024-07-20 16:51:44 +0200
committerAnna (navi) Figueiredo Gomes <navi@vlhl.dev>2024-07-20 18:09:53 +0200
commitdf50d8958991a787dfe4399b4d5b1b0c82ac3141 (patch)
treec57ae84fe2bc9fa9053e4a3bdba9efc9ebf1c109
parent943231981871fc201dd06d14f512e526dd9e0e22 (diff)
user-guide.md add user-services documentation
Signed-off-by: Anna (navi) Figueiredo Gomes <navi@vlhl.dev>
-rw-r--r--user-guide.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/user-guide.md b/user-guide.md
index 01b3add3..3c94a6fa 100644
--- a/user-guide.md
+++ b/user-guide.md
@@ -176,3 +176,15 @@ OpenRC has wrappers for many common output tasks in libeinfo.
This allows to print colour-coded status notices and other things.
To make the output consistent the bundled service scripts all use ebegin/eend to
print nice messages.
+
+# User services
+
+OpenRC supports managing services for users.
+
+The init scripts are loaded from /etc/user.d/init.d and
+${XDG_CONFIG_HOME:-${HOME}/.config}/openrc/init.d, with the latter taking priority.
+
+User services should have `#!/.../openrc-run --user` as the shebang.
+
+An instance of openrc --user is automatically instantiated when the user logs in
+via a pam module, from the `user` system init script, as user.<username>.