OS Manuals

systemd-pty-forward(1)

SYSTEMD-PTY-FORWARD(1) systemd-pty-forward SYSTEMD-PTY-FORWARD(1)


.SH "NAME" systemd-pty-forward - Run a command with a custom terminal background color or title


.SH "SYNOPSIS"


.HP 480u


systemd-pty-forward
[OPTIONS...]
{COMMAND}


.SH "DESCRIPTION"


.PP systemd-pty-forward can be used to run a command with a custom terminal background color or title.


.SH "OPTIONS"


.PP The following options are understood:


.PP --background=COLOR


Change the terminal background color to the specified ANSI color as long as the command runs. The color specified should be an ANSI X3.64 SGR background color, i.e. strings such as 40, 41, ..., 47, 48;2;..., 48;5;.... See ANSI Escape Code (Wikipedia)[1] for details.


Example: --background=44 for a blue background.


Added in version 258.


.RE


.PP --title=TITLE


Change the terminal title to the specified string as long as the command runs.


Added in version 258.


.RE


.PP --quiet, -q


Suppresses additional informational output while running.


Added in version 258.


.RE


.PP --read-only


Do not accept any user input on standard input.


Added in version 258.


.RE


.PP -h, --help


Print a short help text and exit.


.RE
.PP --version


Print a short version string and exit.


.RE

1.
ANSI Escape Code (Wikipedia)
https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_(Select_Graphic_Rendition)_parameters
systemd 262.2

systemd 262.2-r1 · os · ingested 2026-11-06