Name:		logmagic

Author:		Catalin(ux) M. BOIE - catab at embedromix dot ro

Start date:	2015-06-10

Description:	Logs the list of files created by a program.
		One example: you have lots of log files and you do not
		want to scan all filesystems to get a list of files you
		may remove. Pus this .so into global preload file and you
		will get a log of all created files.
		One small problem: it is not working with static compiled
		binaries.

License:	GPLv3

How it works:	logmagic is a shared object that is loaded with LD_PRELOAD
		and hooks the 'open' function.

Examples:
		Note(s):
			- You may want to adapt them for 64bit:
				/usr/lib64/logmagic.so

		1. Output the list of files created by programA into file
		/var/log/logmagic-programA.log:
		export LOGMAGIC_TRACE_FILE=/var/log/logmagic-programA.log
		export LD_PRELOAD=${LD_PRELOAD}:/usr/lib/logmagic.so
		/path/to/programA

		2. Output the list of *.log files created by programA into file
		/var/log/logmagic-programA.log:
		export LOGMAGIC_TRACE_FILE=/var/log/logmagic-programA.log
		export LOGMAGIC_REGEX=".*\.log"
		export LD_PRELOAD=${LD_PRELOAD}:/usr/lib/logmagic.so
		/path/to/programA

Installation:
		- ./configure
		- make
		- make install