summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRainer Gerhards <rgerhards@adiscon.com>2008-08-05 15:02:49 +0200
committerRainer Gerhards <rgerhards@adiscon.com>2008-08-05 15:02:49 +0200
commit15adf8f1fda97b5c744e92390ef7e41ce3d7f3b2 (patch)
tree8a70d11e1c38d74621ef4cdf0abe95c1c9a364ab /doc
parent87576f85699afd0aba3f8a3716b343f8f568d1f0 (diff)
downloadrsyslog-15adf8f1fda97b5c744e92390ef7e41ce3d7f3b2.tar.gz
rsyslog-15adf8f1fda97b5c744e92390ef7e41ce3d7f3b2.tar.xz
rsyslog-15adf8f1fda97b5c744e92390ef7e41ce3d7f3b2.zip
bugfix: IPv6 addresses could not be specified in forwarding actions
New syntax @[addr]:port introduced to enable that. Root problem was IPv6 addresses contain colons. Also somewhat enhanced debugging messages.
Diffstat (limited to 'doc')
-rw-r--r--doc/rsyslog_conf.html11
1 files changed, 10 insertions, 1 deletions
diff --git a/doc/rsyslog_conf.html b/doc/rsyslog_conf.html
index 39e69c90..d3858941 100644
--- a/doc/rsyslog_conf.html
+++ b/doc/rsyslog_conf.html
@@ -788,7 +788,7 @@ administration needs.<br>
forward messages it has received from the network to another host.
Specify the "-h" option to enable this.</b></p>
<p>To forward messages to another host, prepend the hostname with
-the at sign ("@").&nbsp; A single at sign means that messages will
+the at sign ("@"). A single at sign means that messages will
be forwarded via UDP protocol (the standard for syslog). If you prepend
two at signs ("@@"), the messages will be transmitted via TCP. Please
note that plain TCP based syslog is not officially standardized, but
@@ -871,6 +871,15 @@ port 1470.</p>
<p>In the example above, messages are forwarded via UDP to the
machine 192.168.0.1, the destination port defaults to 514. Messages
will not be compressed.</p>
+<p>Note that IPv6 addresses contain colons. So if an IPv6 address is specified
+in the hostname part, rsyslogd could not detect where the IP address ends
+and where the port starts. Since rsyslog 3.21.3 there is a syntax extension to support this:
+put squary brackets around the address (e.g. "[2001::1]"). Square
+brackets also work with real host names and IPv4 addresses, too.
+<p>A valid sample to send messages to the IPv6 host 2001::1 at port 515
+is as follows:
+<p>*.* @[2001::1]:515
+<p>This works with TCP, too.
<p><b>Note to sysklogd users:</b> sysklogd does <b>not</b>
support RFC 3164 format, which is the default forwarding template in
rsyslog. As such, you will experience duplicate hostnames if rsyslog is