1LOGWATCH(8)                      User Manuals                      LOGWATCH(8)
2
3
4

NAME

6       logwatch - system log analyzer and reporter
7

SYNOPSIS

9       logwatch  [--detail level ] [--logfile log-file-group ] [--service ser‐
10       vice-name ] [--mailto address ] [--archives] [--range range ]  [--debug
11       level  ]  [--filename  file-name  ]  [--logdir directory ] [--hostlimit
12       hosts ] [--hostname hostname ]  [--html_wrap  number  of  characters  ]
13       [--hostformat  host  based  options ] [--output output-type ] [--format
14       report format ] [--subject email subject ] [--encode encoding to use  ]
15       [--numeric] [--version] [--help|--usage]
16

DESCRIPTION

18       Logwatch  is  a customizable, pluggable log-monitoring system.  It will
19       go through your logs for a given period of time and make  a  report  in
20       the areas that you wish with the detail that you wish.  Logwatch is be‐
21       ing used for Linux and many types of UNIX.
22

OPTIONS

24       --detail level
25              This is the detail level of the report.  level can be a positive
26              integer, or high, med, low, which correspond to the integers 10,
27              5, and 0, respectively.
28
29       --logfile log-file-group
30              This will force Logwatch to process only the set of logfiles de‐
31              fined by log-file-group (i.e. messages, xferlog, ...).  Logwatch
32              will therefore process all services  that  use  those  logfiles.
33              This  option can be specified more than once to specify multiple
34              logfile-groups.
35
36       --service service-name
37              This will force Logwatch to process only the  service  specified
38              in  service-name  (i.e. login, pam, identd, ...).  Logwatch will
39              therefore also process any log-file-groups necessary to  process
40              these  services.  This option can be specified more than once to
41              specify multiple services to process.  A useful service-name  is
42              All  which  will  process  all services (and logfile-groups) for
43              which you have filters installed.
44
45       --mailto address
46              Mail the results to the email address or user specified  in  ad‐
47              dress.
48
49       --range range
50              You  can specify a date-range to process. Common ranges are Yes‐
51              terday, Today, All, and Help.   Additional  options  are  listed
52              when invoked with the Help parameter.
53
54       --archives
55              Each  log-file-group has basic logfiles (i.e. /var/log/messages)
56              as well as archives (i.e. /var/log/messages.?  or  /var/log/mes‐
57              sages.?.gz).   When  used  with  "--range all", this option will
58              make Logwatch search through the archives  in  addition  to  the
59              regular  logfiles.   For  other values of --range, Logwatch will
60              search the appropriate archived logs.
61
62       --debug level
63              For debugging purposes.  level can range from 0  to  100.   This
64              will  really clutter up your output.  You probably don't want to
65              use this.
66
67       --filename file-name
68              Save the output to file-name instead of  displaying  or  mailing
69              it.
70
71       --logdir directory
72              Look  in directory for log subdirectories or log files first be‐
73              fore looking in the default directories.
74
75       --hostlimit host1,host2
76              Limit report to hostname - host1, host2.
77
78       --hostname hostname
79              Use hostname for the reports instead of this system's  hostname.
80              In addition, if HostLimit is set in the logwatch.conf configura‐
81              tion file (see MORE INFORMATION, below),  then  only  logs  from
82              this hostname will be processed (where appropriate).
83
84       --html_wrap num-characters
85              Number  of characters that html output should be wrapped to. De‐
86              fault is 80.
87
88       --hostformat split
89              Use split approach when formatting report for multiple  hosts  -
90              none [default], split, splitmail.
91
92       --output output-type
93              Report using output-type - stdout [default], mail, file.
94
95       --format format
96              Format report using format - text [default], html.
97
98       --subject email-subject
99              Customize  the  email subject sent by Logwatch.  Option --output
100              must be set to mail.
101
102       --encode encoding
103              Encode report using encoding -  none  [default],  base64,  7bit,
104              8bit [same as 'none'].
105
106       --numeric
107              Inhibits additional name lookups, displaying IP addresses numer‐
108              ically.
109
110       --usage
111              Displays usage information
112
113       --help same as --usage.
114

FILES

116       /usr/share/logwatch/
117              This directory contains all the perl executables and  configura‐
118              tion files shipped with the logwatch distribution.
119
120       /etc/logwatch
121              This  directory contains local configuration files that override
122              the default configuration.  See MORE INFORMATION below for  more
123              information.
124

EXAMPLES

126       logwatch --service ftpd-xferlog --range all --detail high --archives
127              This  will  print  out  all FTP transfers that are stored in all
128              current and archived xferlogs.
129       logwatch --service pam_pwdb --range yesterday --detail high
130              This will print out login information for the previous day...
131

MORE INFORMATION

133       The directory /usr/share/doc/logwatch-* contains several files with ad‐
134       ditional documentation:
135       HOWTO-Customize-LogWatch
136              Documents  the directory structure of Logwatch configuration and
137              executable files, and describes how  to  customize  Logwatch  by
138              overriding these default files.
139       LICENSE
140              Describes  the License under which Logwatch is distributed.  Ad‐
141              ditional clauses may be specified in individual files.
142       README
143              Describes how to install, where to find it, mailing  lists,  and
144              other useful information.
145

AUTHOR

147       Kirk Bauer <kirk@kaybee.org>
148       http://sourceforge.net/projects/logwatch
149
150
151
152Linux                              May 2012                        LOGWATCH(8)
Impressum