Click this button to go to the index for this section.

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)