LinuxCommandLibrary

btrfs-filesystem

TLDR

Show usage statistics

$ btrfs filesystem usage path/to/mount
copy
Show device usage
$ sudo btrfs filesystem show path/to/mount
copy
Defragment a file
$ sudo btrfs filesystem defragment -v path/to/file
copy
Defragment directory recursively
$ sudo btrfs filesystem defragment -v -r path/to/dir
copy
Sync to disk
$ sudo btrfs filesystem sync path/to/mount
copy
Show disk usage for directory
$ sudo btrfs filesystem du -s path/to/dir
copy
Create swap file
$ sudo btrfs filesystem mkswapfile --size 8g path/to/swapfile
copy

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 usage
show
Display filesystem information and device usage
df
Show disk space usage similar to df command
defragment
Defragment files or directories
sync
Force sync unwritten data to disk
du
Calculate disk usage for files and directories
mkswapfile
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

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)

Copied to clipboard