Debian Codegraph @

upstream/debian-unstable/man1/systemd-pty-forward.1

raw
1 '\" t
2 .TH "SYSTEMD\-PTY\-FORWARD" "1" "" "systemd 261~rc3" "systemd-pty-forward"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-pty-forward \- Run a command with a custom terminal background color or title
24 .SH "SYNOPSIS"
25 .HP \w'\fBsystemd\-pty\-forward\fR\ 'u
26 \fBsystemd\-pty\-forward\fR [OPTIONS...] {COMMAND}
27 .SH "DESCRIPTION"
28 .PP
29 \fBsystemd\-pty\-forward\fR
30 can be used to run a command with a custom terminal background color or title\&.
31 .SH "OPTIONS"
32 .PP
33 The following options are understood:
34 .PP
35 \fB\-\-background=\fR\fB\fICOLOR\fR\fR
36 .RS 4
37 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
38 "40",
39 "41", \&...,
40 "47",
41 "48;2;\&...",
42 "48;5;\&..."\&. See
43 \m[blue]\fBANSI Escape Code (Wikipedia)\fR\m[]\&\s-2\u[1]\d\s+2
44 for details\&.
45 .sp
46 Example:
47 "\-\-background=44"
48 for a blue background\&.
49 .sp
50 Added in version 258\&.
51 .RE
52 .PP
53 \fB\-\-title=\fR\fB\fITITLE\fR\fR
54 .RS 4
55 Change the terminal title to the specified string as long as the command runs\&.
56 .sp
57 Added in version 258\&.
58 .RE
59 .PP
60 \fB\-\-quiet\fR, \fB\-q\fR
61 .RS 4
62 Suppresses additional informational output while running\&.
63 .sp
64 Added in version 258\&.
65 .RE
66 .PP
67 \fB\-\-read\-only\fR
68 .RS 4
69 Do not accept any user input on standard input\&.
70 .sp
71 Added in version 258\&.
72 .RE
73 .PP
74 \fB\-h\fR, \fB\-\-help\fR
75 .RS 4
76 Print a short help text and exit\&.
77 .RE
78 .PP
79 \fB\-\-version\fR
80 .RS 4
81 Print a short version string and exit\&.
82 .RE
83 .SH "NOTES"
84 .IP " 1." 4
85 ANSI Escape Code (Wikipedia)
86 .RS 4
87 \%https://en.wikipedia.org/wiki/ANSI_escape_code#SGR_(Select_Graphic_Rendition)_parameters
88 .RE