From owner-svn-src-projects@FreeBSD.ORG Thu Feb 3 19:27:09 2011 Return-Path: Delivered-To: svn-src-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 07B571065694; Thu, 3 Feb 2011 19:27:09 +0000 (UTC) (envelope-from mav@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id EA9588FC20; Thu, 3 Feb 2011 19:27:08 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id p13JR85V055833; Thu, 3 Feb 2011 19:27:08 GMT (envelope-from mav@svn.freebsd.org) Received: (from mav@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id p13JR8A0055831; Thu, 3 Feb 2011 19:27:08 GMT (envelope-from mav@svn.freebsd.org) Message-Id: <201102031927.p13JR8A0055831@svn.freebsd.org> From: Alexander Motin Date: Thu, 3 Feb 2011 19:27:08 +0000 (UTC) To: src-committers@freebsd.org, svn-src-projects@freebsd.org X-SVN-Group: projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r218233 - projects/graid/head/sbin/geom/class/raid X-BeenThere: svn-src-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the src " projects" tree" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Feb 2011 19:27:09 -0000 Author: mav Date: Thu Feb 3 19:27:08 2011 New Revision: 218233 URL: http://svn.freebsd.org/changeset/base/218233 Log: Grammar lesson. Submitted by: Ben Kaduk Modified: projects/graid/head/sbin/geom/class/raid/graid.8 Modified: projects/graid/head/sbin/geom/class/raid/graid.8 ============================================================================== --- projects/graid/head/sbin/geom/class/raid/graid.8 Thu Feb 3 19:22:21 2011 (r218232) +++ projects/graid/head/sbin/geom/class/raid/graid.8 Thu Feb 3 19:27:08 2011 (r218233) @@ -77,16 +77,17 @@ .Sh DESCRIPTION The .Nm -utility is used to manage software RAID configurations, supported by GEOM RAID -class. +utility is used to manage software RAID configurations, supported by the +GEOM RAID class. GEOM RAID class uses on-disk metadata to provide access to software-RAID volumes defined by different RAID BIOSes. Depending on RAID BIOS type and it's metadata format, different subsets of -configurations and features supported. -To allow booting from RAID volume metadata format should match RAID BIOS type -and it's capabilities. -To guarantee this match it is recommended to create volumes via RAID BIOS -interface, while experienced users are free to do it using this utility. +configurations and features are supported. +To allow booting from RAID volume, the metadata format should match the +RAID BIOS type and its capabilities. +To guarantee that these match, it is recommended to create volumes via the +RAID BIOS interface, while experienced users are free to do it using this +utility. .Pp The first argument to .Nm @@ -94,16 +95,19 @@ indicates an action to be performed: .Bl -tag -width ".Cm destroy" .It Cm label Create an array with single volume. +The .Ar format -argument specifies on-disk metadata format to use for this array, +argument specifies the on-disk metadata format to use for this array, such as "Intel". +The .Ar label -argument specifies label of the created volume. +argument specifies teh label of the created volume. +The .Ar level -argument specifies RAID level of the created volume, such as: +argument specifies the RAID level of the created volume, such as: "RAID0", "RAID1", etc. -Subsequent list enumerates providers to use as array components. -Special name "NONE" can be used to reserve space for absent disk. +The subsequent list enumerates providers to use as array components. +The special name "NONE" can be used to reserve space for absent disks. The order of components can be important, depending on specific RAID level and metadata format. .Pp @@ -122,39 +126,43 @@ Defaults to 131072. .El .It Cm add Create another volume on the existing array. +The .Ar name -argument is the name of existing array, reported by label command. -The rest of arguments are the same as for label command. +argument is the name of the existing array, reported by label command. +The rest of arguments are the same as for the label command. .It Cm delete -Delete volume(s) from the existing array. When last volume deleted, array is -also getting deleted and metadata erased. +Delete volume(s) from the existing array. +When the last volume is deleted, the array is also deleted and its metadata +erased. +The .Ar name argument is the name of existing array. Optional .Ar label or .Ar num -arguments allow to specify volume for deletion. +arguments allow specifying volume for deletion. .It Cm insert Insert specified provider(s) into specified array instead of the first missing or failed components. -If there is no such components - mark disk(s) as spare. +If there are no such components, mark disk(s) as spare. .It Cm remove -Remove specified provider(s) from specified array and erase metadata. -If there are spare disks present - removed disk will be replaced with one -of them. +Remove the specified provider(s) from the specified array and erase metadata. +If there are spare disks present, the removed disk(s) will be replaced by +spares. .It Cm fail Mark the given disks(s) as failed, removing from active use unless absolutely necessary due to exhausted redundancy. If there are spare disks present - failed disk(s) will be replaced with one of them. .It Cm stop -Stop the given array. Metadata not erased. +Stop the given array. +The metadata will not be erased. .Pp Additional options include: .Bl -tag -width ".Fl f" .It Fl f -Stop the given array even if some of it's volumes are opened. +Stop the given array even if some of its volumes are opened. .El .It Cm list See @@ -176,19 +184,22 @@ Additional options include: Be more verbose. .El .Sh SUPPORTED METADATA FORMATS -GEOM RAID class implements modular design, allowing different metadata formats -to be used. Support for such formats is implemented now: +The GEOM RAID class follows a modular design, allowing different metadata +formats to be used. +Support is currently implemented for the following formats: .Bl -tag -width "Intel" .It Intel -Format supported by Intel RAID BIOS. Supports up to two volumes per array. -Supports such configurations: RAID0 (2+ disks), RAID1 (2 disks), -RAID5 (3+ disks), RAID10 (2 or 4 disks). +The format used by Intel RAID BIOS. +Supports up to two volumes per array. +Supports configurations: RAID0 (2+ disks), RAID1 (2 disks), +RAID5 (3+ disks), RAID10 (4 disks). .El .Sh SUPPORTED RAID LEVELS -GEOM RAID class implements modular design, allowing different RAID levels -to be used. Support for such formats is implemented now: RAID0, RAID1. +The GEOM RAID class follows a modular design, allowing different RAID levels +to be used. +Support for the following RAID levels is currently implemented: RAID0, RAID1. .Sh EXIT STATUS -Exit status is 0 on success, and others if the command fails. +Exit status is 0 on success, and non-zero if the command fails. .Sh SEE ALSO .Xr geom 4 , .Xr geom 8 ,