summaryrefslogtreecommitdiffstats
path: root/man/systemd.exec.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2024-07-12 06:06:11 +0200
committerLennart Poettering <lennart@poettering.net>2024-07-19 11:44:04 +0200
commitc06b84d816fdeb6a26691b6f3504f541644edb6f (patch)
tree072a7bd8dbd82e71bb3c6780325ce0bbb7a7a0a2 /man/systemd.exec.xml
parentunits: bring agetty command lines back into sync (diff)
downloadsystemd-c06b84d816fdeb6a26691b6f3504f541644edb6f.tar.xz
systemd-c06b84d816fdeb6a26691b6f3504f541644edb6f.zip
man: clarify what TTYReset= and TTYVTDisallocate= do and do not do regarding screen clearing
Diffstat (limited to '')
-rw-r--r--man/systemd.exec.xml15
1 files changed, 9 insertions, 6 deletions
diff --git a/man/systemd.exec.xml b/man/systemd.exec.xml
index 7a2fc76b65..c79cf67445 100644
--- a/man/systemd.exec.xml
+++ b/man/systemd.exec.xml
@@ -3322,7 +3322,8 @@ StandardInputData=V2XigLJyZSBubyBzdHJhbmdlcnMgdG8gbG92ZQpZb3Uga25vdyB0aGUgcnVsZX
<term><varname>TTYReset=</varname></term>
<listitem><para>Reset the terminal device specified with <varname>TTYPath=</varname> before and after
- execution. Defaults to <literal>no</literal>.</para></listitem>
+ execution. This does not erase the screen (see <varname>TTYVTDisallocate=</varname> below for
+ that). Defaults to <literal>no</literal>.</para></listitem>
</varlistentry>
<varlistentry>
@@ -3333,11 +3334,12 @@ StandardInputData=V2XigLJyZSBubyBzdHJhbmdlcnMgdG8gbG92ZQpZb3Uga25vdyB0aGUgcnVsZX
</varlistentry>
<varlistentry>
- <term><varname>TTYRows=</varname></term>
<term><varname>TTYColumns=</varname></term>
+ <term><varname>TTYRows=</varname></term>
<listitem><para>Configure the size of the TTY specified with <varname>TTYPath=</varname>. If unset or
- set to the empty string, the kernel default is used.</para>
+ set to the empty string, it is attempted to retrieve the dimensions of the terminal screen via ANSI
+ sequences, and if that fails the kernel defaults (typically 80x24) are used.</para>
<xi:include href="version-info.xml" xpointer="v250"/></listitem>
</varlistentry>
@@ -3345,9 +3347,10 @@ StandardInputData=V2XigLJyZSBubyBzdHJhbmdlcnMgdG8gbG92ZQpZb3Uga25vdyB0aGUgcnVsZX
<varlistentry>
<term><varname>TTYVTDisallocate=</varname></term>
- <listitem><para>If the terminal device specified with <varname>TTYPath=</varname> is a virtual console
- terminal, try to deallocate the TTY before and after execution. This ensures that the screen and scrollback
- buffer is cleared. Defaults to <literal>no</literal>.</para></listitem>
+ <listitem><para>If the terminal device specified with <varname>TTYPath=</varname> is a virtual
+ console terminal, try to deallocate the TTY before and after execution. This ensures that the screen
+ and scrollback buffer is cleared. If the terminal device is of any other type of TTY an attempt is
+ made to clear the screen via ANSI sequences. Defaults to <literal>no</literal>.</para></listitem>
</varlistentry>
</variablelist>
</refsect1>