Difference between revisions of "Libewf"

From ForensicsWiki
Jump to: navigation, search
(Examples)
(43 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
   maintainer = [[Joachim Metz]], [[David Loveall]] |
 
   maintainer = [[Joachim Metz]], [[David Loveall]] |
 
   os = [[Linux]], [[FreeBSD]], [[NetBSD]], [[OpenBSD]], [[Mac OS X]], [[Windows]] |
 
   os = [[Linux]], [[FreeBSD]], [[NetBSD]], [[OpenBSD]], [[Mac OS X]], [[Windows]] |
   genre = [[File type support]] |
+
   genre = {{Disk imaging}} |
   license = [[LGPL]] |
+
   license = {{LGPL}} |
   website = [http://libewf.sourceforge.net libewf.sourceforge.net] |
+
   website = [http://code.google.com/p/libewf/ code.google.com/p/libewf/] |
 
}}
 
}}
  
The '''libewf''' package contains [[Linux]] based library and applications to read and write EnCase E0* and SMART s0* storage media bitstream copies.
+
'''Libewf''' is a library to access the [[Encase image file format|Expert Witness Compression Format (EWF)]].
It has been ported to other platforms like [[FreeBSD]] [[NetBSD]] [[OpenBSD]] [[Mac OS X]] and [[Windows]] as well.
+
  
== History ==  
+
== Features ==  
 +
Read or write supported EWF formats:
 +
* [[SMART]] .s01 (EWF-S01)
 +
* [[EnCase]] .E01 (EWF-E01) and .Ex01 (EWF2-Ex01)
  
Libewf was created by [[Joachim Metz]] in 2006, while working for [http://en.hoffmannbv.nl/ Hoffmann Investigations].
+
Read-only supported EWF formats:
 +
* Logical Evidence File (LEF) .L01 (EWF-L01) and .Lx01 (EWF2-Lx01)
  
Libewf is a rewrite of earlier work on the EnCase 4 file format by [[Michael Cohen]] part of [[PyFlag]] and the [http://www.asrdata.com/SMART/whitepaper.html Expert Witness Compression Format Specification] by [Andrew Rosen]. It has been updated to read and write EnCase version 1 to 6 E01 files and SMART s01 files (EWF files). Libewf has initiated an Extended EWF (EWF-X) specifications to bypass limitations on the format imposed by EnCase.
+
Other features:
 
+
* empty-block compression
Currently libewf partially supports the EnCase L01 format but this functionality has been disabled.
+
* read/write access using delta (or shadow) files
 
+
* write resume
In 2007 [[David Loveall]] contributed mount_ewf.py to the libewf project. This application allows a [[fuse]] based mount of the storage media data in the EWF files to be mounted.
+
  
 
== Tools ==  
 
== Tools ==  
 
The '''libewf''' package contains the following tools:
 
The '''libewf''' package contains the following tools:
* '''ewfacquire''' and '''ewfacquire''' , which writes storage media data from a device handle EWF files.
+
* '''ewfacquire''', which writes storage media data from devices and files to EWF files.
* '''ewfexport''', which exports storage media data in a set of E01 or s01 files to raw (dd) format or a specific version of EWF files.
+
* '''ewfacquirestream''', which writes data from stdin to EWF files.
 +
* '''ewfdebug'''; experimental tool does nothing at the moment.
 +
* '''ewfexport''', which exports storage media data in EWF files to (split) RAW format or a specific version of EWF files.
 
* '''ewfinfo''', which shows the metadata in EWF files.
 
* '''ewfinfo''', which shows the metadata in EWF files.
 +
* '''ewfmount''', which FUSE mounts EWF files.
 +
* '''ewfrecover'''; special variant of ewfexport to create a new set of EWF files from a corrupt set.
 
* '''ewfverify''', which verifies the storage media data in EWF files.
 
* '''ewfverify''', which verifies the storage media data in EWF files.
* '''mount_ewf.py''', which allows the storage media data in a EWF files to be mounted.
 
  
[[Dennis Schreiber]] created a menu based interface for ewfacquirestream called pyEWF. However this seems currently not to be maintained.
+
The '''libewf''' package also contains the following bindings:
 +
* '''ewf.net''', bindings for .Net
 +
* '''pyewf''', bindings for Python contributed by [[David Collett]] in 2008
 +
 
 +
=== Contributions ===
 +
Tools that have been contributed to the project are provided as separate tools on the sourceforge libewf project site. These are:
 +
* '''mount_ewf.py''', which allows the storage media data in a EWF files to be mounted, contributed by [[David Loveall]] in 2007.
 +
* '''libewf-java''', Java (JNA) bindings were contributed by [[Bradley Schatz]] in 2009.
 +
* '''delphi imdisk proxy''', Borland Delphi imdisk proxy, as an alternative to mount_ewf.py for Windows, contributed by [[Brendan Berney]] in 2010.
 +
* '''jlibewf''', native Java EWF reader contributed by [[Bruce Allen]] in 2010.
 +
* '''libewfcs''', native C# EWF reader contributed by [[Bruce Allen]] in 2011.
 +
 
 +
A menu based interface for ewfacquirestream called pyEWF, contributed by [[Dennis Schreiber]], was originally also available on the uitwisselplatform project site. However this is currently no longer maintained and was not moved to the sourceforge project size. The uitwisselplatform no longer exists. The name pyewf was reused for the libewf Python bindings created by [[David Collett]] which is now included in the libewf package.
 +
 
 +
=== Examples ===
 +
 
 +
Imaging a device on a Unix-based system:
 +
<pre>
 +
ewfacquire /dev/sda
 +
</pre>
 +
 
 +
Imaging a device on a Windows system:
 +
<pre>
 +
ewfacquire \\.\PhysicalDrive0
 +
</pre>
 +
 
 +
Converting a RAW into an EWF image
 +
<pre>
 +
ewfacquire myfile.raw
 +
</pre>
 +
 
 +
or:
 +
<pre>
 +
ewfacquire -c best -m fixed -t myfile -S 1T -u [-q] myfile.raw
 +
</pre>
 +
 
 +
or
 +
 
 +
<pre>
 +
cat split.raw.??? | ewfacquirestream
 +
cat myfile.??? | ewfacquirestream  -c best -m fixed -t myfile -S 1T
 +
 
 +
</pre>
 +
 
 +
Converting an optical disc (split) RAW into an EWF image (libewf 20110109 or later)
 +
<pre>
 +
ewfacquire -T optical.cue optical.iso
 +
</pre>
 +
 
 +
Converting an EWF into another EWF format or a (split) RAW image
 +
<pre>
 +
ewfexport image.E01
 +
</pre>
 +
 
 +
Exporting files from a logical image (L01)
 +
<pre>
 +
ewfexport image.L01
 +
</pre>
 +
 
 +
FUSE mounting an EWF image (libewf 20110828 or later)
 +
<pre>
 +
ewfmount image.E01 mount_point
 +
</pre>
 +
 
 +
FUSE mounting a logical image (L01) (libewf 20111016 or later)
 +
<pre>
 +
ewfmount -f files image.L01 mount_point
 +
</pre>
 +
 
 +
Verify an single image with results to the screen
 +
<pre>
 +
ewfverify image.E01
 +
</pre>
 +
 
 +
From a linux shell, verify a group of images in subdirectories of the current directory creating a simple log file per image.
 +
<pre>
 +
find . -name \*.E01 -printf '%f %p\n' | xargs printf "ewfverify -l \$(basename -s .E01 %s).ewfverify.out  %s\n" | sh
 +
</pre>
 +
 
 +
or
 +
 
 +
<pre>
 +
find . -name '*.E01' | while read F
 +
do
 +
  echo ewfverify -l "$(basename -s .E01 $F).ewfverify.out" "$F"
 +
done
 +
</pre>
 +
 
 +
== History ==
 +
 
 +
Libewf was created by [[Joachim Metz]] in 2006, while working for [http://en.hoffmannbv.nl/ Hoffmann Investigations].
 +
 
 +
Libewf is a rewrite of earlier work on the EnCase 4 file format by [[Michael Cohen]] part of [[PyFlag]] and the [[:File:ASR Data's Expert Witness Compression Format.pdf|Expert Witness Compression Format]] Specification by [[Andrew Rosen]]. It has been updated to read and write EnCase version 1 to 7 .E01 files, EnCase 5 to 7 .L01 files, EnCase 7 .Ex01 and .Lx01 files and SMART .s01 files. Libewf has initiated an Extended EWF (EWF-X) specifications to bypass limitations on the format imposed by the EnCase .E01 format.
 +
 
 +
In 2007 [[David Loveall]] contributed mount_ewf.py to the libewf project. This application allows a [[fuse]] based mount of the storage media data in the EWF files to be mounted. Due to repeated issues with Python and the fuse Python-bindings on [[Mac OS X]] part of the functionality of these scripts has been rewritten into '''ewfmount'''.
 +
 
 +
As of version 20120715 support for EWF version 2 (.Ex01 and .Lx01) was added.
  
 
== External Links ==
 
== External Links ==
  
* [http://libewf.sourceforge.net libewf project site]
+
* [http://code.google.com/p/libewf/ Project site]
* [https://www.uitwisselplatform.nl/projects/libewf/ old libewf project site]
+
* [http://libewf.sourceforge.net Old project site]

Revision as of 16:50, 25 February 2013

libewf
Maintainer: Joachim Metz, David Loveall
OS: Linux, FreeBSD, NetBSD, OpenBSD, Mac OS X, Windows
Genre: Disk imaging
License: LGPL
Website: code.google.com/p/libewf/

Libewf is a library to access the Expert Witness Compression Format (EWF).

Features

Read or write supported EWF formats:

  • SMART .s01 (EWF-S01)
  • EnCase .E01 (EWF-E01) and .Ex01 (EWF2-Ex01)

Read-only supported EWF formats:

  • Logical Evidence File (LEF) .L01 (EWF-L01) and .Lx01 (EWF2-Lx01)

Other features:

  • empty-block compression
  • read/write access using delta (or shadow) files
  • write resume

Tools

The libewf package contains the following tools:

  • ewfacquire, which writes storage media data from devices and files to EWF files.
  • ewfacquirestream, which writes data from stdin to EWF files.
  • ewfdebug; experimental tool does nothing at the moment.
  • ewfexport, which exports storage media data in EWF files to (split) RAW format or a specific version of EWF files.
  • ewfinfo, which shows the metadata in EWF files.
  • ewfmount, which FUSE mounts EWF files.
  • ewfrecover; special variant of ewfexport to create a new set of EWF files from a corrupt set.
  • ewfverify, which verifies the storage media data in EWF files.

The libewf package also contains the following bindings:

  • ewf.net, bindings for .Net
  • pyewf, bindings for Python contributed by David Collett in 2008

Contributions

Tools that have been contributed to the project are provided as separate tools on the sourceforge libewf project site. These are:

  • mount_ewf.py, which allows the storage media data in a EWF files to be mounted, contributed by David Loveall in 2007.
  • libewf-java, Java (JNA) bindings were contributed by Bradley Schatz in 2009.
  • delphi imdisk proxy, Borland Delphi imdisk proxy, as an alternative to mount_ewf.py for Windows, contributed by Brendan Berney in 2010.
  • jlibewf, native Java EWF reader contributed by Bruce Allen in 2010.
  • libewfcs, native C# EWF reader contributed by Bruce Allen in 2011.

A menu based interface for ewfacquirestream called pyEWF, contributed by Dennis Schreiber, was originally also available on the uitwisselplatform project site. However this is currently no longer maintained and was not moved to the sourceforge project size. The uitwisselplatform no longer exists. The name pyewf was reused for the libewf Python bindings created by David Collett which is now included in the libewf package.

Examples

Imaging a device on a Unix-based system:

ewfacquire /dev/sda

Imaging a device on a Windows system:

ewfacquire \\.\PhysicalDrive0

Converting a RAW into an EWF image

ewfacquire myfile.raw

or:

ewfacquire -c best -m fixed -t myfile -S 1T -u [-q] myfile.raw

or

cat split.raw.??? | ewfacquirestream
cat myfile.??? | ewfacquirestream  -c best -m fixed -t myfile -S 1T 

Converting an optical disc (split) RAW into an EWF image (libewf 20110109 or later)

ewfacquire -T optical.cue optical.iso

Converting an EWF into another EWF format or a (split) RAW image

ewfexport image.E01

Exporting files from a logical image (L01)

ewfexport image.L01

FUSE mounting an EWF image (libewf 20110828 or later)

ewfmount image.E01 mount_point

FUSE mounting a logical image (L01) (libewf 20111016 or later)

ewfmount -f files image.L01 mount_point

Verify an single image with results to the screen

ewfverify image.E01

From a linux shell, verify a group of images in subdirectories of the current directory creating a simple log file per image.

find . -name \*.E01 -printf '%f %p\n' | xargs printf "ewfverify -l \$(basename -s .E01 %s).ewfverify.out  %s\n" | sh

or

find . -name '*.E01' | while read F
do
  echo ewfverify -l "$(basename -s .E01 $F).ewfverify.out" "$F"
done

History

Libewf was created by Joachim Metz in 2006, while working for Hoffmann Investigations.

Libewf is a rewrite of earlier work on the EnCase 4 file format by Michael Cohen part of PyFlag and the Expert Witness Compression Format Specification by Andrew Rosen. It has been updated to read and write EnCase version 1 to 7 .E01 files, EnCase 5 to 7 .L01 files, EnCase 7 .Ex01 and .Lx01 files and SMART .s01 files. Libewf has initiated an Extended EWF (EWF-X) specifications to bypass limitations on the format imposed by the EnCase .E01 format.

In 2007 David Loveall contributed mount_ewf.py to the libewf project. This application allows a fuse based mount of the storage media data in the EWF files to be mounted. Due to repeated issues with Python and the fuse Python-bindings on Mac OS X part of the functionality of these scripts has been rewritten into ewfmount.

As of version 20120715 support for EWF version 2 (.Ex01 and .Lx01) was added.

External Links