summaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2025-01-14 11:50:52 +0100
committerLennart Poettering <lennart@poettering.net>2025-01-15 17:03:21 +0100
commitef5f72437e661b603e4b05ad89446883f80a29c3 (patch)
tree8ece39d8807e3a2133f29c5bc3ece0681d55301b /man
parentrun: fire sd_notify("READY=1") when in service mode and the unit is properly ... (diff)
downloadsystemd-ef5f72437e661b603e4b05ad89446883f80a29c3.tar.xz
systemd-ef5f72437e661b603e4b05ad89446883f80a29c3.zip
run0: allow explicit control of service manager activation for run0 sessions
This adds a new --lightweight=yes/no switch which allows controlling whether the invoked service will have the service manager around or not. Moreover, this changes that if the target user is root it will now support to the lightweight mode, i.e. run0 towards root will no longer pull in the service manager (a real tty login via getty still will though!). My thinking here is that quickly raising privileges via run0 probably shouldn't be considered a proper login but just something short lived, temporary for a single command or similar.
Diffstat (limited to 'man')
-rw-r--r--man/run0.xml16
1 files changed, 16 insertions, 0 deletions
diff --git a/man/run0.xml b/man/run0.xml
index 16774813d4..59aa6d05d9 100644
--- a/man/run0.xml
+++ b/man/run0.xml
@@ -225,6 +225,21 @@
</varlistentry>
<varlistentry>
+ <term><option>--lightweight=<replaceable>BOOLEAN</replaceable></option></term>
+
+ <listitem><para>Controls whether to activate the per-user service manager for the target user. By
+ default if the target user is <literal>root</literal> or a system user the per-user service manager
+ is not activated as effect of the <command>run0</command> invocation, otherwise it is.</para>
+
+ <para>This ultimately controls the <varname>$XDG_SESSION_CLASS</varname> variable
+ <citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
+ respects.</para>
+
+ <xi:include href="version-info.xml" xpointer="v258"/>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><option>--machine=</option></term>
<listitem>
@@ -321,6 +336,7 @@
<member><citerefentry><refentrytitle>systemd-run</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
<member><citerefentry project='man-pages'><refentrytitle>sudo</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
<member><citerefentry><refentrytitle>machinectl</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
+ <member><citerefentry><refentrytitle>pam_systemd</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
</simplelist></para>
</refsect1>