From 8b7924fb8a3fa24cefc573b7372514d26a684b2d Mon Sep 17 00:00:00 2001
From: Rainer Gerhards
Date: Thu, 2 Feb 2012 17:51:08 +0100
Subject: upgraded omlibdbi to support the new v6 config format
---
doc/omlibdbi.html | 56 +++++++++++++++++++++++++++++++++----------------------
1 file changed, 34 insertions(+), 22 deletions(-)
(limited to 'doc')
diff --git a/doc/omlibdbi.html b/doc/omlibdbi.html
index ec1d01b6..008dcb81 100644
--- a/doc/omlibdbi.html
+++ b/doc/omlibdbi.html
@@ -54,32 +54,38 @@ dlopen()ed plugin (as omlibdbi is). So in short, you probably save you
a lot of headache if you make sure you have at least libdbi version
0.8.3 on your system.
-Configuration Directives:
+Action Parameters:
-- $ActionLibdbiDriverDirectory /path/to/dbd/drivers
This
-is a global setting. It points libdbi to its driver directory. Usually,
-you do not need to set it. If you installed libdbi-driver's at a
-non-standard location, you may need to specify the directory here. If
-you are unsure, do not use this configuration directive. Usually, everything works just fine. - $ActionLibdbiDriver drivername
+ - server
Name or address of the MySQL server
+ - db
Database to use
+ - uid
logon userid used to connect to server. Must have proper permissions.
+ - pwd
the user's password
+ - template
Template to use when submitting messages.
+ - driver
Name of the dbidriver to use, see libdbi-drivers documentation. As a
quick excerpt, at least those were available at the time of this
writiting "mysql" (suggest to use ommysql instead), "firebird" (Firbird
and InterBase), "ingres", "msql", "Oracle", "sqlite", "sqlite3",
"freetds" (for Microsoft SQL and Sybase) and "pgsql" (suggest to use
ompgsql instead).
-- $ActionLibdbiHost
-hostname
+ - driverdirectory
+Path to the libdbi drivers. Usually,
+you do not need to set it. If you installed libdbi-drivers at a
+non-standard location, you may need to specify the directory here. If
+you are unsure, do not use this configuration directive.
+Usually, everything works just fine.
+
+Legacy (pre-v6) Configuration Directives:
+
+- $ActionLibdbiDriverDirectory /path/to/dbd/drivers
+- like the driverdirectory action parameter.
+
- $ActionLibdbiDriver drivername
- like the drivername action parameter.
+ - $ActionLibdbiHost hostname - like the server action parameter
The host to connect to.
-- $ActionLibdbiUserName
-user
-The user used to connect to the database.
-- $ActionlibdbiPassword
-That user's password.
-- $ActionlibdbiDBName
-db
-The database that shall be written to.
-- selector
-line: :omlibdbi:;template
+ - $ActionLibdbiUserName user - like the uid action parameter
+
- $ActionlibdbiPassword - like the pwd action parameter
+
- $ActionlibdbiDBName db - like the db action parameter
+
- selector line: :omlibdbi:;template
executes the recently configured omlibdbi action. The ;template part is
optional. If no template is provided, a default template is used (which
is currently optimized for MySQL - sorry, folks...)
@@ -108,7 +114,14 @@ database "syslog_db" on mysqlsever.example.com. The server is MySQL and
being accessed under the account of "user" with password "pwd" (if you
have empty passwords, just remove the $ActionLibdbiPassword line).
-