
MD5DEEP 
---------------------------------------------------------
Md5deep recursively computes MD5 message digests of input files.

Details on how to use md5deep are in the man page.

The MD5 algorithm is defined in RFC 1321:
http://www.ietf.org/rfc/rfc1321.txt

md5deep was written by Special Agent Jesse Kornblum, United States Air
Force Office of Special Investigations. jesse.kornblum@ogn.af.mil.

md5deep is a work of the US Government. In accordance with 17 USC 105,
works of the US Government are not entitled to Copyright protection. This
program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.




INSTALLATION INSTRUCTIONS 
---------------------------------------------------------

Installing md5deep on *nix is easy. For Windows, the easiest thing to do 
is grab the binary. Compilation instructions are below for the 
do-it-yourself types.


Linux:
--------------------------
$ make linux
$ make install


Solaris
--------------------------
$ make solaris
$ make install


Mac OS X
--------------------------
$ make mac
$ make install


*BSD, and other Unicies
--------------------------
$ make unix
$ make install



If you ever need to remove md5deep from your system, you can do this:
$ make uninstall



Microsoft Windows(R) 
--------------------------

The easiest way to get md5deep for Windows is to download the binary 
version. The current binary is available at:

http://md5deep.sourceforge.net/


If you want to compile md5deep yourself, I recommend using the (Free) 
MingGW compiler. 

First, obtain the MinGW toolkit from:  http://www.mingw.org/
Install this package and use it to compile md5deep as follows:

C:\> PATH=c:\mingw\bin;c:\mingw\mingw32\bin;%PATH%
C:\> gcc -Wall -D__WIN32 -o md5deep.exe c:\path\to\md5deep-xx\*.c -liberty


If you want to get really fancy, you can compile md5deep using MinGW
from inside the Cygwin environment.

$ tar zxvf md5deep-xx.tar.gz
$ cd md5deep-xx
$ PATH="/cygdrive/c/mingw/bin:/cygdrive/c/mingw/mingw32/bin:$PATH"
$ make windows

Although it is possible to compile md5deep under Cygwin using the "make
unix" directive, this is not recommended. Not only will the resulting
executable require the cygwin1.dll file to run, but the output for each
file will be in "cygdrive" notation, which takes up extra space and may be
confusing to those not familar with the Cygwin environment.



You can also use the linux port of the MinGW compiler to cross-compile. I 
use this to create the binary versions of md5deep. The port is available:

http://www.libsdl.org/extras/win32/cross/mingw32-linux-x86-glibc-2.2.tar.gz

Steps to build a Linux hosted MinGW cross-compilation environment:

Step 1. Download the build-cross.sh script:
	http://www.libsdl.org/extras/win32/cross/build-cross.sh
        This script builds and installs the cross-compilation tools
        into /usr/local/cross-tools by default.
Step 2. Put the script in a temporary directory with lots of space
Step 3. Edit the configuration variables in the script (if needed)
Step 4. Run the script to download files, compile and install.

You can get precompiled binaries for x86 Linux from:
http://www.libsdl.org/extras/win32/cross/mingw32-linux-x86-glibc-2.2.tar.gz

Once you have the cross-compilation tools available, you can get
the scripts cross-configure.sh and cross-make.sh and use them as
you would normally use configure and make.

These scripts are available from:
	http://www.libsdl.org/extras/win32/cross/cross-configure.sh
	http://www.libsdl.org/extras/win32/cross/cross-make.sh



Microsoft Windows is a registered trademark of the Microsoft Corporation.
