mirror of
https://github.com/kdave/btrfs-progs
synced 2025-04-25 12:37:55 +00:00
btrfs-progs: scrub added to manpage
Signed-off-by: Jan Schmidt <list.btrfs@jan-o-sch.net> Signed-off-by: Hugo Mills <hugo@carfax.org.uk>
This commit is contained in:
parent
4ba1653187
commit
25439670a6
@ -35,7 +35,15 @@ btrfs \- control a btrfs filesystem
|
|||||||
.PP
|
.PP
|
||||||
\fBbtrfs\fP \fBdevice add\fP\fI <device> [<device>...] <path> \fP
|
\fBbtrfs\fP \fBdevice add\fP\fI <device> [<device>...] <path> \fP
|
||||||
.PP
|
.PP
|
||||||
\fBbtrfs\fP \fBdevice delete\fP\fI <device> [<device>...] <path> \fP]
|
\fBbtrfs\fP \fBdevice delete\fP\fI <device> [<device>...] <path> \fP
|
||||||
|
.PP
|
||||||
|
\fBbtrfs\fP \fBscrub start\fP [-Bdqru] {\fI<path>\fP|\fI<device>\fP}
|
||||||
|
.PP
|
||||||
|
\fBbtrfs\fP \fBscrub cancel\fP {\fI<path>\fP|\fI<device>\fP}
|
||||||
|
.PP
|
||||||
|
\fBbtrfs\fP \fBscrub resume\fP [-Bdqru] {\fI<path>\fP|\fI<device>\fP}
|
||||||
|
.PP
|
||||||
|
\fBbtrfs\fP \fBscrub status\fP [-d] {\fI<path>\fP|\fI<device>\fP}
|
||||||
.PP
|
.PP
|
||||||
\fBbtrfs\fP \fBhelp|\-\-help|\-h \fP\fI\fP
|
\fBbtrfs\fP \fBhelp|\-\-help|\-h \fP\fI\fP
|
||||||
.PP
|
.PP
|
||||||
@ -205,6 +213,60 @@ Add device(s) to the filesystem identified by \fI<path>\fR.
|
|||||||
Remove device(s) from a filesystem identified by \fI<path>\fR.
|
Remove device(s) from a filesystem identified by \fI<path>\fR.
|
||||||
.PP
|
.PP
|
||||||
|
|
||||||
|
\fBscrub start\fP [-Bdqru] {\fI<path>\fP|\fI<device>\fP}
|
||||||
|
Start a scrub on all devices of the filesystem identified by \fI<path>\fR or on
|
||||||
|
a single \fI<device>\fR. Without options, scrub is started as a background
|
||||||
|
process. Progress can be obtained with the \fBscrub status\fR command. Scrubbing
|
||||||
|
involves reading all data from all disks and verifying checksums. Errors are
|
||||||
|
corrected along the way if possible.
|
||||||
|
.RS
|
||||||
|
|
||||||
|
\fIOptions\fR
|
||||||
|
.IP -B 5
|
||||||
|
Do not background and print scrub statistics when finished.
|
||||||
|
.IP -d 5
|
||||||
|
Print separate statistics for each device of the filesystem (-B only).
|
||||||
|
.IP -q 5
|
||||||
|
Quiet. Omit error messages and statistics.
|
||||||
|
.IP -r 5
|
||||||
|
Read only mode. Do not attempt to correct anything.
|
||||||
|
.IP -u 5
|
||||||
|
Scrub unused space as well. (NOT IMPLEMENTED)
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
|
||||||
|
\fBscrub cancel\fP {\fI<path>\fP|\fI<device>\fP}
|
||||||
|
If a scrub is running on the filesystem identified by \fI<path>\fR, cancel it.
|
||||||
|
Progress is saved in the scrub progress file and scrubbing can be resumed later
|
||||||
|
using the \fBscrub resume\fR command.
|
||||||
|
If a \fI<device>\fR is given, the corresponding filesystem is found and
|
||||||
|
\fBscrub cancel\fP behaves as if it was called on that filesystem.
|
||||||
|
.TP
|
||||||
|
|
||||||
|
\fBscrub resume\fP [-Bdqru] {\fI<path>\fP|\fI<device>\fP}
|
||||||
|
Resume a canceled or interrupted scrub cycle on the filesystem identified by
|
||||||
|
\fI<path>\fR or on a given \fI<device>\fR. Does not start a new scrub if the
|
||||||
|
last scrub finished successfully.
|
||||||
|
.RS
|
||||||
|
|
||||||
|
\fIOptions\fR
|
||||||
|
.TP
|
||||||
|
see \fBscrub start\fP.
|
||||||
|
.RE
|
||||||
|
.TP
|
||||||
|
|
||||||
|
\fBscrub status\fP [-d] {\fI<path>\fP|\fI<device>\fP}
|
||||||
|
Show status of a running scrub for the filesystem identified by \fI<path>\fR or
|
||||||
|
for the specified \fI<device>\fR.
|
||||||
|
If no scrub is running, show statistics of the last finished or canceled scrub
|
||||||
|
for that filesystem or device.
|
||||||
|
.RS
|
||||||
|
|
||||||
|
\fIOptions\fR
|
||||||
|
.IP -d 5
|
||||||
|
Print separate statistics for each device of the filesystem.
|
||||||
|
.RE
|
||||||
|
|
||||||
.SH EXIT STATUS
|
.SH EXIT STATUS
|
||||||
\fBbtrfs\fR returns a zero exist status if it succeeds. Non zero is returned in
|
\fBbtrfs\fR returns a zero exist status if it succeeds. Non zero is returned in
|
||||||
case of failure.
|
case of failure.
|
||||||
|
Loading…
Reference in New Issue
Block a user