ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/root-tail/root-tail.man.html
Revision: 1.3
Committed: Sun Jun 16 01:34:45 2019 UTC (5 years, 1 month ago) by root
Content type: text/html
Branch: MAIN
CVS Tags: rel-1_3, HEAD
Changes since 1.2: +9 -8 lines
Log Message:
*** empty log message ***

File Contents

# Content
1 <!-- Creator : groff version 1.22.4 -->
2 <!-- CreationDate: Sun Jun 16 01:34:30 2019 -->
3 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
4 "http://www.w3.org/TR/html4/loose.dtd">
5 <html>
6 <head>
7 <meta name="generator" content="groff -Thtml, see www.gnu.org">
8 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
9 <meta name="Content-Style" content="text/css">
10 <style type="text/css">
11 p { margin-top: 0; margin-bottom: 0; vertical-align: top }
12 pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
13 table { margin-top: 0; margin-bottom: 0; vertical-align: top }
14 h1 { text-align: center }
15 </style>
16 <title>ROOTTAIL</title>
17
18 </head>
19 <body>
20
21 <h1 align="center">ROOTTAIL</h1>
22
23 <a href="#NAME">NAME</a><br>
24 <a href="#SYNOPSIS">SYNOPSIS</a><br>
25 <a href="#DESCRIPTION">DESCRIPTION</a><br>
26 <a href="#EXAMPLE">EXAMPLE</a><br>
27 <a href="#BUGS">BUGS</a><br>
28
29 <hr>
30
31
32 <h2>NAME
33 <a name="NAME"></a>
34 </h2>
35
36
37 <p style="margin-left:11%; margin-top: 1em">root-tail -
38 print text directly to X11 root window</p>
39
40 <h2>SYNOPSIS
41 <a name="SYNOPSIS"></a>
42 </h2>
43
44
45
46 <p style="margin-left:11%; margin-top: 1em"><b>root-tail</b>
47 [<b>-g</b>|<b>--geometry</b> <i>GEOMETRY</i>]
48 [<b>-fn</b>|<b>--font</b> <i>FONTSPEC</i>] [<b>--color</b>
49 <i>color</i>] [<b>--reload</b> <i>SEC COMMAND</i>]
50 [<b>--shade</b>] [<b>--outline</b>] [<b>--minspace</b>]
51 [<b>--noflicker</b>] [<b>-f</b>|<b>--fork</b>]
52 [<b>--reverse</b>] [<b>--whole</b>] [<b>--partial</b>]
53 [<b>--update</b>] [<b>--cont</b> <i>STRING</i>]
54 [<b>--wordwrap</b>] [<b>--justify</b>] [<b>--noinitial</b>]
55 [<b>--frame</b>] [<b>--windowed</b>} [<b>-id</b> <i>ID</i>]
56 [<b>-i</b>|<b>--interval</b> <i>SECONDS</i>] [<b>-V</b>]
57 file1[,color[,desc]] [file2[,color[,desc]]]</p>
58
59 <h2>DESCRIPTION
60 <a name="DESCRIPTION"></a>
61 </h2>
62
63
64 <p style="margin-left:11%; margin-top: 1em">Displays a
65 given file anywhere on your X11 root window, i.e. it is kind
66 of tail -f for multiple files using your desktop background
67 as output window.</p>
68
69 <p style="margin-left:11%; margin-top: 1em">All non-option
70 arguments on the command line are files to be logged. A null
71 desc (example: &quot;/var/log/messages,red,&quot;) will
72 prevent the printing of a description and the
73 []&rsquo;s.</p>
74
75 <p style="margin-left:11%; margin-top: 1em"><b>General
76 Options <br>
77 --color</b> <i>COLOR</i></p>
78
79 <p style="margin-left:22%;">Use COLOR as default.</p>
80
81 <p style="margin-left:11%;"><b>--font | -fn</b>
82 <i>FONTSPEC</i></p>
83
84 <p style="margin-left:22%;">Use font FONTSPEC. This can be
85 either a fixed width font like <b>-fn</b> <i>fixed</i> or
86 any font using <b>-fn</b>
87 &rsquo;<i>-*-*-*-*-*-*-*-*-*-*-*-*-*-*</i>&rsquo; with the
88 appropriate fields filled out (see xfontsel). Specifying a
89 different FONTSPEC before each filename will cause each file
90 to be displayed in a different font.</p>
91
92 <p style="margin-left:11%;"><b>-f | --fork</b></p>
93
94 <p style="margin-left:22%;">Forks to the background.</p>
95
96 <p style="margin-left:11%;"><b>--reverse</b></p>
97
98 <p style="margin-left:22%;">Display the files in reverse
99 order, with the newest lines at the top.</p>
100
101 <p style="margin-left:11%;"><b>--whole</b></p>
102
103 <p style="margin-left:22%;">Only display whole lines. If
104 the last line of a file doesn&rsquo;t yet end with a newline
105 character then wait until it does before displaying it. This
106 is the default if more than one file is being displayed.</p>
107
108 <p style="margin-left:11%;"><b>--partial</b></p>
109
110 <p style="margin-left:22%;">This is the opposite of the
111 <b>--whole</b> option (see above). It displays lines even if
112 they don&rsquo;t yet have a newline at the end. This is the
113 default if only one file is being displayed.</p>
114
115 <p style="margin-left:11%;"><b>--update</b></p>
116
117 <p style="margin-left:22%;">Update partial lines &rsquo;in
118 place&rsquo; if they are still on the screen when they are
119 updated in their files. Using <b>--update</b> automatically
120 turns on <b>--partial</b>.</p>
121
122 <p style="margin-left:11%;"><b>--cont</b> <i>STRING</i></p>
123
124 <p style="margin-left:22%;">When partial lines are broken
125 into two lines in the display, prefix the 2nd line with
126 STRING. Defaults to &quot;<i>||</i> &quot;. Specify the
127 &quot;<b>--whole</b>&quot; argument to ensure partial lines
128 are never displayed, or specify &quot;<b>--update</b>&quot;
129 to attempt to &quot;repair&quot; broken lines in-place.</p>
130
131 <p style="margin-left:11%;"><b>--cont-color</b>
132 <i>COLOR</i></p>
133
134 <p style="margin-left:22%;">Use COLOR when displaying the
135 continuation string (as optionally specified with the
136 <b>--cont</b> option above).</p>
137
138 <p style="margin-left:11%;"><b>--wordwrap</b></p>
139
140 <p style="margin-left:22%;">The default behaviour is to fit
141 as much as possible onto each line of output, even if this
142 means splitting a word between one line and the next. The
143 <b>--wordwrap</b> argument splits lines at spaces if
144 possible.</p>
145
146 <p style="margin-left:11%;"><b>--justify</b></p>
147
148 <p style="margin-left:22%;">After wrapping long lines,
149 attempt to justify the text to produce a smooth right-hand
150 margin. Implies <b>--wordwrap</b>.</p>
151
152 <p style="margin-left:11%;"><b>--reload</b> <i>SEC
153 COMMAND</i></p>
154
155 <p style="margin-left:22%;">Re-display the file(s) and run
156 COMMAND every SEC seconds. The default is to never
157 re-display the file(s).</p>
158
159 <p style="margin-left:11%;"><b>--shade</b></p>
160
161 <p style="margin-left:22%;">Add black shading to the
162 font.</p>
163
164 <p style="margin-left:11%;"><b>--outline</b></p>
165
166 <p style="margin-left:22%;">Add a black outline to the font
167 (making redraws quite a bit slower).</p>
168
169 <p style="margin-left:11%;"><b>--minspace</b></p>
170
171 <p style="margin-left:22%;">Use minimum linespace even when
172 using shading or outlining. This might result in leftover
173 pixels (dependign on font and logfile content).</p>
174
175 <p style="margin-left:11%;"><b>--noflicker</b></p>
176
177 <p style="margin-left:22%;">Use slower but flicker-free
178 update.</p>
179
180 <p style="margin-left:11%;"><b>--noinitial</b></p>
181
182 <p style="margin-left:22%;">Don&rsquo;t display the end of
183 the file(s) initially.</p>
184
185 <p style="margin-left:11%;"><b>--windowed</b></p>
186
187 <p style="margin-left:22%;">Create a new window instead of
188 reusing the root window. The newly created window covers the
189 whole screen, puts itself behind all other windows and and
190 does not accept events. Use this option if you use a
191 compositing manager suihc as xcompmgr or compton, as the
192 compositing extension has been very badly designed and
193 cannot handle root windows correctly.</p>
194
195 <table width="100%" border="0" rules="none" frame="void"
196 cellspacing="0" cellpadding="0">
197 <tr valign="top" align="left">
198 <td width="11%"></td>
199 <td width="9%">
200
201
202 <p><b>-id</b> <i>ID</i></p></td>
203 <td width="2%"></td>
204 <td width="78%">
205
206
207 <p>Use the given window ID for output instead of the root
208 window.</p> </td></tr>
209 </table>
210
211 <p style="margin-left:11%;"><b>-i | --interval</b>
212 <i>SECONDS</i></p>
213
214 <p style="margin-left:22%;">Use the specified sleeping
215 interval between checks instead of the default 2.4 seconds.
216 Fractional values are OK.</p>
217
218 <table width="100%" border="0" rules="none" frame="void"
219 cellspacing="0" cellpadding="0">
220 <tr valign="top" align="left">
221 <td width="11%"></td>
222 <td width="3%">
223
224
225 <p><b>-V</b></p></td>
226 <td width="8%"></td>
227 <td width="40%">
228
229
230 <p>Print version information.</p></td>
231 <td width="38%">
232 </td></tr>
233 </table>
234
235 <p style="margin-left:11%;"><b>--frame</b></p>
236
237 <p style="margin-left:22%;">Draw a frame around the
238 selected area. This is useful when trying to find the
239 perfect geometry.</p>
240
241 <h2>EXAMPLE
242 <a name="EXAMPLE"></a>
243 </h2>
244
245
246 <p style="margin-left:11%; margin-top: 1em">root-tail
247 --windowed -g 800x250+100+50 -font 10x20
248 /var/log/messages,green -font 12x24
249 /var/log/secure,red,&rsquo;ALERT&rsquo;</p>
250
251 <h2>BUGS
252 <a name="BUGS"></a>
253 </h2>
254
255
256 <p style="margin-left:11%; margin-top: 1em">Some desktop
257 environments open a virtual root window and make it
258 difficult to share it. If you cannot see anything after
259 starting root-tail, try the --windowed option, a setting
260 &quot;allow programs on desktop&quot; or similar, or
261 manually specify a window id.</p>
262
263 <p style="margin-left:11%; margin-top: 1em">Should you
264 happen to find any bugs please fix them and send me a
265 diff.</p>
266
267 <p style="margin-left:11%; margin-top: 1em">NOTE: This
268 program was modified by Marc Lehmann
269 &lt;schmorp@schmorp.de&gt;, who couldn&rsquo;t reach the
270 original author. Please direct bug-reports etc. to
271 root-tail@schmorp.de.</p>
272
273
274 <p style="margin-left:11%; margin-top: 1em">http://software.schmorp.de/pkg/root-tail.html</p>
275 <hr>
276 </body>
277 </html>