From b39a751bbe832d98754cd3aa8cf08b53c85ca73c Mon Sep 17 00:00:00 2001 From: Rainer Gerhards Date: Thu, 27 Dec 2007 11:22:08 +0000 Subject: added new settings --- doc/rsyslog_conf.html | 5 ++++- doc/v3compatibility.html | 28 +++++++++++++++++++++++++--- 2 files changed, 29 insertions(+), 4 deletions(-) diff --git a/doc/rsyslog_conf.html b/doc/rsyslog_conf.html index 183a6be7..95fe22a7 100644 --- a/doc/rsyslog_conf.html +++ b/doc/rsyslog_conf.html @@ -67,7 +67,10 @@ development and quite unstable...). So you have been warned ;)

  • $RepeatedMsgReduction
  • $ResetConfigVariables
  • $SystemLogSocketName <name-of-socket> -- former -p option
    • -
  • $UDPListenPort <port> (imudp) -- former -r<port> option, default 514
    • +
  • $UDPServerAddress <IP> (imudp) -- local IP address (or name) the UDP + listens should bind to
    • +
  • $UDPServerRun <port> (imudp) -- former -r<port> option, default 514, + start UDP server on this port, "*" means all addresses
  • $UMASK

    • Basic Structure

    diff --git a/doc/v3compatibility.html b/doc/v3compatibility.html index a0b1e9c6..ab45801b 100644 --- a/doc/v3compatibility.html +++ b/doc/v3compatibility.html @@ -24,10 +24,32 @@ mark period. If you need a 20 minute mark period you need to

    $ModLoad immark # wherever this is
    $MarkMessageInterval 1800 # 20 minutes

    -r command line option

    -

    Is also no longer available. Use

    +

    Is also no longer available. Use the $UDPSeverRun <port> config file +directives. You can now also set the local address the server should listen to +via $UDPServerAddress <ip> config directive.

    +

    The following example configures an UDP syslog server at the local address +192.0.2.1 on port 514:

    $ModLoad imudp
    -$UDPListenPort <port>

    -

    config file directives.

    +$UDPSeverAddress 192.0.2.1 # this MUST be before the $UDPServerRun directive!
    +$UDPServerRun 514

    +

    "$UDPServerAddress *" means listen on all local interfaces. This is the +default if no directive is specified.

    +

    Please note that now multiple listeners are supported. For example, you can +do the following:

    +

    $ModLoad imudp
    +$UDPSeverAddress 192.0.2.1 # this MUST be before the $UDPServerRun directive!
    +$UDPServerRun 514
    +$UDPSeverAddress * # all local interfaces
    +$UDPServerRun 1514

    +

    These config file settings run two listeners: one at192.0.2.1:514 and one on +port 1514, which listens on all local interfaces.

    +

    Default port for UDP (and TCP) Servers

    +

    Please note that with pre-v3 rsyslogd, a service database lookup was made +when a UDP server was started and no port was configured. Only if that failed, +the IANA default of 514 was used. For TCP serves, this lookup was never done and +514 always used if no specific port was configured. For consitency, both TCP and +UDP now use port 514 as default. If a lookup is desired, you need to specify it +in the "Run" directive, e.g. "$UDPServerRun syslog".

    klogd

    klogd has (finally) been replaced by a loadable input module. To enable klogd functionality, do

    -- cgit v1.2.3