summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRainer Gerhards <rgerhards@adiscon.com>2007-10-15 06:48:23 +0000
committerRainer Gerhards <rgerhards@adiscon.com>2007-10-15 06:48:23 +0000
commit6a06807e36602a0ece3e8d3865cb2685b45521b2 (patch)
tree84cc1580af915b7a62989e59956373058772464c
parent4eda5a54938140c6602a41c702340fbb7f9ac5bf (diff)
downloadrsyslog-6a06807e36602a0ece3e8d3865cb2685b45521b2.tar.gz
rsyslog-6a06807e36602a0ece3e8d3865cb2685b45521b2.tar.xz
rsyslog-6a06807e36602a0ece3e8d3865cb2685b45521b2.zip
added documentation of module interface / module action designator in
selector line
-rw-r--r--doc/modules.html12
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/modules.html b/doc/modules.html
index aea6b014..df2d4409 100644
--- a/doc/modules.html
+++ b/doc/modules.html
@@ -69,6 +69,18 @@ property replacer. Then, the output module can work with this serialized object.
The key point is that output modules never deal directly with msg objects (and
other internal structures). Besides security, this also greatly simplifies the
job of the output module developer.</p>
+<h2>Action Selectors</h2>
+<p>Modules (and rsyslog) need to know when they are called. For this, there must
+a an action identification in selector lines. There are two syntaxes: the
+single-character syntax, where a single characters identifies a module (e.g. &quot;*&quot;
+for a wall message) and the modules designator syntax, where the module name is
+given between colons (e.g. &quot;:ommysql:&quot;). The single character syntax is
+depreciated and should not be used for new plugins.</p>
+<p>An in-depth discussion of module designation in action selectors can be found
+in this forum thread:</p>
+<p>
+<a href="http://www.rsyslog.com/index.php?name=PNphpBB2&file=viewtopic&p=678#678">
+http://www.rsyslog.com/index.php?name=PNphpBB2&amp;file=viewtopic&amp;p=678#678</a></p>
<h2>Copyright</h2>
<p>Copyright (c) 2007
<a href="http://www.adiscon.com/en/people/rainer-gerhards.php">Rainer Gerhards</a>