btrfs-check man page

btrfs-check — check or repair an unmounted btrfs filesystem


btrfs check [options] <device>


btrfs check is used to check or repair an unmounted btrfs filesystem.


Since btrfs is under development, the btrfs check capabilities are continuously enhanced. It’s highly recommended to read the following btrfs wiki before executing btrfs check with --repair option: https://btrfs.wiki.kernel.org/index.php…

btrfsck is an alias of btrfs check command and is now deprecated.


-s|--super <superblock>
use <superblock>th superblock copy, valid values are 0 up to 2 if the respective superblock offset is within the fileystem
try to repair the filesystem
create a new CRC tree and recalculate all checksums
create a new extent tree
verify checkums of data blocks
indicate progress at various checking phases
verify qgroup accounting and compare against filesystem accounting
--subvol-extents <subvolid>
show extent state for a subvolume
--tree-root <bytenr>
use the given bytenr for the tree root

Exit Status

btrfs check returns a zero exit status if it succeeds. Non zero is returned in case of failure.


btrfs is part of btrfs-progs. Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for further details.

See Also

mkfs.btrfs(8), btrfs-scrub(8), btrfs-rescue(8)