dissect.btrfs

View on GitHub

A Dissect module implementing a parser for the Btrfs file system, a commonly used Linux filesystem.

Installation

dissect.btrfs is available on PyPI.

$ pip install dissect.btrfs

This project supports file systems with LZO compression. It can use either a fast Rust implementation, or a slow pure Python implementation. Both implementations are provided by dissect.util, and the faster implementation will automatically be used if available. Pre-build wheels are available for most common platforms. In the rare case that a pre-build wheel is not available, please refer to dissect.util for build instructions.

Usage

This package is a library with no CLI tools, so you can only interact with it from Python. For example, to print a directory listing of the root directory and read a file:

from dissect.btrfs import Btrfs

fh = open_btrfs_volume()  # i.e. using dissect.volume

fs = Btrfs(fh)
print(fs.get("/").listdir())

file_fh = fs.get("/file.txt").open()  # This is just another file-like object
print(file_fh.read())

Reference

For more details, please refer to the API documentation of dissect.btrfs.