dsyslog build from source guide
6/22/2008 Jeff Katz

So you've decided that you want to build dsyslog from source. You are going to 
need a few things before you begin, namely:

	* A working C compiler (gcc preferred)
	* GNUMake, or equivalent
	* glib development headers
	
For optional RDBMS support, you'll also need the development headers for
MySQL and/or PostGreSQL.

In Debian, these requirements are contained in the following packages:

	gcc, make, and libglib2.0-dev
	(Optionally libmysqlclient15-dev and/or libpq-dev)
	
Once you have these requirements, it's time to download the dsyslog source.
You can download this source from one of a few places:

	* As a tarball from http://distfiles.atheme.org/
	* From source control, hg clone http://hg.atheme.org/dsyslog
	* From the Apt repository, apt-get install dsyslog
	
Note that if you install dsyslog through apt, all prerequisites will be 
installed for you and any other system loggers will be disabled. This is the
preferred installation method of dsyslog. 

Once you have the source, you'll want to run './autogen.sh' to create the configure
scripts, then run './configure'. Check that you're going to be building dsyslog
with the support for what you want, then run 'make'. When dsyslog has finished 
building, execute 'make install' to install dsyslog into your system.

By default, dsyslog is installed into /usr/local. The default configuration file
location is /usr/local/etc/dsyslog.conf (you should probably copy the example
from /usr/local/share/doc/dsyslog/example.conf and edit it to your liking)

Happy Logging!