summaryrefslogtreecommitdiffstats
path: root/man/org.freedesktop.login1.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2023-11-27 22:34:12 +0100
committerLennart Poettering <lennart@poettering.net>2024-02-14 15:08:03 +0100
commit955502121d8252637f61c0faea3b14d0388c2a6e (patch)
treef51eafa09fe6c86af36e0f284fbc611730246358 /man/org.freedesktop.login1.xml
parenthomed: generate fallback data in user record, for inactive homes (diff)
downloadsystemd-955502121d8252637f61c0faea3b14d0388c2a6e.tar.xz
systemd-955502121d8252637f61c0faea3b14d0388c2a6e.zip
man: update D-Bus docs with new calls
Diffstat (limited to 'man/org.freedesktop.login1.xml')
-rw-r--r--man/org.freedesktop.login1.xml10
1 files changed, 10 insertions, 0 deletions
diff --git a/man/org.freedesktop.login1.xml b/man/org.freedesktop.login1.xml
index ea46653160..dffd16e325 100644
--- a/man/org.freedesktop.login1.xml
+++ b/man/org.freedesktop.login1.xml
@@ -1146,6 +1146,7 @@ node /org/freedesktop/login1/session/1 {
TakeControl(in b force);
ReleaseControl();
SetType(in s type);
+ SetClass(in s class);
SetDisplay(in s display);
SetTTY(in h tty_fd);
TakeDevice(in u major,
@@ -1242,6 +1243,8 @@ node /org/freedesktop/login1/session/1 {
<variablelist class="dbus-method" generated="True" extra-ref="SetType()"/>
+ <variablelist class="dbus-method" generated="True" extra-ref="SetClass()"/>
+
<variablelist class="dbus-method" generated="True" extra-ref="SetDisplay()"/>
<variablelist class="dbus-method" generated="True" extra-ref="SetTTY()"/>
@@ -1342,6 +1345,12 @@ node /org/freedesktop/login1/session/1 {
connection. This should help prevent a session from entering an inconsistent state, for example if the
controller crashes. The only argument <varname>type</varname> is the new session type.</para>
+ <para><function>SetClass()</function> allows the caller to change the class of the session dynamically.
+ It may only be called by session's owening user. Currently, this call may be exclusively used to change
+ the class from <literal>user-incomplete</literal> to <literal>user</literal>. The call is synchronous,
+ and will return only once the user's service manager has successfully been started, if necessary. The
+ only argument <varname>type</varname> is the new session type.</para>
+
<para><function>SetDisplay()</function> allows the display name of the graphical session to be changed. This is
useful if the display server is started as part of the session. It can only be called by session's current
controller. If <function>TakeControl()</function> has not been called, this method will fail. The only argument
@@ -1578,6 +1587,7 @@ node /org/freedesktop/login1/session/1 {
<title>Session Objects</title>
<para><function>SetDisplay()</function> was added in version 252.</para>
<para><function>SetTTY()</function> was added in version 254.</para>
+ <para><function>SetClass()</function> was added in version 256.</para>
</refsect2>
</refsect1>
</refentry>