 |
Index for Section 8 |
|
 |
Alphabetical listing for L |
|
lvcreate(8)
NAME
lvcreate - Creates a logical volume in a volume group
SYNOPSIS
/usr/sbin/lvcreate [-d Schedule] [-l LogicalExtentsNumber] [-m
MirrorCopies] [-n LogicalVolumeName] [L-p Permission] [-r Relocate]
[-s Strict] [-v Verify] VolumeGroupName
DESCRIPTION
Note
This command is no longer supported on Digital UNIX systems.
Features formerly provided by the Logical Volume Manager (LVM)
are now provided by the Logical Storage Manager (LSM). Existing
LVM volumes must be migrated to LSM, using an encapsulation
process. For information about moving LVM volumes to LSM, see the
vollvmencap(8) reference page and the manual Logical Storage
Manager.
The lvcreate command creates a new logical volume within the volume group
represented by the VolumeGroupName parameter.
If LogicalVolumeName is provided by the user, the new logical volume is
created with the given name. If LogicalVolumeName is not provided, a
system generated name is provided. The system generated name is of the
form lvol#, where # is the minor number of the new logical volume.
The name of the new logical volume is displayed.
The default settings provide the most commonly used characteristics, but
use flags to tailor the logical volume to the requirements of your system.
Once a logical volume is created, its characteristics can be changed with
the lvchange, lvextend and lvreduce commands.
FLAGS
-d Schedule
Sets the scheduling policy when one logical extent with more than
one mirror is written. Schedule is represented by one of the
following:
p Establishes a parallel scheduling policy. (The
default.)
s Establishes a sequential scheduling policy. This value
should be used with care since, in most cases, it will
lead to performance loss.
-l LogicalExtentsNumber
Allocates LogicalExtentsNumber number of logical extents to the
LogicalVolumePath. LogicalExtentsNumber must be a number
between 1 and 65535, which is the implementation limit.
The default for LogicalExtentsNumber is 0
-m MirrorCopies
Sets the number of physical extents allocated for each logical
extent.
MirrorCopies (that is, mirrors) can be a value of either 1 or 2;
this means that, beyond the original copy, one or two mirror
copies will contain the same data as the original one.
The default for MirrorCopies is 0.
-n LogicalVolumeName
Specifies that the new logical volume must be created with the
name LogicalVolumeName supplied by you. This name must be a
simple file name and not a path name.
-p Permission
Sets the access permission to read-write or read-only.
Permission is represented by one of the following:
w Sets the access permission to read-write. (The
default.)
r Sets the access permission to read-only
-r Relocate
Sets the bad block relocation policy. Relocation is represented
by one of the following:
y Causes bad block relocation to occur. (The default.)
n Prevents bad block relocation from occurring.
-s Strict Determines the strict allocation policy. Mirror copies of a
logical extent can be allocated to share or not to share the same
physical volume. This flag only makes sense when the physical
volumes (of the volume group that owns the logical volume to be
created) reside on different physical disks. The Strict
parameter is represented by one of the following:
y Sets a strict allocation policy; mirrors for a logical
extent cannot share the same physical volume. (The
default.)
n Does not set a strict allocation policy; mirrors for a
logical extent can share the same physical volume.
-v Verify Sets the write-verify state for the logical volume. The Verify
parameter is represented by one of the following:
y Causes the verification of all write operations to the
logical volume.
n Prevents the verification of all write operations to
the logical volume. (The default.)
EXAMPLES
1. To make a logical volume in volume group vg02, enter:
lvcreate /dev/vg02
2. To make a logical volume in volume group vg03 with non-strict
allocation policy, enter:
lvcreate -s n /dev/vg03
A new logical volume in volume group vg03 is created with non-strict
allocation policy.
FILES
/usr/sbin/lvcreate
Specifies the command path.
RELATED INFORMATION
Commands: lvchange(8), lvextend(8), lvreduce(8), pvchange(8)