Documentation/btrfs-check.asciidoc

   1 btrfs-check(8)
   2 ==============
   3
   4 NAME
   5 ----
   6 btrfs-check - check or repair an unmounted btrfs filesystem
   7
   8 SYNOPSIS
   9 --------
  10 *btrfs check* [options] <device>
  11
  12 DESCRIPTION
  13 -----------
  14 *btrfs check* is used to check or repair an unmounted btrfs filesystem.
  15
  16 NOTE: Since btrfs is under development, the *btrfs check* capabilities are
  17 continuously enhanced. It's highly recommended to read the following btrfs
  18 wiki before executing *btrfs check* with '--repair' option: +
  19 https://btrfs.wiki.kernel.org/index.php/Btrfsck
  20
  21 *btrfsck* is an alias of *btrfs check* command and is now deprecated.
  22
  23 OPTIONS
  24 -------
  25 -s|--super <superblock>::
  26 use <superblock>th superblock copy, valid values are 0 up to 2 if the
  27 respective superblock offset is within the fileystem
  28 --repair::
  29 try to repair the filesystem
  30 --init-csum-tree::
  31 create a new CRC tree and recalculate all checksums
  32 --init-extent-tree::
  33 create a new extent tree
  34 --check-data-csum::
  35 verify checkums of data blocks
  36 -p|--progress::
  37 indicate progress at various checking phases
  38 --qgroup-report::
  39 verify qgroup accounting and compare against filesystem accounting
  40 --subvol-extents <subvolid>::
  41 show extent state for a subvolume
  42 --tree-root <bytenr>::
  43 use the given bytenr for the tree root
  44
  45 EXIT STATUS
  46 -----------
  47 *btrfs check* returns a zero exit status if it succeeds. Non zero is
  48 returned in case of failure.
  49
  50 AVAILABILITY
  51 ------------
  52 *btrfs* is part of btrfs-progs.
  53 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
  54 further details.
  55
  56 SEE ALSO
  57 --------
  58 `mkfs.btrfs`(8),
  59 `btrfs-scrub`(8),
  60 `btrfs-rescue`(8)