'\" t
.TH "SYSTEMD\-PTY\-FORWARD" "1" "" "systemd 258" "systemd-pty-forward"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
systemd-pty-forward \- Run a command with a custom terminal background color or title
.SH "SYNOPSIS"
.HP \w'\fBsystemd\-pty\-forward\fR\ 'u
\fBsystemd\-pty\-forward\fR [OPTIONS...] {COMMAND}
.SH "DESCRIPTION"
.PP
\fBsystemd\-pty\-forward\fR
can be used to run a command with a custom terminal background color or title\&.
.SH "OPTIONS"
.PP
The following options are understood:
.PP
\fB\-\-background=\fR\fB\fICOLOR\fR\fR
.RS 4
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
\m[blue]\fBANSI Escape Code (Wikipedia)\fR\m[]\&\s-2\u[1]\d\s+2
for details\&.
.sp
Example:
"\-\-background=44"
for a blue background\&.
.sp
Added in version 258\&.
.RE
.PP
\fB\-\-title=\fR\fB\fITITLE\fR\fR
.RS 4
Change the terminal title to the specified string as long as the command runs\&.
.sp
Added in version 258\&.
.RE
.PP
\fB\-\-quiet\fR, \fB\-q\fR
.RS 4
Suppresses additional informational output while running\&.
.sp
Added in version 258\&.
.RE
.PP
\fB\-\-read\-only\fR
.RS 4
Do not accept any user input on standard input\&.
.sp
Added in version 258\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Print a short help text and exit\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Print a short version string and exit\&.
.RE
.SH "NOTES"
.IP " 1." 4
ANSI Escape Code (Wikipedia)
.RS 4
\%https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_(Select_Graphic_Rendition)_parameters
.RE