PERFORCE change 122957 for review

[Ulf Lilleengen]

http://perforce.freebsd.org/chv.cgi?CH=122957

Change 122957 by lulf at lulf_carrot on 2007/07/05 14:44:30

	- Update the manpage, and add information about the new raid5 command
	  in it.

Affected files ...

.. //depot/projects/soc2007/lulf/gvinum_fixup/sbin/gvinum/gvinum.8#3 edit

Differences ...

==== //depot/projects/soc2007/lulf/gvinum_fixup/sbin/gvinum/gvinum.8#3 (text+ko) ====

@@ -129,6 +129,10 @@
 when running in interactive mode.
 Normally this would be done by entering the
 EOF character.
+.It Ic raid5 Oo Fl fv Oc Oo Fl s Ar stripesize Oc Oo Fl n Ar name Oc Ar drives
+Create a RAID-5 volume from the specified drives. If no name is specified,
+a unique name will be set by Ic gvinum. This organization requires at least
+three drives.
 .It Ic rename Oo Fl r Oc Ar drive | subdisk | plex | volume newname
 Change the name of the specified object.
 The
@@ -250,14 +254,6 @@
 directory with device nodes for
 .Nm
 objects
-.It Pa /dev/gvinum/plex
-directory containing device nodes for
-.Nm
-plexes
-.It Pa /dev/gvinum/sd
-directory containing device nodes for
-.Nm
-subdisks
 .El
 .Sh EXAMPLES
 To create a mirror on disks /dev/ad1 and /dev/ad2, create a filesystem, mount,
@@ -276,42 +272,32 @@
 .Dl "gvinum mirror -s -n data /dev/ad1 /dev/ad2 /dev/ad3 /dev/ad4"
 .Dl "newfs /dev/gvinum/data"
 .Pp
-To create a raid5 array on disks /dev/ad1 /dev/ad2 and /dev/ad3, you can
-create a config file like this:
+To create a raid5 array on disks /dev/ad1 /dev/ad2 and /dev/ad3, with stripesize
+493k you can use the raid5 command:
 .Pp
-.Dl "gvinum create"
+.Dl "gvinum raid5 -s 493k /dev/ad1 /dev/ad2 /dev/ad3"
 .Pp
-Then an editor will open, and you can create your configuration:
-.Pp
-.Dl "drive gdrive1 device /dev/ad1"
-.Dl "drive gdrive2 device /dev/ad2"
-.Dl "drive gdrive3 device /dev/ad3"
-.Dl "volume myraid5vol"
-.Dl "plex org raid5 493k"
-.Dl "sd drive gdrive1"
-.Dl "sd drive gdrive2"
-.Dl "sd drive gdrive3"
-.Pp
+Then the volume will be created automatically.
 Afterwards, you have to initialize the volume:
 .Pp
 .Dl "gvinum start myraid5vol"
 .Pp
 The initialization will start, and the states will be updated when it's
-finished.
+finished. The list command will give you information about its progress.
 .Pp
 Imagine that one of the drives fails, and the output of 'printconfig' looks
 something like this:
 .Pp
-.Dl "drive gdrive2 device /dev/ad2"
-.Dl "drive gdrive3 device /dev/???"
-.Dl "drive gdrive1 device /dev/ad1"
+.Dl "drive gvinumdrive1 device /dev/ad2"
+.Dl "drive gvinumdrive2 device /dev/???"
+.Dl "drive gvinumdrive0 device /dev/ad1"
 .Dl "volume myraid5vol"
 .Dl "plex name myraid5vol.p0 org raid5 986s vol myraid5vol"
-.Dl "sd name myraid5vol.p0.s2 drive gdrive3 len 32538s driveoffset 265s"
+.Dl "sd name myraid5vol.p0.s2 drive gvinumdrive2 len 32538s driveoffset 265s"
 .Dl "plex myraid5vol.p0 plexoffset 1972s"
-.Dl "sd name myraid5vol.p0.s1 drive gdrive2 len 32538s driveoffset 265s"
+.Dl "sd name myraid5vol.p0.s1 drive gvinumdrive1 len 32538s driveoffset 265s"
 .Dl "plex myraid5vol.p0 plexoffset 986s"
-.Dl "sd name myraid5vol.p0.s0 drive gdrive1 len 32538s driveoffset 265s"
+.Dl "sd name myraid5vol.p0.s0 drive gvinumdrive0 len 32538s driveoffset 265s"
 .Dl "plex myraid5vol.p0 plexoffset 0s"
 .Pp
 Create a new drive with this configuration: