gvinum.8 (233458) | gvinum.8 (233648) |
---|---|
1.\" Copyright (c) 2005 Chris Jones 2.\" All rights reserved. 3.\" 4.\" This software was developed for the FreeBSD Project by Chris Jones 5.\" thanks to the support of Google's Summer of Code program and 6.\" mentoring by Lukas Ertl. 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 12 unchanged lines hidden (view full) --- 21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" | 1.\" Copyright (c) 2005 Chris Jones 2.\" All rights reserved. 3.\" 4.\" This software was developed for the FreeBSD Project by Chris Jones 5.\" thanks to the support of Google's Summer of Code program and 6.\" mentoring by Lukas Ertl. 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 12 unchanged lines hidden (view full) --- 21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" |
29.\" $FreeBSD: head/sbin/gvinum/gvinum.8 233458 2012-03-25 09:21:09Z joel $ | 29.\" $FreeBSD: head/sbin/gvinum/gvinum.8 233648 2012-03-29 05:02:12Z eadler $ |
30.\" 31.Dd April 10, 2009 32.Dt GVINUM 8 33.Os 34.Sh NAME 35.Nm gvinum 36.Nd Logical Volume Manager control program 37.Sh SYNOPSIS 38.Nm 39.Op Ar command 40.Op Fl options 41.Sh COMMANDS 42.Bl -tag -width indent 43.It Ic attach Ar plex volume Op Cm rename 44.It Ic attach Ar subdisk plex Oo Ar offset Oc Op Cm rename | 30.\" 31.Dd April 10, 2009 32.Dt GVINUM 8 33.Os 34.Sh NAME 35.Nm gvinum 36.Nd Logical Volume Manager control program 37.Sh SYNOPSIS 38.Nm 39.Op Ar command 40.Op Fl options 41.Sh COMMANDS 42.Bl -tag -width indent 43.It Ic attach Ar plex volume Op Cm rename 44.It Ic attach Ar subdisk plex Oo Ar offset Oc Op Cm rename |
45Attach a plex to a volume, or a subdisk to a plex. | 45Attach a plex to a volume, or a subdisk to a plex. |
46If offset is specified, the subdisk will be attached to the given offset within 47the plex. 48If rename is specified, the subdisk or plex will change name according to the 49object it attaches to. 50.It Ic checkparity Oo Fl f Oc Ar plex 51Check the parity blocks of a RAID-5 plex. 52The parity check will start at the 53beginning of the plex if the --- 44 unchanged lines hidden (view full) --- 98flag provides recursive display, showing each object's subordinate objects in 99proper relation. 100The 101.Fl v 102and 103.Fl V 104flags provide progressively more detailed output. 105.It Ic mirror Oo Fl fsv Oc Oo Fl n Ar name Oc Ar drives | 46If offset is specified, the subdisk will be attached to the given offset within 47the plex. 48If rename is specified, the subdisk or plex will change name according to the 49object it attaches to. 50.It Ic checkparity Oo Fl f Oc Ar plex 51Check the parity blocks of a RAID-5 plex. 52The parity check will start at the 53beginning of the plex if the --- 44 unchanged lines hidden (view full) --- 98flag provides recursive display, showing each object's subordinate objects in 99proper relation. 100The 101.Fl v 102and 103.Fl V 104flags provide progressively more detailed output. 105.It Ic mirror Oo Fl fsv Oc Oo Fl n Ar name Oc Ar drives |
106Create a mirrored volume from the specified drives. | 106Create a mirrored volume from the specified drives. |
107It requires at least a multiple of 2 drives. 108If no name is specified, a unique name will be set by gvinum. | 107It requires at least a multiple of 2 drives. 108If no name is specified, a unique name will be set by gvinum. |
109If the | 109If the |
110.Fl s 111flag is specified, a striped mirror will be created, and thus requires a 112multiple of 4 drives. 113.It Ic move | mv Fl f Ar drive subdisk Op Ar ... 114Move the subdisk(s) to the specified drive. 115The 116.Fl f 117flag is required, as all data on the indicated subdisk(s) will be destroyed as --- 26 unchanged lines hidden (view full) --- 144Exit 145.Nm 146when running in interactive mode. 147Normally this would be done by entering the 148EOF character. 149.It Ic raid5 Oo Fl fv Oc Oo Fl s Ar stripesize Oc Oo Fl n Ar name Oc Ar drives 150Create a RAID-5 volume from the specified drives. 151If no name is specified,a unique name will be set by | 110.Fl s 111flag is specified, a striped mirror will be created, and thus requires a 112multiple of 4 drives. 113.It Ic move | mv Fl f Ar drive subdisk Op Ar ... 114Move the subdisk(s) to the specified drive. 115The 116.Fl f 117flag is required, as all data on the indicated subdisk(s) will be destroyed as --- 26 unchanged lines hidden (view full) --- 144Exit 145.Nm 146when running in interactive mode. 147Normally this would be done by entering the 148EOF character. 149.It Ic raid5 Oo Fl fv Oc Oo Fl s Ar stripesize Oc Oo Fl n Ar name Oc Ar drives 150Create a RAID-5 volume from the specified drives. 151If no name is specified,a unique name will be set by |
152.Ic gvinum. | 152.Ic gvinum. |
153This organization requires at least three drives. 154.It Ic rename Oo Fl r Oc Ar drive | subdisk | plex | volume newname 155Change the name of the specified object. 156The 157.Fl r 158flag will recursively rename subordinate objects. 159.Pp 160Note that device nodes will not be renamed until --- 116 unchanged lines hidden (view full) --- 277objects 278.El 279.Sh EXAMPLES 280To create a mirror on disks /dev/ad1 and /dev/ad2, create a filesystem, mount, 281unmount and then stop Ic gvinum: 282.Pp 283.Dl "gvinum mirror /dev/ad1 /dev/ad2" 284.Dl "newfs /dev/gvinum/gvinumvolume0" | 153This organization requires at least three drives. 154.It Ic rename Oo Fl r Oc Ar drive | subdisk | plex | volume newname 155Change the name of the specified object. 156The 157.Fl r 158flag will recursively rename subordinate objects. 159.Pp 160Note that device nodes will not be renamed until --- 116 unchanged lines hidden (view full) --- 277objects 278.El 279.Sh EXAMPLES 280To create a mirror on disks /dev/ad1 and /dev/ad2, create a filesystem, mount, 281unmount and then stop Ic gvinum: 282.Pp 283.Dl "gvinum mirror /dev/ad1 /dev/ad2" 284.Dl "newfs /dev/gvinum/gvinumvolume0" |
285.Dl "mount /dev/gvinum/gvinumvolume0 /mnt" | 285.Dl "mount /dev/gvinum/gvinumvolume0 /mnt" |
286.Dl "..." 287.Dl "unmount /mnt" 288.Dl "gvinum stop" 289.Pp 290To create a striped mirror on disks /dev/ad1 /dev/ad2 /dev/ad3 and /dev/ad4 291named "data" and create a filesystem: 292.Pp 293.Dl "gvinum mirror -s -n data /dev/ad1 /dev/ad2 /dev/ad3 /dev/ad4" --- 147 unchanged lines hidden --- | 286.Dl "..." 287.Dl "unmount /mnt" 288.Dl "gvinum stop" 289.Pp 290To create a striped mirror on disks /dev/ad1 /dev/ad2 /dev/ad3 and /dev/ad4 291named "data" and create a filesystem: 292.Pp 293.Dl "gvinum mirror -s -n data /dev/ad1 /dev/ad2 /dev/ad3 /dev/ad4" --- 147 unchanged lines hidden --- |