From 2550d2afdca391cc7513a6a2842d78df32a2ce37 Mon Sep 17 00:00:00 2001
From: Greg Lehey <grog@FreeBSD.org>
Date: Wed, 7 Jun 2000 04:15:40 +0000
Subject: [PATCH] Update description of checkparity and rebuildparity commands.

---
 sbin/vinum/vinum.8 | 62 ++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 57 insertions(+), 5 deletions(-)

diff --git a/sbin/vinum/vinum.8 b/sbin/vinum/vinum.8
index 068299efde4b..fb4eccaf915b 100644
--- a/sbin/vinum/vinum.8
+++ b/sbin/vinum/vinum.8
@@ -55,9 +55,10 @@
 .in +1i
 Attach a plex to a volume, or a subdisk to a plex.
 .in
-.Cd checkparity Ar plex
+.Cd checkparity Ar plex Op Fl f 
+.Op Fl v
 .in +1i
-Check the parity blocks of a RAID-5 plex.
+Check the parity blocks of a RAID-4 or RAID-5 plex.
 .in
 .Nm concat
 .Op Fl f
@@ -227,9 +228,11 @@ XXX
 Move all the subdisks from the specified drive onto the new drive.
 .in
 ..
-.Cd rebuildparity Ar plex
+.Cd rebuildparity Ar plex Op Fl f
+.Op Fl v 
+.Op Fl V
 .in +1i
-Rebuild the parity blocks of a RAID-5 plex.
+Rebuild the parity blocks of a RAID-4 or RAID-5 plex.
 .in
 .Cd resetconfig
 .in +1i
@@ -468,6 +471,27 @@ multiplied by the stripe size.  For example, in a plex of block size 256k, the
 first subdisk will have offset 0, the second offset 256k, the third 512k, etc.
 This calculation ignores parity blocks in RAID-5 plexes.
 .El
+.It Nm checkparity
+.Ar plex
+.Op Fl f
+.Op Fl v
+.Pp
+Check the parity blocks on the specified RAID-4 or RAID-5 plex.  This operation
+maintains a pointer in the plex, so it can be stopped and later restarted from
+the same position if desired.  In addition, this pointer is used by the
+.Nm rebuildparity
+command, so rebuilding the parity blocks need only start at the location where
+the first parity problem has been detected.
+.Pp
+If the
+.Fl f
+flag is specified,
+.Nm checkparity
+starts checking at the beginning of the plex.  If the
+.Fl v
+flag is specified,
+.Nm checkparity
+prints a running progress report.
 .It Nm concat
 .Op Fl f
 .Op Fl n Ar name
@@ -1041,6 +1065,34 @@ and
 .Nm saveconfig
 commands.  Reset bit 4 of the daemon options mask to re-enable configuration
 saves.
+.It Nm rebuildparity
+.Ar plex
+.Op Fl f
+.Op Fl v
+.Op Fl V
+.Pp
+Rebuild the parity blocks on the specified RAID-4 or RAID-5 plex.  This
+operation maintains a pointer in the plex, so it can be stopped and later
+restarted from the same position if desired.  In addition, this pointer is used
+by the
+.Nm checkparity
+command, so rebuilding the parity blocks need only start at the location where
+the first parity problem has been detected.
+.Pp
+If the
+.Fl f
+flag is specified,
+.Nm rebuildparity
+starts rebuilding at the beginning of the plex.  If the
+.Fl v
+flag is specified,
+.Nm rebuildparity
+first checks the existing parity blocks prints information about those found to
+be incorrect before rebuilding.  If the
+.Fl V
+flag is specified,
+.Nm rebuildparity
+prints a running progress report.
 .It Nm rename
 .Op Fl r
 .Ar [ drive | subdisk | plex | volume ]
@@ -1288,7 +1340,7 @@ example, if you are performing this operation in a script), use the
 option.
 .Pp
 Copying data doesn't just take a long time, it can also place a significant load
-on the system.  You can specify the transfer size in bytes with the
+on the system.  You can specify the transfer size in bytes or sectors with the
 .Fl S
 option, and an interval (in milliseconds) to wait between copying each block with
 the