diff options
Diffstat (limited to 'sbin')
-rw-r--r-- | sbin/geom/class/mirror/gmirror.8 | 36 | ||||
-rw-r--r-- | sbin/geom/class/raid3/graid3.8 | 10 |
2 files changed, 27 insertions, 19 deletions
diff --git a/sbin/geom/class/mirror/gmirror.8 b/sbin/geom/class/mirror/gmirror.8 index e98bab9..9efa9e6 100644 --- a/sbin/geom/class/mirror/gmirror.8 +++ b/sbin/geom/class/mirror/gmirror.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd Jul 9, 2004 +.Dd July 9, 2004 .Dt GMIRROR 8 .Os .Sh NAME @@ -131,14 +131,14 @@ Additional options include: .Bl -tag -width ".Fl b Ar balance" .It Fl b Ar balance Specifies balance algorithm to use, one of: -.Bl -tag -width "round-robin" -.It load +.Bl -tag -width ".Cm round-robin" +.It Cm load Read from the component with the lowest load. -.It prefer +.It Cm prefer Read from the component with the biggest priority. -.It round-robin +.It Cm round-robin Use round-robin algorithm when choosing component to read. -.It split +.It Cm split Split read requests, which are bigger than or equal to slice size on N pieces, where N is the number of active components. .El @@ -148,7 +148,7 @@ Hardcode providers' names in metadata. Turn off autosynchronization of stale components. .It Fl s Ar slice When using the -.Nm split +.Cm split balance algorithm and an I/O READ request is bigger than or equal to this value, the I/O request will be split into N pieces, where N is the number of active component. @@ -172,7 +172,7 @@ Hardcode providers' names in metadata. Turn off autosynchronization of stale components. .It Fl s Ar slice Specifies slice size for -.Nm split +.Cm split balance algorithm. .El .It Cm rebuild @@ -200,7 +200,7 @@ Mark the given component(s) as inactive, so it will not be automatically connected to the mirror. .It Cm forget Forget about components which are not connected. -This command is useful when a disk has failed and can not be reconnected, preventing the +This command is useful when a disk has failed and cannot be reconnected, preventing the .Cm remove command from being used to remove it. .It Cm stop @@ -230,20 +230,23 @@ Additional options include: Be more verbose. .El .Sh EXAMPLES -Use 3 disks to setup a mirror. Choose split balance algorithm, split only -requests which are bigger than or equal to 2kB. Create file system, +Use 3 disks to setup a mirror. +Choose split balance algorithm, split only +requests which are bigger than or equal to 2kB. +Create file system, mount it, then unmount it and stop device: .Bd -literal -offset indent gmirror label -v -b split -s 2048 data da0 da1 da2 newfs /dev/mirror/data mount /dev/mirror/data /mnt -[...] +\&... umount /mnt gmirror stop data gmirror unload .Ed .Pp -Create a mirror on disk with valid data. Add another disk to this mirror, +Create a mirror on disk with valid data. +Add another disk to this mirror, so it will be synchronized with existing disk: .Bd -literal -offset indent gmirror label -v -b round-robin data da0 @@ -258,7 +261,8 @@ gmirror insert data da2 gmirror rebuild data da2 .Ed .Pp -One disk failed. Replace it with a brand new one: +One disk failed. +Replace it with a brand new one: .Bd -literal -offset indent gmirror forget data gmirror insert data da1 @@ -294,4 +298,6 @@ There should be a way to change a component's priority inside a running mirror. .Pp There should be a section with an implementation description. .Pp -Documentation for sysctls kern.geom.mirror.* is missing. +Documentation for sysctls +.Va kern.geom.mirror.* +is missing. diff --git a/sbin/geom/class/raid3/graid3.8 b/sbin/geom/class/raid3/graid3.8 index b64b21e..4d88458 100644 --- a/sbin/geom/class/raid3/graid3.8 +++ b/sbin/geom/class/raid3/graid3.8 @@ -24,7 +24,7 @@ .\" .\" $FreeBSD$ .\" -.Dd Aug 22, 2004 +.Dd August 22, 2004 .Dt GRAID3 8 .Os .Sh NAME @@ -99,7 +99,7 @@ indicates an action to be performed: Create a RAID3 device. The last given component will contain parity data, whilst the others will all contain regular data. -The number of components must be equal to 3, 5, 9, 17, etc\&. (2^n + 1). +The number of components must be equal to 3, 5, 9, 17, etc.\& (2^n + 1). .Pp Additional options include: .Bl -tag -width ".Fl h" @@ -203,7 +203,7 @@ Create a file system, mount it, then unmount it and stop device: graid3 label -v -r data da0 da1 da2 newfs /dev/raid3/data mount /dev/raid3/data /mnt -[...] +\&... umount /mnt graid3 stop data graid3 unload @@ -241,4 +241,6 @@ utility appeared in .Sh BUGS There should be a section with an implementation description. .Pp -Documentation for sysctls kern.geom.raid3.* is missing. +Documentation for sysctls +.Va kern.geom.raid3.* +is missing. |