summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorThorsten Kukuk <kukuk@suse.com>2023-04-19 16:11:55 +0200
committerLennart Poettering <lennart@poettering.net>2023-04-25 14:33:09 +0200
commit092e6cd19adf1ff6bc979034cbe287d92ca2efd7 (patch)
treefb8a9dd07a7cac3eca66d463962892d6f2640eac /man
parent4d26b2277a9a982b8c061d7da2300b266161b716 (diff)
downloadsystemd-092e6cd19adf1ff6bc979034cbe287d92ca2efd7.tar.gz
sd-login: add SetTTY session object #26611
Diffstat (limited to 'man')
-rw-r--r--man/org.freedesktop.login1.xml8
1 files changed, 8 insertions, 0 deletions
diff --git a/man/org.freedesktop.login1.xml b/man/org.freedesktop.login1.xml
index 6781e1dcaa..034fd1078f 100644
--- a/man/org.freedesktop.login1.xml
+++ b/man/org.freedesktop.login1.xml
@@ -1083,6 +1083,7 @@ node /org/freedesktop/login1/session/1 {
ReleaseControl();
SetType(in s type);
SetDisplay(in s display);
+ SetTTY(in h tty_fd);
TakeDevice(in u major,
in u minor,
out h fd,
@@ -1182,6 +1183,8 @@ node /org/freedesktop/login1/session/1 {
<variablelist class="dbus-method" generated="True" extra-ref="SetDisplay()"/>
+ <variablelist class="dbus-method" generated="True" extra-ref="SetTTY()"/>
+
<variablelist class="dbus-method" generated="True" extra-ref="TakeDevice()"/>
<variablelist class="dbus-method" generated="True" extra-ref="ReleaseDevice()"/>
@@ -1283,6 +1286,11 @@ node /org/freedesktop/login1/session/1 {
controller. If <function>TakeControl()</function> has not been called, this method will fail. The only argument
<varname>display</varname> is the new display name.</para>
+ <para><function>SetTTY()</function> allows the device name of the session to be changed. This is
+ useful if the tty device is only known after authentication. 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 <varname>tty_fd</varname> is a file handle to the new tty device.</para>
+
<para><function>TakeDevice()</function> allows a session controller to get a file descriptor for a
specific device. Pass in the major and minor numbers of the character device and
<filename>systemd-logind</filename> will return a file descriptor for the device. Only a limited set of