filefrag 0.0.2

examine fragments of files in the filesystem

filefrag

Python library to get FIE and command line tool

Install

See the video for a demo including installing from source, but you can install with pip:

pip install filefrag

Usage

Run pyfilefrag on the command line. See --help for details. It has --verbose, and --json outputs for your parsing pleasure.

To use the library, just call filefrag.FileMap('/path/whatever') to build a map of the extents in the file using ioctl’s interface. Then you can poke about in the guts of a file:

• ⛓️‍💥 inspect fragmentation
• 🔍 find out where data is on your physical drive
• 🟰 compare extents between paths
• 📔 use them as dict keys
• 🕳️ check files for holes, like before and after hole punching
• ✅ verify your deduplication strategy, write your own stats tool
• 💩 dump file layouts to json (print(f"{filemap:j}")
• ⚠️ break your disk because you believed the outputs of this alpha release!

Comes with a Device class to do comparisons, so it ought to work with fragments in files on different mountpoints, bind mounts and so on (unfortunately not snap’s FUSE mounts; they’re far too abstract and piped in via a socket)

Example

from filefrag import FileMap

mapping = FileMap('/usr/bin/bash')

print(mapping)
print(extents)