diff options
author | Rodrigo G. López <r.gonzalez@telfy.com> | 2020-08-26 11:00:11 +0200 |
---|---|---|
committer | Rodrigo G. López <r.gonzalez@telfy.com> | 2020-08-26 11:00:11 +0200 |
commit | e2e807dd68ad1e0708e8a2ab8f81c64da7695456 (patch) | |
tree | 62edc8a653a18fbe028536c955d69a321743fea8 /logwatch.8.man | |
download | logwatch-master.tar.gz logwatch-master.tar.bz2 logwatch-master.zip |
initial release.master
Diffstat (limited to 'logwatch.8.man')
-rw-r--r-- | logwatch.8.man | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/logwatch.8.man b/logwatch.8.man new file mode 100644 index 0000000..9613f5f --- /dev/null +++ b/logwatch.8.man @@ -0,0 +1,41 @@ +.TH LOGWATCH 8 +.SH NAME +logwatch \- log file stalker +.SH SYNOPSIS +.PP +.B logwatch +[ +.B -d +] [ +.B -t +.I perc +] +.I logfile +.SH DESCRIPTION +.I logwatch +uses +.I inotify (7) +watches to monitor changes in a specific +.IR logfile . +It also monitors its parent directory, so it can track local movements (e.g. log rotations). +If the +.I logfile +exceeds an established disk quota, it is truncated to half its size, keeping the latest data. +.PP +The flags are: +.TP +.B d +Enable debugging output. +.TP +.B t +Sets a percentage +.I perc +for the disk usage threshold the file cannot exceed. The available quota is 100\-perc%. +By default the threshold is set to 5%. +.SH SEE ALSO +.IR inotify (7), +.IR logrotate (8). +.SH BUGS +The heuristics used to clamp the file are faulty, if the disk is already filled to the threshold, the program assumes it's the log file's fault and truncates it. +.br +Slicing the file in half isn't necessarily the best approach. More disk usage statistics are needed to make an informed decision. |