1LVCREATE(8) System Manager's Manual LVCREATE(8)
2
6 lvcreate - Create a logical volume
7
9 lvcreate option_args position_args
10 [ option_args ]
11 [ position_args ]
12 -a|--activate y|n|ay
14 --addtag Tag
15 --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
16 -A|--autobackup y|n
17 -H|--cache
18 --cachemetadataformat auto|1|2
19 --cachemode writethrough|writeback|passthrough
20 --cachepolicy String
21 --cachepool LV
22 --cachesettings String
23 -c|--chunksize Size[k|UNIT]
24 --commandprofile String
25 --compression y|n
26 --config String
27 -C|--contiguous y|n
28 -d|--debug
29 --deduplication y|n
30 --discards passdown|nopassdown|ignore
31 --driverloaded y|n
32 --errorwhenfull y|n
33 -l|--extents Number[PERCENT]
34 -h|--help
35 -K|--ignoreactivationskip
36 --ignoremonitoring
37 --lockopt String
38 --longhelp
39 -j|--major Number
40 --[raid]maxrecoveryrate Size[k|UNIT]
41 --metadataprofile String
42 --minor Number
43 --[raid]minrecoveryrate Size[k|UNIT]
44 --mirrorlog core|disk
45 -m|--mirrors Number
46 --monitor y|n
47 -n|--name String
48 --nolocking
49 --nosync
50 --noudevsync
51 -p|--permission rw|r
52 -M|--persistent y|n
53 --poolmetadatasize Size[m|UNIT]
54 --poolmetadataspare y|n
55 --profile String
56 -q|--quiet
57 -r|--readahead auto|none|Number
58 -R|--regionsize Size[m|UNIT]
59 --reportformat basic|json
60 -k|--setactivationskip y|n
61 -L|--size Size[m|UNIT]
62 -s|--snapshot
63 -i|--stripes Number
64 -I|--stripesize Size[k|UNIT]
65 -t|--test
66 -T|--thin
67 --thinpool LV
68 --type linear|striped|snapshot|mir‐
69 ror|raid|thin|cache|thin-pool|cache-pool
70 --vdo
71 --vdopool LV
72 -v|--verbose
73 --version
74 -V|--virtualsize Size[m|UNIT]
75 -W|--wipesignatures y|n
76 -y|--yes
77 -Z|--zero y|n
78
80 lvcreate creates a new LV in a VG. For standard LVs, this requires
81 allocating logical extents from the VG's free physical extents. If
82 there is not enough free space, the VG can be extended with other PVs
83 (vgextend(8)), or existing LVs can be reduced or removed (lvremove(8),
84 lvreduce(8).)
85 To control which PVs a new LV will use, specify one or more PVs as
87 position args at the end of the command line. lvcreate will allocate
88 physical extents only from the specified PVs.
89 lvcreate can also create snapshots of existing LVs, e.g. for backup
91 purposes. The data in a new snapshot LV represents the content of the
92 original LV from the time the snapshot was created.
93 RAID LVs can be created by specifying an LV type when creating the LV
95 (see lvmraid(7)). Different RAID levels require different numbers of
96 unique PVs be available in the VG for allocation.
97 Thin pools (for thin provisioning) and cache pools (for caching) are
99 represented by special LVs with types thin-pool and cache-pool (see
100 lvmthin(7) and lvmcache(7)). The pool LVs are not usable as standard
101 block devices, but the LV names act as references to the pools.
102 Thin LVs are thinly provisioned from a thin pool, and are created with
104 a virtual size rather than a physical size. A cache LV is the combina‐
105 tion of a standard LV with a cache pool, used to cache active portions
106 of the LV to improve performance.
107 Usage notes
109 In the usage section below, --size Size can be replaced with --extents
110 Number. See descriptions in the options section.
111 In the usage section below, --name is omitted from the required
113 options, even though it is typically used. When the name is not speci‐
114 fied, a new LV name is generated with the "lvol" prefix and a unique
115 numeric suffix.
116
118 Create an LV that returns VDO when used.
119 lvcreate --type vdo -L|--size Size[m|UNIT] VG
121 [ -l|--extents Number[PERCENT] ]
122 [ -A|--autobackup y|n ]
123 [ -a|--activate y|n|ay ]
124 [ -C|--contiguous y|n ]
125 [ -K|--ignoreactivationskip ]
126 [ -j|--major Number ]
127 [ -n|--name String ]
128 [ -p|--permission rw|r ]
129 [ -M|--persistent y|n ]
130 [ -r|--readahead auto|none|Number ]
131 [ -k|--setactivationskip y|n ]
132 [ -W|--wipesignatures y|n ]
133 [ -Z|--zero y|n ]
134 [ -V|--virtualsize Size[m|UNIT] ]
135 [ -i|--stripes Number ]
136 [ -I|--stripesize Size[k|UNIT] ]
137 [ --vdo ]
138 [ --addtag Tag ]
139 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
140 ]
141 [ --ignoremonitoring ]
142 [ --metadataprofile String ]
143 [ --minor Number ]
144 [ --monitor y|n ]
145 [ --nosync ]
146 [ --noudevsync ]
147 [ --reportformat basic|json ]
148 [ --compression y|n ]
149 [ --deduplication y|n ]
150 [ COMMON_OPTIONS ]
151 [ PV ... ]
152 -
153 Create a linear LV.
155 lvcreate -L|--size Size[m|UNIT] VG
157 [ -l|--extents Number[PERCENT] ]
158 [ -A|--autobackup y|n ]
159 [ -a|--activate y|n|ay ]
160 [ -C|--contiguous y|n ]
161 [ -K|--ignoreactivationskip ]
162 [ -j|--major Number ]
163 [ -n|--name String ]
164 [ -p|--permission rw|r ]
165 [ -M|--persistent y|n ]
166 [ -r|--readahead auto|none|Number ]
167 [ -k|--setactivationskip y|n ]
168 [ -W|--wipesignatures y|n ]
169 [ -Z|--zero y|n ]
170 [ --type linear ]
171 [ --addtag Tag ]
172 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
173 ]
174 [ --ignoremonitoring ]
175 [ --metadataprofile String ]
176 [ --minor Number ]
177 [ --monitor y|n ]
178 [ --nosync ]
179 [ --noudevsync ]
180 [ --reportformat basic|json ]
181 [ COMMON_OPTIONS ]
182 [ PV ... ]
183 -
184 Create a striped LV (infers --type striped).
186 lvcreate -i|--stripes Number -L|--size Size[m|UNIT] VG
188 [ -l|--extents Number[PERCENT] ]
189 [ -I|--stripesize Size[k|UNIT] ]
190 [ -A|--autobackup y|n ]
191 [ -a|--activate y|n|ay ]
192 [ -C|--contiguous y|n ]
193 [ -K|--ignoreactivationskip ]
194 [ -j|--major Number ]
195 [ -n|--name String ]
196 [ -p|--permission rw|r ]
197 [ -M|--persistent y|n ]
198 [ -r|--readahead auto|none|Number ]
199 [ -k|--setactivationskip y|n ]
200 [ -W|--wipesignatures y|n ]
201 [ -Z|--zero y|n ]
202 [ --addtag Tag ]
203 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
204 ]
205 [ --ignoremonitoring ]
206 [ --metadataprofile String ]
207 [ --minor Number ]
208 [ --monitor y|n ]
209 [ --nosync ]
210 [ --noudevsync ]
211 [ --reportformat basic|json ]
212 [ COMMON_OPTIONS ]
213 [ PV ... ]
214 -
215 Create a raid1 or mirror LV (infers --type raid1|mirror).
217 lvcreate -m|--mirrors Number -L|--size Size[m|UNIT] VG
219 [ -l|--extents Number[PERCENT] ]
220 [ -R|--regionsize Size[m|UNIT] ]
221 [ -A|--autobackup y|n ]
222 [ -a|--activate y|n|ay ]
223 [ -C|--contiguous y|n ]
224 [ -K|--ignoreactivationskip ]
225 [ -j|--major Number ]
226 [ -n|--name String ]
227 [ -p|--permission rw|r ]
228 [ -M|--persistent y|n ]
229 [ -r|--readahead auto|none|Number ]
230 [ -k|--setactivationskip y|n ]
231 [ -W|--wipesignatures y|n ]
232 [ -Z|--zero y|n ]
233 [ --mirrorlog core|disk ]
234 [ --[raid]minrecoveryrate Size[k|UNIT] ]
235 [ --[raid]maxrecoveryrate Size[k|UNIT] ]
236 [ --addtag Tag ]
237 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
238 ]
239 [ --ignoremonitoring ]
240 [ --metadataprofile String ]
241 [ --minor Number ]
242 [ --monitor y|n ]
243 [ --nosync ]
244 [ --noudevsync ]
245 [ --reportformat basic|json ]
246 [ COMMON_OPTIONS ]
247 [ PV ... ]
248 -
249 Create a raid LV (a specific raid level must be used, e.g. raid1).
251 lvcreate --type raid -L|--size Size[m|UNIT] VG
253 [ -l|--extents Number[PERCENT] ]
254 [ -m|--mirrors Number ]
255 [ -i|--stripes Number ]
256 [ -I|--stripesize Size[k|UNIT] ]
257 [ -R|--regionsize Size[m|UNIT] ]
258 [ -A|--autobackup y|n ]
259 [ -a|--activate y|n|ay ]
260 [ -C|--contiguous y|n ]
261 [ -K|--ignoreactivationskip ]
262 [ -j|--major Number ]
263 [ -n|--name String ]
264 [ -p|--permission rw|r ]
265 [ -M|--persistent y|n ]
266 [ -r|--readahead auto|none|Number ]
267 [ -k|--setactivationskip y|n ]
268 [ -W|--wipesignatures y|n ]
269 [ -Z|--zero y|n ]
270 [ --[raid]minrecoveryrate Size[k|UNIT] ]
271 [ --[raid]maxrecoveryrate Size[k|UNIT] ]
272 [ --addtag Tag ]
273 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
274 ]
275 [ --ignoremonitoring ]
276 [ --metadataprofile String ]
277 [ --minor Number ]
278 [ --monitor y|n ]
279 [ --nosync ]
280 [ --noudevsync ]
281 [ --reportformat basic|json ]
282 [ COMMON_OPTIONS ]
283 [ PV ... ]
284 -
285 Create a raid10 LV.
287 lvcreate -m|--mirrors Number -i|--stripes Number
289 -L|--size Size[m|UNIT] VG
290 [ -l|--extents Number[PERCENT] ]
291 [ -I|--stripesize Size[k|UNIT] ]
292 [ -R|--regionsize Size[m|UNIT] ]
293 [ -A|--autobackup y|n ]
294 [ -a|--activate y|n|ay ]
295 [ -C|--contiguous y|n ]
296 [ -K|--ignoreactivationskip ]
297 [ -j|--major Number ]
298 [ -n|--name String ]
299 [ -p|--permission rw|r ]
300 [ -M|--persistent y|n ]
301 [ -r|--readahead auto|none|Number ]
302 [ -k|--setactivationskip y|n ]
303 [ -W|--wipesignatures y|n ]
304 [ -Z|--zero y|n ]
305 [ --[raid]minrecoveryrate Size[k|UNIT] ]
306 [ --[raid]maxrecoveryrate Size[k|UNIT] ]
307 [ --addtag Tag ]
308 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
309 ]
310 [ --ignoremonitoring ]
311 [ --metadataprofile String ]
312 [ --minor Number ]
313 [ --monitor y|n ]
314 [ --nosync ]
315 [ --noudevsync ]
316 [ --reportformat basic|json ]
317 [ COMMON_OPTIONS ]
318 [ PV ... ]
319 -
320 Create a COW snapshot LV of an origin LV.
322 lvcreate -s|--snapshot -L|--size Size[m|UNIT] LV
324 [ -l|--extents Number[PERCENT] ]
325 [ -i|--stripes Number ]
326 [ -I|--stripesize Size[k|UNIT] ]
327 [ -c|--chunksize Size[k|UNIT] ]
328 [ -A|--autobackup y|n ]
329 [ -a|--activate y|n|ay ]
330 [ -C|--contiguous y|n ]
331 [ -K|--ignoreactivationskip ]
332 [ -j|--major Number ]
333 [ -n|--name String ]
334 [ -p|--permission rw|r ]
335 [ -M|--persistent y|n ]
336 [ -r|--readahead auto|none|Number ]
337 [ -k|--setactivationskip y|n ]
338 [ -W|--wipesignatures y|n ]
339 [ -Z|--zero y|n ]
340 [ --type snapshot ]
341 [ --addtag Tag ]
342 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
343 ]
344 [ --ignoremonitoring ]
345 [ --metadataprofile String ]
346 [ --minor Number ]
347 [ --monitor y|n ]
348 [ --nosync ]
349 [ --noudevsync ]
350 [ --reportformat basic|json ]
351 [ COMMON_OPTIONS ]
352 [ PV ... ]
353 -
354 Create a thin pool.
356 lvcreate --type thin-pool -L|--size Size[m|UNIT] VG
358 [ -l|--extents Number[PERCENT] ]
359 [ -c|--chunksize Size[k|UNIT] ]
360 [ -A|--autobackup y|n ]
361 [ -a|--activate y|n|ay ]
362 [ -C|--contiguous y|n ]
363 [ -K|--ignoreactivationskip ]
364 [ -j|--major Number ]
365 [ -n|--name String ]
366 [ -p|--permission rw|r ]
367 [ -M|--persistent y|n ]
368 [ -r|--readahead auto|none|Number ]
369 [ -k|--setactivationskip y|n ]
370 [ -W|--wipesignatures y|n ]
371 [ -Z|--zero y|n ]
372 [ -i|--stripes Number ]
373 [ -I|--stripesize Size[k|UNIT] ]
374 [ --thinpool LV_new ]
375 [ --poolmetadatasize Size[m|UNIT] ]
376 [ --poolmetadataspare y|n ]
377 [ --discards passdown|nopassdown|ignore ]
378 [ --errorwhenfull y|n ]
379 [ --addtag Tag ]
380 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
381 ]
382 [ --ignoremonitoring ]
383 [ --metadataprofile String ]
384 [ --minor Number ]
385 [ --monitor y|n ]
386 [ --nosync ]
387 [ --noudevsync ]
388 [ --reportformat basic|json ]
389 [ COMMON_OPTIONS ]
390 [ PV ... ]
391 -
392 Create a cache pool.
394 lvcreate --type cache-pool -L|--size Size[m|UNIT] VG
396 [ -l|--extents Number[PERCENT] ]
397 [ -H|--cache ]
398 [ -c|--chunksize Size[k|UNIT] ]
399 [ -A|--autobackup y|n ]
400 [ -a|--activate y|n|ay ]
401 [ -C|--contiguous y|n ]
402 [ -K|--ignoreactivationskip ]
403 [ -j|--major Number ]
404 [ -n|--name String ]
405 [ -p|--permission rw|r ]
406 [ -M|--persistent y|n ]
407 [ -r|--readahead auto|none|Number ]
408 [ -k|--setactivationskip y|n ]
409 [ -W|--wipesignatures y|n ]
410 [ -Z|--zero y|n ]
411 [ --poolmetadatasize Size[m|UNIT] ]
412 [ --poolmetadataspare y|n ]
413 [ --cachemode writethrough|writeback|passthrough ]
414 [ --cachepolicy String ]
415 [ --cachesettings String ]
416 [ --cachemetadataformat auto|1|2 ]
417 [ --addtag Tag ]
418 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
419 ]
420 [ --ignoremonitoring ]
421 [ --metadataprofile String ]
422 [ --minor Number ]
423 [ --monitor y|n ]
424 [ --nosync ]
425 [ --noudevsync ]
426 [ --reportformat basic|json ]
427 [ COMMON_OPTIONS ]
428 [ PV ... ]
429 -
430 Create a thin LV in a thin pool (infers --type thin).
432 lvcreate -V|--virtualsize Size[m|UNIT] --thinpool LV_thinpool VG
434 [ -T|--thin ]
435 [ -A|--autobackup y|n ]
436 [ -a|--activate y|n|ay ]
437 [ -C|--contiguous y|n ]
438 [ -K|--ignoreactivationskip ]
439 [ -j|--major Number ]
440 [ -n|--name String ]
441 [ -p|--permission rw|r ]
442 [ -M|--persistent y|n ]
443 [ -r|--readahead auto|none|Number ]
444 [ -k|--setactivationskip y|n ]
445 [ -W|--wipesignatures y|n ]
446 [ -Z|--zero y|n ]
447 [ --type thin ]
448 [ --discards passdown|nopassdown|ignore ]
449 [ --errorwhenfull y|n ]
450 [ --addtag Tag ]
451 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
452 ]
453 [ --ignoremonitoring ]
454 [ --metadataprofile String ]
455 [ --minor Number ]
456 [ --monitor y|n ]
457 [ --nosync ]
458 [ --noudevsync ]
459 [ --reportformat basic|json ]
460 [ COMMON_OPTIONS ]
461 -
462 Create a thin LV that is a snapshot of an existing thin LV
464 (infers --type thin).
465 lvcreate -s|--snapshot LV_thin
467 [ -A|--autobackup y|n ]
468 [ -a|--activate y|n|ay ]
469 [ -C|--contiguous y|n ]
470 [ -K|--ignoreactivationskip ]
471 [ -j|--major Number ]
472 [ -n|--name String ]
473 [ -p|--permission rw|r ]
474 [ -M|--persistent y|n ]
475 [ -r|--readahead auto|none|Number ]
476 [ -k|--setactivationskip y|n ]
477 [ -W|--wipesignatures y|n ]
478 [ -Z|--zero y|n ]
479 [ --type thin ]
480 [ --discards passdown|nopassdown|ignore ]
481 [ --errorwhenfull y|n ]
482 [ --addtag Tag ]
483 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
484 ]
485 [ --ignoremonitoring ]
486 [ --metadataprofile String ]
487 [ --minor Number ]
488 [ --monitor y|n ]
489 [ --nosync ]
490 [ --noudevsync ]
491 [ --reportformat basic|json ]
492 [ COMMON_OPTIONS ]
493 -
494 Create a thin LV that is a snapshot of an external origin LV.
496 lvcreate --type thin --thinpool LV_thinpool LV
498 [ -T|--thin ]
499 [ -c|--chunksize Size[k|UNIT] ]
500 [ -A|--autobackup y|n ]
501 [ -a|--activate y|n|ay ]
502 [ -C|--contiguous y|n ]
503 [ -K|--ignoreactivationskip ]
504 [ -j|--major Number ]
505 [ -n|--name String ]
506 [ -p|--permission rw|r ]
507 [ -M|--persistent y|n ]
508 [ -r|--readahead auto|none|Number ]
509 [ -k|--setactivationskip y|n ]
510 [ -W|--wipesignatures y|n ]
511 [ -Z|--zero y|n ]
512 [ --poolmetadatasize Size[m|UNIT] ]
513 [ --poolmetadataspare y|n ]
514 [ --discards passdown|nopassdown|ignore ]
515 [ --errorwhenfull y|n ]
516 [ --addtag Tag ]
517 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
518 ]
519 [ --ignoremonitoring ]
520 [ --metadataprofile String ]
521 [ --minor Number ]
522 [ --monitor y|n ]
523 [ --nosync ]
524 [ --noudevsync ]
525 [ --reportformat basic|json ]
526 [ COMMON_OPTIONS ]
527 -
528 Create a thin LV, first creating a thin pool for it,
530 where the new thin pool is named by the --thinpool arg.
531 lvcreate --type thin -V|--virtualsize Size[m|UNIT]
533 -L|--size Size[m|UNIT] --thinpool LV_new
534 [ -l|--extents Number[PERCENT] ]
535 [ -T|--thin ]
536 [ -c|--chunksize Size[k|UNIT] ]
537 [ -A|--autobackup y|n ]
538 [ -a|--activate y|n|ay ]
539 [ -C|--contiguous y|n ]
540 [ -K|--ignoreactivationskip ]
541 [ -j|--major Number ]
542 [ -n|--name String ]
543 [ -p|--permission rw|r ]
544 [ -M|--persistent y|n ]
545 [ -r|--readahead auto|none|Number ]
546 [ -k|--setactivationskip y|n ]
547 [ -W|--wipesignatures y|n ]
548 [ -Z|--zero y|n ]
549 [ -i|--stripes Number ]
550 [ -I|--stripesize Size[k|UNIT] ]
551 [ --poolmetadatasize Size[m|UNIT] ]
552 [ --poolmetadataspare y|n ]
553 [ --discards passdown|nopassdown|ignore ]
554 [ --errorwhenfull y|n ]
555 [ --addtag Tag ]
556 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
557 ]
558 [ --ignoremonitoring ]
559 [ --metadataprofile String ]
560 [ --minor Number ]
561 [ --monitor y|n ]
562 [ --nosync ]
563 [ --noudevsync ]
564 [ --reportformat basic|json ]
565 [ COMMON_OPTIONS ]
566 [ PV ... ]
567 -
568 Create a cache LV, first creating a new origin LV,
570 then combining it with the existing cache pool named
571 by the --cachepool arg.
572 lvcreate --type cache -L|--size Size[m|UNIT]
574 --cachepool LV_cachepool VG
575 [ -l|--extents Number[PERCENT] ]
576 [ -H|--cache ]
577 [ -c|--chunksize Size[k|UNIT] ]
578 [ -A|--autobackup y|n ]
579 [ -a|--activate y|n|ay ]
580 [ -C|--contiguous y|n ]
581 [ -K|--ignoreactivationskip ]
582 [ -j|--major Number ]
583 [ -n|--name String ]
584 [ -p|--permission rw|r ]
585 [ -M|--persistent y|n ]
586 [ -r|--readahead auto|none|Number ]
587 [ -k|--setactivationskip y|n ]
588 [ -W|--wipesignatures y|n ]
589 [ -Z|--zero y|n ]
590 [ -i|--stripes Number ]
591 [ -I|--stripesize Size[k|UNIT] ]
592 [ --poolmetadatasize Size[m|UNIT] ]
593 [ --poolmetadataspare y|n ]
594 [ --cachemode writethrough|writeback|passthrough ]
595 [ --cachepolicy String ]
596 [ --cachesettings String ]
597 [ --cachemetadataformat auto|1|2 ]
598 [ --addtag Tag ]
599 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
600 ]
601 [ --ignoremonitoring ]
602 [ --metadataprofile String ]
603 [ --minor Number ]
604 [ --monitor y|n ]
605 [ --nosync ]
606 [ --noudevsync ]
607 [ --reportformat basic|json ]
608 [ COMMON_OPTIONS ]
609 [ PV ... ]
610 -
611 Common options for command:
613 Common options for lvm:
615 [ -d|--debug ]
616 [ -h|--help ]
617 [ -q|--quiet ]
618 [ -t|--test ]
619 [ -v|--verbose ]
620 [ -y|--yes ]
621 [ --commandprofile String ]
622 [ --config String ]
623 [ --driverloaded y|n ]
624 [ --lockopt String ]
625 [ --longhelp ]
626 [ --nolocking ]
627 [ --profile String ]
628 [ --version ]
629
631 -a|--activate y|n|ay
632 Controls the active state of the new LV. y makes the LV active,
633 or available. New LVs are made active by default. n makes the
634 LV inactive, or unavailable, only when possible. In some cases,
635 creating an LV requires it to be active. For example, COW snap‐
636 shots of an active origin LV can only be created in the active
637 state (this does not apply to thin snapshots). The --zero
638 option normally requires the LV to be active. If autoactivation
639 ay is used, the LV is only activated if it matches an item in
640 lvm.conf activation/auto_activation_volume_list. ay implies
641 --zero n and --wipesignatures n. See lvmlockd(8) for more
642 information about activation options for shared VGs.
643 --addtag Tag
645 Adds a tag to a PV, VG or LV. This option can be repeated to add
646 multiple tags at once. See lvm(8) for information about tags.
647 --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
649 Determines the allocation policy when a command needs to allo‐
650 cate Physical Extents (PEs) from the VG. Each VG and LV has an
651 allocation policy which can be changed with vgchange/lvchange,
652 or overriden on the command line. normal applies common sense
653 rules such as not placing parallel stripes on the same PV.
654 inherit applies the VG policy to an LV. contiguous requires new
655 PEs be placed adjacent to existing PEs. cling places new PEs on
656 the same PV as existing PEs in the same stripe of the LV. If
657 there are sufficient PEs for an allocation, but normal does not
658 use them, anywhere will use them even if it reduces performance,
659 e.g. by placing two stripes on the same PV. Optional positional
660 PV args on the command line can also be used to limit which PVs
661 the command will use for allocation. See lvm(8) for more infor‐
662 mation about allocation.
663 -A|--autobackup y|n
665 Specifies if metadata should be backed up automatically after a
666 change. Enabling this is strongly advised! See vgcfgbackup(8)
667 for more information.
668 -H|--cache
670 Specifies the command is handling a cache LV or cache pool. See
671 --type cache and --type cache-pool. See lvmcache(7) for more
672 information about LVM caching.
673 --cachemetadataformat auto|1|2
675 Specifies the cache metadata format used by cache target.
676 --cachemode writethrough|writeback|passthrough
678 Specifies when writes to a cache LV should be considered com‐
679 plete. writeback considers a write complete as soon as it is
680 stored in the cache pool. writethough considers a write com‐
681 plete only when it has been stored in both the cache pool and on
682 the origin LV. While writethrough may be slower for writes, it
683 is more resilient if something should happen to a device associ‐
684 ated with the cache pool LV. With passthrough, all reads are
685 served from the origin LV (all reads miss the cache) and all
686 writes are forwarded to the origin LV; additionally, write hits
687 cause cache block invalidates. See lvmcache(7) for more informa‐
688 tion.
689 --cachepolicy String
691 Specifies the cache policy for a cache LV. See lvmcache(7) for
692 more information.
693 --cachepool LV
695 The name of a cache pool LV.
696 --cachesettings String
698 Specifies tunable values for a cache LV in "Key = Value" form.
699 Repeat this option to specify multiple values. (The default
700 values should usually be adequate.) The special string value
701 default switches settings back to their default kernel values
702 and removes them from the list of settings stored in LVM meta‐
703 data. See lvmcache(7) for more information.
704 -c|--chunksize Size[k|UNIT]
706 The size of chunks in a snapshot, cache pool or thin pool. For
707 snapshots, the value must be a power of 2 between 4KiB and
708 512KiB and the default value is 4. For a cache pool the value
709 must be between 32KiB and 1GiB and the default value is 64. For
710 a thin pool the value must be between 64KiB and 1GiB and the
711 default value starts with 64 and scales up to fit the pool meta‐
712 data size within 128MiB, if the pool metadata size is not speci‐
713 fied. The value must be a multiple of 64KiB. See lvmthin(7)
714 and lvmcache(7) for more information.
715 --commandprofile String
717 The command profile to use for command configuration. See
718 lvm.conf(5) for more information about profiles.
719 --compression y|n
721 Controls whether compression is enabled or disable for VDO vol‐
722 ume. See lvmvdo(7) for more information about VDO usage.
723 --config String
725 Config settings for the command. These override lvm.conf set‐
726 tings. The String arg uses the same format as lvm.conf, or may
727 use section/field syntax. See lvm.conf(5) for more information
728 about config.
729 -C|--contiguous y|n
731 Sets or resets the contiguous allocation policy for LVs.
732 Default is no contiguous allocation based on a next free princi‐
733 ple. It is only possible to change a non-contiguous allocation
734 policy to contiguous if all of the allocated physical extents in
735 the LV are already contiguous.
736 -d|--debug ...
738 Set debug level. Repeat from 1 to 6 times to increase the detail
739 of messages sent to the log file and/or syslog (if configured).
740 --deduplication y|n
742 Controls whether deduplication is enabled or disable for VDO
743 volume. See lvmvdo(7) for more information about VDO usage.
744 --discards passdown|nopassdown|ignore
746 Specifies how the device-mapper thin pool layer in the kernel
747 should handle discards. ignore causes the thin pool to ignore
748 discards. nopassdown causes the thin pool to process discards
749 itself to allow reuse of unneeded extents in the thin pool.
750 passdown causes the thin pool to process discards itself (like
751 nopassdown) and pass the discards to the underlying device. See
752 lvmthin(7) for more information.
753 --driverloaded y|n
755 If set to no, the command will not attempt to use device-mapper.
756 For testing and debugging.
757 --errorwhenfull y|n
759 Specifies thin pool behavior when data space is exhausted. When
760 yes, device-mapper will immediately return an error when a thin
761 pool is full and an I/O request requires space. When no,
762 device-mapper will queue these I/O requests for a period of time
763 to allow the thin pool to be extended. Errors are returned if
764 no space is available after the timeout. (Also see dm-thin-pool
765 kernel module option no_space_timeout.) See lvmthin(7) for more
766 information.
767 -l|--extents Number[PERCENT]
769 Specifies the size of the new LV in logical extents. The --size
770 and --extents options are alternate methods of specifying size.
771 The total number of physical extents used will be greater when
772 redundant data is needed for RAID levels. An alternate syntax
773 allows the size to be determined indirectly as a percentage of
774 the size of a related VG, LV, or set of PVs. The suffix %VG
775 denotes the total size of the VG, the suffix %FREE the remaining
776 free space in the VG, and the suffix %PVS the free space in the
777 specified PVs. For a snapshot, the size can be expressed as a
778 percentage of the total size of the origin LV with the suffix
779 %ORIGIN (100%ORIGIN provides space for the whole origin). When
780 expressed as a percentage, the size defines an upper limit for
781 the number of logical extents in the new LV. The precise number
782 of logical extents in the new LV is not determined until the
783 command has completed.
784 -h|--help
786 Display help text.
787 -K|--ignoreactivationskip
789 Ignore the "activation skip" LV flag during activation to allow
790 LVs with the flag set to be activated.
791 --ignoremonitoring
793 Do not interact with dmeventd unless --monitor is specified. Do
794 not use this if dmeventd is already monitoring a device.
795 --lockopt String
797 Used to pass options for special cases to lvmlockd. See lvm‐
798 lockd(8) for more information.
799 --longhelp
801 Display long help text.
802 -j|--major Number
804 Sets the major number of an LV block device.
805 --[raid]maxrecoveryrate Size[k|UNIT]
807 Sets the maximum recovery rate for a RAID LV. The rate value is
808 an amount of data per second for each device in the array. Set‐
809 ting the rate to 0 means it will be unbounded. See lvmraid(7)
810 for more information.
811 --metadataprofile String
813 The metadata profile to use for command configuration. See
814 lvm.conf(5) for more information about profiles.
815 --minor Number
817 Sets the minor number of an LV block device.
818 --[raid]minrecoveryrate Size[k|UNIT]
820 Sets the minimum recovery rate for a RAID LV. The rate value is
821 an amount of data per second for each device in the array. Set‐
822 ting the rate to 0 means it will be unbounded. See lvmraid(7)
823 for more information.
824 --mirrorlog core|disk
826 Specifies the type of mirror log for LVs with the "mirror" type
827 (does not apply to the "raid1" type.) disk is a persistent log
828 and requires a small amount of storage space, usually on a sepa‐
829 rate device from the data being mirrored. core is not persis‐
830 tent; the log is kept only in memory. In this case, the mirror
831 must be synchronized (by copying LV data from the first device
832 to others) each time the LV is activated, e.g. after reboot.
833 mirrored is a persistent log that is itself mirrored, but should
834 be avoided. Instead, use the raid1 type for log redundancy.
835 -m|--mirrors Number
837 Specifies the number of mirror images in addition to the origi‐
838 nal LV image, e.g. --mirrors 1 means there are two images of the
839 data, the original and one mirror image. Optional positional PV
840 args on the command line can specify the devices the images
841 should be placed on. There are two mirroring implementations:
842 "raid1" and "mirror". These are the names of the corresponding
843 LV types, or "segment types". Use the --type option to specify
844 which to use (raid1 is default, and mirror is legacy) Use
845 lvm.conf global/mirror_segtype_default and global/raid10_seg‐
846 type_default to configure the default types. See the --nosync
847 option for avoiding initial image synchronization. See lvm‐
848 raid(7) for more information.
849 --monitor y|n
851 Start (yes) or stop (no) monitoring an LV with dmeventd.
852 dmeventd monitors kernel events for an LV, and performs auto‐
853 mated maintenance for the LV in reponse to specific events. See
854 dmeventd(8) for more information.
855 -n|--name String
857 Specifies the name of a new LV. When unspecified, a default
858 name of "lvol#" is generated, where # is a number generated by
859 LVM.
860 --nolocking
862 Disable locking.
863 --nosync
865 Causes the creation of mirror, raid1, raid4, raid5 and raid10 to
866 skip the initial synchronization. In case of mirror, raid1 and
867 raid10, any data written afterwards will be mirrored, but the
868 original contents will not be copied. In case of raid4 and
869 raid5, no parity blocks will be written, though any data written
870 afterwards will cause parity blocks to be stored. This is use‐
871 ful for skipping a potentially long and resource intensive ini‐
872 tial sync of an empty mirror/raid1/raid4/raid5 and raid10 LV.
873 This option is not valid for raid6, because raid6 relies on
874 proper parity (P and Q Syndromes) being created during initial
875 synchronization in order to reconstruct proper user date in case
876 of device failures. raid0 and raid0_meta do not provide any
877 data copies or parity support and thus do not support initial
878 synchronization.
879 --noudevsync
881 Disables udev synchronisation. The process will not wait for
882 notification from udev. It will continue irrespective of any
883 possible udev processing in the background. Only use this if
884 udev is not running or has rules that ignore the devices LVM
885 creates.
886 -p|--permission rw|r
888 Set access permission to read only r or read and write rw.
889 -M|--persistent y|n
891 When yes, makes the specified minor number persistent.
892 --poolmetadatasize Size[m|UNIT]
894 Specifies the size of the new pool metadata LV.
895 --poolmetadataspare y|n
897 Enable or disable the automatic creation and management of a
898 spare pool metadata LV in the VG. A spare metadata LV is
899 reserved space that can be used when repairing a pool.
900 --profile String
902 An alias for --commandprofile or --metadataprofile, depending on
903 the command.
904 -q|--quiet ...
906 Suppress output and log messages. Overrides --debug and --ver‐
907 bose. Repeat once to also suppress any prompts with answer
908 'no'.
909 -r|--readahead auto|none|Number
911 Sets read ahead sector count of an LV. auto is the default
912 which allows the kernel to choose a suitable value automati‐
913 cally. none is equivalent to zero.
914 -R|--regionsize Size[m|UNIT]
916 Size of each raid or mirror synchronization region. lvm.conf
917 activation/raid_region_size can be used to configure a default.
918 --reportformat basic|json
920 Overrides current output format for reports which is defined
921 globally by the report/output_format setting in lvm.conf. basic
922 is the original format with columns and rows. If there is more
923 than one report per command, each report is prefixed with the
924 report name for identification. json produces report output in
925 JSON format. See lvmreport(7) for more information.
926 -k|--setactivationskip y|n
928 Persistently sets (yes) or clears (no) the "activation skip"
929 flag on an LV. An LV with this flag set is not activated unless
930 the --ignoreactivationskip option is used by the activation com‐
931 mand. This flag is set by default on new thin snapshot LVs.
932 The flag is not applied to deactivation. The current value of
933 the flag is indicated in the lvs lv_attr bits.
934 -L|--size Size[m|UNIT]
936 Specifies the size of the new LV. The --size and --extents
937 options are alternate methods of specifying size. The total
938 number of physical extents used will be greater when redundant
939 data is needed for RAID levels.
940 -s|--snapshot
942 Create a snapshot. Snapshots provide a "frozen image" of an ori‐
943 gin LV. The snapshot LV can be used, e.g. for backups, while
944 the origin LV continues to be used. This option can create a
945 COW (copy on write) snapshot, or a thin snapshot (in a thin
946 pool.) Thin snapshots are created when the origin is a thin LV
947 and the size option is NOT specified. Thin snapshots share the
948 same blocks in the thin pool, and do not allocate new space from
949 the VG. Thin snapshots are created with the "activation skip"
950 flag, see --setactivationskip. A thin snapshot of a non-thin
951 "external origin" LV is created when a thin pool is specified.
952 Unprovisioned blocks in the thin snapshot LV are read from the
953 external origin LV. The external origin LV must be read-only.
954 See lvmthin(7) for more information about LVM thin provisioning.
955 COW snapshots are created when a size is specified. The size is
956 allocated from space in the VG, and is the amount of space that
957 can be used for saving COW blocks as writes occur to the origin
958 or snapshot. The size chosen should depend upon the amount of
959 writes that are expected; often 20% of the origin LV is enough.
960 If COW space runs low, it can be extended with lvextend (shrink‐
961 ing is also allowed with lvreduce.) A small amount of the COW
962 snapshot LV size is used to track COW block locations, so the
963 full size is not available for COW data blocks. Use lvs to
964 check how much space is used, and see --monitor to to automati‐
965 cally extend the size to avoid running out of space.
966 -i|--stripes Number
968 Specifies the number of stripes in a striped LV. This is the
969 number of PVs (devices) that a striped LV is spread across. Data
970 that appears sequential in the LV is spread across multiple
971 devices in units of the stripe size (see --stripesize). This
972 does not change existing allocated space, but only applies to
973 space being allocated by the command. When creating a RAID
974 4/5/6 LV, this number does not include the extra devices that
975 are required for parity. The largest number depends on the RAID
976 type (raid0: 64, raid10: 32, raid4/5: 63, raid6: 62), and when
977 unspecified, the default depends on the RAID type (raid0: 2,
978 raid10: 2, raid4/5: 3, raid6: 5.) To stripe a new raid LV
979 across all PVs by default, see lvm.conf alloca‐
980 tion/raid_stripe_all_devices.
981 -I|--stripesize Size[k|UNIT]
983 The amount of data that is written to one device before moving
984 to the next in a striped LV.
985 -t|--test
987 Run in test mode. Commands will not update metadata. This is
988 implemented by disabling all metadata writing but nevertheless
989 returning success to the calling function. This may lead to
990 unusual error messages in multi-stage operations if a tool
991 relies on reading back metadata it believes has changed but
992 hasn't.
993 -T|--thin
995 Specifies the command is handling a thin LV or thin pool. See
996 --type thin, --type thin-pool, and --virtualsize. See
997 lvmthin(7) for more information about LVM thin provisioning.
998 --thinpool LV
1000 The name of a thin pool LV.
1001 --type linear|striped|snapshot|mir‐
1003 ror|raid|thin|cache|thin-pool|cache-pool
1004 The LV type, also known as "segment type" or "segtype". See
1005 usage descriptions for the specific ways to use these types.
1006 For more information about redundancy and performance (raid<N>,
1007 mirror, striped, linear) see lvmraid(7). For thin provisioning
1008 (thin, thin-pool) see lvmthin(7). For performance caching
1009 (cache, cache-pool) see lvmcache(7). For copy-on-write snap‐
1010 shots (snapshot) see usage definitions. Several commands omit
1011 an explicit type option because the type is inferred from other
1012 options or shortcuts (e.g. --stripes, --mirrors, --snapshot,
1013 --virtualsize, --thin, --cache). Use inferred types with care
1014 because it can lead to unexpected results.
1015 --vdo
1017 Specifies the command is handling VDO LV. See --type vdo. See
1018 lvmvdo(7) for more information about VDO usage.
1019 --vdopool LV
1021 The name of a VDO pool LV. See lvmvdo(7) for more information
1022 about VDO usage.
1023 -v|--verbose ...
1025 Set verbose level. Repeat from 1 to 4 times to increase the
1026 detail of messages sent to stdout and stderr.
1027 --version
1029 Display version information.
1030 -V|--virtualsize Size[m|UNIT]
1032 The virtual size of a new thin LV. See lvmthin(7) for more
1033 information about LVM thin provisioning. Using virtual size
1034 (-V) and actual size (-L) together creates a sparse LV.
1035 lvm.conf global/sparse_segtype_default determines the default
1036 segment type used to create a sparse LV. Anything written to a
1037 sparse LV will be returned when reading from it. Reading from
1038 other areas of the LV will return blocks of zeros. When using a
1039 snapshot to create a sparse LV, a hidden virtual device is cre‐
1040 ated using the zero target, and the LV has the suffix _vorigin.
1041 Snapshots are less efficient than thin provisioning when creat‐
1042 ing large sparse LVs (GiB).
1043 -W|--wipesignatures y|n
1045 Controls detection and subsequent wiping of signatures on new
1046 LVs. There is a prompt for each signature detected to confirm
1047 its wiping (unless --yes is used to override confirmations.)
1048 When not specified, signatures are wiped whenever zeroing is
1049 done (see --zero). This behaviour can be configured with
1050 lvm.conf allocation/wipe_signatures_when_zeroing_new_lvs. If
1051 blkid wiping is used (lvm.conf allocation/use_blkid_wiping) and
1052 LVM is compiled with blkid wiping support, then the blkid(8)
1053 library is used to detect the signatures (use blkid -k to list
1054 the signatures that are recognized). Otherwise, native LVM code
1055 is used to detect signatures (only MD RAID, swap and LUKS signa‐
1056 tures are detected in this case.) The LV is not wiped if the
1057 read only flag is set.
1058 -y|--yes
1060 Do not prompt for confirmation interactively but always assume
1061 the answer yes. Use with extreme caution. (For automatic no,
1062 see -qq.)
1063 -Z|--zero y|n
1065 Controls zeroing of the first 4KiB of data in the new LV.
1066 Default is y. Snapshot COW volumes are always zeroed. For thin
1067 pools, this controls zeroing of provisioned blocks. LV is not
1068 zeroed if the read only flag is set. Warning: trying to mount
1069 an unzeroed LV can cause the system to hang.
1070
1072 VG
1073 Volume Group name. See lvm(8) for valid names. For lvcreate,
1074 the required VG positional arg may be omitted when the VG name
1075 is included in another option, e.g. --name VG/LV.
1076 LV
1078 Logical Volume name. See lvm(8) for valid names. An LV posi‐
1079 tional arg generally includes the VG name and LV name, e.g.
1080 VG/LV. LV followed by _<type> indicates that an LV of the given
1081 type is required. (raid represents raid<N> type)
1082 PV
1084 Physical Volume name, a device path under /dev. For commands
1085 managing physical extents, a PV positional arg generally accepts
1086 a suffix indicating a range (or multiple ranges) of physical
1087 extents (PEs). When the first PE is omitted, it defaults to the
1088 start of the device, and when the last PE is omitted it defaults
1089 to end. Start and end range (inclusive): PV[:PE-PE]... Start
1090 and length range (counting from 0): PV[:PE+PE]...
1091 String
1093 See the option description for information about the string con‐
1094 tent.
1095 Size[UNIT]
1097 Size is an input number that accepts an optional unit. Input
1098 units are always treated as base two values, regardless of capi‐
1099 talization, e.g. 'k' and 'K' both refer to 1024. The default
1100 input unit is specified by letter, followed by |UNIT. UNIT rep‐
1101 resents other possible input units: bBsSkKmMgGtTpPeE. b|B is
1102 bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is
1103 megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
1104 e|E is exabytes. (This should not be confused with the output
1105 control --units, where capital letters mean multiple of 1000.)
1106
1108 See lvm(8) for information about environment variables used by lvm.
1109 For example, LVM_VG_NAME can generally be substituted for a required VG
1110 parameter.
1111
1113 Alternate command forms, advanced command usage, and listing of all
1114 valid syntax for completeness.
1115 Create an LV that returns errors when used.
1117 lvcreate --type error -L|--size Size[m|UNIT] VG
1119 [ -l|--extents Number[PERCENT] ]
1120 [ -A|--autobackup y|n ]
1121 [ -a|--activate y|n|ay ]
1122 [ -C|--contiguous y|n ]
1123 [ -K|--ignoreactivationskip ]
1124 [ -j|--major Number ]
1125 [ -n|--name String ]
1126 [ -p|--permission rw|r ]
1127 [ -M|--persistent y|n ]
1128 [ -r|--readahead auto|none|Number ]
1129 [ -k|--setactivationskip y|n ]
1130 [ -W|--wipesignatures y|n ]
1131 [ -Z|--zero y|n ]
1132 [ --addtag Tag ]
1133 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1134 ]
1135 [ --ignoremonitoring ]
1136 [ --metadataprofile String ]
1137 [ --minor Number ]
1138 [ --monitor y|n ]
1139 [ --nosync ]
1140 [ --noudevsync ]
1141 [ --reportformat basic|json ]
1142 [ COMMON_OPTIONS ]
1143 -
1144 Create an VDO LV with VDO pool.
1146 lvcreate --vdo -L|--size Size[m|UNIT] VG
1148 [ -l|--extents Number[PERCENT] ]
1149 [ -A|--autobackup y|n ]
1150 [ -a|--activate y|n|ay ]
1151 [ -C|--contiguous y|n ]
1152 [ -K|--ignoreactivationskip ]
1153 [ -j|--major Number ]
1154 [ -n|--name String ]
1155 [ -p|--permission rw|r ]
1156 [ -M|--persistent y|n ]
1157 [ -r|--readahead auto|none|Number ]
1158 [ -k|--setactivationskip y|n ]
1159 [ -W|--wipesignatures y|n ]
1160 [ -Z|--zero y|n ]
1161 [ -V|--virtualsize Size[m|UNIT] ]
1162 [ -i|--stripes Number ]
1163 [ -I|--stripesize Size[k|UNIT] ]
1164 [ --addtag Tag ]
1165 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1166 ]
1167 [ --ignoremonitoring ]
1168 [ --metadataprofile String ]
1169 [ --minor Number ]
1170 [ --monitor y|n ]
1171 [ --nosync ]
1172 [ --noudevsync ]
1173 [ --reportformat basic|json ]
1174 [ --compression y|n ]
1175 [ --deduplication y|n ]
1176 [ COMMON_OPTIONS ]
1177 [ PV ... ]
1178 -
1179 Create an VDO LV using existing VDO pool.
1181 lvcreate --vdopool LV -V|--virtualsize Size[m|UNIT] VG
1183 [ --vdo ]
1184 [ --type vdo ]
1185 [ COMMON_OPTIONS ]
1186 [ PV ... ]
1187 -
1188 Create an LV that returns zeros when read.
1190 lvcreate --type zero -L|--size Size[m|UNIT] VG
1192 [ -l|--extents Number[PERCENT] ]
1193 [ -A|--autobackup y|n ]
1194 [ -a|--activate y|n|ay ]
1195 [ -C|--contiguous y|n ]
1196 [ -K|--ignoreactivationskip ]
1197 [ -j|--major Number ]
1198 [ -n|--name String ]
1199 [ -p|--permission rw|r ]
1200 [ -M|--persistent y|n ]
1201 [ -r|--readahead auto|none|Number ]
1202 [ -k|--setactivationskip y|n ]
1203 [ -W|--wipesignatures y|n ]
1204 [ -Z|--zero y|n ]
1205 [ --addtag Tag ]
1206 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1207 ]
1208 [ --ignoremonitoring ]
1209 [ --metadataprofile String ]
1210 [ --minor Number ]
1211 [ --monitor y|n ]
1212 [ --nosync ]
1213 [ --noudevsync ]
1214 [ --reportformat basic|json ]
1215 [ COMMON_OPTIONS ]
1216 -
1217 Create a linear LV.
1219 lvcreate --type linear -L|--size Size[m|UNIT] VG
1221 [ -l|--extents Number[PERCENT] ]
1222 [ -A|--autobackup y|n ]
1223 [ -a|--activate y|n|ay ]
1224 [ -C|--contiguous y|n ]
1225 [ -K|--ignoreactivationskip ]
1226 [ -j|--major Number ]
1227 [ -n|--name String ]
1228 [ -p|--permission rw|r ]
1229 [ -M|--persistent y|n ]
1230 [ -r|--readahead auto|none|Number ]
1231 [ -k|--setactivationskip y|n ]
1232 [ -W|--wipesignatures y|n ]
1233 [ -Z|--zero y|n ]
1234 [ --addtag Tag ]
1235 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1236 ]
1237 [ --ignoremonitoring ]
1238 [ --metadataprofile String ]
1239 [ --minor Number ]
1240 [ --monitor y|n ]
1241 [ --nosync ]
1242 [ --noudevsync ]
1243 [ --reportformat basic|json ]
1244 [ COMMON_OPTIONS ]
1245 [ PV ... ]
1246 -
1247 Create a striped LV (also see lvcreate --stripes).
1249 lvcreate --type striped -L|--size Size[m|UNIT] VG
1251 [ -l|--extents Number[PERCENT] ]
1252 [ -i|--stripes Number ]
1253 [ -I|--stripesize Size[k|UNIT] ]
1254 [ -A|--autobackup y|n ]
1255 [ -a|--activate y|n|ay ]
1256 [ -C|--contiguous y|n ]
1257 [ -K|--ignoreactivationskip ]
1258 [ -j|--major Number ]
1259 [ -n|--name String ]
1260 [ -p|--permission rw|r ]
1261 [ -M|--persistent y|n ]
1262 [ -r|--readahead auto|none|Number ]
1263 [ -k|--setactivationskip y|n ]
1264 [ -W|--wipesignatures y|n ]
1265 [ -Z|--zero y|n ]
1266 [ --addtag Tag ]
1267 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1268 ]
1269 [ --ignoremonitoring ]
1270 [ --metadataprofile String ]
1271 [ --minor Number ]
1272 [ --monitor y|n ]
1273 [ --nosync ]
1274 [ --noudevsync ]
1275 [ --reportformat basic|json ]
1276 [ COMMON_OPTIONS ]
1277 [ PV ... ]
1278 -
1279 Create a mirror LV (also see --type raid1).
1281 lvcreate --type mirror -L|--size Size[m|UNIT] VG
1283 [ -l|--extents Number[PERCENT] ]
1284 [ -m|--mirrors Number ]
1285 [ -R|--regionsize Size[m|UNIT] ]
1286 [ -i|--stripes Number ]
1287 [ -I|--stripesize Size[k|UNIT] ]
1288 [ -A|--autobackup y|n ]
1289 [ -a|--activate y|n|ay ]
1290 [ -C|--contiguous y|n ]
1291 [ -K|--ignoreactivationskip ]
1292 [ -j|--major Number ]
1293 [ -n|--name String ]
1294 [ -p|--permission rw|r ]
1295 [ -M|--persistent y|n ]
1296 [ -r|--readahead auto|none|Number ]
1297 [ -k|--setactivationskip y|n ]
1298 [ -W|--wipesignatures y|n ]
1299 [ -Z|--zero y|n ]
1300 [ --mirrorlog core|disk ]
1301 [ --addtag Tag ]
1302 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1303 ]
1304 [ --ignoremonitoring ]
1305 [ --metadataprofile String ]
1306 [ --minor Number ]
1307 [ --monitor y|n ]
1308 [ --nosync ]
1309 [ --noudevsync ]
1310 [ --reportformat basic|json ]
1311 [ COMMON_OPTIONS ]
1312 [ PV ... ]
1313 -
1314 Create a COW snapshot LV of an origin LV
1316 (also see --snapshot).
1317 lvcreate --type snapshot -L|--size Size[m|UNIT] LV
1319 [ -l|--extents Number[PERCENT] ]
1320 [ -s|--snapshot ]
1321 [ -i|--stripes Number ]
1322 [ -I|--stripesize Size[k|UNIT] ]
1323 [ -c|--chunksize Size[k|UNIT] ]
1324 [ -A|--autobackup y|n ]
1325 [ -a|--activate y|n|ay ]
1326 [ -C|--contiguous y|n ]
1327 [ -K|--ignoreactivationskip ]
1328 [ -j|--major Number ]
1329 [ -n|--name String ]
1330 [ -p|--permission rw|r ]
1331 [ -M|--persistent y|n ]
1332 [ -r|--readahead auto|none|Number ]
1333 [ -k|--setactivationskip y|n ]
1334 [ -W|--wipesignatures y|n ]
1335 [ -Z|--zero y|n ]
1336 [ --addtag Tag ]
1337 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1338 ]
1339 [ --ignoremonitoring ]
1340 [ --metadataprofile String ]
1341 [ --minor Number ]
1342 [ --monitor y|n ]
1343 [ --nosync ]
1344 [ --noudevsync ]
1345 [ --reportformat basic|json ]
1346 [ COMMON_OPTIONS ]
1347 [ PV ... ]
1348 -
1349 Create a sparse COW snapshot LV of a virtual origin LV
1351 (also see --snapshot).
1352 lvcreate --type snapshot -L|--size Size[m|UNIT]
1354 -V|--virtualsize Size[m|UNIT] VG
1355 [ -l|--extents Number[PERCENT] ]
1356 [ -s|--snapshot ]
1357 [ -c|--chunksize Size[k|UNIT] ]
1358 [ -A|--autobackup y|n ]
1359 [ -a|--activate y|n|ay ]
1360 [ -C|--contiguous y|n ]
1361 [ -K|--ignoreactivationskip ]
1362 [ -j|--major Number ]
1363 [ -n|--name String ]
1364 [ -p|--permission rw|r ]
1365 [ -M|--persistent y|n ]
1366 [ -r|--readahead auto|none|Number ]
1367 [ -k|--setactivationskip y|n ]
1368 [ -W|--wipesignatures y|n ]
1369 [ -Z|--zero y|n ]
1370 [ --addtag Tag ]
1371 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1372 ]
1373 [ --ignoremonitoring ]
1374 [ --metadataprofile String ]
1375 [ --minor Number ]
1376 [ --monitor y|n ]
1377 [ --nosync ]
1378 [ --noudevsync ]
1379 [ --reportformat basic|json ]
1380 [ COMMON_OPTIONS ]
1381 [ PV ... ]
1382 -
1383 Create a sparse COW snapshot LV of a virtual origin LV.
1385 lvcreate -s|--snapshot -L|--size Size[m|UNIT]
1387 -V|--virtualsize Size[m|UNIT] VG
1388 [ -l|--extents Number[PERCENT] ]
1389 [ -c|--chunksize Size[k|UNIT] ]
1390 [ -A|--autobackup y|n ]
1391 [ -a|--activate y|n|ay ]
1392 [ -C|--contiguous y|n ]
1393 [ -K|--ignoreactivationskip ]
1394 [ -j|--major Number ]
1395 [ -n|--name String ]
1396 [ -p|--permission rw|r ]
1397 [ -M|--persistent y|n ]
1398 [ -r|--readahead auto|none|Number ]
1399 [ -k|--setactivationskip y|n ]
1400 [ -W|--wipesignatures y|n ]
1401 [ -Z|--zero y|n ]
1402 [ --type snapshot ]
1403 [ --addtag Tag ]
1404 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1405 ]
1406 [ --ignoremonitoring ]
1407 [ --metadataprofile String ]
1408 [ --minor Number ]
1409 [ --monitor y|n ]
1410 [ --nosync ]
1411 [ --noudevsync ]
1412 [ --reportformat basic|json ]
1413 [ COMMON_OPTIONS ]
1414 [ PV ... ]
1415 -
1416 Create a thin pool (infers --type thin-pool).
1418 lvcreate -T|--thin -L|--size Size[m|UNIT] VG
1420 [ -l|--extents Number[PERCENT] ]
1421 [ -c|--chunksize Size[k|UNIT] ]
1422 [ -A|--autobackup y|n ]
1423 [ -a|--activate y|n|ay ]
1424 [ -C|--contiguous y|n ]
1425 [ -K|--ignoreactivationskip ]
1426 [ -j|--major Number ]
1427 [ -n|--name String ]
1428 [ -p|--permission rw|r ]
1429 [ -M|--persistent y|n ]
1430 [ -r|--readahead auto|none|Number ]
1431 [ -k|--setactivationskip y|n ]
1432 [ -W|--wipesignatures y|n ]
1433 [ -Z|--zero y|n ]
1434 [ -i|--stripes Number ]
1435 [ -I|--stripesize Size[k|UNIT] ]
1436 [ --type thin-pool ]
1437 [ --poolmetadatasize Size[m|UNIT] ]
1438 [ --poolmetadataspare y|n ]
1439 [ --discards passdown|nopassdown|ignore ]
1440 [ --errorwhenfull y|n ]
1441 [ --addtag Tag ]
1442 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1443 ]
1444 [ --ignoremonitoring ]
1445 [ --metadataprofile String ]
1446 [ --minor Number ]
1447 [ --monitor y|n ]
1448 [ --nosync ]
1449 [ --noudevsync ]
1450 [ --reportformat basic|json ]
1451 [ COMMON_OPTIONS ]
1452 [ PV ... ]
1453 -
1454 Create a thin pool named by the --thinpool arg
1456 (infers --type thin-pool).
1457 lvcreate -L|--size Size[m|UNIT] --thinpool LV_new VG
1459 [ -l|--extents Number[PERCENT] ]
1460 [ -T|--thin ]
1461 [ -c|--chunksize Size[k|UNIT] ]
1462 [ -A|--autobackup y|n ]
1463 [ -a|--activate y|n|ay ]
1464 [ -C|--contiguous y|n ]
1465 [ -K|--ignoreactivationskip ]
1466 [ -j|--major Number ]
1467 [ -n|--name String ]
1468 [ -p|--permission rw|r ]
1469 [ -M|--persistent y|n ]
1470 [ -r|--readahead auto|none|Number ]
1471 [ -k|--setactivationskip y|n ]
1472 [ -W|--wipesignatures y|n ]
1473 [ -Z|--zero y|n ]
1474 [ -i|--stripes Number ]
1475 [ -I|--stripesize Size[k|UNIT] ]
1476 [ --type thin-pool ]
1477 [ --poolmetadatasize Size[m|UNIT] ]
1478 [ --poolmetadataspare y|n ]
1479 [ --discards passdown|nopassdown|ignore ]
1480 [ --errorwhenfull y|n ]
1481 [ --addtag Tag ]
1482 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1483 ]
1484 [ --ignoremonitoring ]
1485 [ --metadataprofile String ]
1486 [ --minor Number ]
1487 [ --monitor y|n ]
1488 [ --nosync ]
1489 [ --noudevsync ]
1490 [ --reportformat basic|json ]
1491 [ COMMON_OPTIONS ]
1492 [ PV ... ]
1493 -
1494 Create a cache pool named by the --cachepool arg
1496 (variant, uses --cachepool in place of --name).
1497 lvcreate --type cache-pool -L|--size Size[m|UNIT]
1499 --cachepool LV_new VG
1500 [ -l|--extents Number[PERCENT] ]
1501 [ -H|--cache ]
1502 [ -c|--chunksize Size[k|UNIT] ]
1503 [ -A|--autobackup y|n ]
1504 [ -a|--activate y|n|ay ]
1505 [ -C|--contiguous y|n ]
1506 [ -K|--ignoreactivationskip ]
1507 [ -j|--major Number ]
1508 [ -n|--name String ]
1509 [ -p|--permission rw|r ]
1510 [ -M|--persistent y|n ]
1511 [ -r|--readahead auto|none|Number ]
1512 [ -k|--setactivationskip y|n ]
1513 [ -W|--wipesignatures y|n ]
1514 [ -Z|--zero y|n ]
1515 [ --poolmetadatasize Size[m|UNIT] ]
1516 [ --poolmetadataspare y|n ]
1517 [ --cachemode writethrough|writeback|passthrough ]
1518 [ --cachepolicy String ]
1519 [ --cachesettings String ]
1520 [ --cachemetadataformat auto|1|2 ]
1521 [ --addtag Tag ]
1522 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1523 ]
1524 [ --ignoremonitoring ]
1525 [ --metadataprofile String ]
1526 [ --minor Number ]
1527 [ --monitor y|n ]
1528 [ --nosync ]
1529 [ --noudevsync ]
1530 [ --reportformat basic|json ]
1531 [ COMMON_OPTIONS ]
1532 [ PV ... ]
1533 -
1534 Create a thin LV in a thin pool.
1536 lvcreate --type thin -V|--virtualsize Size[m|UNIT]
1538 --thinpool LV_thinpool VG
1539 [ -T|--thin ]
1540 [ -c|--chunksize Size[k|UNIT] ]
1541 [ -A|--autobackup y|n ]
1542 [ -a|--activate y|n|ay ]
1543 [ -C|--contiguous y|n ]
1544 [ -K|--ignoreactivationskip ]
1545 [ -j|--major Number ]
1546 [ -n|--name String ]
1547 [ -p|--permission rw|r ]
1548 [ -M|--persistent y|n ]
1549 [ -r|--readahead auto|none|Number ]
1550 [ -k|--setactivationskip y|n ]
1551 [ -W|--wipesignatures y|n ]
1552 [ -Z|--zero y|n ]
1553 [ --poolmetadatasize Size[m|UNIT] ]
1554 [ --poolmetadataspare y|n ]
1555 [ --discards passdown|nopassdown|ignore ]
1556 [ --errorwhenfull y|n ]
1557 [ --addtag Tag ]
1558 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1559 ]
1560 [ --ignoremonitoring ]
1561 [ --metadataprofile String ]
1562 [ --minor Number ]
1563 [ --monitor y|n ]
1564 [ --nosync ]
1565 [ --noudevsync ]
1566 [ --reportformat basic|json ]
1567 [ COMMON_OPTIONS ]
1568 -
1569 Create a thin LV in a thin pool named in the first arg
1571 (variant, also see --thinpool for naming pool).
1572 lvcreate --type thin -V|--virtualsize Size[m|UNIT] LV_thinpool
1574 [ -T|--thin ]
1575 [ -A|--autobackup y|n ]
1576 [ -a|--activate y|n|ay ]
1577 [ -C|--contiguous y|n ]
1578 [ -K|--ignoreactivationskip ]
1579 [ -j|--major Number ]
1580 [ -n|--name String ]
1581 [ -p|--permission rw|r ]
1582 [ -M|--persistent y|n ]
1583 [ -r|--readahead auto|none|Number ]
1584 [ -k|--setactivationskip y|n ]
1585 [ -W|--wipesignatures y|n ]
1586 [ -Z|--zero y|n ]
1587 [ --discards passdown|nopassdown|ignore ]
1588 [ --errorwhenfull y|n ]
1589 [ --addtag Tag ]
1590 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1591 ]
1592 [ --ignoremonitoring ]
1593 [ --metadataprofile String ]
1594 [ --minor Number ]
1595 [ --monitor y|n ]
1596 [ --nosync ]
1597 [ --noudevsync ]
1598 [ --reportformat basic|json ]
1599 [ COMMON_OPTIONS ]
1600 -
1601 Create a thin LV in the thin pool named in the first arg
1603 (variant, infers --type thin, also see --thinpool for
1604 naming pool.)
1605 lvcreate -V|--virtualsize Size[m|UNIT] LV_thinpool
1607 [ -T|--thin ]
1608 [ -A|--autobackup y|n ]
1609 [ -a|--activate y|n|ay ]
1610 [ -C|--contiguous y|n ]
1611 [ -K|--ignoreactivationskip ]
1612 [ -j|--major Number ]
1613 [ -n|--name String ]
1614 [ -p|--permission rw|r ]
1615 [ -M|--persistent y|n ]
1616 [ -r|--readahead auto|none|Number ]
1617 [ -k|--setactivationskip y|n ]
1618 [ -W|--wipesignatures y|n ]
1619 [ -Z|--zero y|n ]
1620 [ --type thin ]
1621 [ --discards passdown|nopassdown|ignore ]
1622 [ --errorwhenfull y|n ]
1623 [ --addtag Tag ]
1624 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1625 ]
1626 [ --ignoremonitoring ]
1627 [ --metadataprofile String ]
1628 [ --minor Number ]
1629 [ --monitor y|n ]
1630 [ --nosync ]
1631 [ --noudevsync ]
1632 [ --reportformat basic|json ]
1633 [ COMMON_OPTIONS ]
1634 -
1635 Create a thin LV that is a snapshot of an existing thin LV.
1637 lvcreate --type thin LV_thin
1639 [ -T|--thin ]
1640 [ -A|--autobackup y|n ]
1641 [ -a|--activate y|n|ay ]
1642 [ -C|--contiguous y|n ]
1643 [ -K|--ignoreactivationskip ]
1644 [ -j|--major Number ]
1645 [ -n|--name String ]
1646 [ -p|--permission rw|r ]
1647 [ -M|--persistent y|n ]
1648 [ -r|--readahead auto|none|Number ]
1649 [ -k|--setactivationskip y|n ]
1650 [ -W|--wipesignatures y|n ]
1651 [ -Z|--zero y|n ]
1652 [ --discards passdown|nopassdown|ignore ]
1653 [ --errorwhenfull y|n ]
1654 [ --addtag Tag ]
1655 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1656 ]
1657 [ --ignoremonitoring ]
1658 [ --metadataprofile String ]
1659 [ --minor Number ]
1660 [ --monitor y|n ]
1661 [ --nosync ]
1662 [ --noudevsync ]
1663 [ --reportformat basic|json ]
1664 [ COMMON_OPTIONS ]
1665 -
1666 Create a thin LV that is a snapshot of an existing thin LV
1668 (infers --type thin).
1669 lvcreate -T|--thin LV_thin
1671 [ -A|--autobackup y|n ]
1672 [ -a|--activate y|n|ay ]
1673 [ -C|--contiguous y|n ]
1674 [ -K|--ignoreactivationskip ]
1675 [ -j|--major Number ]
1676 [ -n|--name String ]
1677 [ -p|--permission rw|r ]
1678 [ -M|--persistent y|n ]
1679 [ -r|--readahead auto|none|Number ]
1680 [ -k|--setactivationskip y|n ]
1681 [ -W|--wipesignatures y|n ]
1682 [ -Z|--zero y|n ]
1683 [ --type thin ]
1684 [ --discards passdown|nopassdown|ignore ]
1685 [ --errorwhenfull y|n ]
1686 [ --addtag Tag ]
1687 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1688 ]
1689 [ --ignoremonitoring ]
1690 [ --metadataprofile String ]
1691 [ --minor Number ]
1692 [ --monitor y|n ]
1693 [ --nosync ]
1694 [ --noudevsync ]
1695 [ --reportformat basic|json ]
1696 [ COMMON_OPTIONS ]
1697 -
1698 Create a thin LV that is a snapshot of an external origin LV
1700 (infers --type thin).
1701 lvcreate -s|--snapshot --thinpool LV_thinpool LV
1703 [ -A|--autobackup y|n ]
1704 [ -a|--activate y|n|ay ]
1705 [ -C|--contiguous y|n ]
1706 [ -K|--ignoreactivationskip ]
1707 [ -j|--major Number ]
1708 [ -n|--name String ]
1709 [ -p|--permission rw|r ]
1710 [ -M|--persistent y|n ]
1711 [ -r|--readahead auto|none|Number ]
1712 [ -k|--setactivationskip y|n ]
1713 [ -W|--wipesignatures y|n ]
1714 [ -Z|--zero y|n ]
1715 [ --type thin ]
1716 [ --discards passdown|nopassdown|ignore ]
1717 [ --errorwhenfull y|n ]
1718 [ --addtag Tag ]
1719 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1720 ]
1721 [ --ignoremonitoring ]
1722 [ --metadataprofile String ]
1723 [ --minor Number ]
1724 [ --monitor y|n ]
1725 [ --nosync ]
1726 [ --noudevsync ]
1727 [ --reportformat basic|json ]
1728 [ COMMON_OPTIONS ]
1729 -
1730 Create a thin LV, first creating a thin pool for it,
1732 where the new thin pool is named by the --thinpool arg
1733 (variant, infers --type thin).
1734 lvcreate -V|--virtualsize Size[m|UNIT] -L|--size Size[m|UNIT]
1736 --thinpool LV_new
1737 [ -l|--extents Number[PERCENT] ]
1738 [ -T|--thin ]
1739 [ -c|--chunksize Size[k|UNIT] ]
1740 [ -A|--autobackup y|n ]
1741 [ -a|--activate y|n|ay ]
1742 [ -C|--contiguous y|n ]
1743 [ -K|--ignoreactivationskip ]
1744 [ -j|--major Number ]
1745 [ -n|--name String ]
1746 [ -p|--permission rw|r ]
1747 [ -M|--persistent y|n ]
1748 [ -r|--readahead auto|none|Number ]
1749 [ -k|--setactivationskip y|n ]
1750 [ -W|--wipesignatures y|n ]
1751 [ -Z|--zero y|n ]
1752 [ -i|--stripes Number ]
1753 [ -I|--stripesize Size[k|UNIT] ]
1754 [ --poolmetadatasize Size[m|UNIT] ]
1755 [ --poolmetadataspare y|n ]
1756 [ --discards passdown|nopassdown|ignore ]
1757 [ --errorwhenfull y|n ]
1758 [ --addtag Tag ]
1759 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1760 ]
1761 [ --ignoremonitoring ]
1762 [ --metadataprofile String ]
1763 [ --minor Number ]
1764 [ --monitor y|n ]
1765 [ --nosync ]
1766 [ --noudevsync ]
1767 [ --reportformat basic|json ]
1768 [ COMMON_OPTIONS ]
1769 [ PV ... ]
1770 -
1771 Create a thin LV, first creating a thin pool for it,
1773 where the new thin pool is named by the --thinpool arg
1774 (variant, infers --type thin).
1775 lvcreate -V|--virtualsize Size[m|UNIT] -L|--size Size[m|UNIT]
1777 --thinpool LV_new VG
1778 [ -l|--extents Number[PERCENT] ]
1779 [ -T|--thin ]
1780 [ -c|--chunksize Size[k|UNIT] ]
1781 [ -A|--autobackup y|n ]
1782 [ -a|--activate y|n|ay ]
1783 [ -C|--contiguous y|n ]
1784 [ -K|--ignoreactivationskip ]
1785 [ -j|--major Number ]
1786 [ -n|--name String ]
1787 [ -p|--permission rw|r ]
1788 [ -M|--persistent y|n ]
1789 [ -r|--readahead auto|none|Number ]
1790 [ -k|--setactivationskip y|n ]
1791 [ -W|--wipesignatures y|n ]
1792 [ -Z|--zero y|n ]
1793 [ -i|--stripes Number ]
1794 [ -I|--stripesize Size[k|UNIT] ]
1795 [ --poolmetadatasize Size[m|UNIT] ]
1796 [ --poolmetadataspare y|n ]
1797 [ --discards passdown|nopassdown|ignore ]
1798 [ --errorwhenfull y|n ]
1799 [ --addtag Tag ]
1800 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1801 ]
1802 [ --ignoremonitoring ]
1803 [ --metadataprofile String ]
1804 [ --minor Number ]
1805 [ --monitor y|n ]
1806 [ --nosync ]
1807 [ --noudevsync ]
1808 [ --reportformat basic|json ]
1809 [ COMMON_OPTIONS ]
1810 [ PV ... ]
1811 -
1812 Create a thin LV, first creating a thin pool for it,
1814 where the new thin pool is named in the first arg,
1815 or the new thin pool name is generated when the first
1816 arg is a VG name.
1817 lvcreate --type thin -V|--virtualsize Size[m|UNIT]
1819 -L|--size Size[m|UNIT] VG|LV_new
1820 [ -l|--extents Number[PERCENT] ]
1821 [ -T|--thin ]
1822 [ -c|--chunksize Size[k|UNIT] ]
1823 [ -A|--autobackup y|n ]
1824 [ -a|--activate y|n|ay ]
1825 [ -C|--contiguous y|n ]
1826 [ -K|--ignoreactivationskip ]
1827 [ -j|--major Number ]
1828 [ -n|--name String ]
1829 [ -p|--permission rw|r ]
1830 [ -M|--persistent y|n ]
1831 [ -r|--readahead auto|none|Number ]
1832 [ -k|--setactivationskip y|n ]
1833 [ -W|--wipesignatures y|n ]
1834 [ -Z|--zero y|n ]
1835 [ -i|--stripes Number ]
1836 [ -I|--stripesize Size[k|UNIT] ]
1837 [ --poolmetadatasize Size[m|UNIT] ]
1838 [ --poolmetadataspare y|n ]
1839 [ --discards passdown|nopassdown|ignore ]
1840 [ --errorwhenfull y|n ]
1841 [ --addtag Tag ]
1842 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1843 ]
1844 [ --ignoremonitoring ]
1845 [ --metadataprofile String ]
1846 [ --minor Number ]
1847 [ --monitor y|n ]
1848 [ --nosync ]
1849 [ --noudevsync ]
1850 [ --reportformat basic|json ]
1851 [ COMMON_OPTIONS ]
1852 [ PV ... ]
1853 -
1854 Create a thin LV, first creating a thin pool for it,
1856 where the new thin pool is named in the first arg,
1857 or the new thin pool name is generated when the first
1858 arg is a VG name (variant, infers --type thin).
1859 lvcreate -T|--thin -V|--virtualsize Size[m|UNIT]
1861 -L|--size Size[m|UNIT] VG|LV_new
1862 [ -l|--extents Number[PERCENT] ]
1863 [ -c|--chunksize Size[k|UNIT] ]
1864 [ -A|--autobackup y|n ]
1865 [ -a|--activate y|n|ay ]
1866 [ -C|--contiguous y|n ]
1867 [ -K|--ignoreactivationskip ]
1868 [ -j|--major Number ]
1869 [ -n|--name String ]
1870 [ -p|--permission rw|r ]
1871 [ -M|--persistent y|n ]
1872 [ -r|--readahead auto|none|Number ]
1873 [ -k|--setactivationskip y|n ]
1874 [ -W|--wipesignatures y|n ]
1875 [ -Z|--zero y|n ]
1876 [ -i|--stripes Number ]
1877 [ -I|--stripesize Size[k|UNIT] ]
1878 [ --poolmetadatasize Size[m|UNIT] ]
1879 [ --poolmetadataspare y|n ]
1880 [ --discards passdown|nopassdown|ignore ]
1881 [ --errorwhenfull y|n ]
1882 [ --addtag Tag ]
1883 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1884 ]
1885 [ --ignoremonitoring ]
1886 [ --metadataprofile String ]
1887 [ --minor Number ]
1888 [ --monitor y|n ]
1889 [ --nosync ]
1890 [ --noudevsync ]
1891 [ --reportformat basic|json ]
1892 [ COMMON_OPTIONS ]
1893 [ PV ... ]
1894 -
1895 Create a thin LV, first creating a thin pool for it
1897 (infers --type thin).
1898 Create a sparse snapshot of a virtual origin LV
1899 (infers --type snapshot).
1900 Chooses --type thin or --type snapshot according to
1901 config setting sparse_segtype_default.
1902 lvcreate -L|--size Size[m|UNIT] -V|--virtualsize Size[m|UNIT] VG
1904 [ -l|--extents Number[PERCENT] ]
1905 [ -s|--snapshot ]
1906 [ -c|--chunksize Size[k|UNIT] ]
1907 [ -A|--autobackup y|n ]
1908 [ -a|--activate y|n|ay ]
1909 [ -C|--contiguous y|n ]
1910 [ -K|--ignoreactivationskip ]
1911 [ -j|--major Number ]
1912 [ -n|--name String ]
1913 [ -p|--permission rw|r ]
1914 [ -M|--persistent y|n ]
1915 [ -r|--readahead auto|none|Number ]
1916 [ -k|--setactivationskip y|n ]
1917 [ -W|--wipesignatures y|n ]
1918 [ -Z|--zero y|n ]
1919 [ -i|--stripes Number ]
1920 [ -I|--stripesize Size[k|UNIT] ]
1921 [ --type snapshot ]
1922 [ --poolmetadatasize Size[m|UNIT] ]
1923 [ --poolmetadataspare y|n ]
1924 [ --discards passdown|nopassdown|ignore ]
1925 [ --errorwhenfull y|n ]
1926 [ --addtag Tag ]
1927 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1928 ]
1929 [ --ignoremonitoring ]
1930 [ --metadataprofile String ]
1931 [ --minor Number ]
1932 [ --monitor y|n ]
1933 [ --nosync ]
1934 [ --noudevsync ]
1935 [ --reportformat basic|json ]
1936 [ COMMON_OPTIONS ]
1937 [ PV ... ]
1938 -
1939 Create a cache LV, first creating a new origin LV,
1941 then combining it with the existing cache pool named
1942 by the --cachepool arg (variant, infers --type cache).
1943 lvcreate -L|--size Size[m|UNIT] --cachepool LV_cachepool VG
1945 [ -l|--extents Number[PERCENT] ]
1946 [ -H|--cache ]
1947 [ -c|--chunksize Size[k|UNIT] ]
1948 [ -A|--autobackup y|n ]
1949 [ -a|--activate y|n|ay ]
1950 [ -C|--contiguous y|n ]
1951 [ -K|--ignoreactivationskip ]
1952 [ -j|--major Number ]
1953 [ -n|--name String ]
1954 [ -p|--permission rw|r ]
1955 [ -M|--persistent y|n ]
1956 [ -r|--readahead auto|none|Number ]
1957 [ -k|--setactivationskip y|n ]
1958 [ -W|--wipesignatures y|n ]
1959 [ -Z|--zero y|n ]
1960 [ -i|--stripes Number ]
1961 [ -I|--stripesize Size[k|UNIT] ]
1962 [ --type cache ]
1963 [ --cachemode writethrough|writeback|passthrough ]
1964 [ --cachepolicy String ]
1965 [ --cachesettings String ]
1966 [ --cachemetadataformat auto|1|2 ]
1967 [ --addtag Tag ]
1968 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
1969 ]
1970 [ --ignoremonitoring ]
1971 [ --metadataprofile String ]
1972 [ --minor Number ]
1973 [ --monitor y|n ]
1974 [ --nosync ]
1975 [ --noudevsync ]
1976 [ --reportformat basic|json ]
1977 [ COMMON_OPTIONS ]
1978 [ PV ... ]
1979 -
1980 Create a cache LV, first creating a new origin LV,
1982 then combining it with the existing cache pool named
1983 in the first arg (variant, also use --cachepool).
1984 lvcreate --type cache -L|--size Size[m|UNIT] LV_cachepool
1986 [ -l|--extents Number[PERCENT] ]
1987 [ -H|--cache ]
1988 [ -c|--chunksize Size[k|UNIT] ]
1989 [ -A|--autobackup y|n ]
1990 [ -a|--activate y|n|ay ]
1991 [ -C|--contiguous y|n ]
1992 [ -K|--ignoreactivationskip ]
1993 [ -j|--major Number ]
1994 [ -n|--name String ]
1995 [ -p|--permission rw|r ]
1996 [ -M|--persistent y|n ]
1997 [ -r|--readahead auto|none|Number ]
1998 [ -k|--setactivationskip y|n ]
1999 [ -W|--wipesignatures y|n ]
2000 [ -Z|--zero y|n ]
2001 [ -i|--stripes Number ]
2002 [ -I|--stripesize Size[k|UNIT] ]
2003 [ --poolmetadatasize Size[m|UNIT] ]
2004 [ --poolmetadataspare y|n ]
2005 [ --cachemode writethrough|writeback|passthrough ]
2006 [ --cachepolicy String ]
2007 [ --cachesettings String ]
2008 [ --cachemetadataformat auto|1|2 ]
2009 [ --addtag Tag ]
2010 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
2011 ]
2012 [ --ignoremonitoring ]
2013 [ --metadataprofile String ]
2014 [ --minor Number ]
2015 [ --monitor y|n ]
2016 [ --nosync ]
2017 [ --noudevsync ]
2018 [ --reportformat basic|json ]
2019 [ COMMON_OPTIONS ]
2020 [ PV ... ]
2021 -
2022 When LV is a cache pool, create a cache LV,
2024 first creating a new origin LV, then combining it with
2025 the existing cache pool named in the first arg
2026 (variant, infers --type cache, also use --cachepool).
2027 When LV is not a cache pool, convert the specified LV
2028 to type cache after creating a new cache pool LV to use
2029 (use lvconvert).
2030 lvcreate -H|--cache -L|--size Size[m|UNIT] LV
2032 [ -l|--extents Number[PERCENT] ]
2033 [ -c|--chunksize Size[k|UNIT] ]
2034 [ -A|--autobackup y|n ]
2035 [ -a|--activate y|n|ay ]
2036 [ -C|--contiguous y|n ]
2037 [ -K|--ignoreactivationskip ]
2038 [ -j|--major Number ]
2039 [ -n|--name String ]
2040 [ -p|--permission rw|r ]
2041 [ -M|--persistent y|n ]
2042 [ -r|--readahead auto|none|Number ]
2043 [ -k|--setactivationskip y|n ]
2044 [ -W|--wipesignatures y|n ]
2045 [ -Z|--zero y|n ]
2046 [ -i|--stripes Number ]
2047 [ -I|--stripesize Size[k|UNIT] ]
2048 [ --cachemode writethrough|writeback|passthrough ]
2049 [ --cachepolicy String ]
2050 [ --cachesettings String ]
2051 [ --cachemetadataformat auto|1|2 ]
2052 [ --poolmetadatasize Size[m|UNIT] ]
2053 [ --poolmetadataspare y|n ]
2054 [ --addtag Tag ]
2055 [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
2056 ]
2057 [ --ignoremonitoring ]
2058 [ --metadataprofile String ]
2059 [ --minor Number ]
2060 [ --monitor y|n ]
2061 [ --nosync ]
2062 [ --noudevsync ]
2063 [ --reportformat basic|json ]
2064 [ COMMON_OPTIONS ]
2065 [ PV ... ]
2066 -
2067
2070 Create a striped LV with 3 stripes, a stripe size of 8KiB and a size of
2071 100MiB. The LV name is chosen by lvcreate.
2072 lvcreate -i 3 -I 8 -L 100m vg00
2073 Create a raid1 LV with two images, and a useable size of 500 MiB. This
2075 operation requires two devices, one for each mirror image. RAID meta‐
2076 data (superblock and bitmap) is also included on the two devices.
2077 lvcreate --type raid1 -m1 -L 500m -n mylv vg00
2078 Create a mirror LV with two images, and a useable size of 500 MiB.
2080 This operation requires three devices: two for mirror images and one
2081 for a disk log.
2082 lvcreate --type mirror -m1 -L 500m -n mylv vg00
2083 Create a mirror LV with 2 images, and a useable size of 500 MiB. This
2085 operation requires 2 devices because the log is in memory.
2086 lvcreate --type mirror -m1 --mirrorlog core -L 500m -n mylv vg00
2087 Create a copy-on-write snapshot of an LV:
2089 lvcreate --snapshot --size 100m --name mysnap vg00/mylv
2090 Create a copy-on-write snapshot with a size sufficient for overwriting
2092 20% of the size of the original LV.
2093 lvcreate -s -l 20%ORIGIN -n mysnap vg00/mylv
2094 Create a sparse LV with 1TiB of virtual space, and actual space just
2096 under 100MiB.
2097 lvcreate --snapshot --virtualsize 1t --size 100m --name mylv vg00
2098 Create a linear LV with a usable size of 64MiB on specific physical
2100 extents.
2101 lvcreate -L 64m -n mylv vg00 /dev/sda:0-7 /dev/sdb:0-7
2102 Create a RAID5 LV with a usable size of 5GiB, 3 stripes, a stripe size
2104 of 64KiB, using a total of 4 devices (including one for parity).
2105 lvcreate --type raid5 -L 5G -i 3 -I 64 -n mylv vg00
2106 Create a RAID5 LV using all of the free space in the VG and spanning
2108 all the PVs in the VG (note that the command will fail if there are
2109 more than 8 PVs in the VG, in which case -i 7 must be used to get to
2110 the current maximum of 8 devices including parity for RaidLVs).
2111 lvcreate --config allocation/raid_stripe_all_devices=1
2112 --type raid5 -l 100%FREE -n mylv vg00
2113 Create RAID10 LV with a usable size of 5GiB, using 2 stripes, each on a
2115 two-image mirror. (Note that the -i and -m arguments behave differ‐
2116 ently: -i specifies the total number of stripes, but -m specifies the
2117 number of images in addition to the first image).
2118 lvcreate --type raid10 -L 5G -i 2 -m 1 -n mylv vg00
2119 Create a 1TiB thin LV, first creating a new thin pool for it, where the
2121 thin pool has 100MiB of space, uses 2 stripes, has a 64KiB stripe size,
2122 and 256KiB chunk size.
2123 lvcreate --type thin --name mylv --thinpool mypool
2124 -V 1t -L 100m -i 2 -I 64 -c 256 vg00
2125 Create a thin snapshot of a thin LV (the size option must not be used,
2127 otherwise a copy-on-write snapshot would be created).
2128 lvcreate --snapshot --name mysnap vg00/thinvol
2129 Create a thin snapshot of the read-only inactive LV named "origin"
2131 which becomes an external origin for the thin snapshot LV.
2132 lvcreate --snapshot --name mysnap --thinpool mypool vg00/origin
2133 Create a cache pool from a fast physical device. The cache pool can
2135 then be used to cache an LV.
2136 lvcreate --type cache-pool -L 1G -n my_cpool vg00 /dev/fast1
2137 Create a cache LV, first creating a new origin LV on a slow physical
2139 device, then combining the new origin LV with an existing cache pool.
2140 lvcreate --type cache --cachepool my_cpool
2141 -L 100G -n mylv vg00 /dev/slow1
2142
2144 lvm(8) lvm.conf(5) lvmconfig(8)
2145 pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8)
2147 pvresize(8) pvs(8) pvscan(8)
2148 vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8) vgcreate(8) vgcon‐
2150 vert(8) vgdisplay(8) vgexport(8) vgextend(8) vgimport(8) vgimport‐
2151 clone(8) vgmerge(8) vgmknodes(8) vgreduce(8) vgremove(8) vgrename(8)
2152 vgs(8) vgscan(8) vgsplit(8)
2153 lvcreate(8) lvchange(8) lvconvert(8) lvdisplay(8) lvextend(8) lvre‐
2155 duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
2156 lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
2158 vate(8) lvmdump(8)
2159 dmeventd(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) cmirrord(8) lvmd‐
2161 busd(8)
2162 lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
2164Red Hat, Inc. LVM TOOLS 2.03.02(2)-RHEL8 (2019-01-04) LVCREATE(8)