summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRainer Gerhards <rgerhards@adiscon.com>2012-03-21 11:43:45 +0100
committerRainer Gerhards <rgerhards@adiscon.com>2012-03-21 11:43:45 +0100
commit49ec54d36984b9e91da7bd41e56e65dac22ce830 (patch)
tree09bcb0b68f6ec337bc938e53d95840b75955ebbc /doc
parentdbc2efa6bea0a0ca7ded6d4a5f0378da0aab6936 (diff)
downloadrsyslog-49ec54d36984b9e91da7bd41e56e65dac22ce830.tar.gz
rsyslog-49ec54d36984b9e91da7bd41e56e65dac22ce830.tar.xz
rsyslog-49ec54d36984b9e91da7bd41e56e65dac22ce830.zip
milestone: added capability to use a local interface IP address as fromhost-ip
... for locally originating messages. New directive $LocalHostIPIF. Note that not all modules yet support this new directive - next step...
Diffstat (limited to 'doc')
-rw-r--r--doc/rsyslog_conf_global.html13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/rsyslog_conf_global.html b/doc/rsyslog_conf_global.html
index 21786a7f..86e4bab2 100644
--- a/doc/rsyslog_conf_global.html
+++ b/doc/rsyslog_conf_global.html
@@ -301,6 +301,19 @@ the value, the less precise the timestamp.
<li><b>$Sleep</b> &lt;seconds&gt; - puts the rsyslog main thread to sleep for the specified
number of seconds immediately when the directive is encountered. You should have a
good reason for using this directive!</li>
+<li><b>$LocalHostIPIF</b> &lt;interface name&gt; - (available since 5.9.6) - if provided, the IP of the specified
+interface (e.g. "eth0") shall be used as fromhost-ip for locall-originating messages.
+If this directive is not given OR the interface cannot be found (or has no IP address),
+the default of "127.0.0.1" is used. Note that this directive can be given only
+once. Trying to reset will result in an error message and the new value will
+be ignored. Please note that modules must have support for obtaining the local
+IP address set via this directive. While this is the case for rsyslog-provided
+modules, it may not always be the case for contributed plugins.
+<br><b>Important:</b> This directive shall be placed <b>right at the top of
+rsyslog.conf</b>. Otherwise, if error messages are triggered before this directive
+is processed, rsyslog will fix the local host IP to "127.0.0.1", what than can
+not be reset.
+</li>
<li><a href="rsconf1_umask.html">$UMASK</a></li>
</ul>
<p><b>Where &lt;size_nbr&gt; is specified above,</b>