summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRainer Gerhards <rgerhards@adiscon.com>2008-11-10 09:57:49 +0100
committerRainer Gerhards <rgerhards@adiscon.com>2008-11-10 09:57:49 +0100
commitb4729996790c0f7a0b2758d9ee809b7cc10dec8f (patch)
tree471f8ab37828e694674e0c278bb2c797ed25c420 /doc
parentaaab9bb8a6d6249bff9642a67ef97cfb09e58b3b (diff)
downloadrsyslog-b4729996790c0f7a0b2758d9ee809b7cc10dec8f.tar.gz
rsyslog-b4729996790c0f7a0b2758d9ee809b7cc10dec8f.tar.xz
rsyslog-b4729996790c0f7a0b2758d9ee809b7cc10dec8f.zip
doc update: documented how to specify multiple property replacer options
abd link to new online regex generator tool added
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.html1
-rw-r--r--doc/property_replacer.html11
2 files changed, 12 insertions, 0 deletions
diff --git a/doc/manual.html b/doc/manual.html
index cbb3477d..61b16527 100644
--- a/doc/manual.html
+++ b/doc/manual.html
@@ -35,6 +35,7 @@ the links below for the</b><br></p><ul>
<li><a href="rsyslog_conf.html">configuration file syntax (rsyslog.conf)</a></li>
<li> <a href="property_replacer.html">property
replacer, an important core component</a></li>
+<li><a href="http://www.rsyslog.com/tool-regex">a regular expression checker/generator tool for rsyslog</a></li>
<li>a commented <a href="sample.conf.html">sample
rsyslog.conf</a>
</li>
diff --git a/doc/property_replacer.html b/doc/property_replacer.html
index 367c8add..0b4f1a01 100644
--- a/doc/property_replacer.html
+++ b/doc/property_replacer.html
@@ -231,6 +231,13 @@ the full field if no match is found:
<p>%msg:R,ERE,1,FIELD:for (vlan[0-9]*):--end%
<p>and this takes the first submatch of the second match of said expression:
<p>%msg:R,ERE,1,FIELD,1:for (vlan[0-9]*):--end%
+<p><b>Please note: there is also a
+<a href="http://www.rsyslog.com/tool-regex">rsyslog regular expression checker/generator</a>
+online tool available.</b> With that tool, you can check your regular expressions and
+also generate a valid property replacer sequence. Usage of this tool is recommended.
+Depending on the version offered, the tool may not cover all subleties that can
+be done with the property replacer. It concentrates on the most often used cases. So it
+is still useful to hand-craft expressions for demanding environments.
<p><b>Also, extraction can be done based on so-called
"fields"</b>. To do so, place a "F" into FromChar. A field in its
current definition is anything that is delimited by a delimiter
@@ -347,6 +354,10 @@ Useful for secure pathname generation (with dynafiles).
</tr>
</tbody>
</table>
+<p>To use multiple options, simply place them one after each other with a comma delmimiting
+them. For example "escape-cc,sp-if-no-1st-sp". If you use conflicting options together,
+the last one will override the previous one. For example, using "escape-cc,drop-cc" will
+use drop-cc and "drop-cc,escape-cc" will use escape-cc mode.
<h2>Further Links</h2>
<ul>
<li>Article on "<a href="rsyslog_recording_pri.html">Recording