Page MenuHomePhabricator
Files F7687421

README_Win32.txt
No OneTemporary
Actions

Size
5 KB
Referenced Files
None
Subscribers
None

README_Win32.txt
View Options

Using AFF Tool Under Microsoft Windows (Win32)
There are two ways to use AFFLIB with Windows: you can download the
pre-compiled executables, or you can compile your own. The advantage
of the pre-compiled executables is that they work. The advantage of
compiling the executables yourself is that you can modify them.
Downloading and Installing
==========================
You can download the current version of AFF Tools from:
http://afflib.org/downloads/afflib_windows.zip
The ZIP file contains:
* pre-compiled executables for AFF Tools
* lib32eay.dll, the OpenSSL DLL (cryptography support for AFFLIB)
* bulk_extractor jar and bat file. (Use the bat file to run the jar file)
Install these tools by:
1. Unzip the archive into the c:\afflib directory.
2. Add c:\afflib to your system PATH directory by:
a. Opening the System control panel.
b. Clicking the "Environment Variables" button.
c. Adding "c:\afflib;" to the beginning of the PATH environment variable.
*******************************
Compiling under Windows
There are three ways to compile for Windows:
1 - Cross-compiling from a Linux or Mac system with mingw.
2 - Compiling natively on Windows using mingw.
3 - Compiling natively on Windows using cygwin (untested)
Cross-compiling from Linux or Mac using MINGW:
*********************************************
* Cross-compiling works fine, but it does not include the version 4.x
GCC compiler and pthreads does not appear to work properly.
* We used to install with mingw cross-compiling, but that created problems with multi-threading
Compiling natively under Windows with MINGW:
*******************************************
Download the Windows Resource Kit from:
http://www.microsoft.com/downloads/details.aspx?familyid=9d467a69-57ff-4ae7-96ee-b18c4790cffd&displaylang=en
Download and run mingw-get-inst-20101030.exe (or whatever version is current),
selecting all options including these:
C Compiler, C++ Compiler. MSYS Basic System, MinGW Development Toolkit.
When selecting the installation path to MinGW, Do not define a path with spaces in it.
Start the MinGW32 shell window.
Download the latest repository catalog and update and install modules required by MinGW
by typing the following:
mingw-get update
mingw-get install g++
mingw-get install pthreads
mingw-get install mingw32-make
mingw-get install zlib
mingw-get install libz-dev
Install the libraries in this order:
* expat (http://sourceforge.net/projects/expat/)
* openssl (http://openssl.org)
For each library:
- download
- ./configure --prefix=/usr/local/ --enable-winapi=yes
- make
- make install
For openssl, run "./config --prefix=/usr/local" rather than configure.
Don't make directories in your home directory if there is a space in it!
Libtool doesn't handle paths with spaces in them.
If OpenSSL is installed in /usr/local/ssl, you may need to build other libraries with:
./configure CPPFLAGS="-I/usr/local/include" -I/usr/local/ssl/include" \
LDFLAGS="-L/usr/local/lib -L/usr/local/ssl/lib"
Most libraries will install in /usr/local/ ; you may need to add -I/usr/local/include to CFLAGS
and -L/usr/local/lib to your make scripts
Still problematic, though, is actually running what is produced. Unless you link -static you will have
a lot of DLL references. Most of the DLLs are installed in /usr/local/bin/*.dll and /bin/*.dll and elsewhere,
which maps typically to c:\mingw\msys\1.0\local\bin and c:\mingw\bin\
Compiling your own copy:
=======================
We compile with mingw. Download and install MSys.
Next you will need to download and i
Working with the tools
======================
If you are working with an encrypted disk image, set the environment
variable AFFLIB_PASSPHRASE to be the passphrase that should be used
for decryption.
% set AFFLIB_PASSPHRASE="this_is_my_passphrase"
Displaying the metadata with a disk image:
% afinfo.exe filename.aff
To convert an AFF file into a RAW file, use:
% affconvert.exe -e raw filename.aff
To reliably copy an AFF file from one location to another:
% afcopy.exe file1.aff d:\dest\path\file2.aff
To compare two AFF files:
% afcompare file1.aff file2.aff
To fix a corrupted AFF file:
% affix badfile.aff
To print statistics about a file:
% afstats.exe filename.aff
Diskprint
=================
An exciting feature in AFF 3.5 is the ability to rapidly calculate and
verify the "print" of a disk image. A print is constructed by
computing the SHA-256 of the beginning, end, and several randomly
chosen parts of the disk image.
To calculate the diskprint and store it in a file:
% afdiskprint myfile.iso > myfile.xml
To verify a diskprint
% afdiskprint -x myfile.xml myfile.iso
Verifying the AFFLIB Digital Signature
===============================
Some organizations require that dgital signatures be verified on programs that are downloaded.
Some AFF distributions are now signed with the AFFLIB privat key. You
can verify the distribution by downloading a copy of the public key
from the AFFLIB website or the GPG key server.
The public key can be downloaded from the website:
http://afflib.org/pubkey.asc
You can also download the key directly from the GPG keyserver with
this command:
$ gpg --keyserver subkeys.pgp.net --recv-keys 805B3DB0
gpg: requesting key 805B3DB0 from hkp server subkeys.pgp.net
gpg: /home/simsong/.gnupg/trustdb.gpg: trustdb created
gpg: key 805B3DB0: public key "AFFLIB Distribution (Simson L. Garfinkel)" imported
gpg: Total number processed: 1
gpg: imported: 1
$

File Metadata

Mime Type
text/plain
Expires
Wed, Oct 29, 1:26 PM (15 h, 12 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
1347024
Default Alt Text
README_Win32.txt (5 KB)

Event Timeline