OS Manuals

/usr/bin/lvcreate

Logical Volume Manager 2 utilities

From lvm2 2.03.44-r1 (os), captured 2026-11-08 by running lvcreate --help (exit 0) · terse output. permalink

  Failed to find sysfs mount point
  WARNING: Running as a non-root user. Functionality may be unavailable.
  lvcreate - Create a logical volume

  Create a linear LV.
  lvcreate -L|--size Size[m|UNIT] VG
	[ --type linear ] (implied)
	[ -l|--extents Number[PERCENT] ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a striped LV.
  lvcreate -i|--stripes Number -L|--size Size[m|UNIT] VG
	[ --type striped ] (implied)
	[ -l|--extents Number[PERCENT] ]
	[ -I|--stripesize Size[k|UNIT] ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a raid1 or mirror LV.
  Implicit type is defined by lvm.conf global/mirror_segtype_default.
  lvcreate -L|--size Size[m|UNIT] -m|--mirrors Number VG
	[ --type raid1|mirror ] (implied)
	[ -l|--extents Number[PERCENT] ]
	[ -I|--stripesize Size[k|UNIT] ]
	[ -R|--regionsize Size[m|UNIT] ]
	[    --integritysettings String ]
	[    --maxrecoveryrate Size[k|UNIT] ]
	[    --minrecoveryrate Size[k|UNIT] ]
	[    --mirrorlog core|disk ]
	[    --raidintegrity y|n ]
	[    --raidintegrityblocksize Number ]
	[    --raidintegritymode String ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a raid LV (a specific raid level must be used, e.g. raid1).
  lvcreate --type raid -L|--size Size[m|UNIT] VG
	[ -l|--extents Number[PERCENT] ]
	[ -i|--stripes Number ]
	[ -I|--stripesize Size[k|UNIT] ]
	[ -m|--mirrors Number ]
	[ -R|--regionsize Size[m|UNIT] ]
	[    --integritysettings String ]
	[    --maxrecoveryrate Size[k|UNIT] ]
	[    --minrecoveryrate Size[k|UNIT] ]
	[    --raidintegrity y|n ]
	[    --raidintegrityblocksize Number ]
	[    --raidintegritymode String ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a raid10 LV.
  lvcreate -i|--stripes Number -L|--size Size[m|UNIT] -m|--mirrors Number VG
	[ --type raid10 ] (implied)
	[ -l|--extents Number[PERCENT] ]
	[ -I|--stripesize Size[k|UNIT] ]
	[ -R|--regionsize Size[m|UNIT] ]
	[    --integritysettings String ]
	[    --maxrecoveryrate Size[k|UNIT] ]
	[    --minrecoveryrate Size[k|UNIT] ]
	[    --raidintegrity y|n ]
	[    --raidintegrityblocksize Number ]
	[    --raidintegritymode String ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a COW snapshot LV of an origin LV.
  lvcreate -L|--size Size[m|UNIT] -s|--snapshot LV
	[ --type snapshot ] (implied)
	[ -l|--extents Number[PERCENT] ]
	[ -c|--chunksize Size[k|UNIT] ]
	[ -i|--stripes Number ]
	[ -I|--stripesize Size[k|UNIT] ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a thin pool.
  lvcreate --type thin-pool -L|--size Size[m|UNIT] VG
	[ -l|--extents Number[PERCENT] ]
	[ -c|--chunksize Size[k|UNIT] ]
	[ -i|--stripes Number ]
	[ -I|--stripesize Size[k|UNIT] ]
	[ -T|--thin ]
	[    --compression y|n ]
	[    --deduplication y|n ]
	[    --discards passdown|nopassdown|ignore ]
	[    --errorwhenfull y|n ]
	[    --pooldatavdo y|n ]
	[    --poolmetadatasize Size[m|UNIT] ]
	[    --poolmetadataspare y|n ]
	[    --thinpool LV_new ]
	[    --vdosettings String ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a cache pool.
  lvcreate --type cache-pool -L|--size Size[m|UNIT] VG
	[ -l|--extents Number[PERCENT] ]
	[ -c|--chunksize Size[k|UNIT] ]
	[ -H|--cache ]
	[ -i|--stripes Number ]
	[ -I|--stripesize Size[k|UNIT] ]
	[    --cachemetadataformat auto|1|2 ]
	[    --cachemode writethrough|writeback|passthrough ]
	[    --cachepolicy String ]
	[    --cachesettings String ]
	[    --poolmetadatasize Size[m|UNIT] ]
	[    --poolmetadataspare y|n ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a thin LV in a thin pool.
  lvcreate --thinpool LV -V|--virtualsize Size[m|UNIT] VG
	[ --type thin ] (implied)
	[ -T|--thin ]
	[ COMMON_OPTIONS ]

  Create a thin LV that is a snapshot of an existing thin LV.
  lvcreate -s|--snapshot LV
	[ --type thin ] (implied)
	[ COMMON_OPTIONS ]

  Create a thin LV that is a snapshot of an external origin LV.
  lvcreate --thinpool LV --type thin LV
	[ -T|--thin ]
	[ COMMON_OPTIONS ]

  Create a LV that returns VDO when used.
  lvcreate --type vdo -L|--size Size[m|UNIT] VG
	[ -l|--extents Number[PERCENT] ]
	[ -i|--stripes Number ]
	[ -I|--stripesize Size[k|UNIT] ]
	[ -V|--virtualsize Size[m|UNIT] ]
	[    --compression y|n ]
	[    --deduplication y|n ]
	[    --vdo ]
	[    --vdopool LV_new ]
	[    --vdosettings String ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a new LV, then attach the specified cachepool
  which converts the new LV to type cache.
  lvcreate --cachepool LV --type cache -L|--size Size[m|UNIT] VG
	[ -l|--extents Number[PERCENT] ]
	[ -c|--chunksize Size[k|UNIT] ]
	[ -H|--cache ]
	[ -i|--stripes Number ]
	[ -I|--stripesize Size[k|UNIT] ]
	[    --cachemetadataformat auto|1|2 ]
	[    --cachemode writethrough|writeback|passthrough ]
	[    --cachepolicy String ]
	[    --cachesettings String ]
	[    --poolmetadatasize Size[m|UNIT] ]
	[    --poolmetadataspare y|n ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a new LV, then attach the specified cachevol
  which converts the new LV to type cache.
  lvcreate --cachevol LV --type cache -L|--size Size[m|UNIT] VG
	[ -l|--extents Number[PERCENT] ]
	[ -c|--chunksize Size[k|UNIT] ]
	[ -i|--stripes Number ]
	[ -I|--stripesize Size[k|UNIT] ]
	[    --cachemetadataformat auto|1|2 ]
	[    --cachemode writethrough|writeback|passthrough ]
	[    --cachepolicy String ]
	[    --cachesettings String ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a new LV, then attach a cachevol created from
  the specified cache device, which converts the
  new LV to type cache.
  lvcreate --cachedevice PV --type cache -L|--size Size[m|UNIT] VG
	[ -l|--extents Number[PERCENT] ]
	[ -c|--chunksize Size[k|UNIT] ]
	[ -i|--stripes Number ]
	[ -I|--stripesize Size[k|UNIT] ]
	[    --cachemetadataformat auto|1|2 ]
	[    --cachemode writethrough|writeback|passthrough ]
	[    --cachepolicy String ]
	[    --cachesettings String ]
	[    --cachesize Size[m|UNIT] ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a new LV, then attach the specified cachevol
  which converts the new LV to type writecache.
  lvcreate --cachevol LV --type writecache -L|--size Size[m|UNIT] VG
	[ -l|--extents Number[PERCENT] ]
	[ -i|--stripes Number ]
	[ -I|--stripesize Size[k|UNIT] ]
	[    --cachesettings String ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Create a new LV, then attach a cachevol created from
  the specified cache device, which converts the
  new LV to type writecache.
  lvcreate --cachedevice PV --type writecache -L|--size Size[m|UNIT] VG
	[ -l|--extents Number[PERCENT] ]
	[ -i|--stripes Number ]
	[ -I|--stripesize Size[k|UNIT] ]
	[    --cachesettings String ]
	[    --cachesize Size[m|UNIT] ]
	[ COMMON_OPTIONS ]
	[ PV ... ]

  Common options for command:
	[ -a|--activate y|n|ay ]
	[ -A|--autobackup y|n ]
	[ -C|--contiguous y|n ]
	[ -j|--major Number ]
	[ -k|--setactivationskip y|n ]
	[ -K|--ignoreactivationskip ]
	[ -M|--persistent y|n ]
	[ -n|--name String ]
	[ -p|--permission rw|r ]
	[ -r|--readahead auto|none|Number ]
	[ -W|--wipesignatures y|n ]
	[ -Z|--zero y|n ]
	[    --addtag Tag ]
	[    --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit ]
	[    --ignoremonitoring ]
	[    --metadataprofile String ]
	[    --minor Number ]
	[    --monitor y|n ]
	[    --nosync ]
	[    --noudevsync ]
	[    --reportformat basic|json|json_std ]
	[    --setautoactivation y|n ]

  Common options for lvm:
	[ -d|--debug ]
	[ -h|--help ]
	[ -q|--quiet ]
	[ -v|--verbose ]
	[ -y|--yes ]
	[ -t|--test ]
	[    --commandprofile String ]
	[    --config String ]
	[    --driverloaded y|n ]
	[    --nolocking ]
	[    --lockopt String ]
	[    --longhelp ]
	[    --profile String ]
	[    --version ]
	[    --devicesfile String ]
	[    --devices PV ]
	[    --nohints ]
	[    --journal String ]

  Use --longhelp to show all options and advanced commands.
Options (8)
OptionDescriptionSource
--ignoremonitoringDo not interact with dmeventd unless --monitor is specified.man
--longhelpDisplay long help text.man
--nohintsDo not use the hints file to locate devices for PVs.man
--nolockingDisable locking.man
--nosyncCauses the creation of mirror, raid1, raid4, raid5 and raid10 to skip the initial synchronization.man
--noudevsyncDisables udev synchronization.man
--vdoSpecifies the command is handling VDO LV.man
--versionDisplay version information.man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.