cCarve: Carving attributed dump sets
-----------------
Version 1.0.1
October 13, 2012

Copyright 2012 T. van Deursen, P. Kordy and S. Mauw, and S. Radomirovic
-----------------
cCarve is a command line tool for carving attributed dump sets.  These dump 
sets can, for instance, be obtained by dumping the memory of a number of
smart cards or by regularly dumping the memory of a single smart card
during its lifetime. The tool helps in determining 
at which location in the dumps certain attributes are stored. 
The tool is based on <a href="../mCarve">mCarve</a>.

cCarve is a tool for carving attributed dump sets, based on mCarve. The
dump sets can, for instance, be obtained by dumping the memory of a number of
smart cards or by regularly dumping the memory of a single smart card during
its lifetime. The tool helps in determining at which location in the dumps
certain attributes are stored.

More information can be obtained from paper [1].

[1] T. van Deursen, S. Mauw, and S. Radomirovic. mCarve: Carving attributed
dump sets. In USENIX Security Symposium, 2011.

Contact address:
Piotr Kordy
Universit\'e du Luxembourg 
Facult\'e des Sciences, de la Technologie et de la Communication
6, rue Richard Coudenhove-Kalergi
L-1359 Luxembourg
Updates via: http://satoss.uni.lu/ccarve/


-----------------
Requirements

In order to build mcarve written in C++ you will need:
   C++ compiler 
   GNU make 
   cmake 
   program_options,system and filesystem(v3) from Boost library, http://www.boost.org/
   lzz executable - http://www.lazycplusplus.com/
   google sparse hash -  http://code.google.com/p/google-sparsehash/

 Debian/Ubuntu specific guidelines:
  -install packages:
    sudo apt-get install libboost-program-options-dev libboost-system-dev libboost-filesystem-dev libsparsehash-dev cmake make gcc g++
  -optionally install ccmake
    sudo apt-get install cmake-curses-gui
  -download lzz from http://www.lazycplusplus.com/download.html and copy to /usr/local/bin

 MacOS specific guidelines:
  -install Xcode
  -install MacPorts (http://www.macports.org/install.php) - you do not have to install MacPorts but it simplifies process
  -Open terminal and type:
     sudo port install cmake
     sudo port install boost
     sudo port install google-sparsehash
  -download lzz from http://www.lazycplusplus.com/download.html and copy to /usr/local/bin

-----------------
Installation details:

    To compile source:
      - unpack the archived file and go to the main directory were README file
        is located.
      - create build directory
          mkdir build
      - go to build directory 
          cd build
      - run cmake 
          cmake .. 
      - run make
          make
    This will build command line as well as tests.
    To run tests:
          make test
    To package:
          make package
    To make source package:
          make package_source
    To convert from project files used by mCarve use the convert.py from
    src directory:
          python src/convert.py oldProject.prj >newProject.prj
