diff options
author | Rainer Gerhards <rgerhards@adiscon.com> | 2008-10-23 14:46:47 +0200 |
---|---|---|
committer | Rainer Gerhards <rgerhards@adiscon.com> | 2008-10-23 14:46:47 +0200 |
commit | 6334d335d89ae5df344f833c5095e9dea2abf6fb (patch) | |
tree | 9cd1a8de9e3b94e72b38b0612ba4d90cadccd81d /doc/rsyslog_conf.html | |
parent | cf38fc81759b01af5125b1a05e0d6fe8e2e1bc21 (diff) | |
download | rsyslog-6334d335d89ae5df344f833c5095e9dea2abf6fb.tar.gz rsyslog-6334d335d89ae5df344f833c5095e9dea2abf6fb.tar.xz rsyslog-6334d335d89ae5df344f833c5095e9dea2abf6fb.zip |
added configuration directive "HUPisRestart"
...which enables to configure HUP to be either a full restart
or "just" a leightweight way to close open files
Diffstat (limited to 'doc/rsyslog_conf.html')
-rw-r--r-- | doc/rsyslog_conf.html | 20 |
1 files changed, 13 insertions, 7 deletions
diff --git a/doc/rsyslog_conf.html b/doc/rsyslog_conf.html index be543833..cd3db405 100644 --- a/doc/rsyslog_conf.html +++ b/doc/rsyslog_conf.html @@ -59,17 +59,19 @@ remember, that a modules configuration directive (and functionality) is only available if it has been loaded (using $ModLoad).</p> <h2>Lines</h2> Lines can be continued by specifying a backslash ("\") as the last -character of the line.<br> +character of the line. There is a hard-coded maximum line length of 4K. +If you need lines larger than that, you need to change compile-time +settings inside rsyslog and recompile. <h2>Global Directives</h2> <p>All global directives need to be specified on a line by their own and must start with a dollar-sign. Here is a list in alphabetical order. Follow links for a description.</p> +<p>Please note that not all directives here are actually global. Some affect +only the next action. This documentation will be changed soon. <p>Not all directives have an in-depth description right now. Default values for them are in bold. A more in-depth description will -appear as implementation progresses. Directives may change during that -process, we will NOT try hard to maintain backwards compatibility -(after all, v3 is still very early in development and quite -unstable...). So you have been warned ;)</p> +appear as implementation progresses. +</p> <p><b>Be sure to read information about <a href="queues.html">queues in rsyslog</a></b> - many parameter settings modify queue parameters. If in doubt, use the default, it is usually well-chosen and applicable in most cases.</p> @@ -175,12 +177,16 @@ default 60000 (1 minute)]</li> <li><a href="rsconf1_gssforwardservicename.html">$GssForwardServiceName</a></li> <li><a href="rsconf1_gsslistenservicename.html">$GssListenServiceName</a></li> <li><a href="rsconf1_gssmode.html">$GssMode</a></li> +<li>$HUPisRestart [<b>on</b>/off] - if set to on, a HUP is a full daemon restart. This means any queued messages are discarded (depending +on queue configuration, of course) all modules are unloaded and reloaded. This mode keeps compatible with sysklogd, but is +not recommended for use with rsyslog. To do a full restart, simply stop and start the daemon. The default is "on" for +compatibility reasons. If it is set to "off", a HUP will only close open files. This is a much quicker action and usually +the only one that is needed e.g. for log rotation. <b>It is recommended to set the setting to "off".</b></li> <li><a href="rsconf1_includeconfig.html">$IncludeConfig</a></li><li>MainMsgQueueCheckpointInterval <number></li> <li>$MainMsgQueueDequeueSlowdown <number> [number is timeout in <i> micro</i>seconds (1000000us is 1sec!), default 0 (no delay). Simple rate-limiting!]</li> -<li>$MainMsgQueueDiscardMark <number> [default -9750]</li> +<li>$MainMsgQueueDiscardMark <number> [default 9750]</li> <li>$MainMsgQueueDiscardSeverity <severity> [either a textual or numerical severity! default 4 (warning)]</li> <li>$MainMsgQueueFileName <name></li> |