8 releases (1 stable)
Uses new Rust 2024
| 2.0.0-rc.3 | Nov 18, 2025 |
|---|---|
| 2.0.0-rc.1 | Apr 4, 2025 |
| 2.0.0-beta.0 | Dec 28, 2023 |
| 1.0.1 | Sep 15, 2022 |
| 0.10.0 | Nov 6, 2021 |
#2508 in Command line utilities
79KB
1.5K
SLoC
zffacquire
zffacquire is a command line utility for acquiring images, memory dumps and/or logical file/folder structures into the forensic format Zff.
Installation
Build from source (Linux)
Prerequisites
First, you need to install rust and cargo to build or install zffacquire.
After that you still need the gcc, which you can install as follows (depends on the distribution):
Debian/Ubuntu
$ sudo apt-get install gcc
Fedora
$ sudo dnf install gcc
Then you can easily build this tool yourself by using cargo:
[/home/ph0llux/projects/zffacquire] $ cargo build --release
Cross-compile for Windows
You need a cross-compiler and should use the target x86_64-pc-windows-gnu for Windows x86 or aarch64-pc-windows-msvc for Windows on arm64.
It is necessary to use a nightly compiler, stable Rust is currently not supported for Windows targets (by the underlying zff-library).
cargo +nightly build --release --target=x86_64-pc-windows-gnu # for x86 targets
cargo +nightly build --release --target=aarch64-pc-windows-msvc # for arm64 targets
Install via cargo
Or you can install the tool directly from crates.io:
```bash
$ cargo install zffacquire
Usage
Example for Linux systems
To create an image with the default parameters, the following command is just enough:
zffacquire physical -i /dev/sda -o /media/usb-hdd/my_zff_container
You can also dump a logical folder structure into a logical zff container:
zffacquire logical -i /home/ph0llux/pictures -o /media/usb-hdd/my_zff_container
And you can extend an zff container by adding additional containers:
zffacquire physical -i /dev/sda -o /media/usb-hdd/my_zff_container
zffacquire extend logical -i /home/ph0llux/pictures -a /media/usb-hdd/my_zff_container.z01
zffacquire extend physical -i /dev/sdb -a /media/usb-hdd/my_zff_container.z01
The complete feature set of zffacquire can be shown using zffacquire -h.
Example for Windows systems
On Windows, you can list the dumpable physical targets with the list-devices subcommand.
zffacquire list-devices
If you want to dump a full physical device, you can choose the appropriate device from the printed table (by using the command above).
zffacquire physical -i "\\?\PhysicalDrive2" -o my_physical_drive
You can also dump just a single volume (e.g. the volume which is mounted at drive D:\):
zffacquire physical -i "\Device\HarddriveVolume2" -o my_volume_d
In both cases, you have to use the quotation marks as shown or to escape the \ characters.
The complete feature set of zffacquire can be shown using zffacquire -h.
Dependencies
~17–32MB
~497K SLoC