
		MUDDLEFTPD DOCUMENTATION (Version 1.3.10)
		Beau Kuiper (support@muddleftpd.cx)
		License under GPL

This is a quick guide to using mudlogd. Mudlogd is a deamon designed to make
rotating muddleftpd log files simple, without bothering the main server.
Muddleftpd isn't able to rotate its log files sometimes because it has lost
the permissions or file access to do so. Mudlogd overcomes this by providing
muddleftpd a single place to store logs and then handling rotation itself

Although designed for muddleftpd, mudlogd can also be used by almost any program.
Simply substitue any references to muddleftpd with your favourite program
and its configuration requirements.

Using mudlogd:

1) Decide a directory and filename to store the fifo object muddleftpd needs
   to communicate with mudlogd. Make sure this file cannot be
   modified/deleted by other local users.

2) Create a configuration file containing the following:

	[section] logger

	logfile /var/log/muddleftpd.conf
	fifoname /etc/muddleftpd/mudlog

   Replace the parameter on logfile with the output log file you wish to
   use. Replace the parameter on fifoname with the filename you decided
   in part 1.

3) In the muddleftpd configuration file. set the logfile directives for the
   servers and virtual servers that will use mudlogd to the filename you
   decided in part 1.

4) Start muddleftpd by running:

	mudlogd -c /etc/muddleftpd/mudlogd.conf
	muddleftpd -c /etc/muddleftpd/muddleftpd.conf

   Replace the configuration files specified above with the ones created for
   mudlogd and muddleftpd.

5) You can rotate the logs now using logrotate, or by using the following:

	mv /var/log/muddleftpd.log /var/log/muddleftpd.log.old
	killall -SIGUSR1 mudlogd

