diff options
author | grog <grog@FreeBSD.org> | 1999-03-23 04:55:50 +0000 |
---|---|---|
committer | grog <grog@FreeBSD.org> | 1999-03-23 04:55:50 +0000 |
commit | df50af5d1e09153cbd89b95c92a5bccad476959c (patch) | |
tree | c65c05204992c0852eca55b2b5f121b88c55c812 /sbin/vinum/vinum.8 | |
parent | b05d4b54a516b4ff586ccb82414d6e9d430978e8 (diff) | |
download | FreeBSD-src-df50af5d1e09153cbd89b95c92a5bccad476959c.zip FreeBSD-src-df50af5d1e09153cbd89b95c92a5bccad476959c.tar.gz |
Describe the new semantics of 'create':
When creating a new drive, if the drive already has a vinum label,
and name doesn't match the specified drive, do it anyway if the
'force' flag is specified.
Continually-tripped-over-by: Karl Pielorz <kpielorz@tdx.co.uk>
Update information about partition type for Vinum drives. They
*should* be of type 'vinum', but currently we still accept (and
complain about) partitions of type 'unused'. At a later date, only
'vinum' will be accepted.
Threatened-since: over a year
Diffstat (limited to 'sbin/vinum/vinum.8')
-rw-r--r-- | sbin/vinum/vinum.8 | 39 |
1 files changed, 31 insertions, 8 deletions
diff --git a/sbin/vinum/vinum.8 b/sbin/vinum/vinum.8 index 74ebc5b..b52a4dc 100644 --- a/sbin/vinum/vinum.8 +++ b/sbin/vinum/vinum.8 @@ -12,6 +12,7 @@ .Op Fl options .Sh COMMANDS .Cd create +.Fl f .Ar description-file .in +1i Create a volume as described in @@ -322,7 +323,7 @@ multiplied by the stripe size. For example, in a plex of block size 256k, the first subdisk will have offset 0, the second offset 256k, the third 512k, etc. This calculation ignores parity blocks in RAID-5 plexes. .El -.It Nm create Ar description-file +.It Nm create Fl f Ar description-file .sp .Nm .Ar create @@ -337,6 +338,21 @@ Note that the .Ar create function is additive: if you run it multiple times, you will create multiple copies of all unnamed objects. +.Pp +Normally the +.Nm create +command will not change the names of existing +.Nm +drives, in order to avoid accidentally erasing them. The correct way to dispose +of no longer wanted +.Nm +drives is to reset the configuration with the +.Nm resetconfig +command. In some cases, however, it may be necessary to create new data on +.Nm +drives which can no longer be started. In this case, use the +.Nm create Fl f +command. .It Nm debug .Pp .Nm @@ -1148,11 +1164,15 @@ volume vol5 .Ss DRIVE LAYOUT CONSIDERATIONS .Nm drives are currently BSD disk partitions. They must be of type -.Ar unused -in order to avoid overwriting file systems. In later versions of +.Ar vinum +in order to avoid overwriting file systems. For compatibility reasons, +.Nm +currently accepts partitions of type +.Ar unused , +but the next release will not allow this kind of partition. .Nm -this requirement will change to type -.Ar vinum . +prints a warning message when reading a configuration from a partition of type +.Ar unused . Use .Nm disklabel .Ar -e @@ -1167,7 +1187,7 @@ partition layout as shown by c: 4226725 0 unused 0 0 # (Cyl. 0 - 2955*) e: 81920 0 4.2BSD 0 0 0 # (Cyl. 0 - 57*) f: 1900000 425984 4.2BSD 0 0 0 # (Cyl. 297*- 1626*) - g: 1900741 2325984 unused 0 0 0 # (Cyl. 1626*- 2955*) + g: 1900741 2325984 vinum 0 0 0 # (Cyl. 1626*- 2955*) .Ed .sp In this example, partition @@ -1200,8 +1220,11 @@ section above. .It .Nm will not create a device on UFS partitions. Instead, it will return an error -message ``wrong partition type''. The partition type must currently be -``unused''. +message ``wrong partition type''. The partition type should be +.Ar vinum , +though currently partitions of type +.Ar unused +are also accepted. .It When you create a volume with multiple plexes, .Nm |