Deleted Added
full compact
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