LOGWATCH(8)                                               User Manuals                                               LOGWATCH(8)



NAME
       logwatch - system log analyzer and reporter

SYNOPSIS
       logwatch  [--detail  level  ]  [--logfile log-file-group ] [--service service-name ] [--print] [--mailto address ] [--ar-
       chives] [--range range ] [--debug level ] [--save file-name ] [--logdir directory ] [--hostname hostname ] [--splithosts]
       [--multiemail] [--output output-type ] [--numeric] [--no-oldfiles-log] [--version] [--help|--usage]

DESCRIPTION
       Logwatch is a customizable, pluggable log-monitoring system.  It will go through your logs for a given period of time and
       make a report in the areas that you wish with the detail that you wish.  Logwatch is being used for Linux and many  types
       of UNIX.

OPTIONS
       --detail level
              This  is  the detail level of the report.  level can be a positive integer, or high, med, low, which correspond to
              the integers 10, 5, and 0, repectively.

       --logfile log-file-group
              This will force Logwatch to process only the set of logfiles defined by log-file-group  (i.e.  messages,  xferlog,
              ...).   Logwatch  will  therefore process all services that use those logfiles.  This option can be specified more
              than once to specify multiple logfile-groups.

       --service service-name
              This will force Logwatch to process only the service specified in service-name (i.e.  login,  pam,  identd,  ...).
              Logwatch  will therefore also process any log-file-groups necessary to process these services.  This option can be
              specified more than once to specify multiple services to process.  A useful service-name is All which will process
              all services (and logfile-groups) for which you have filters installed.

       --print
              Print the results to stdout (i.e. the screen).

       --mailto address
              Mail the results to the email address or user specified in address.  This option overrides the --print option.

       --range range
              You  can  specify  a date-range to process. Common ranges are Yesterday, Today, All, and Help.  Additional options
              are listed when invoked with the Help parameter.

       --archives
              Each log-file-group has basic logfiles (i.e. /var/log/messages) as well as archives (i.e.  /var/log/messages.?  or
              /var/log/messages.?.gz).  When used with "--range all", this option will make Logwatch search through the archives
              in addition to the regular logfiles.  For other values of --range, Logwatch will search the  appropriate  archived
              logs.

       --debug level
              For  debugging  purposes.   level can range from 0 to 100.  This will really clutter up your output.  You probably
              don't want to use this.

       --save file-name
              Save the output to file-name instead of displaying or mailing it.

       --logdir directory
              Look in directory for log subdirectories or log files instead of the default directory.

       --hostname hostname
              Use hostname for the reports instead of this system's hostname.  In addition, if HostLimit  is  set  in  the  log-
              watch.conf  configuration  file (see MORE INFORMATION, below), then only logs from this hostname will be processed
              (where appropriate).

       --numeric
              Inhibits additional name lookups, displaying IP addresses numerically.

       --no-oldfiles-log
              Suppress the logwatch log, which informs about the old files in logwatch tmpdir.

       --help Displays usage information.

FILES
       /usr/share/logwatch/
              This directory contains all the perl executables and configuration files shipped with the logwatch distribution.

       /etc/logwatch
              This directory contains local configuration files that override the default configuration.  See  MORE  INFORMATION
              below for more information.

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

MORE INFORMATION
       The directory /usr/share/doc/logwatch-* contains several files with additional documentation:
       HOWTO-Customize-LogWatch
              Documents  the  directory structure of Logwatch configuration and executable files, and describes how to customize
              Logwatch by overriding these default files.
       License
              Describes the License under which Logwatch is distributed.  Additional clauses  may  be  specified  in  individual
              files.
       README
              Describes how to install, where to find it, mailing lists, and other useful information.

AUTHOR
       Kirk Bauer <kirkATkaybee.org>
       http://www.kaybee.org/~kirk
       ftp://ftp.kaybee.org/pub/redhat/RPMS



Linux                                                     October 2005                                               LOGWATCH(8)