Markup fixes.

This commit is contained in:
Ruslan Ermilov 2005-01-15 10:05:02 +00:00
parent cfe08ee602
commit e6ee149692
2 changed files with 27 additions and 19 deletions

View File

@ -24,7 +24,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd Jul 9, 2004 .Dd July 9, 2004
.Dt GMIRROR 8 .Dt GMIRROR 8
.Os .Os
.Sh NAME .Sh NAME
@ -131,14 +131,14 @@ Additional options include:
.Bl -tag -width ".Fl b Ar balance" .Bl -tag -width ".Fl b Ar balance"
.It Fl b Ar balance .It Fl b Ar balance
Specifies balance algorithm to use, one of: Specifies balance algorithm to use, one of:
.Bl -tag -width "round-robin" .Bl -tag -width ".Cm round-robin"
.It load .It Cm load
Read from the component with the lowest load. Read from the component with the lowest load.
.It prefer .It Cm prefer
Read from the component with the biggest priority. Read from the component with the biggest priority.
.It round-robin .It Cm round-robin
Use round-robin algorithm when choosing component to read. 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, Split read requests, which are bigger than or equal to slice size on N pieces,
where N is the number of active components. where N is the number of active components.
.El .El
@ -148,7 +148,7 @@ Hardcode providers' names in metadata.
Turn off autosynchronization of stale components. Turn off autosynchronization of stale components.
.It Fl s Ar slice .It Fl s Ar slice
When using the When using the
.Nm split .Cm split
balance algorithm and an I/O READ request is bigger than or equal to this value, 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 the I/O request will be split into N pieces, where N is the number of active
component. component.
@ -172,7 +172,7 @@ Hardcode providers' names in metadata.
Turn off autosynchronization of stale components. Turn off autosynchronization of stale components.
.It Fl s Ar slice .It Fl s Ar slice
Specifies slice size for Specifies slice size for
.Nm split .Cm split
balance algorithm. balance algorithm.
.El .El
.It Cm rebuild .It Cm rebuild
@ -200,7 +200,7 @@ Mark the given component(s) as inactive, so it will not be automatically
connected to the mirror. connected to the mirror.
.It Cm forget .It Cm forget
Forget about components which are not connected. 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 .Cm remove
command from being used to remove it. command from being used to remove it.
.It Cm stop .It Cm stop
@ -230,20 +230,23 @@ Additional options include:
Be more verbose. Be more verbose.
.El .El
.Sh EXAMPLES .Sh EXAMPLES
Use 3 disks to setup a mirror. Choose split balance algorithm, split only Use 3 disks to setup a mirror.
requests which are bigger than or equal to 2kB. Create file system, 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: mount it, then unmount it and stop device:
.Bd -literal -offset indent .Bd -literal -offset indent
gmirror label -v -b split -s 2048 data da0 da1 da2 gmirror label -v -b split -s 2048 data da0 da1 da2
newfs /dev/mirror/data newfs /dev/mirror/data
mount /dev/mirror/data /mnt mount /dev/mirror/data /mnt
[...] \&...
umount /mnt umount /mnt
gmirror stop data gmirror stop data
gmirror unload gmirror unload
.Ed .Ed
.Pp .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: so it will be synchronized with existing disk:
.Bd -literal -offset indent .Bd -literal -offset indent
gmirror label -v -b round-robin data da0 gmirror label -v -b round-robin data da0
@ -258,7 +261,8 @@ gmirror insert data da2
gmirror rebuild data da2 gmirror rebuild data da2
.Ed .Ed
.Pp .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 .Bd -literal -offset indent
gmirror forget data gmirror forget data
gmirror insert data da1 gmirror insert data da1
@ -294,4 +298,6 @@ There should be a way to change a component's priority inside a running mirror.
.Pp .Pp
There should be a section with an implementation description. There should be a section with an implementation description.
.Pp .Pp
Documentation for sysctls kern.geom.mirror.* is missing. Documentation for sysctls
.Va kern.geom.mirror.*
is missing.

View File

@ -24,7 +24,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd Aug 22, 2004 .Dd August 22, 2004
.Dt GRAID3 8 .Dt GRAID3 8
.Os .Os
.Sh NAME .Sh NAME
@ -99,7 +99,7 @@ indicates an action to be performed:
Create a RAID3 device. Create a RAID3 device.
The last given component will contain parity data, whilst the others The last given component will contain parity data, whilst the others
will all contain regular data. 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 .Pp
Additional options include: Additional options include:
.Bl -tag -width ".Fl h" .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 graid3 label -v -r data da0 da1 da2
newfs /dev/raid3/data newfs /dev/raid3/data
mount /dev/raid3/data /mnt mount /dev/raid3/data /mnt
[...] \&...
umount /mnt umount /mnt
graid3 stop data graid3 stop data
graid3 unload graid3 unload
@ -241,4 +241,6 @@ utility appeared in
.Sh BUGS .Sh BUGS
There should be a section with an implementation description. There should be a section with an implementation description.
.Pp .Pp
Documentation for sysctls kern.geom.raid3.* is missing. Documentation for sysctls
.Va kern.geom.raid3.*
is missing.