gstripe.8 (133373) | gstripe.8 (135826) |
---|---|
1.\" Copyright (c) 2004 Pawel Jakub Dawidek <pjd@FreeBSD.org> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" | 1.\" Copyright (c) 2004 Pawel Jakub Dawidek <pjd@FreeBSD.org> 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" |
25.\" $FreeBSD: head/sbin/geom/class/stripe/gstripe.8 133373 2004-08-09 11:29:42Z pjd $ | 25.\" $FreeBSD: head/sbin/geom/class/stripe/gstripe.8 135826 2004-09-26 17:29:09Z obrien $ |
26.\" 27.Dd May 21, 2004 28.Dt GSTRIPE 8 29.Os 30.Sh NAME 31.Nm gstripe 32.Nd "control utility for striped devices" 33.Sh SYNOPSIS --- 63 unchanged lines hidden (view full) --- 97.Nm 98indicates an action to be performed: 99.Bl -tag -width ".Cm destroy" 100.It Cm create 101Set up a striped device from the given devices with specified 102.Ar name . 103This is the 104.Dq manual | 26.\" 27.Dd May 21, 2004 28.Dt GSTRIPE 8 29.Os 30.Sh NAME 31.Nm gstripe 32.Nd "control utility for striped devices" 33.Sh SYNOPSIS --- 63 unchanged lines hidden (view full) --- 97.Nm 98indicates an action to be performed: 99.Bl -tag -width ".Cm destroy" 100.It Cm create 101Set up a striped device from the given devices with specified 102.Ar name . 103This is the 104.Dq manual |
105method. | 105method and the stripe will not exist after a reboot (see 106.Cm DESCRIPTION 107above). |
106The kernel module 107.Pa geom_stripe.ko 108will be loaded if it is not loaded already. 109.It Cm label 110Set up a striped device from the given devices with the specified 111.Ar name . 112This is the 113.Dq automatic --- 26 unchanged lines hidden (view full) --- 140.Pp 141Additional options: 142.Bl -tag -width ".Fl s Ar stripesize" 143.It Fl f 144Force the removal of the specified striped device. 145.It Fl h 146Hardcode providers' names in metadata. 147.It Fl s Ar stripesize | 108The kernel module 109.Pa geom_stripe.ko 110will be loaded if it is not loaded already. 111.It Cm label 112Set up a striped device from the given devices with the specified 113.Ar name . 114This is the 115.Dq automatic --- 26 unchanged lines hidden (view full) --- 142.Pp 143Additional options: 144.Bl -tag -width ".Fl s Ar stripesize" 145.It Fl f 146Force the removal of the specified striped device. 147.It Fl h 148Hardcode providers' names in metadata. 149.It Fl s Ar stripesize |
148Specifies size of stripe block. | 150Specifies size of stripe block in bytes. 151The 152.Ar stripesize 153must be a multiple of the largest sector size of all the providers. |
149.It Fl v 150Be more verbose. 151.El 152.Sh SYSCTL VARIABLES 153The following 154.Xr sysctl 8 155variables can be used to control the behavior of the 156.Nm STRIPE --- 32 unchanged lines hidden (view full) --- 189How many times 190.Dq "fast mode" 191failed because of insufficient amount of memory. 192If this value is big, you should considern increasing 193.Va kern.geom.stripe.maxmem 194value. 195.El 196.Sh EXAMPLES | 154.It Fl v 155Be more verbose. 156.El 157.Sh SYSCTL VARIABLES 158The following 159.Xr sysctl 8 160variables can be used to control the behavior of the 161.Nm STRIPE --- 32 unchanged lines hidden (view full) --- 194How many times 195.Dq "fast mode" 196failed because of insufficient amount of memory. 197If this value is big, you should considern increasing 198.Va kern.geom.stripe.maxmem 199value. 200.El 201.Sh EXAMPLES |
197The following example shows how to set up striped device from four disks 198for automatic configuration, create a file system on it, and mount it: | 202The following example shows how to set up striped device from four disks with a 2034 KB stripe size for automatic configuration, 204create a file system on it, 205and mount it: |
199.Bd -literal -offset indent 200gstripe label -v -s 4096 data /dev/da0 /dev/da1 /dev/da2 /dev/da3 201newfs /dev/stripe/data 202mount /dev/stripe/data /mnt 203[...] 204umount /mnt 205gstripe stop data 206gstripe unload 207.Ed 208.Sh DIAGNOSTICS 209Exit status is 0 on success, and 1 if the command fails. | 206.Bd -literal -offset indent 207gstripe label -v -s 4096 data /dev/da0 /dev/da1 /dev/da2 /dev/da3 208newfs /dev/stripe/data 209mount /dev/stripe/data /mnt 210[...] 211umount /mnt 212gstripe stop data 213gstripe unload 214.Ed 215.Sh DIAGNOSTICS 216Exit status is 0 on success, and 1 if the command fails. |
217.Sh COMPATIBILITY 218.Nm 219interleave is in number of bytes, 220unlike 221.Xr ccdconfig 8 222and 223.Xr atacontrol 8 224which uses number of sectors. 225A a 226.Xr ccdconfig 8 227.Ar ileave 228of `128' is 64 KB (128 512B sectors). 229The same stripe interleave would be specified as '65536' for 230.Nm . |
|
210.Sh SEE ALSO 211.Xr geom 4 , 212.Xr loader.conf 5 , | 231.Sh SEE ALSO 232.Xr geom 4 , 233.Xr loader.conf 5 , |
234.Xr atacontrol 8 , 235.Xr ccdconfig 8 , |
|
213.Xr geom 8 , 214.Xr mount 8 , 215.Xr newfs 8 , 216.Xr sysctl 8 , 217.Xr umount 8 , 218.Xr vinum 8 219.Sh HISTORY 220The 221.Nm 222utility appeared in 223.Fx 5.3 . 224.Sh AUTHORS 225.An Pawel Jakub Dawidek Aq pjd@FreeBSD.org | 236.Xr geom 8 , 237.Xr mount 8 , 238.Xr newfs 8 , 239.Xr sysctl 8 , 240.Xr umount 8 , 241.Xr vinum 8 242.Sh HISTORY 243The 244.Nm 245utility appeared in 246.Fx 5.3 . 247.Sh AUTHORS 248.An Pawel Jakub Dawidek Aq pjd@FreeBSD.org |