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)

Xymon                                      Version 4.3.7: 13 Dec 2011                                LOGFETCH(1)