| 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: "/var/log/messages,red,") will |
| 72 |
prevent the printing of a description and the |
| 73 |
[]’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 |
’<i>-*-*-*-*-*-*-*-*-*-*-*-*-*-*</i>’ 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’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’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 ’in |
| 118 |
place’ 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 "<i>||</i> ". Specify the |
| 127 |
"<b>--whole</b>" argument to ensure partial lines |
| 128 |
are never displayed, or specify "<b>--update</b>" |
| 129 |
to attempt to "repair" 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’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,’ALERT’</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 |
"allow programs on desktop" 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 |
<schmorp@schmorp.de>, who couldn’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> |
