Content-type: text/html Man page of lvcreate

lvcreate

Section: Maintenance Commands (8)
Index Return to Main Contents
 

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

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

Sets the scheduling policy when one logical extent with more than one mirror is written. Schedule is represented by one of the following: Establishes a parallel scheduling policy. (The default.) Establishes a sequential scheduling policy. This value should be used with care since, in most cases, it will lead to performance loss. 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 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. 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. Sets the access permission to read-write or read-only. Permission is represented by one of the following: Sets the access permission to read-write. (The default.) Sets the access permission to read-only Sets the bad block relocation policy. Relocation is represented by one of the following: Causes bad block relocation to occur. (The default.) Prevents bad block relocation from occurring. 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: Sets a strict allocation policy; mirrors for a logical extent cannot share the same physical volume. (The default.) Does not set a strict allocation policy; mirrors for a logical extent can share the same physical volume. Sets the write-verify state for the logical volume. The Verify parameter is represented by one of the following: Causes the verification of all write operations to the logical volume. Prevents the verification of all write operations to the logical volume. (The default.)  

EXAMPLES

To make a logical volume in volume group vg02, enter: lvcreate /dev/vg02 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

Specifies the command path.  

RELATED INFORMATION

Commands: lvchange(8), lvextend(8), lvreduce(8), pvchange(8) delim off


 

Index

NAME
SYNOPSIS
DESCRIPTION
FLAGS
EXAMPLES
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:41 GMT, October 02, 2010