96 lines
2.8 KiB
Text
96 lines
2.8 KiB
Text
$NetBSD: patch-ac,v 1.1 2002/12/13 23:01:43 jschauma Exp $
|
|
|
|
--- /dev/null Fri Dec 13 17:52:18 2002
|
|
+++ colortail.1 Fri Dec 13 17:54:23 2002
|
|
@@ -0,0 +1,91 @@
|
|
+.TH COLORTAIL 1 "August 02, 2001" "System Utilities" colortail
|
|
+.SH NAME
|
|
+colortail \- output the last part of files, optionally with color
|
|
+
|
|
+.SH SYNOPSIS
|
|
+.B colortail
|
|
+[\fIOPTION\fR]... [\fIFILE\fR]...
|
|
+
|
|
+.SH DESCRIPTION
|
|
+Print last 10 lines of each FILE to standard output.
|
|
+With more than one FILE, precede each with a header giving the file name.
|
|
+
|
|
+\fBcolortail\fR works like tail but can optionally read one or more config files
|
|
+where it's specified which patterns results in which colors.
|
|
+
|
|
+\fBcolortail\fR uses regular expressions (see \fIregex(7)\fR) to determine
|
|
+which lines and parts of lines to print in which colors.
|
|
+
|
|
+.SH USAGE
|
|
+Most options are easily understandood. The only somewhat strange option is the
|
|
+\fI-k\fR option that specifies the config files so \fBcolortail\fR knows what
|
|
+should be printed in which color.
|
|
+
|
|
+If only one config file and one or more tail files is given the config file
|
|
+is treated as a global one, i.e.
|
|
+
|
|
+\fBcolortail\fR \fI-k\fR conf.global file1 file2 file3
|
|
+
|
|
+Multiple config files are separated with a , and if one tail file shouldn't
|
|
+have a config file just leave it blank, i.e.
|
|
+
|
|
+\fBcolortail\fR \fI-k\fR conf.file1,,conf.file3 file1 file2 file3
|
|
+
|
|
+.SH OPTIONS
|
|
+This program follow the usual GNU command line syntax, with long options
|
|
+starting with two dashes (`--'). A summary of options is included below.
|
|
+
|
|
+.TP
|
|
+.B \-f, \-\-follow
|
|
+output appended data as the file grows
|
|
+
|
|
+.TP
|
|
+.B \-h, \-\-help
|
|
+Show summary of options.
|
|
+.TP
|
|
+.B \-k, \-\-config=file, \-\-config=file1,file2,...
|
|
+color config files for the tail files. If only one config file it's global
|
|
+otherwise one config file for each tail file
|
|
+.TP
|
|
+\fB\-n, \-\-lines=\fR\fIN\fR
|
|
+output the last \fIN\fR lines, instead of last 10
|
|
+.TP
|
|
+.TP
|
|
+.B \-v, \-\-version
|
|
+output version information and exit
|
|
+
|
|
+.SH FILE FORMAT
|
|
+The file specified by the \fI-k\fR option tells colortail how to display the
|
|
+output according to regular expressions. The file mapps one or more regular
|
|
+expressions to one of the following colors: brightblue, brightred,
|
|
+brightwhite, blue, cyan, green, magenta, yellow. Comments start with a "#":
|
|
+
|
|
+COLOR brightred
|
|
+.br
|
|
+{
|
|
+.br
|
|
+# matches the word "root"
|
|
+.br
|
|
+^.*(root).*$
|
|
+.br
|
|
+}
|
|
+.br
|
|
+
|
|
+.SH VERSION
|
|
+0.3.0
|
|
+
|
|
+.SH BUGS
|
|
+
|
|
+Under certain circumstances \fBcolortail\fR may miss some characters when
|
|
+tailing forever. This bug also exists in \fItail(1)\fR. If you have found a
|
|
+bug, please send a mail to pt98jan@student.hk-r.se
|
|
+
|
|
+.SH SEE ALSO
|
|
+.BR regex (7),
|
|
+.BR tail (1)
|
|
+
|
|
+.SH AUTHOR
|
|
+.nr
|
|
+Joakim Andersson <pt98jan@student.hk-r.se> - colortail
|
|
+.br
|
|
+Jan Schaumann <jschauma@netmeister.org> - this man page
|