Manpage/btrfs-check
From btrfs Wiki
(Difference between revisions)
(Update from git, v4.3) |
(Update from git, v4.5) |
||
| Line 22: | Line 22: | ||
; -s|--super <superblock> | ; -s|--super <superblock> | ||
| − | : use <superblock>th superblock copy, valid values are 0 up to 2 if the respective superblock offset is within the | + | : use <superblock>th superblock copy, valid values are 0 up to 2 if the respective superblock offset is within the filesystem |
| + | ; -b|--backup | ||
| + | : use the first backup roots stored in the superblock that is valid | ||
; --repair | ; --repair | ||
: try to repair the filesystem | : try to repair the filesystem | ||
| + | ; --readonly | ||
| + | : run in read-only mode (default) | ||
; --init-csum-tree | ; --init-csum-tree | ||
: create a new CRC tree and recalculate all checksums | : create a new CRC tree and recalculate all checksums | ||
| Line 30: | Line 34: | ||
: create a new extent tree | : create a new extent tree | ||
; --check-data-csum | ; --check-data-csum | ||
| − | : verify | + | : verify checksums of data blocks |
; -p|--progress | ; -p|--progress | ||
: indicate progress at various checking phases | : indicate progress at various checking phases | ||
; --qgroup-report | ; --qgroup-report | ||
: verify qgroup accounting and compare against filesystem accounting | : verify qgroup accounting and compare against filesystem accounting | ||
| − | ; --subvol-extents <subvolid> | + | ; -E|--subvol-extents <subvolid> |
| − | : show extent state for | + | : show extent state for the given subvolume |
| − | ; --tree-root <bytenr> | + | ; -r|--tree-root <bytenr> |
: use the given bytenr for the tree root | : use the given bytenr for the tree root | ||
| + | ; --chunk-root <bytenr> | ||
| + | : use the given bytenr for the chunk tree root | ||
==EXIT STATUS== | ==EXIT STATUS== | ||
Revision as of 16:40, 21 March 2016
Contents |
btrfs-check(8) Manual Page
Note: manual pages are located at
read-the-docs site, please update your links.
NAME
btrfs-check - check or repair an unmounted btrfs filesystem
SYNOPSIS
btrfs check [options] <device>
DESCRIPTION
btrfs check is used to check or repair an unmounted btrfs filesystem.
Note: 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
btrfsck is an alias of btrfs check command and is now deprecated.
OPTIONS
- -s|--super <superblock>
- use <superblock>th superblock copy, valid values are 0 up to 2 if the respective superblock offset is within the filesystem
- -b|--backup
- use the first backup roots stored in the superblock that is valid
- --repair
- try to repair the filesystem
- --readonly
- run in read-only mode (default)
- --init-csum-tree
- create a new CRC tree and recalculate all checksums
- --init-extent-tree
- create a new extent tree
- --check-data-csum
- verify checksums of data blocks
- -p|--progress
- indicate progress at various checking phases
- --qgroup-report
- verify qgroup accounting and compare against filesystem accounting
- -E|--subvol-extents <subvolid>
- show extent state for the given subvolume
- -r|--tree-root <bytenr>
- use the given bytenr for the tree root
- --chunk-root <bytenr>
- use the given bytenr for the chunk tree root
EXIT STATUS
btrfs check returns a zero exit status if it succeeds. Non zero is returned in case of failure.
AVAILABILITY
btrfs is part of btrfs-progs. Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for further details.
