1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
.TH "logprn" "1" "0.06" "Russell Coker <russell@coker.com.au>" "logtools"
.SH "NAME"
logprn \- merge Common\-Log Format web logs based on time\-stamps
.SH "SYNOPSIS"
.B logprn logfile idle\-time[:max\-wait] command
.SH "DESCRIPTION"
The
.B logprn
program is designed to print new data that is appended to log files. It will
wait until a specified amount of time has elapsed since the last write to the
file before printing the data. It will print the data by pipeing it to a
specified command. The command will be run by popen(3) so the usual shell
commands will operate (whether this is a bug or a feature is a matter of
opinion).
.SH "OPTIONS"
.TP
.B logfile
specifies a file to read data from. It should be a regular file not a pipe,
device, or anything else.
.TP
.B idle\-time
.TP
.B max\-wait
.TP
.B command
.SH "EXIT STATUS"
.B 0
Never happens, this program will run forever.
.P
.B 1
Bad command\-line parameters or couldn't stat the log file on startup \- couldn't start the program.
.P
.B 2
File disappeared or became unreadable at run\-time.
.P
.B 3
Can't run the specified command.
.SH "AUTHOR"
This program, its manual page, and the Debian package were written by
Russell Coker <russell@coker.com.au>.
.SH "BUGS"
Uses
.B popen (3)
but I consider this a feature not a bug.
.SH "SEE ALSO"
.BR popen (3)
|
