Skip to main content

Fossil

Status Powered By: EDF License: MIT

A post-mortem analysis tool for raw disk/partition images


Introduction

Fossil is a linux command line collector based on pre-configured or customizable collection profiles.

It uses sleuthkit tools under the hood.

It can be used to perform various forensic tasks during the post-mortem examination of raw disk or partition images, such as computing image content digests or creating collections based on generaptor collection targets.


[!TIP] If your disk image is not a raw disk image, you can use tools such as affuse from afflib-tools to create a mountpoint exposing a read-only raw disk image.

Getting Started

Fossil releases are available on Github and Pypi. Using a Python virtual environment is recommended.

# Setup sleuthkit toolkit
sudo apt install sleuthkit
# Setup fossil
python3 -m pip install edf-fossil
# Setup generaptor configuration files w/o fetching velociraptor binaries
generaptor update --do-no-fetch
# List partitions
fossil windows disk.img partitions
# List file system entries (see options to include deleted files and directories)
fossil windows disk.img fs_entries
# List file system entries in a raw partition instead
fossil --image-is-partition windows part.img fs_entries
# Perform default data collection on disk.img raw disk image
fossil windows disk.img collect
# Perform custom collection based on a collection profile
echo '{"targets":["WebServer/IIS"]}' > iis_server.json
fossil windows disk.img collect --custom-profile iis_server.json
# Hash all existing files in the disk
fossil windows disk.img digest > result.csv
# Include deleted files (warning, sleuthkit is prone to errors when extracting deleted data)
fossil windows disk.img digest --deleted > result.csv

Configuration

Fossil does not need any configuration file, it relies on Generaptor configuration files instead.


License

Distributed under the MIT License.


Contributing

Contributions are welcome. See CONTRIBUTING.md.


Security

To report a (suspected) security issue, see SECURITY.md.

Metadata

Release files for edf-fossil 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for edf-fossil 1.0.0
File Interpreter ABI Platform Actions
edf_fossil-1.0.0-py3-none-any.whl Python 3 none any Details for edf_fossil-1.0.0-py3-none-any.whl

Release files / edf_fossil-1.0.0-py3-none-any.whl

Download URL edf_fossil-1.0.0-py3-none-any.whl
Size 14.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6d2e51b5a4a6f7f478883ba44417c68c42a54561322de09ecb6a5e4ed125601a
BLAKE2b-256 checksum
How to use checksums
12fc2a0875201c6c4c0c5a6a81ef04d4b5341c3f0e8e6edabac773d38154b8cd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Security for edf-fossil 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page