From df50d8958991a787dfe4399b4d5b1b0c82ac3141 Mon Sep 17 00:00:00 2001 From: "Anna (navi) Figueiredo Gomes" Date: Sat, 20 Jul 2024 16:51:44 +0200 Subject: user-guide.md add user-services documentation Signed-off-by: Anna (navi) Figueiredo Gomes --- user-guide.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) 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.. -- cgit v1.2.3