gstripe.8 (135826) | gstripe.8 (137221) |
---|---|
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 135826 2004-09-26 17:29:09Z obrien $ | 25.\" $FreeBSD: head/sbin/geom/class/stripe/gstripe.8 137221 2004-11-04 19:12:43Z ceri $ |
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 --- 39 unchanged lines hidden (view full) --- 73.Cm load 74.Op Fl v 75.Nm 76.Cm unload 77.Op Fl v 78.Sh DESCRIPTION 79The 80.Nm | 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 --- 39 unchanged lines hidden (view full) --- 73.Cm load 74.Op Fl v 75.Nm 76.Cm unload 77.Op Fl v 78.Sh DESCRIPTION 79The 80.Nm |
81utility is used for setting up stripe on two or more disks. | 81utility is used for setting up a stripe on two or more disks. |
82The striped device can be configured using two different methods: 83.Dq manual 84or 85.Dq automatic . 86When using the 87.Dq manual 88method, no metadata are stored on the devices, so the striped 89device has to be configured by hand every time it is needed. --- 23 unchanged lines hidden (view full) --- 113.Ar name . 114This is the 115.Dq automatic 116method, where metadata are stored in every device's last sector. 117The kernel module 118.Pa geom_stripe.ko 119will be loaded if it is not loaded already. 120.It Cm stop | 82The striped device can be configured using two different methods: 83.Dq manual 84or 85.Dq automatic . 86When using the 87.Dq manual 88method, no metadata are stored on the devices, so the striped 89device has to be configured by hand every time it is needed. --- 23 unchanged lines hidden (view full) --- 113.Ar name . 114This is the 115.Dq automatic 116method, where metadata are stored in every device's last sector. 117The kernel module 118.Pa geom_stripe.ko 119will be loaded if it is not loaded already. 120.It Cm stop |
121Turn off existing striped device by its | 121Turn off an existing striped device by its |
122.Ar name . 123This command does not touch on-disk metadata! 124.It Cm destroy 125Same as 126.Cm stop . 127.It Cm clear 128Clear metadata on the given devices. 129.It Cm dump --- 31 unchanged lines hidden (view full) --- 161.Nm STRIPE 162GEOM class. 163The default value is shown next to each variable. 164.Bl -tag -width indent 165.It Va kern.geom.stripe.debug : No 0 166Debug level of the 167.Nm STRIPE 168GEOM class. | 122.Ar name . 123This command does not touch on-disk metadata! 124.It Cm destroy 125Same as 126.Cm stop . 127.It Cm clear 128Clear metadata on the given devices. 129.It Cm dump --- 31 unchanged lines hidden (view full) --- 161.Nm STRIPE 162GEOM class. 163The default value is shown next to each variable. 164.Bl -tag -width indent 165.It Va kern.geom.stripe.debug : No 0 166Debug level of the 167.Nm STRIPE 168GEOM class. |
169This can be set to a number between 0 and 3, both included. | 169This can be set to a number between 0 and 3 inclusive. |
170If set to 0 minimal debug information is printed, and if set to 3 the 171maximum amount of debug information in printed. 172.It Va kern.geom.stripe.fast : No 1 173If set to a non-zero value enable 174.Dq "fast mode" 175instead of the normal 176.Dq "economic mode" . 177Compared to 178.Dq "economic mode" 179.Dq "fast mode" 180uses more memory, but it is much faster for smaller stripe sizes. | 170If set to 0 minimal debug information is printed, and if set to 3 the 171maximum amount of debug information in printed. 172.It Va kern.geom.stripe.fast : No 1 173If set to a non-zero value enable 174.Dq "fast mode" 175instead of the normal 176.Dq "economic mode" . 177Compared to 178.Dq "economic mode" 179.Dq "fast mode" 180uses more memory, but it is much faster for smaller stripe sizes. |
181If enough memory cannot be allocated | 181If enough memory cannot be allocated, |
182.Nm STRIPE 183will fall back to 184.Dq "economic mode" . 185.It Va kern.geom.stripe.maxmem : No 1310720 186Maximum amount of memory that can be consumed by 187.Dq "fast mode" 188(in bytes). 189This 190.Xr sysctl 8 191variable is read-only and can only be set as a tunable in 192.Xr loader.conf 5 . 193.It Va kern.geom.stripe.fast_failed | 182.Nm STRIPE 183will fall back to 184.Dq "economic mode" . 185.It Va kern.geom.stripe.maxmem : No 1310720 186Maximum amount of memory that can be consumed by 187.Dq "fast mode" 188(in bytes). 189This 190.Xr sysctl 8 191variable is read-only and can only be set as a tunable in 192.Xr loader.conf 5 . 193.It Va kern.geom.stripe.fast_failed |
194How many times | 194A count of how many times |
195.Dq "fast mode" | 195.Dq "fast mode" |
196failed because of insufficient amount of memory. 197If this value is big, you should considern increasing | 196has failed due to an insufficient amount of memory. 197If this value is large, you should consider increasing the |
198.Va kern.geom.stripe.maxmem 199value. 200.El 201.Sh EXAMPLES | 198.Va kern.geom.stripe.maxmem 199value. 200.El 201.Sh EXAMPLES |
202The following example shows how to set up striped device from four disks with a | 202The following example shows how to set up a striped device from four disks with a |
2034 KB stripe size for automatic configuration, 204create a file system on it, 205and mount it: 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[...] --- 38 unchanged lines hidden --- | 2034 KB stripe size for automatic configuration, 204create a file system on it, 205and mount it: 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[...] --- 38 unchanged lines hidden --- |