btrfs-filesystem
Manage btrfs filesystem properties and operations
TLDR
Show usage statistics
$ btrfs filesystem usage path/to/mount
Show device usage$ sudo btrfs filesystem show path/to/mount
Defragment a file$ sudo btrfs filesystem defragment -v path/to/file
Defragment directory recursively$ sudo btrfs filesystem defragment -v -r path/to/dir
Sync to disk$ sudo btrfs filesystem sync path/to/mount
Show disk usage for directory$ sudo btrfs filesystem du -s path/to/dir
Create swap file$ sudo btrfs filesystem mkswapfile --size 8g path/to/swapfile
SYNOPSIS
btrfs filesystem command [OPTIONS] [path]
DESCRIPTION
btrfs filesystem manages btrfs filesystem properties and operations including usage statistics, defragmentation, synchronization, and device information display.
PARAMETERS
usage
Show detailed filesystem space usageshow
Display filesystem information and device usagedf
Show disk space usage similar to df commanddefragment
Defragment files or directoriessync
Force sync unwritten data to diskdu
Calculate disk usage for files and directoriesmkswapfile
Create a swap file properly formatted for btrfs-v, --verbose
Enable verbose output-r
Recursive operation for defragment and du-s, --summarize
Show only summary for du command
INSTALL
sudo apt install btrfs-progs
sudo dnf install btrfs-progs
sudo pacman -S btrfs-progs
sudo apk add btrfs-progs
brew install btrfs-progs
nix profile install nixpkgs#btrfs-progs
CAVEATS
Defragmentation may break reflinks and reduce deduplication benefits. Running defragment while deduplication is active can cause issues. The df command may show different values than standard df due to btrfs's space accounting.
HISTORY
btrfs filesystem is part of the btrfs-progs package for managing btrfs filesystems on Linux.
SEE ALSO
btrfs(8), btrfs-device(8), df(1)