The 'Kazimir' tag is used to define the characteristics of the Kazimir program itself.
This tag is the only one that should be found only once in the configuration file. It is of course possible to put several Kazimir tag but only
the last one in the config file will be used (because it will be the last to be parsed).
Each of these characteristic is associated with a keyword . All this keywords are mandatory, but not TmpDir, PrologueCmd and EpilogueCmd.
The keyword and and significance are
LogFile : the location of the Kazimir log
EventDir: the path of the directory that will receive the event completion records
OutputDir: the path of the directory for the external command output records.
TmpDir: the path to the directory for temporary files (usually stdout and stderr from coroutines). Default value is /tmp
LockFile: the location of the lockfile. Kazimir does nothing as long as this file exists.
EventUpdateInt: shows the delay between two event check passes. This is a time postfixed notation (see below)
IdleTime: an optional tag used to define the number of seconds to stay idle between two events' checks. This could be used for avoiding a load on the CPU due to Kazimir. This value should not be to large in order not to collide with the other definitions.
SelectTime: an optional tag, for advanced use only. The Kazimir software is mostly a loop that checks for new information coming from the logs. This is do by a call to the 'select' function 2.2. There is a timeout interval to be specified for the select. The duration for the timeout is to be set here. The default is 450ms. A value of -1 will totally
disable the timeout. This is pretty useful for saving CPU (Kazimir does nothing if no new informations come), BUT
it prevents you from detecting the non-production of a pattern and nothing will be displayed in the Kazimir's log if nothing happens in any log (the call to select will hang until something occurs)
PrologueCmd : an optional tag, used to specify a command to be ran at the time Kazimir starts, before proceeding into the main event loop. The command can contain variables managed by Kazimir (see the section about variables for details). This is not a mandatory field, no command will be executed if it is not specified.
EpilogueCmd : an optional tag, used to specify a command to be ran at the time Kazimir ends, after a SIGINT or SIGTERM was received. The command can contain variables managed by Kazimir (see the section about variables for details). I strongly suggest to put "clean up" commands in this field. This is not a mandatory field, no command will be executed if it is not specified.
The IdleTime is a field that is optional and to be used very carefully. When set it makes Kazimir
sleep the duration indicated just after the Event Checking pass. During this time Kazimir does
nothing. This is a good way of making Kazimir consume less CPU, but it can badly interfere with
Event processing and make you looses event occurrences if set too big
