[lwatch-cvs] files/doc lwatch.1.in,NONE,1.1
Brought to you by:
arturcz
|
From: <ar...@us...> - 2003-03-17 14:54:04
|
Update of /cvsroot/lwatch/files/doc
In directory sc8-pr-cvs1:/tmp/cvs-serv16859
Added Files:
lwatch.1.in
Log Message:
- docbook-to-man is not needed to compile & install from CVS
--- NEW FILE: lwatch.1.in ---
.\" This -*- nroff -*- file has been generated from
.\" DocBook SGML with docbook-to-man on Debian GNU/Linux.
...\"
...\" transcript compatibility for postscript use.
...\"
...\" synopsis: .P! <file.ps>
...\"
.de P!
\\&.
.fl \" force out current output buffer
\\!%PB
\\!/showpage{}def
...\" the following is from Ken Flowers -- it prevents dictionary overflows
\\!/tempdict 200 dict def tempdict begin
.fl \" prolog
.sy cat \\$1\" bring in postscript file
...\" the following line matches the tempdict above
\\!end % tempdict %
\\!PE
\\!.
.sp \\$2u \" move below the image
..
.de pF
.ie \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie !\\*(f4 \{\
. ft \\*(f4
. ds f4\"
' br \}
.el .ie !\\*(f3 \{\
. ft \\*(f3
. ds f3\"
' br \}
.el .ie !\\*(f2 \{\
. ft \\*(f2
. ds f2\"
' br \}
.el .ie !\\*(f1 \{\
. ft \\*(f1
. ds f1\"
' br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
'\" t
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
.TH "lwatch" "1"
.SH "NAME"
\fBlwatch\fR \(em syntax highlighting for syslog/syslog-ng file
.SH "SYNOPSIS"
.PP
\fBlwatch\fP [-C \fIfilename\fP] [--config \fIfilename\fP] [-f \fIfilename\fP] [--fifo \fIfilename\fP] [-coh] [--create-fifo] [--omit-rc] [--help]
.SH "Description"
.PP
The lwatch is a log colorizer. It reads syslog/syslog-ng data
from named fifo or from stdin and displays colored logs into
stdout.
.PP
The lwatch is highly user-customizable. It reads configuration
data from file @CONFDIR@/lwatch.conf or (if given) from file provided with option
\fB-C\fP
.PP
The way it works is simple. It reads a line from input, splits it
into four parts: date, hostname, service name (with PID, if available)
and real message. Each part has its own default color. You can redefine
them in configuration file. Default colors as the same as in loco(1)
[see: http://zjuul.net/~jules/loco/]. But lwatch is not only a static log
colorizer. It is something more. It can colorize your logs any way
you wish. You are able to set a new color for any part (date, host,
service, message) using regexp based patterns.
.SH "Configuration file"
.PP
There is no documentation for configuration file as for now. Look at
provided file, there are a lot of comments there.
.PP
I am going to make some changes in configuration file before
1.0-stable release. I will also provide docs about how to configure lwatch
in this release.
.SH "Command line options"
.PP
Type lwatch -h for options and their description.
.SH "Running"
.PP
Preferred way to run lwatch is to read syslog messages from named fifo or from standard input.
.PP
If you use syslog you really want to read messages from named fifo.
To do it put a line:
.PP
.nf
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
*.* |/tmp/your_fifo
.fi
in your syslog.conf. Create apropriate fifo and restart syslog, then run
lwatch. You can also run lwatch before starting syslog.
.PP
Remember:
.IP " \(bu" 6
fifo must exists
.IP " \(bu" 6
proper name must be put in @CONFDIR@/lwatch.conf
.PP
In syslog-ng you can run lwatch directly from syslog, i.e.:
.PP
.nf
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
log { source(src); destination(console_all);};
destination console_all {program("/usr/bin/lwatch -f- > /dev/tty11"); };
.fi
.SH "Copyright"
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
...\" created by instant / docbook-to-man, Mon 17 Mar 2003, 15:39
|