summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRainer Gerhards <rgerhards@adiscon.com>2009-07-09 18:14:58 +0200
committerRainer Gerhards <rgerhards@adiscon.com>2009-07-09 18:14:58 +0200
commit834f29da3909ad7f674488c47332652a741d47a7 (patch)
treeecb712e4b081da7d5d3e620a56dbf9f73171bf6e
parent809f0a16e75bf7679a4919c642699a7bb3039ae3 (diff)
downloadrsyslog-834f29da3909ad7f674488c47332652a741d47a7.tar.gz
rsyslog-834f29da3909ad7f674488c47332652a741d47a7.tar.xz
rsyslog-834f29da3909ad7f674488c47332652a741d47a7.zip
added some (very) basic doc on omudpspoof
-rw-r--r--ChangeLog1
-rw-r--r--doc/Makefile.am2
-rw-r--r--doc/omudpspoof.html44
-rw-r--r--doc/rsyslog_conf_modules.html1
4 files changed, 48 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index d4e21081..9b8a1433 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,6 @@
---------------------------------------------------------------------------
Version 5.1.3 [DEVEL] (rgerhards), 2009-07-??
+- enhance: UDP spoofing supported via omudpspoof
- bugfix: message could be truncated after TAG, often when forwarding
This was a result of an internal processing error if maximum field
sizes had been specified in the property replacer.
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 62ec7500..f950f122 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -31,6 +31,8 @@ html_files = \
version_naming.html \
contributors.html \
dev_queue.html \
+ omstdout.html \
+ omudpspoof.html \
omsnmp.html \
ommysql.html \
omoracle.html \
diff --git a/doc/omudpspoof.html b/doc/omudpspoof.html
new file mode 100644
index 00000000..7715b80c
--- /dev/null
+++ b/doc/omudpspoof.html
@@ -0,0 +1,44 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head>
+<title>UDP spoofing output module (omudpspoof)</title>
+</head>
+<body>
+<a href="rsyslog_conf_modules.html">rsyslog module reference</a>
+
+<h1>UDP spoofing output module (omudpspoof)</h1>
+<p><b>Module Name:&nbsp;&nbsp;&nbsp; omstdout</b></p>
+<p><b>Author: </b>David Lang &lt;david@lang.hm&gt; and Rainer Gerhards
+&lt;rgerhards@adiscon.com&gt;</p>
+<p><b>Available Since</b>: 5.1.3</p>
+<p><b>Description</b>:</p>
+<p>This module is similar to the regular UDP forwarder, but permits to
+spoof the sender address.
+<p><b>Configuration Directives</b>:</p>
+<ul>
+<li><b>$ActionUDPSpoofDefaultTemplate</b> &lt;templatename&gt;<br>
+This setting instructs omudpspoof to use a template different from the
+default template for all of its actions that do not have a template specified
+explicitely.
+</ul>
+<b>Caveats/Known Bugs:</b>
+<ul>
+<li><b>IPv6</b> is currently not supported. If you need this capability, please let us
+know via the rsyslog mailing list.
+</ul>
+<p><b>Sample:</b></p>
+<p>The following sample forwards all syslog messages in unmodified form to the
+remote server server.example.com. The sender address 192.0.2.1 is used.
+</p>
+<textarea rows="5" cols="80">$ModLoad omudpspoof
+$template spooftemplate,"192.0.2.1 %rawmsg%"
+*.*&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; :omudpspoof:server.example.com;spooftemplate
+</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
+<a href="http://www.rsyslog.com/">rsyslog</a>
+project.<br>
+Copyright &copy; 2009 by <a href="http://www.gerhards.net/rainer">Rainer Gerhards</a> and
+<a href="http://www.adiscon.com/">Adiscon</a>.
+Released under the GNU GPL version 3 or higher.</font></p>
+</body></html>
diff --git a/doc/rsyslog_conf_modules.html b/doc/rsyslog_conf_modules.html
index df9abeea..f9bdad4a 100644
--- a/doc/rsyslog_conf_modules.html
+++ b/doc/rsyslog_conf_modules.html
@@ -20,6 +20,7 @@ SQLLite, Ingres, Oracle, mSQL)</li>
<li><a href="ommail.html">ommail</a> -
permits rsyslog to alert folks by mail if something important happens</li>
<li><a href="omoracle.html">omoracle</a> - output module for Oracle (native OCI interface)</li>
+<li><a href="omudpspoof.html">omudpspoof</a> - output module sending UDP syslog messages with a spoofed address</li>
<li><a href="imfile.html">imfile</a>
-&nbsp; input module for text files</li>
<li><a href="imrelp.html">imrelp</a> - RELP