summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/mmutf8fix.html11
1 files changed, 10 insertions, 1 deletions
diff --git a/doc/mmutf8fix.html b/doc/mmutf8fix.html
index 1a98f660..e8020685 100644
--- a/doc/mmutf8fix.html
+++ b/doc/mmutf8fix.html
@@ -57,7 +57,8 @@ control characters are NOT being replaced, because they are valid UTF-8.
<br>In <b>controlcharacters</b> mode, all bytes which do not represent a
printable US-ASCII character (codes 32 to 126) are replaced. Note that this
also mangles valid UTF-8 multi-byte sequences, as these are (deliberately) outside
-of that character range.
+of that character range. This mode is most useful if it is known that no
+characters outside of the US-ASCII alphabet need to be processed.
<li><b>replacementChar</b> - default " " (space), a single character<br>
This is the character that invalid sequences are replaced by. Currently, it
MUST be a <b>printable</b> US-ASCII character.
@@ -85,6 +86,14 @@ if $fromhost-ip == "10.0.0.1" then
# all other actions here...
</textarea>
+<p>This is mostly the same as the previous sample, but uses "controlcharacters"
+processing mode.
+<p><textarea rows="5" cols="60">module(load="mmutf8fix")
+if $fromhost-ip == "10.0.0.1" then
+ action(type="mmutf8fix" mode="controlcharacters")
+# all other actions here...
+</textarea>
+
<p>[<a href="rsyslog_conf.html">rsyslog.conf overview</a>] [<a href="manual.html">manual
index</a>] [<a href="http://www.rsyslog.com/">rsyslog site</a>]</p>
<p><font size="2">This documentation is part of the