From patchwork Mon Jul 18 12:37:25 2011 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jan Schmidt X-Patchwork-Id: 986022 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by demeter1.kernel.org (8.14.4/8.14.4) with ESMTP id p6ICbfJB007572 for ; Mon, 18 Jul 2011 12:37:41 GMT Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752180Ab1GRMh2 (ORCPT ); Mon, 18 Jul 2011 08:37:28 -0400 Received: from ysabell.rzone.de ([81.169.144.237]:11744 "EHLO ysabell.rzone.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751927Ab1GRMh1 (ORCPT ); Mon, 18 Jul 2011 08:37:27 -0400 Received: from gargravarr.store (gargravarr.store [192.168.42.236]) by ysabell.rzone.de (Postfix) with ESMTP id 47841698; Mon, 18 Jul 2011 14:37:25 +0200 (MEST) Received: by gargravarr.store (Postfix, from userid 32566) id 428B7C046; Mon, 18 Jul 2011 14:37:25 +0200 (CEST) From: Jan Schmidt To: chris.mason@oracle.com, linux-btrfs@vger.kernel.org Subject: [PATCH v3 5/5] btrfs-progs: scrub added to manpage Date: Mon, 18 Jul 2011 14:37:25 +0200 Message-Id: X-Mailer: git-send-email 1.7.3.4 In-Reply-To: References: In-Reply-To: References: Sender: linux-btrfs-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-btrfs@vger.kernel.org X-Greylist: IP, sender and recipient auto-whitelisted, not delayed by milter-greylist-4.2.6 (demeter1.kernel.org [140.211.167.41]); Mon, 18 Jul 2011 12:37:41 +0000 (UTC) Signed-off-by: Jan Schmidt --- man/btrfs.8.in | 64 +++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 files changed, 63 insertions(+), 1 deletions(-) diff --git a/man/btrfs.8.in b/man/btrfs.8.in index e1a6ad9..84a60cd 100644 --- a/man/btrfs.8.in +++ b/man/btrfs.8.in @@ -41,7 +41,15 @@ btrfs \- control a btrfs filesystem .PP \fBbtrfs\fP \fBdevice add\fP\fI [...] \fP .PP -\fBbtrfs\fP \fBdevice delete\fP\fI [...] \fP] +\fBbtrfs\fP \fBdevice delete\fP\fI [...] \fP +.PP +\fBbtrfs\fP \fBscrub start\fP [-Bdqru] {\fI\fP|\fI\fP} +.PP +\fBbtrfs\fP \fBscrub cancel\fP {\fI\fP|\fI\fP} +.PP +\fBbtrfs\fP \fBscrub resume\fP [-Bdqru] {\fI\fP|\fI\fP} +.PP +\fBbtrfs\fP \fBscrub status\fP [-d] {\fI\fP|\fI\fP} .PP \fBbtrfs\fP \fBhelp|\-\-help|\-h \fP\fI\fP .PP @@ -225,6 +233,60 @@ Finally, if \fB--all-devices\fP is passed, all the devices under /dev are scanned. .TP +\fBscrub start\fP [-Bdqru] {\fI\fP|\fI\fP} +Start a scrub on all devices of the filesystem identified by \fI\fR or on +a single \fI\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\fP|\fI\fP} +If a scrub is running on the filesystem identified by \fI\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\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\fP|\fI\fP} +Resume a canceled or interrupted scrub cycle on the filesystem identified by +\fI\fR or on a given \fI\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\fP|\fI\fP} +Show status of a running scrub for the filesystem identified by \fI\fR or +for the specified \fI\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 + .PP \fBbalance progress\fP [\fB-m\fP|\fB--monitor\fP] \fI\fP