Provided by: epylog_1.0.3-7_all bug

NAME

       epylog.conf - epylog configuration

SYNOPSIS

       epylog config file is a simple plaintext file in win.ini style format.

Location

       Epylog  will  look  in  /etc/epylog/epylog.conf by default, but you can
       override that by passing -c switch on the command line.

[main]

       cfgdir This  is  where  epylog  should  look  for  other  configuration
              information,  most  notably,  modules.d  directory.  See epylog-
              modules(5) for more info.

       tmpdir Where to create temporary directories and put  temporary  files.
              Note  that  log  files can grow VERY big and epylog might create
              several copies of them for processing purposes. Make sure  there
              is  no  danger  of  filling up that partition. A good place on a
              designated loghost is /var/tmp, since that is usually a separate
              partition dedicated entirely for logs.

       vardir Where  epylog should save its state data, namely the offsets.xml
              file. The sanest place for this is /var/lib/epylog.

       multimatch
              By default, if a line is matched  against  a  module,  no  other
              modules  will be tried. This helps speed things up tremendously.
              However, you may have several  modules  that  process  the  same
              lines (although this is not a very good setup). In that case you
              may set this to "yes". The default value is "no".

       threads
              How many processing threads to  start.  50  is  a  good  default
              value,  but  you  may  set it to less or more, depending on your
              system.

[report]

       title  What should be the title of the report. For mailed reports, this
              is  the  subject  of  the message. For the ones published on the
              web, this is the title of the page (as in <title></title>).

       template
              Which html template should be used for the final report. See the
              source of the default template for the format used.

       include_unparsed
              Can  be either "yes" or "no". If "no" is specified, strings that
              didn't match any of the modules will  not  be  appended  to  the
              report. Not very wise! A good setting is "yes".

       publishers
              Lists  the  publishers  to  use.  The  value  is the name of the
              section where to look for the publisher configuration. E.g.:
              publishers = nfspub
              will  look  for  a  section  called  "[nfspub]"  for   publisher
              initialization. The name of the publisher has nothing to do with
              the method it uses for publishing. The fact that the default are
              named  [file]  and  [mail] is only a matter of convenience. List
              multiple values separated by a comma.

Mail Publisher

       method Method must be set to "mail" for this publisher to be considered
              a mail publisher.

       smtpserv
              Can  be  either  a  hostname  of  an  SMTP server to use, or the
              location of a sendmail binary. If the value starts with a "/" it
              will be considered a path. E.g. valid entries:
              smtpserv = mail.example.com
              smtpserv = /usr/sbin/sendmail -t

       mailto The  list  of email addresses where to mail the report. Separate
              multiple entries by a comma. If ommitted, "root@localhost"  will
              be used.

       format Can  be one of the following: html, plain, or both. If you use a
              mail client that doesn't support html mail, then you better  use
              "plain"  or  "both",  though  you will miss out on visual cueing
              that epylog uses to notify of important events.

       lynx   This is only useful if you use format other than "html".  Epylog
              will  use  a  lynx-compliant  tool  to transform HTML into plain
              text. The following browsers are known to  work:  lynx,  elinks,
              w3m.

       include_rawlogs
              Whether to include the gzipped raw logs with the message. If set
              to "yes", it will attach the file with all processed  logs  with
              the message. If you use a file publisher in addition to the mail
              publisher, this may be a tad too paranoid.

       rawlogs_limit
              If the  size  of  rawlogs.gz  is  more  than  this  setting  (in
              kilobytes),  then  raw  logs will not be attached. Useful if you
              have a 50Mb log and check your mail over a slow uplink.

File Publisher

       method Method must be set to "file" for this config to work as  a  file
              publisher.

       path   Where to place the directories with reports. A sensible location
              would be in /var/www/html/epylog.  Note  that  the  reports  may
              contain   sensitive  information,  so  make  sure  you  place  a
              .htaccess in that directory and require a password, or limit  by
              host.

       dirmask, filemask
              These  are  the masks to be used for the created directories and
              files. For format values look at  strftime  documentation  here:
              http://www.python.org/doc/current/lib/module-time.html

       expire_in
              A  digit  specifying  the  number  of  days  after which the old
              directories should be removed. Default is 7.

       notify Optionally send notifications to these email addresses when  new
              reports  become  available.  Comment  out  if no notification is
              desired. This is definitely redundant if you also use  the  mail
              publisher.

       smtpserv
              Use this smtp server when sending notifications. Can be either a
              hostname or a path to sendmail. Defaults to  "/usr/sbin/sendmail
              -t".

       pubroot
              When  generating a notification message, use this as publication
              root to make a link. E.g.:
              pubroot = http://www.example.com/epylog
              will                make                 a                 link:
              http://www.example.com/epylog/dirname/filename.html

COMMENTS

       Lines starting with "#" will be considered commented out.

AUTHORS

       Konstantin Ryabitsev <icon@linux.duke.edu>

SEE ALSO

       epylog(3), epylog(8), epylog-modules(5)