guymager homepage Get guymager at SourceForge.net. Fast, secure and Free Open Source software downloads

Introduction


guymager is a forensic imager for media acquisition. Its main features are: The current version is 0.4.2.

How it looks


Main screen
Explanations:
Acquisition dialog

The above screenshot shows the default acquisition dialog which can be easily adapted to fit your requirements. You may add or remove fields. You can set their default values statically (text) and dynamically (current date, size of disk, serial number, ...). Have a look at /etc/guymager/guymager.cfg.

Download and installation


The following has been tested on Debian Etch (stable) but should work as well on any other Debian based distribution (Ubuntu, Knoppix, ...). For other systems: See the source compilation section below.

Installation with the pinguin APT server


Using Daniel's pinguin server is by far the easiest way for installing Guymager and related packages:
  1. Open a shell and get root rights
  2. Add the pinguin server to your repository list by executing the following command:
        wget -P /etc/apt/sources.list.d/ http://deb.pinguin.lu/pinguin.lu.list
    Currently, i386 and amd64 systems are supported, powerpc packages are available upon request.
  3. Execute the following commands:
       apt-get update
       apt-get install guymager smartmontools hdparm libewf-tools
  4. Start the program with
       guymager

Manual download and installation of the Debian packages


If you do not like to edit your /etc/apt/soures.list, you can download and install the packages manually:
  1. Browse to apt.pinguin.lu, and choose the directory corresponding to your processor architecture (i386 or amd64).
    Remark: amd64 refers to the architecture, not the processor. So, amd64 is ok for both, the AMD and Intel 64 bit processors.
  2. Download the packages for guymager, libewf_ and libguytools1.

Installation from the command line:
  1. Open a shell and get root rights
  2. Change to the directory with the files you downloaded.
  3. Use the following commands for the installation:
       apt-get update
       dpkg -i guymager_xxx_i386.deb libguytools_xxx_i386.deb libewf_xxx_i386.deb libewf-tools_xxx_i386.deb
       apt-get -f install
    xxx stands for the version number. In case you have a 64 bit system, replace i386 by amd64.
    The 2nd command most probably returns some error messages about missing packages. They are installed by executing the 3rd command.
  4. There are 2 recommended packages you should install as well:
       apt-get install smartmontools hdparm
  5. Start the program with
       guymager

Configuration and log


guymager works with two configuration files: If you want to try a parameter quickly without editing local.cfg, you may put it on the command line. For example:
   guymager EwfCompression=BEST
The command line precedes both configuration files. There are 2 parameters which only can be set on the command line: Example:
   guymager cfg="/tests/g_special.cfg" log="/mylogs/guymager.log"
The configuration parameters are well documented inside /etc/guymager/guymager.cfg. Just remember not to do any changes there.

If ever there's a problem, have a look at the log file /var/log/guymager.log. Please attach the log file when reporting a problem.

Compiling the source code


For compilation and packaging on Debian based systems refer to the end of this section.

Get the source code:
Let's start with libewf:
  1. Unpack the archive
  2. Compile and install with the standard command trio configure, make, make install. Missing libs and tools have to be installed, refer to the error messages. You probably have to go several times through the "install missing libs / configure" cycle until everything is ok.
  3. After successfull completion of the 3 commands, you not only have the lib required by guymager, but the libewf tools as well. So, it's easy to check if libewf works fine. Try for instance to run ewfinfo on a EWF (E01) image if you have one available. Try ewfacquire on a memory stick otherwise (see the man pages for details).

Next comes libguytools:
  1. Change to the directory where you did the subversion checkout, go to the subdir tags and further down to the latest version.
  2. libguytools is composed of several libs. There's a script called alltools for easy compilation. Create the Makefile:
       ./alltools makemake
    Compile the libs:
       ./alltools make
    Most probably, there will be some tools or libs missing, for instance the Qt developer stuff (libguytools uses qmake). The same procedure as before applies (install/retry/install...).
  3. There is no installation procedure (except for Debian, see above). After completion of the previous step, the libs are in the subdirectory lib. Copy them to a location that is included in the search path on your system (could be /usr/local/lib, for instance) or redirect the LD_LIBRARY_PATH environment variable.
  4. Make the headers from the subdirectory "include" available to other applications (for instance by copying to /usr/local/include).

And finally, guymager:
  1. Change to the directory where you did the subversion checkout, go to the subdir tags and further down to the latest version.
  2. Create the Makefile:
       qmake
  3. Compile:
       make
    If ever you have problems with the include path of libguytools: You can add it in the file guymager.pro (re-execute qmake afterwards).
  4. Create the language files:
       lrelease guymager.pro
  5. Copy the configuration file guymager.cfg to /etc/guymager/

guymager should now be ready. Start it with:
   ./guymager


Compilation and packaging on a Debian based system is easier. Get the sources of libewf, libguytools and guymager as described above. Then:
  1. Make sure you have the package dpkg-dev installed.
       aptitude install dpkg-dev
  2. Unpack libewf, change into the directory and execute
  3.    dpkg-buildpackage -B -uc -rfakeroot
    Follow the instructions given. Most probably, you will be told to install some additional packages before the compilation and packaging can begin. At the end you will get .deb packages in the directory above.
  4. Do the same for libguytools.
  5. Do the same for guymager. You will be told to install some of the packages you created in the previous steps (libguytools, libguytools1-dev, libewf and libewf-dev). Install these packages by means of dpkg -i (see above for the usage of dpkg).

Contact


The author of guymager can be reached by an email to vogu00 at gmail point com. If ever you want to report a problem, be sure to attach the guymager log file.

Disclaimer


The author of guymager and these pages is not responsible, not liable nor anything else for the content of extern web pages that are linked on this website nor for extern web pages linking to this one, nor for anything else. There is no garantuee for any software to work and any software may damage anything.
LPO