COMPILE:
	make


OPTIONS:
	(set via environment variables; see fmtlib.h for defaults)
	FMT_OUTFILE:	 log output to this file instead the default.  If
			 the program forks, a race condition may occur (i.e.
			 different processes trying to write to the same
			 file at the same time).
	FMT_OUTFILE_PID: log output to this file instead the default, and
			 append the current PID to the filename.  Useful if
			 the process will fork, i.e. to avoid race
			 conditions.
	FMT_DLFILE:	 the shared library in which to find the real
			 functions, instead of the default.  Presently, only
			 one file may be specified.
	FMT_SYSLOG:	 use syslog instead of the output file.
	FMT_SYSLOG_PRE:	 prepend this prefix to syslog messages instead of
			 the default.


NOTES:
	if vsyslog(3) is not supported on your system, set WRAP_VSYSLOG to 0
	in fmtlib.h.


CAVEATS:
	- Multithreading wrapped calls will cause race conditions.
	- It is possible that the preloading of this library will break
	  programs that use trampolines, due to its property of removing
	  executable permission from memory pages.  However, this is only
	  done if the page was read-only, while trampolines are likely to be
	  used with writable memory.


EXAMPLES:

  # env LD_PRELOAD=$PWD/fmtlib.so FMT_OUTFILE_PID=/data/dir/sshdfmt.out sshd
  # tcpserver 0 21 env LD_PRELOAD=$PWD/fmtlib.so \
			FMT_OUTFILE_PID=/data/dir/ftpdfmt.out ftpd

