path: root/Documentation/btrfs-scrub.txt
diff options
authorQu Wenruo <>2014-04-02 16:29:17 +0800
committerDavid Sterba <>2014-04-22 14:15:20 +0200
commit8cf75a9a26049df5f401ea29a6021f5ba9410558 (patch)
treec1f984776e6d138c9ffd59c6c6d81b2d750787ce /Documentation/btrfs-scrub.txt
parentba42a2e67fd35939f686459738eca49c174c3fa6 (diff)
btrfs-progs: Convert man page for btrfs-scrub
Convert man page for btrfs-scrub. Signed-off-by: Qu Wenruo <> Signed-off-by: David Sterba <>
Diffstat (limited to 'Documentation/btrfs-scrub.txt')
1 files changed, 98 insertions, 0 deletions
diff --git a/Documentation/btrfs-scrub.txt b/Documentation/btrfs-scrub.txt
new file mode 100644
index 00000000..3973f317
--- /dev/null
+++ b/Documentation/btrfs-scrub.txt
@@ -0,0 +1,98 @@
+btrfs-scrub - scrub btrfs filesystem
+'btrfs scrub' <subcommand> <args>
+'btrfs scrub' is used to scrub a btrfs filesystem, which will reading all data
+from all disks and verifying checksums.
+'start' [-BdqrRf] [-c ioprio_class -n ioprio_classdata] <path>|<device>::
+Start a scrub on all devices of the filesystem identified by <path> or on
+a single <device>.
+Without options, scrub is started as a background process.
+Progress can be obtained with the 'scrub status' command. Scrubbing
+involves reading all data from all disks and verifying checksums. Errors are
+corrected along the way if possible.
+The default IO priority of scrub is the idle class. The priority can be
+configured similar to the `ionice`(1) syntax using '-c' and '-n' options.
+Do not background and print scrub statistics when finished.
+Print separate statistics for each device of the filesystem (-B only).
+Quiet. Omit error messages and statistics.
+Read only mode. Do not attempt to correct anything.
+Raw print mode. Print full data instead of summary.
+-c ioprio_class::::
+Set IO priority class (see
+ ionice (1)
+-n ioprio_classdata::::
+Set IO priority classdata (see `ionice`(1) manpage).
+force to check whether scrub has started or resumed in userspace.
+this is useful when scrub stat record file is damaged.
+'cancel' <path>|<device>::
+If a scrub is running on the filesystem identified by <path>, cancel it.
+Progress is saved in the scrub progress file and scrubbing can be resumed later
+using the scrub resume command.
+If a <device> is given, the corresponding filesystem is found and
+scrub cancel behaves as if it was called on that filesystem.
+'resume' [-BdqrR] [-c ioprio_class -n ioprio_classdata] <path>|<device>::
+Resume a canceled or interrupted scrub cycle on the filesystem identified by
+<path> or on a given <device>.
+Does not start a new scrub if the last scrub finished successfully.
+see 'scrub start'.
+'status' [-d] <path>|<device>::
+Show status of a running scrub for the filesystem identified by <path> or
+for the specified <device>.
+If no scrub is running, show statistics of the last finished or canceled scrub
+for that filesystem or device.
+Print separate statistics for each device of the filesystem.
+'btrfs scrub' returns a zero exist status if it succeeds. Non zero is
+returned in case of failure.
+'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+and not suitable for any uses other than benchmarking and review.
+Please refer to the btrfs wiki for
+further details.