/*--------------------------------------------------------------
 NetLoadD - Network Load Deamon                    Read The
 David Cutting (dcutting@purplepixie.org)       L I C E N C E
--------------------------------------------------------------*/

CONFIG: Using the Configuration File to Configure NetLoadD

Using the configuration file is a very simple and painless
afair. NetLoadD uses the DLL (Dave Linked List) system to
load the file and as such each file is of DLL format
containing a title for each block contained in [] for
example [mysql] followed by a block of data. Whitespaced
lines are ignored as are any lines beginning with the #
(hash) character.

Please note two things at this point. Firstly the main
command block is parsed command for command line a
command line configuration and the LAST option for each
setting will be the one used.

The configuration file must contain a [main] block. Below
main can be specified any number of valid command-line
arguments (using short or long names). These can include
delays and other file lines (avoid the possibility of
eternal loop - do not reference a file within itself).
An example config file would be:

[main]
-debug
-commentary
-quitonerror
d120
+syslog

This would turn off the debug, commentary and quitonerror
flags, set the delay to 120 seconds and turn on syslog
output.

MySQL is also configurable through the configuration file.

A MySQL enabled file will contain two blocks in addition
to main - [ident] and [mysql]

The ident block contains the ident/pass pair on the lines
immediately after the block title and nothing else. For
example:

[ident]
fish.network.com
fishident

Would set the MySQL record host identity as fish.network.com
with the identity pass fishident. The MySQL database server,
username, password and name are contained in the [mysql]
block in a similar style each immediately after the other,
for example:

[mysql]
localhost
netloadd
yellow
netload

Would connect to the database server localhost using the
username netloadd with password yellow. The ident would
be found on the netload database.

Inclusion of the [mysql] and [ident] blocks is compulsary
if MySQL support is to be used but the inclusion in a parsed
config file of these blocks will not enable MySQL if it
is not enabled explicity or set as default at compile time.

For more information on using the MySQL data recorder,
please see the MYSQL document.