NAME

       logfetch - Xymon client data collector

SYNOPSIS

       logfetch CONFIGFILE STATUSFILE

DESCRIPTION

       logfetch is part of the Xymon client. It is responsible for collecting data from logfiles,
       and other file-related data, which is then sent to the Xymon server for analysis.

       logfetch uses a configuration file,  which  is  automatically  retrieved  from  the  Xymon
       server.  There  is no configuration done locally. The configuration file is usually stored
       in the $XYMONHOME/tmp/logfetch.cfg file, but editing this file has no effect since  it  is
       re-written with data from the Xymon server each time the client runs.

       logfetch stores information about what parts of the monitored logfiles have been processed
       already in the $XYMONHOME/tmp/logfetch.status file. This file is an internal file used  by
       logfetch, and should not be edited. If deleted, it will be re-created automatically.

SECURITY

       logfetch  needs read access to the logfiles it should monitor. If you configure monitoring
       of files or directories through the "file:" and "dir:" entries in client-local.cfg(5) then
       logfetch  will  require at least read-acces to the directory where the file is located. If
       you request checksum calculation for a file, then it must be readable by the Xymon  client
       user.

       Do  NOT install logfetch as suid-root. There is no way that logfetch can check whether the
       configuration file it uses has been tampered with, so installing logfetch  with  suid-root
       privileges  could allow an attacker to read any file on the system by using a hand-crafted
       configuration file. In fact, logfetch will attempt to remove its own suid-root setup if it
       detects that it has been installed suid-root.

ENVIRONMENT VARIABLES

       DU     Command  used  to  collect  information about the size of directories.  By default,
              this is the command du -k. If the local du-command on the client does not recognize
              the   "-k"   option,   you   should   set   the  DU  environment  variable  in  the
              $XYMONHOME/etc/xymonclient.cfg file to a command that does report  directory  sizes
              in kilobytes.

FILES

       $XYMONHOME/tmp/logfetch.cfg

       $XYMONHOME/tmp/logfetch.status

SEE ALSO

       xymon(7), analysis.cfg(5)