From 21c2f630e9ce218f86b1bd314e7c803b381fcec2 Mon Sep 17 00:00:00 2001 From: Rainer Gerhards Date: Fri, 16 Dec 2011 10:31:17 +0100 Subject: added doc for omprog --- ChangeLog | 1 + doc/omprog.html | 43 +++++++++++++++++++++++++++++++++++++++++++ doc/rsyslog_conf_modules.html | 1 + 3 files changed, 45 insertions(+) create mode 100644 doc/omprog.html diff --git a/ChangeLog b/ChangeLog index 2014e6e2..1f2e0199 100644 --- a/ChangeLog +++ b/ChangeLog @@ -8,6 +8,7 @@ Version 4.8.1 [v4-stable], 2011-09-?? - bugfix: potential abort after reading invalid X.509 certificate closes: http://bugzilla.adiscon.com/show_bug.cgi?id=290 Thanks to Tomas Heinrich for the patch +- added doc for omprog --------------------------------------------------------------------------- Version 4.8.0 [v4-stable] (rgerhards), 2011-09-07 *************************************************************************** diff --git a/doc/omprog.html b/doc/omprog.html new file mode 100644 index 00000000..471ab224 --- /dev/null +++ b/doc/omprog.html @@ -0,0 +1,43 @@ + +omprog output module - sending messages to a program +back + + +

Program integration Output module

Module Name: omprog

Available since: 4.3.0

Author: Rainer Gerhards +<rgerhards@adiscon.com>

Description:

This module permits to integrate arbitrary external programs into rsyslog's +logging. It is similar to the "execute program (^)" action, but offers better security +and much higher performance. While "execute program (^)" can be a useful tool for +executing programs if rare events occur, omprog can be used to provide massive +amounts of log data to a program. +

Executes the configured program and feeds log messages to that binary via +stdin. The binary is free to do whatever it wants with the supplied data. +If the program terminates, it is re-started. If rsyslog terminates, the +program's stdin will see EOF. The program must than terminate. The message format +passed to the program can, as usual, be modified by defining rsyslog templates. +

Note that each time an omprog action is defined, the corresponding programm +is invoked. A single instance is not being re-used. There are arguments pro and +con re-using existing binaries. For the time being, it simply is not done. In the future, +we may add an option for such pooling, provided that some demand for that is voiced. +You can also mimic the same effect by defining multiple rulesets and including them (at +the price of some slight performance loss). +

Configuration Directives:

$ActionOMProgBinary <binary>
+The binary program to be executed. +

+Caveats/Known Bugs: +

Currently none known. +

[rsyslog.conf overview] +[manual index] [rsyslog site]

+ diff --git a/doc/rsyslog_conf_modules.html b/doc/rsyslog_conf_modules.html index b2830535..d9a59d8c 100644 --- a/doc/rsyslog_conf_modules.html +++ b/doc/rsyslog_conf_modules.html @@ -52,6 +52,7 @@ generic database output module (Firebird/Interbase, MS SQL, Sybase, SQLLite, Ingres, Oracle, mSQL)

ommail - permits rsyslog to alert folks by mail if something important happens

omprog - permits sending messages to a program for custom processing

omoracle - output module for Oracle (native OCI interface)

omuxsock - output module Unix domain sockets

-- cgit v1.2.3 From 5f662e81de4ec13bd29ec7b686646b2a8996f45d Mon Sep 17 00:00:00 2001 From: Tomas Heinrich Date: Fri, 16 Dec 2011 10:54:40 +0100 Subject: bugfix: potential fatal abort in omgssapi --- ChangeLog | 4 +++- plugins/omgssapi/omgssapi.c | 4 +--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 1f2e0199..6fc754cd 100644 --- a/ChangeLog +++ b/ChangeLog @@ -7,7 +7,9 @@ Version 4.8.1 [v4-stable], 2011-09-?? platforms) - bugfix: potential abort after reading invalid X.509 certificate closes: http://bugzilla.adiscon.com/show_bug.cgi?id=290 - Thanks to Tomas Heinrich for the patch + Thanks to Tomas Heinrich for the patch. +- bugfix: potential fatal abort in omgssapi + Thanks to Tomas Heinrich for the patch. - added doc for omprog --------------------------------------------------------------------------- Version 4.8.0 [v4-stable] (rgerhards), 2011-09-07 diff --git a/plugins/omgssapi/omgssapi.c b/plugins/omgssapi/omgssapi.c index 782ac22f..3fb0b8f0 100644 --- a/plugins/omgssapi/omgssapi.c +++ b/plugins/omgssapi/omgssapi.c @@ -361,9 +361,7 @@ static rsRetVal doTryResume(instanceData *pData) } break; case eDestFORW: - /* rgerhards, 2007-09-11: this can not happen, but I've included it to - * a) make the compiler happy, b) detect any logic errors */ - assert(0); + /* NOOP */ break; } -- cgit v1.2.3