RepoMirrors
/
btrfs-progs
mirror of https://github.com/kdave/btrfs-progs
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

btrfs-progs: docs: clarify how btrfs check works with replicas 

- Btrfs-check does device assembly automatically
  Thus no difference when specifying different devices of the same
  filesystem

- Btrfs-check automatically choose good metadata
  Thus as long as there is any good mirror for metadata, it will not
  report error for that repariable metadata.

Signed-off-by: Colin Snover <csnover@users.noreply.github.com>
[ Add an SoB line, remove the scrub recommendation as btrfs-check is
  supposed to choose the good mirror ]
Signed-off-by: Qu Wenruo <wqu@suse.com>
This commit is contained in:
Colin Snover 2024-08-05 19:19:49 -05:00 committed by Qu Wenruo
parent b3f6300176
commit d832a32d8d
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
Documentation/btrfs-check.rst
View File

@ -19,6 +19,13 @@ by the option *--readonly*.
:command:`btrfsck` is an alias of :command:`btrfs check` command and is now deprecated.
.. note::
Even though the filesystem checker requires a device argument, it scans for all
devices belonging to the same filesystem, thus it should not cause a difference
using different devices of the same filesystem.
Furthermore `btrfs check` will automatically choose the good mirror, thus as long
as there is a good copy for metadata, it will not report such case as an error.
.. warning::
Do not use *--repair* unless you are advised to do so by a developer
or an experienced user, and then only after having accepted that no *fsck*