diff options
author | Rainer Gerhards <rgerhards@adiscon.com> | 2011-07-11 10:08:16 +0200 |
---|---|---|
committer | Rainer Gerhards <rgerhards@adiscon.com> | 2011-07-11 10:08:16 +0200 |
commit | d66d3d6033aae584bfc622f3f9dcddc4f152c308 (patch) | |
tree | 1d9b8097ef0f1c32bd2f0d6b038cfea4c58efc4c /doc/v4compatibility.html | |
parent | 398966be6d5a94d2602a08305b0533bf4a502a95 (diff) | |
download | rsyslog-d66d3d6033aae584bfc622f3f9dcddc4f152c308.tar.gz rsyslog-d66d3d6033aae584bfc622f3f9dcddc4f152c308.tar.xz rsyslog-d66d3d6033aae584bfc622f3f9dcddc4f152c308.zip |
added warning message for old-style outchannel syntax
Diffstat (limited to 'doc/v4compatibility.html')
-rw-r--r-- | doc/v4compatibility.html | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/v4compatibility.html b/doc/v4compatibility.html index 5d877af1..72b0f5a9 100644 --- a/doc/v4compatibility.html +++ b/doc/v4compatibility.html @@ -74,4 +74,23 @@ So it is a good idea to become ready for the new version now and also enjoy some benefits of the "real restart", like the better error-reporting capability. <p>Note that code complexity reduction (and thus performance improvement) needs the restart-type HUP code to be removed, so these changes can (and will) only happen in version 5. +<h2>outchannels</h2> +Note: as always documented, outchannels are an experimental feature that may be +removed and/or changed in the future. +There is one concrete change done starting with 4.6.7: let's assume an +outchannel "mychannel" was defined. Then, this channel could be used inside an +<code> +*.* $mychannel +</code> +This is still supported and will remain to be supported in v4. However, there is +a new variant which explicitely tells this is to be handled by omfile. This new +syntax is as follows: +<code> +*.* :omfile:$mychannel +</code> +Note that future versions, specifically starting with v6, the older syntax is no +longer supported. So users are strongly advised to switch to the new syntax. As an +aid to the conversion process, rsyslog 4.7.4 and above issue a warning message +if the old-style directive is seen -- but still accept the old syntax without +any problems. </body></html> |