diff options
author | grog <grog@FreeBSD.org> | 1999-10-13 03:30:29 +0000 |
---|---|---|
committer | grog <grog@FreeBSD.org> | 1999-10-13 03:30:29 +0000 |
commit | 1e09a99ada53a192649596eefdff0d435852ea59 (patch) | |
tree | 335831095d683f6448958b5e4e16521a75dba40e /sbin/vinum/vinum.8 | |
parent | 00578e9ef1e0c754be943eadc0fda688e102e16d (diff) | |
download | FreeBSD-src-1e09a99ada53a192649596eefdff0d435852ea59.zip FreeBSD-src-1e09a99ada53a192649596eefdff0d435852ea59.tar.gz |
Describe the new options of start and init commands.
Diffstat (limited to 'sbin/vinum/vinum.8')
-rw-r--r-- | sbin/vinum/vinum.8 | 53 |
1 files changed, 43 insertions, 10 deletions
diff --git a/sbin/vinum/vinum.8 b/sbin/vinum/vinum.8 index a63801e..2081343 100644 --- a/sbin/vinum/vinum.8 +++ b/sbin/vinum/vinum.8 @@ -34,9 +34,10 @@ .\" otherwise) arising in any way out of the use of this software, even if .\" advised of the possibility of such damage. .\" +.\" $Id: vinum.8,v 1.12 1999/10/13 02:58:57 grog Exp grog $ .\" $FreeBSD$ .\" -.Dd 28 March 1999 +.Dd 13 October 1999 .Dt vinum 8 .Os .Sh NAME @@ -90,16 +91,18 @@ Detach a plex or subdisk from the volume or plex to which it is attached. .in .Cd info .Op Fl v +.Op Fl V .in +1i List information about volume manager state. .in .Cd init +.Op Fl S Ar size .Op Fl v .Op Fl w -.Ar plex +.Ar plex | subdisk .in +1i .\" XXX -Initialize a plex by writing zeroes to all its subdisks. +Initialize the contents of a subdisk or all the subdisks of a plex to all zeros. .in .Cd label .Ar volume @@ -269,8 +272,9 @@ Set state without influencing other objects, for diagnostic purposes only. Read configuration from all vinum drives. .in .Cd start +.Op Fl S Ar size .Op Fl w -.Op volume | plex | subdisk +volume | plex | subdisk .in +1i Allow the system to access the objects .in @@ -358,12 +362,23 @@ The option is used by the list commands to display statistical information. The .Nm mirror command also uses this flag to specify that it should create striped plexes. +.It Fl S Ar size +The +.Fl S +option specifies the transfer size for the +.Nm init +and +.Nm start +commands. .It Fl v The .Fl v .if t (``verbose'') .if n ("verbose") -option can be used to request more detailed information. +option can be used to request more detailed information. This flag also means +``verify'' for the +.Nm init +command. .It Fl V The .Fl V @@ -744,20 +759,30 @@ specifies that a range lock has been released. The parameters are the same as for the range lock. .El .\" XXX -.It Nm init Op Fl w -.Ar plex +.It Nm init Op Fl S +.Ar size Op Fl v +.Op Fl w +.Ar plex | subdisk .Pp .Nm .Ar init -initializes a plex by writing zeroes to all its subdisks. This is the only way -to ensure consistent data in a plex. You must perform this initialization -before using a RAID-5 plex. It is also recommended for other new plexes. +initializes a subdisk by writing zeroes to it. You can initialize all subdisks +in a plex by specifying the plex name. This is the only way to ensure +consistent data in a plex. You must perform this initialization before using a +RAID-5 plex. It is also recommended for other new plexes. .Nm initializes all subdisks of a plex in parallel. Since this operation can take a long time, it is normally performed in the background. If you want to wait for completion of the command, use the .Fl w (wait) option. +.Pp +Specify the +.Fl S +option if you want to write blocks of a different size from the default value of +16 kB. Specify the +.Fl v +if you want to confirm that the initialization is correct. .Nm prints a console message when the initialization is complete. .It Nm label @@ -1110,6 +1135,7 @@ the usual consistency mechanism of and should be used only for recovery purposes. It is possible to crash the system by incorrect use of this command. .It Nm start +.Op Fl S Ar size .Op Fl w .Op volume | plex | subdisk .Pp @@ -1214,6 +1240,13 @@ done in the background. If you want to wait for this operation to complete (for example, if you are performing this operation in a script), use the .Fl w flag. +.Pp +Copying data doesn't just take a long time, it can also place a significant load +on the system. You can specify the transfer size with the +.Fl S +flag. A future change to +.Nm +will allow a pause between each block to lessen the load on the system. .It Nm stop .Op Fl f .Op volume | plex | subdisk |