more verbose comments, so people could actually understand it

diff --git a/ulogd.conf b/ulogd.conf
index 8a026b2cbdfef1efa4d4d8ddd683a882e64d45d8..9fd72d996c972be437d695090ab0ef2c1075c0e2 100644 (file)
--- a/ulogd.conf
+++ b/ulogd.conf
@@ -1,17 +1,65 @@
+# Example configuration for ulogd
+# $Id$
+#
+
+######################################################################
+# GLOBAL OPTIONS
+######################################################################
+
 # netlink multicast group (the same as the iptables --ulog-nlgroup param)
 nlgroup 1
+
 # logfile for status messages
 logfile /var/log/ulogd.log
+
 # loglevel: notice, warnings, error and fatal
 loglevel 5
+
+######################################################################
+# PLUGIN OPTIONS
+######################################################################
+
+# We have to configure and load all the plugins we want to use
+
+# general rules:
+# 1. specify the options FIRST, then load the plugin
+# 2. interpreter plugins have to precede output plugins
+
+
+#
+# ulogd_BASE.so - interpreter plugin for basic IPv4 header fields
+#                you will always need this
+plugin /usr/local/lib/ulogd/ulogd_BASE.so
+
+
+#
+# ulogd_LOGEMU.so - simple syslog emulation target
+#
+# where to write to
+syslogfile /var/log/ulogd.syslogemu
+# do we want to fflush() the file after each write?
+syslogsync 1
+# load the plugin
+plugin /usr/local/lib/ulogd/ulogd_LOGEMU.so
+
+
+# 
 # ulogd_OPRINT.so: file for packet dumping
+#
+# where to write the log
 dumpfile /var/log/ulogd.pktlog
-# ulogd_MYSQL.so: database information
+# load the plugin (remove the '#'if you want to enable it
+#plugin /usr/local/lib/ulogd/ulogd_OPRINT.so
+
+
+#
+# ulogd_MYSQL.so: optional logging into a MySQL database
+#
+# database information
 mysqltable ulog
 mysqlpass changeme
 mysqluser laforge
 mysqldb ulogd
 mysqlhost localhost
-# plugins: always load interpreter plugins _before_ any output plugins
-plugin /usr/local/lib/ulogd/ulogd_BASE.so
-plugin /usr/local/lib/ulogd/ulogd_LOGEMU.so
+# load the plugin (remove the '#' if you want to enable it)
+#plugin /usr/local/lib/ulogd/ulogd_MYSQL.so