summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRainer Gerhards <rgerhards@adiscon.com>2009-06-19 14:25:27 +0200
committerRainer Gerhards <rgerhards@adiscon.com>2009-06-19 14:25:27 +0200
commit953d015f440224321796105464294006838b5302 (patch)
tree0f8401957af4b7adbbf6120f7a224cffd632de63 /doc
parentcbad28915a847d9ad461d8099e90ad7903d537a3 (diff)
downloadrsyslog-953d015f440224321796105464294006838b5302.tar.gz
rsyslog-953d015f440224321796105464294006838b5302.tar.xz
rsyslog-953d015f440224321796105464294006838b5302.zip
switched default to keep in line with traditional syslogd behaviour
Diffstat (limited to 'doc')
-rw-r--r--doc/rsyslog_conf_global.html7
1 files changed, 5 insertions, 2 deletions
diff --git a/doc/rsyslog_conf_global.html b/doc/rsyslog_conf_global.html
index d58bcac0..332b6282 100644
--- a/doc/rsyslog_conf_global.html
+++ b/doc/rsyslog_conf_global.html
@@ -196,13 +196,16 @@ supported in order to be compliant to the upcoming new syslog RFC series.
of the output file. The higher the number, the better the compression, but also the
more CPU is required for zipping.</li>
<li><b>$OMFileIOBufferSize</b> &lt;size_nbr&gt;, default 4k, size of the buffer used to writing output data. The larger the buffer, the potentially better performance is. The default of 4k is quite conservative, it is useful to go up to 64k, and 128K if you used gzip compression (then, even higher sizes may make sense)</li>
-<li><b>$OMFileFlushOnTXEnd</b> &lt;[on/<b>off</b>]&gt;, default off, by default, omfile
+<li><b>$OMFileFlushOnTXEnd</b> &lt;[<b>on</b>/off]&gt;, default on. Omfile has the
+capability to
writes output using a buffered writer. Disk writes are only done when the buffer is
full. So if an error happens during that write, data is potentially lost. In cases where
this is unacceptable, set $OMFileFlushOnTXEnd to on. Then, data is written at the end
of each transaction (for pre-v5 this means after <b>each</b> log message) and the usual
error recovery thus can handle write errors without data loss. Note that this option
-severely reduces the effect of zip compression.</li>
+severely reduces the effect of zip compression and should be switched to off
+for that use case. Note that the default -off- is primarily an aid to preserve
+the traditional syslogd behaviour.</li>
<li><b>$RepeatedMsgContainsOriginalMsg</b> [on/<b>off</b>] - "last message repeated n times" messages, if generated,
have a different format that contains the message that is being repeated.
Note that only the first "n" characters are included, with n to be at least 80 characters, most