epylog-modules(5)						Applications/System						 epylog-modules(5)

NAME

       epylog-modules - epylog module cofiguration.

SYNOPSIS

       epylog  uses  pluggable	modules  to  perform  analysis and report on syslog strings. This manpage explains the format of the module config
       files.

modules.d
       Epylog config files are placed in the modules.d directory of the cfgdir specified in epylog.conf. Any file ending in .conf in  that  direc-
       tory is considered a module config file. Most common location for modules.d directory is in /etc/epylog/modules.d.

module.conf
       The name of the config file doesn't carry much meaning, however it MUST end in .conf in order to be recognized as a module config file.

       The config file for each module is separated into two parts: [module] and [conf].

[module]
       desc   The description of the module. It will be shown in the final report.

       exec   This  is	where  the "body" of the module is located. Most modules that come with the distribution will be placed in /usr/share/epy-
	      log/modules, but depending on your setup, you may place them elsewhere.

       files  List the logfiles requested by this module in this field. Separate multiple entries by comma. Epylog will handle rotated files,  but
	      you  need to specify the mask appropriately. E.g. the most common logrotate setup will place rotated files in the same directory and
	      add .0, .1, .2, etc to the end of the file. Therefore, a file entry would look like so:
	      /var/log/filename[.#]
	      If you have compression turned on, your entry will look like so:
	      /var/log/filename[.#.gz]
	      Lastly, for advanced configurations, more complex entries may be required. E.g. if your logrotate saves rotated files in a subdirec-
	      tory in /var/log, you can specify it like so:
	      /var/log/[rotate/]filename[.#.gz]
	      This will work, too:
	      /var/log/filename[/var/rotate/filename.#.gz]
	      In any case, "#" will be where the increments will go.

       enabled
	      Can be either "yes" or "no". If "no" is specified, Epylog will completely ignore this module.

       internal
	      Can  be  either "yes" or "no". If "yes", then the module is handled as an internal module, and if "no", then the external module API
	      is used. See doc/modules.txt for more information about the module APIs.

       outhtml
	      Specifies whether the output produced by the module is HTML or not. Can be either "yes" or "no".

       priority
	      An unsigned int. Most commonly a number from 0 to 10. Modules with the lowest number will be considered  the  highest  prioroty  and
	      will be both invoked and presented in the final report before the others.

[conf]
       This  is where per-module configuration directives go. Some modules have these, some don't. Look in the module config file -- the available
       values should be listed and described there.

COMMENTS

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

AUTHORS

       Konstantin Ryabitsev <icon@linux.duke.edu>

SEE ALSO

       epylog(8), Epylog(3), epylog.conf(5)

Konstantin Ryabitsev							1.0							 epylog-modules(5)