aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-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>.