From owner-man-jp-reviewer@jp.freebsd.org  Tue Jan 11 22:05:56 2000
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id WAA37290;
	Tue, 11 Jan 2000 22:05:56 +0900 (JST)
	(envelope-from owner-man-jp-reviewer@jp.FreeBSD.org)
Received: from serio.al.rim.or.jp (serio.al.rim.or.jp [202.247.191.123])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id WAA37283
	for <man-jp-reviewer@jp.freebsd.org>; Tue, 11 Jan 2000 22:05:55 +0900 (JST)
	(envelope-from inagaki@tg.rim.or.jp)
Received: from mail1.rim.or.jp by serio.al.rim.or.jp (8.8.8/3.7W/HMX-12) with ESMTP id WAA03632 for <man-jp-reviewer@jp.freebsd.org>; Tue, 11 Jan 2000 22:05:53 +0900 (JST)
Received: from lunatic.kareidoscope.ne.jp (cs2d143.ppp.infoweb.ne.jp [202.219.141.155]) by mail1.rim.or.jp (3.7W/)
	id WAA13118 for <man-jp-reviewer@jp.freebsd.org>; Tue, 11 Jan 2000 22:05:52 +0900 (JST)
Received: from localhost (localhost [127.0.0.1])
	by lunatic.kareidoscope.ne.jp (8.9.3/3.7W) with ESMTP id VAA38661
	for <man-jp-reviewer@jp.freebsd.org>; Tue, 11 Jan 2000 21:55:20 +0900 (JST)
To: man-jp-reviewer@jp.freebsd.org
From: Kentaro Inagaki / =?iso-2022-jp?B?GyRCMHAzQBsoQiAbJEI3ckJATzobKEI=?=
 <inagaki@tg.rim.or.jp>
X-Mailer: Mew version 1.95b7 on Emacs 20.5 / Mule 4.0 (HANANOEN)
X-URL: http://www.tg.rim.or.jp/~inagaki/
Mime-Version: 1.0
Content-Type: Text/Plain; charset=iso-2022-jp
Content-Transfer-Encoding: 7bit
Message-Id: <20000111215520H.inagaki@tg.rim.or.jp>
Date: Tue, 11 Jan 2000 21:55:20 +0900
X-Dispatcher: imput version 9911124(IM134)
Lines: 596
Reply-To: man-jp-reviewer@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+990727
X-Sequence: man-jp-reviewer 1907
Subject: [man-jp-reviewer 1907] vinum.8 (3.4R -> 20000105-HEAD)
Errors-To: owner-man-jp-reviewer@jp.freebsd.org
Sender: owner-man-jp-reviewer@jp.freebsd.org
X-Originator: inagaki@tg.rim.or.jp

$B0p3@$G$9!#(B

vinum.8 $B$G$9!#(B

3.4R -> 20000105-HEAD $B$X$NLuJ8$N:9J,$H86J8$N:9J,$G$9!#(B
$B86J8$O(B FTP $B$G;}$C$F$-$FLuJ8$O(B CVS $B$G<h$j=P$7$^$7$?!#(B

$B<j0z$rFI$s$G$d$C$?$D$b$j$J$N$G$9$,2?$+%]%+$,$"$k$+$bCN$l$^$;(B
$B$s!#(B
----
Kentaro Inagaki / $B0p3@(B $B7rB@O:(B
<inagaki@tg.rim.or.jp>
-----------------------------------------------------------
--- vinum.8.ja	Tue Jan 11 15:08:27 2000
+++ vinum.8	Tue Jan 11 20:50:40 2000
@@ -38,7 +38,7 @@
 .\"
 .\" jpman %Id: vinum.8,v 1.3 1999/01/05 15:15:53 horikawa Stab %
 .\" WORD: attach	$B7k9g(B ($B$9$k(B)
-.Dd 28 March 1999
+.Dd 13 October 1999
 .Dt vinum 8
 .Sh $BL>>N(B
 .Nm vinum
@@ -90,17 +90,18 @@
 $B7k9g$5$l$F$$$?%\%j%e!<%`$d%W%l%C%/%9$+$i!"%W%l%C%/%9$d%5%V%G%#%9%/$rJ,N%$7$^$9!#(B
 .in
 .Cd info
-.Op Fl v
+.Op Fl V
 .in +1i
 $B%\%j%e!<%`%^%M!<%8%c$N>uBV$rI=<($7$^$9!#(B
 .in
 .Cd init
+.Op Fl S Ar size
 .Op Fl v
 .Op Fl w
-.Ar plex
+.Ar plex | subdisk
 .in +1i
 .\" XXX
-$B2<0L$NA4%5%V%G%#%9%/$K(B 0 $B$r=q$-9~$s$G$=$N%W%l%C%/%9$r=i4|2=$7$^$9!#(B
+$B%5%V%G%#%9%/$^$?$O%W%l%C%/%9$NA4%5%V%G%#%9%/$NFbMF$r$9$Y$F(B 0 $B$K=i4|2=$7$^$9!#(B
 .in
 .Cd label
 .Ar volume
@@ -177,6 +178,12 @@
 .in +1i
 $B;XDj$7$?%I%i%$%V$+$i%_%i!<2=%\%j%e!<%`$r:n@.$7$^$9!#(B
 .in
+.Cd mv Fl f Ar drive Ar object ...
+.br
+.Cd move Fl f Ar drive Ar object ...
+.in +1i
+$B;XDj$7$?%I%i%$%V$K%*%V%8%'%/%H$r0\F0$7$^$9!#(B
+.in
 .Cd printconfig
 .Op Pa file
 .in +1i
@@ -204,14 +211,15 @@
 .Ar newname
 .in +1i
 $B;XDj$7$?%*%V%8%'%/%H$NL>A0$rJQ99$7$^$9!#(B
+.in
 .ig
 .XXX
-.in
 .Cd replace
-.Ar [ subdisk | plex ]
-.Ar newobject
-.in +1i
-$B%*%V%8%'%/%H$rF10l$NB>$N%*%V%8%'%/%H$HF~$l49$($^$9!#(BXXX $B$^$@<BAu$5$l$F$$$^$;$s!#(B
+.Ar drive
+.Ar newdrive
+.in +1i 
+$B;XDj$7$?%I%i%$%V$+$i?7$7$$%I%i%$%V>e$X$9$Y$F$N%5%V%G%#%9%/$r0\F0$7$^$9!#(B
+.in
 ..
 .in
 .Cd rebuildparity Ar plex
@@ -270,8 +278,9 @@
 $BA4(B vinum $B%I%i%$%V$+$i@_Dj$rFI$_9~$_$^$9!#(B
 .in
 .Cd start
+.Op Fl S Ar size
 .Op Fl w
-.Op volume | plex | subdisk
+volume | plex | subdisk
 .in +1i
 $B%7%9%F%`$,%*%V%8%'%/%H$X%"%/%;%9$G$-$k$h$&$K$7$^$9!#(B
 .in
@@ -366,6 +375,13 @@
 .Nm mirror
 $B%3%^%s%I$b$3$N%U%i%0$r;HMQ$7!"(B
 $B%9%H%i%$%W2=%W%l%C%/%9$r:n@.$9$Y$-$3$H$r<($7$^$9!#(B
+.It Fl S Ar size
+.Fl S
+$B%*%W%7%g%s$O!"(B
+.Nm init
+$B$H(B
+.Nm start
+$B%3%^%s%I$N$?$a$NE>Aw%5%$%:$r;XDj$7$^$9!#(B
 .It Fl v
 .Fl v
 .if t (``verbose: $B>iD9(B'')
@@ -380,6 +396,9 @@
 $B%*%W%7%g%s$O!"(B
 .Fl v
 $B%*%W%7%g%s$,Ds6!$9$k$b$N$h$j$b$5$i$K>\:Y$J>pJs$rMW5a$9$k$?$a$K;HMQ$7$^$9!#(B
+$B$3$N%U%i%0$O(B
+.Nm init
+$B%3%^%s%I$G$O%Y%j%U%!%$$r0UL#$7$^$9!#(B
 .It Fl w
 .Fl w
 .if t (``wait: $BBT$A(B'')
@@ -569,7 +588,7 @@
 $B$NCM$rI=<($7$^$9!#(B
 .It DEBUG_RESID (4)
 .br
-.Fd complete_rqe
+.Fn complete_rqe
 $B$K$*$$$F%G%P%C%,$K0\9T$7$^$9!#(B
 .It DEBUG_LASTREQS (8)
 .br
@@ -774,13 +793,16 @@
 $B%Q%i%a!<%?$O%l%s%8%m%C%/$HF1$8$G$9!#(B
 .El
 .\" XXX
-.It Nm init Op Fl w
-.Ar plex
+.It Nm init Op Fl S 
+.Ar size Op Fl v 
+.Op Fl w
+.Ar plex | subdisk
 .Pp
 .Nm
 .Ar init
-$B$O;XDj$7$?%W%l%C%/%9$N$9$Y$F$N%5%V%G%#%9%/$K(B 0 $B$r=q$-9~$s$G%W%l%C%/%9$r=i4|2=(B
-$B$7$^$9!#$3$l$O%W%l%C%/%9Cf$N%G!<%?$KL7=b$N$J$$$3$H$r3N<B$K$9$kM#0l$NJ}K!$G$9!#(B
+$B$O;XDj$7$?%5%V%G%#%9%/$K(B 0 $B$r=q$-9~$s$G=i4|2=$7$^$9!#(B
+$B%W%l%C%/%9$,;XDj$5$l$?>l9g$O%W%l%C%/%9Fb$NA4%5%V%G%#%9%/$r=i4|2=$G$-$^$9!#(B
+$B$3$l$O%W%l%C%/%9Cf$N%G!<%?$KL7=b$N$J$$$3$H$r3N<B$K$9$kM#0l$NJ}K!$G$9!#(B
 RAID-5 $B%W%l%C%/%9$N;HMQA0$K$O!"$3$N=i4|2=$,I,MW$G$9!#(B
 $BB>$N?75,%W%l%C%/%9$KBP$7$F$b!"$3$N=i4|2=$r?d>)$7$^$9!#(B
 .Nm
@@ -790,6 +812,11 @@
 $B$3$N%3%^%s%I$N40N;$rBT$A$?$$>l9g!"(B
 .Fl w
 ($BBT$A(B) $B%*%W%7%g%s$r;HMQ$7$F$/$@$5$$!#(B
+.Pp
+.Fl S
+$B%*%W%7%g%s$G%G%U%)%k%HCM$N(B 16 kB $B$H0[$J$k%5%$%:$N=q$-9~$_%V%m%C%/$r;XDj$G$-$^(B
+.Fl v
+$B%*%W%7%g%s$G=i4|2=$,@5$7$/9T$J$o$l$?$+3NG'$7$^$9!#(B
 .Nm
 $B$O=i4|2=$,40N;$9$k$H%3%s%=!<%k%a%C%;!<%8$r=PNO$7$^$9!#(B
 .It Nm label
@@ -950,6 +977,19 @@
 $B%*%W%7%g%s$O!">iD9$J=PNO$N$?$a$K;HMQ$7$^$9!#(B
 .Pp
 $B$3$N%3%^%s%I$NNc$O!"8e=R$N!VC1=c$J@_Dj!W$N@a$r;2>H$7$F$/$@$5$$!#(B
+.It Nm mv Fl f Ar drive Ar object ...
+.It Nm move Fl f Ar drive Ar object ...
+.Pp
+$B;XDj$7$?%*%V%8%'%/%H$+$i?7$7$$%I%i%$%V$X$9$Y$F$N%5%V%G%#%9%/$r0\F0$7$^$9!#(B
+$B%*%V%8%'%/%H$O!"%5%V%G%#%9%/!"%I%i%$%V$"$k$$$O%W%l%C%/%9$G$9!#%I%i%$%V(B
+$B$^$?$O%W%l%C%/%9$,;XDj$5$l$?>l9g!"%*%V%8%'%/%H$K4X78$9$k$9$Y$F$N(B
+$B%5%V%G%#%9%/$,0\F0$5$l$^$9!#(B
+.Pp
+$B$3$N5!G=$O8=:_%5%V%G%#%9%/Cf$N%G!<%?$rJ]B8$7$J$$$?$a(B
+.Fl f
+$B%*%W%7%g%s$,I,MW$G$9!#(B
+$B$3$NIU2C5!G=$O!"8eF|DI2C$5$l$^$9!#$7$+$7$J$,$i!"$3$N>uBV$G$b!"8N>c$7$?(B
+$B%G%#%9%/%I%i%$%V$rI|5l$5$;$k$N$K$O==J,$G$9!#(B
 .It Nm printconfig Op Pa file
 $B8=:_$N@_Dj$N%3%T!<$r!"(B
 .Nm
@@ -1016,12 +1056,18 @@
 $B%*%W%7%g%s$,;XDj$5$l$k$H!"2<0L$N%*%V%8%'%/%H$,%G%U%)%k%H$N5,B'$K=>$C$FL?L>$5$l(B
 $B$^$9!#%W%l%C%/%9$NL>A0$O%\%j%e!<%`L>$K(B .p\f(BInumber\fP $B$rIU2C$7$F:n$i$l!"(B
 $B%5%V%G%#%9%/$NL>A0$O%W%l%C%/%9L>$K(B .s\f(BInumber\fP $B$rIU2C$7$F:n$i$l$^$9!#(B
+.ig
 .It Nm replace
-.Ar [ subdisk | plex ]
-.Ar newobject
+.Ar drive
+.Ar newdrive
 .Pp
-$B;XDj$7$?%*%V%8%'%/%H$rF10l$NB>$N%*%V%8%'%/%H$GCV$-49$($^$9!#$3$N%3%^%s%I$O$^$@(B
-$B<BAu$5$l$F$$$^$;$s!#(B
+$B;XDj$7$?%I%i%$%V$+$i?7$7$$%I%i%$%V$X$9$Y$F$N%5%V%G%#%9%/$r0\F0$7$^$9!#(B
+$B$3$l$O2sI|2DG=$J%5%V%G%#%9%/$r2sI|$7$h$&$H$7$^$9!#$=$7$F!"2sI|IT2DG=$J(B
+$B%5%V%G%#%9%/$r:G=i$+$i:n$j$^$9!#(B
+$B$b$7!"?7$7$$%I%i%$%V$K$3$NA`:n$N$?$a$NMFNL$,ITB-$9$k;~$O!"$G$-$k$@$1(B
+$BB?$/$N%5%V%G%#%9%/$r?7$7$$%I%i%$%V>e$K$KAH$_9~$_!";D$j$r85$N%I%i%$%V(B
+$B$K;D$7$^$9!#(B
+..
 .It Nm resetconfig
 .Pp
 .Nm resetconfig
@@ -1154,6 +1200,7 @@
 $B$NDL>o$N0l4S@-5!9=$O%P%$%Q%9$5$l$^$9!#2sI|$NL\E*$G$N$_;HMQ$9$Y$-$G$9!#(B
 $B$3$N%3%^%s%I$r8m$C$F;HMQ$9$k$H!"%7%9%F%`$rGK2u$9$k2DG=@-$,$"$j$^$9!#(B
 .It Nm start
+.Op Fl S Ar size
 .Op Fl w
 .Op volume | plex | subdisk
 .Pp
@@ -1258,7 +1305,6 @@
 $B$O8=:_$N$H$3$m8z2L$,$"$j$^$;$s(B:
 $B2<0L$N%5%V%G%#%9%/$N(B ($B%\%j%e!<%`$N>l9g$K$O$3$l$K2C$($F%W%l%C%/%9$N(B) $B>uBV$r(B
 $B%A%'%C%/$7!"$3$l$K=>$C$F%*%V%8%'%/%H$N>uBV$r@_Dj$7$^$9!#(B
-$B>-Mh$N%P!<%8%g%s$G$O!"K\A`:n$O%5%V%G%#%9%/$K1F6A$rM?$($k$h$&$K$J$j$^$9!#(B
 .Pp
 $B%^%k%A%W%l%C%/%9%\%j%e!<%`$NCf$N(B 1 $B$D$N%W%l%C%/%9$r5/F0$9$k$K$O!"(B
 $B%\%j%e!<%`Cf$NB>$N%W%l%C%/%9$+$i%G!<%?$r%3%T!<$9$kI,MW$,$"$j$^$9!#(B
@@ -1267,6 +1313,16 @@
 ($BNc$($P!"$3$NA`:n$r%9%/%j%W%HCf$G<B9T$7$F$$$k>l9g(B)$B!"(B
 .Fl w
 $B%U%i%0$r;HMQ$7$F$/$@$5$$!#(B
+.Pp
+$B%G!<%?$N%3%T!<$K$O$?$$$7$F;~4V$,$+$+$j$^$;$s!#$=$l$O!"$5$i$K=EBg$JIi2Y$r(B
+$B%7%9%F%`$K$+$1$k$3$H$,$G$-$^$9!#(B
+$B$"$J$?$O(B
+.Fl S
+$B%U%i%0$GE>Aw%5%$%:$r;XDj$9$k$3$H$,$G$-$^$9!#(B
+$B>-Mh(B
+.Nm
+$B$N2~A1$O%7%9%F%`$X$NIU2C$r8:$i$9$h$&$K$=$l$>$l$N%V%m%C%/$N(B
+$B4V$G$N0l;~CfCG$r5v$9$G$7$g$&!#(B
 .It Nm stop
 .Op Fl f
 .Op volume | plex | subdisk
@@ -2417,7 +2473,7 @@
 .Pp
 .Pa rmirror
 $B$H$$$&L>A0$,(B raw $B%G%P%$%9$r;2>H$7$F$$$k$3$H$KCm0U$7$F$/$@$5$$!#(B
-.Sh $B$=$NB>$N$3$H$,$i(B
+.Ss $B$=$NB>$N$3$H$,$i(B
 .Nm
 $B$N@_Dj$K4X78$9$k?t8D$N$=$NB>$N$3$H$,$i$,$"$j$^$9(B:
 .Bl -bullet
@@ -2434,6 +2490,51 @@
 $B8=:_$N$H$3$m4{B8$N(B UFS $B%U%!%$%k%7%9%F%`$NBg$-$5$rA}$9$3$H$b$G$-$^$;$s!#(B
 $B%W%l%C%/%9$*$h$S%U%!%$%k%7%9%F%`$r3HD%2DG=$H$9$k7W2h$O$"$j$^$9!#(B
 .El
+.Sh $B>uBV4IM}(B (STATE MANAGEMENT)
+Vinum $B%*%V%8%'%/%H$O(B
+.Em state
+$B$N35G0$r;}$A$^$9!#(B
+$B>\:Y$O(B
+.Xr vinum 4
+$B$r;2>H$7$F2<$5$$!#$b$7$=$l$i$N>uBV$,(B
+.Em up
+$B$J$i!"$=$l$i$O40A4$K%"%/%;%92DG=$J$@$1$G$9!#(B
+$B%*%V%8%'%/%H$N>uBV$r(B
+.Em up
+$B$KJQ99$9$k$K$O(B
+.Nm start
+$B%3%^%s%I$r;H$$$^$9!#%*%V%8%'%/%H$N>uBV$r(B
+.Em down
+$B$KJQ99$9$k$K$O(B
+.Nm stop
+$B%3%^%s%I$r;H$$$^$9!#(B
+$BDL>o!"B>$N>uBV$O%*%V%8%'%/%H4V$N4X78$K$h$C$F<+F0E*$K:n$i$l$^$9!#(B
+$BNc$($P!"$b$7$"$J$?$,%\%j%e!<%`$K%W%l%C%/%9$rDI2C$7$?$i!"%W%l%C%/%9$N(B
+$B%5%V%G%#%9%/$O!"%O!<%I%&%'%"$,%"%/%;%92DG=$G$"$k$1$l$I$b!"%5%V%G%#%9%/>e$N(B
+$B%G!<%?$OIT@5$G$"$k$3$H$r<($9(B
+.Em stale
+$B>uBV$K@_Dj$5$l$k$G$7$g$&!#$3$N>uBV$N7k2L$H$7$F!"%W%l%C%/%9$O(B
+.Em faulty
+$B>uBV$K@_Dj$5$l$k$G$7$g$&!#(B
+.Ss 'reviving' $B>uBV(B
+$BB?$/$N>l9g!"$"$J$?$,%5%V%G%#%9%/$r5/F0$9$k;~$K!"%7%9%F%`$O%5%V%G%#%9%/$K(B
+$B%G!<%?$r%3%T!<$7$J$1$l$P$J$j$^$;$s!#(B
+$B%5%V%G%#%9%/$NBg$-$5$K$h$j$^$9$,!"$3$l$OD9$$;~4V$+$+$j$^$9!#$3$N4V!"(B
+$B%5%V%G%#%9%/$O(B
+.Em reviving 
+$B>uBV$K@_Dj$5$l$^$9!#%3%T!<A`:n$,@5$7$/=*N;$9$l$P!"$=$l$O<+F0E*$K(B
+.Em up
+$B>uBV$K@_Dj$5$l$^$9!#(B
+$B%W%m%;%9$,!"2sI|(B (revive) $B$rDd;_$5$;!"$=$7$F:F3+$5$;$k$3$H$,$"$j$^$9!#(B
+$B%7%9%F%`$O%5%V%G%#%9%/$N2sI|$N?J$_6q9g$rJ];}$7!"$=$7$F(B
+.Nm start
+$B%3%^%s%I$,:FH/9T$5$l$?;~!"$=$N;~E@$+$i%3%T!<$r:F3+$7$^$9!#(B
+.Pp
+$B%\%j%e!<%`$N%W%l%C%/%9$,0l$D0J>e$,2sI|$7$F$$$k4V$O%\%j%e!<%`$N@09g@-$r(B
+$BJ]$D$?$a$K!"(B
+.Nm
+$B$O=q$-9~$`>l=j$^$G2sI|$5$;$?%5%V%G%#%9%/$K=q$-$^$9!#$b$7FI$_$H$kNN0h$,(B
+$B$9$G$K2sI|$7$F$$$k$J$i$P!"%W%l%C%/%9$+$iFI$_=P$9$3$H$,$G$-$^$9!#(B
 .Sh $BJ,$+$j$K$/$$;EMM(B (GOTCHAS)
 $B<!$N;vJA$O%P%0$G$O$"$j$^$;$s$7!"B8:_$9$kM}M3$,$"$k$N$G$9$,!"(B
 $B:.Mp$r0z$-5/$3$9$b$N$G$9!#(B
---------------------------------------------------------------
--- vinum.8.34R	Mon Dec 20 14:49:33 1999
+++ vinum.8	Wed Jan  5 22:57:55 2000
@@ -34,9 +34,10 @@
 .\" otherwise) arising in any way out of the use of this software, even if
 .\" advised of the possibility of such damage.
 .\"
-.\" $FreeBSD: src/sbin/vinum/vinum.8,v 1.5.2.11 1999/09/22 01:32:20 grog Exp $
+.\" $Id: vinum.8,v 1.13 2000/01/03 03:12:56 grog Exp grog $
+.\" $FreeBSD: src/sbin/vinum/vinum.8,v 1.32 2000/01/05 05:59:08 grog Exp $
 .\"
-.Dd 28 March 1999
+.Dd 13 October 1999
 .Dt vinum 8
 .Os
 .Sh NAME
@@ -90,16 +91,18 @@
 .in
 .Cd info
 .Op Fl v
+.Op Fl V
 .in +1i
 List information about volume manager state.
 .in
 .Cd init
+.Op Fl S Ar size
 .Op Fl v
 .Op Fl w
-.Ar plex
+.Ar plex | subdisk
 .in +1i
 .\" XXX
-Initialize a plex by writing zeroes to all its subdisks.
+Initialize the contents of a subdisk or all the subdisks of a plex to all zeros.
 .in
 .Cd label
 .Ar volume
@@ -176,6 +179,12 @@
 .in +1i
 Create a mirrored volume from the specified drives.
 .in
+.Cd mv Fl f Ar drive Ar object ...
+.br
+.Cd move Fl f Ar drive Ar object ...
+.in +1i
+Move the object(s) to the specified drive.
+.in
 .Cd printconfig
 .Op Pa file
 .in +1i
@@ -203,16 +212,16 @@
 .Ar newname
 .in +1i
 Change the name of the specified object.
+.in
 .ig
 XXX
-.in
 .Cd replace
-.Ar [ subdisk | plex ]
-.Ar newobject
-.in +1i
-Replace the object with an identical other object.  XXX not implemented yet.
-..
+.Ar drive
+.Ar newdrive
+.in +1i 
+Move all the subdisks from the specified drive onto the new drive.
 .in
+..
 .Cd rebuildparity Ar plex
 .in +1i
 Rebuild the parity blocks of a RAID-5 plex.
@@ -269,8 +278,9 @@
 Read configuration from all vinum drives.
 .in
 .Cd start
+.Op Fl S Ar size
 .Op Fl w
-.Op volume | plex | subdisk
+volume | plex | subdisk
 .in +1i
 Allow the system to access the objects
 .in
@@ -358,12 +368,23 @@
 option is used by the list commands to display statistical information.  The
 .Nm mirror
 command also uses this flag to specify that it should create striped plexes.
+.It Fl S Ar size
+The
+.Fl S
+option specifies the transfer size for the
+.Nm init
+and
+.Nm start
+commands.
 .It Fl v
 The
 .Fl v
 .if t (``verbose'')
 .if n ("verbose")
-option can be used to request more detailed information.
+option can be used to request more detailed information.  This flag also means
+``verify'' for the
+.Nm init
+command.
 .It Fl V
 The
 .Fl V
@@ -549,7 +570,7 @@
 .It DEBUG_RESID (4)
 .br
 Go into debugger in
-.Fd complete_rqe.
+.Fn complete_rqe.
 .It DEBUG_LASTREQS (8)
 .br
 Keep a circular buffer of last requests.
@@ -744,20 +765,30 @@
 for the range lock.
 .El
 .\" XXX
-.It Nm init Op Fl w
-.Ar plex
+.It Nm init Op Fl S 
+.Ar size Op Fl v 
+.Op Fl w
+.Ar plex | subdisk
 .Pp
 .Nm
 .Ar init
-initializes a plex by writing zeroes to all its subdisks.  This is the only way
-to ensure consistent data in a plex.  You must perform this initialization
-before using a RAID-5 plex.  It is also recommended for other new plexes.
+initializes a subdisk by writing zeroes to it.  You can initialize all subdisks
+in a plex by specifying the plex name.  This is the only way to ensure
+consistent data in a plex.  You must perform this initialization before using a
+RAID-5 plex.  It is also recommended for other new plexes.
 .Nm
 initializes all subdisks of a plex in parallel.  Since this operation can take a
 long time, it is normally performed in the background.  If you want to wait for
 completion of the command, use the
 .Fl w
 (wait) option.
+.Pp
+Specify the
+.Fl S
+option if you want to write blocks of a different size from the default value of
+16 kB.  Specify the
+.Fl v
+if you want to confirm that the initialization is correct.
 .Nm
 prints a console message when the initialization is complete.
 .It Nm label
@@ -919,6 +950,18 @@
 .Pp
 See the section SIMPLIFIED CONFIGURATION below for some examples of this
 command.
+.It Nm mv Fl f Ar drive Ar object ...
+.It Nm move Fl f Ar drive Ar object ...
+.Pp
+Move all the subdisks from the specified objects onto the new drive.  The
+objects may be subdisks, drives or plexes.  When drives or plexes are specified,
+all subdisks associated with the object are moved.
+.Pp
+The
+.Fl f
+option is required for this function, since it currently does not preserve the
+data in the subdisk.  This functionality will be added at a later date.  In this
+form, however, it is suited to recovering a failed disk drive.
 .It Nm printconfig Op Pa file
 Write a copy of the current configuration to
 .Pa file
@@ -985,12 +1028,17 @@
 option is specified, subordinate objects will be named by the default rules:
 plex names will be formed by appending .p\f(BInumber\fP to the volume name, and
 subdisk names will be formed by appending .s\f(BInumber\fP to the plex name.
+.ig
 .It Nm replace
-.Ar [ subdisk | plex ]
-.Ar newobject
+.Ar drive
+.Ar newdrive
 .Pp
-Replace the object with an identical other object.  This command has not yet
-been implemented.
+Move all the subdisks from the specified drive onto the new drive.  This will
+attempt to recover those subdisks that can be recovered, and create the others
+from scratch.  If the new drive lacks the space for this operation, as many
+subdisks as possible will be fitted onto the drive, and the rest will be left on
+the original drive.
+..
 .It Nm resetconfig
 .Pp
 The
@@ -1110,6 +1158,7 @@
 and should be used only for recovery purposes.  It is possible to crash the
 system by incorrect use of this command.
 .It Nm start
+.Op Fl S Ar size
 .Op Fl w
 .Op volume | plex | subdisk
 .Pp
@@ -1207,7 +1256,6 @@
 .Nm start
 currently has no effect: it checks the state of the subordinate subdisks (and
 plexes in the case of a volume) and sets the state of the object accordingly.
-In a later version, this operation will cause the subdisks
 .Pp
 To start a plex in a multi-plex volume, the data must be copied from another
 plex in the volume.  Since this frequently takes a long time, it is normally
@@ -1215,6 +1263,13 @@
 example, if you are performing this operation in a script), use the
 .Fl w
 flag.
+.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 with the
+.Fl S
+flag.  A future change to
+.Nm
+will allow a pause between each block to lessen the load on the system.
 .It Nm stop
 .Op Fl f
 .Op volume | plex | subdisk
@@ -1794,7 +1849,7 @@
 .Pa /dev/da0
 and
 .Pa /dev/da0s1 ,
-both of which represent a device, not a partition,
+both of which represent a device, not a partition, and
 .Pa /dev/wd1c ,
 which represents a complete disk and should be of type
 .Nm unused .
@@ -2286,7 +2341,7 @@
 Note the name
 .Pa rmirror ,
 indicating the raw device.
-.Sh Other considerations
+.Ss Other considerations
 A number of other considerations apply to
 .Nm
 configuration:
@@ -2302,6 +2357,48 @@
 Currently the size of an existing UFS file system also cannot be increased, but
 it is planned to make both plexes and file systems extensible.
 .El
+.Sh STATE MANAGEMENT
+Vinum objects have the concept of
+.Em state .
+See
+.Xr vinum 4
+for more details.  They are only completely accessible if their state is
+.Em up .
+To change an object state to
+.Em up ,
+use the
+.Nm start
+command.  To change an object state to
+.Em down ,
+use the
+.Nm stop
+command.  Normally other states are created automatically by the relationship
+between objects.  For example, if you add a plex to a volume, the subdisks of
+the plex will be set in the
+.Em stale
+state, indicating that, though the hardware is accessible, the data on the
+subdisk is invalid.  As a result of this state, the plex will be set in the
+.Em faulty
+state.
+.Ss The 'reviving' state
+In many cases, when you start a subdisk the system must copy data to the
+subdisk.  Depending on the size of the subdisk, this can take a long time.
+During this time, the subdisk is set in the
+.Em reviving 
+state.  On successful completion of the copy operation, it is automatically set
+to the
+.Em up
+state.  It is possible for the process performing the revive to be stopped and
+restarted.  The system keeps track of how far the subdisk has been revived, and
+when the
+.Nm start
+command is reissued, the copying continues from this point.
+.Pp
+In order to maintain the consistency of a volume while one or more of its plexes
+is being revived,
+.Nm
+writes to subdisks which have been revived up to the point of the write.  It may
+also read from the plex if the area being read has already been revived.
 .Sh GOTCHAS
 The following points are not bugs, and they have good reasons for existing, but
 they have shown to cause confusion.  Each is discussed in the appropriate
@@ -2478,7 +2575,7 @@
 The
 .Nm
 command first appeared in
-.Fx 3.0.
+.Fx 3.0 .
 The RAID-5 component of
 .Nm
 was developed for Cybernet Inc. 
---------------------------------------------------------------
