1
0
mirror of git://sourceware.org/git/lvm2.git synced 2024-10-26 17:25:10 +03:00
lvm2/man
David Teigland d9e8895a96 Allow dm-integrity to be used for raid images
dm-integrity stores checksums of the data written to an
LV, and returns an error if data read from the LV does
not match the previously saved checksum.  When used on
raid images, dm-raid will correct the error by reading
the block from another image, and the device user sees
no error.  The integrity metadata (checksums) are stored
on an internal LV allocated by lvm for each linear image.
The internal LV is allocated on the same PV as the image.

Create a raid LV with an integrity layer over each
raid image (for raid levels 1,4,5,6,10):

lvcreate --type raidN --raidintegrity y [options]

Add an integrity layer to images of an existing raid LV:

lvconvert --raidintegrity y LV

Remove the integrity layer from images of a raid LV:

lvconvert --raidintegrity n LV

Settings

Use --raidintegritymode journal|bitmap (journal is default)
to configure the method used by dm-integrity to ensure
crash consistency.

Initialization

When integrity is added to an LV, the kernel needs to
initialize the integrity metadata/checksums for all blocks
in the LV.  The data corruption checking performed by
dm-integrity will only operate on areas of the LV that
are already initialized.  The progress of integrity
initialization is reported by the "syncpercent" LV
reporting field (and under the Cpy%Sync lvs column.)

Example: create a raid1 LV with integrity:

$ lvcreate --type raid1 -m1 --raidintegrity y -n rr -L1G foo
  Creating integrity metadata LV rr_rimage_0_imeta with size 12.00 MiB.
  Logical volume "rr_rimage_0_imeta" created.
  Creating integrity metadata LV rr_rimage_1_imeta with size 12.00 MiB.
  Logical volume "rr_rimage_1_imeta" created.
  Logical volume "rr" created.
$ lvs -a foo
  LV                  VG  Attr       LSize  Origin              Cpy%Sync
  rr                  foo rwi-a-r---  1.00g                     4.93
  [rr_rimage_0]       foo gwi-aor---  1.00g [rr_rimage_0_iorig] 41.02
  [rr_rimage_0_imeta] foo ewi-ao---- 12.00m
  [rr_rimage_0_iorig] foo -wi-ao----  1.00g
  [rr_rimage_1]       foo gwi-aor---  1.00g [rr_rimage_1_iorig] 39.45
  [rr_rimage_1_imeta] foo ewi-ao---- 12.00m
  [rr_rimage_1_iorig] foo -wi-ao----  1.00g
  [rr_rmeta_0]        foo ewi-aor---  4.00m
  [rr_rmeta_1]        foo ewi-aor---  4.00m
2020-04-15 12:10:32 -05:00
..
.gitignore man: add man-generator and build artefacts to .gitignore 2017-03-10 13:14:02 +00:00
blkdeactivate.8_main blkdeactivate: add support for VDO in blkdeactivate script 2020-04-09 15:29:29 +02:00
cmirrord.8_main man: remove some clvmd references 2018-11-14 10:00:23 -06:00
dmeventd.8_main man: dmeventd vdo plugin 2019-03-20 14:39:11 +01:00
dmfilemapd.8_main man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
dmsetup.8_main dmsetup: hide integrity encryption keys on table output 2017-11-10 15:23:00 +01:00
dmstats.8_main man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
fsadm.8_main fsadm: add support for crypt devices 2017-10-10 14:18:57 +02:00
lvchange.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvchange.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvchange.8_pregen build: make generate 2019-09-25 08:27:49 +02:00
lvconvert.8_des man lvcreate/lvconvert: minor clean up rewording 2017-04-11 10:21:36 -05:00
lvconvert.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvconvert.8_pregen build: make generate 2019-09-25 08:27:49 +02:00
lvcreate.8_des man: vdo regenerated 2019-01-28 22:39:10 +01:00
lvcreate.8_end vdo: add some basic example 2019-01-28 22:39:10 +01:00
lvcreate.8_pregen build: make generate 2019-06-07 17:59:43 +02:00
lvdisplay.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvdisplay.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvdisplay.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
lvextend.8_des man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvextend.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvextend.8_pregen vdo: document types vdo and vdo-pool 2019-01-28 22:39:10 +01:00
lvm2-activation-generator.8_main man: lvm2-activation-generator fix vgchange comment 2020-03-10 14:41:51 -05:00
lvm-fullreport.8_des man lvm fullreport and lvpoll references 2017-05-03 16:40:44 -05:00
lvm-fullreport.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvm-fullreport.8_pregen build: make generate 2019-06-15 08:30:04 +02:00
lvm-lvpoll.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvm-lvpoll.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvm-lvpoll.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
lvm.8_main man: Include '_vdata' as reserved name 2019-10-30 10:38:40 -05:00
lvm.conf.5_main man lvm.conf: say how to get a description of settings 2017-05-03 16:01:19 -05:00
lvmcache.7_main man: lvmcache raid1 references 2020-02-27 11:33:55 -06:00
lvmconfig.8_des man: simplify by avoiding different headers on de-duplication of lvmconfig, lvm-config and lvm-dumpconfig 2017-03-29 01:44:09 +02:00
lvmconfig.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvmconfig.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
lvmdbusd.8_main man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvmdiskscan.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvmdiskscan.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvmdiskscan.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
lvmdump.8_main man lvmdump: remove clvm reference 2018-11-13 16:20:02 -06:00
lvmlockctl.8_main man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvmlockd.8_main man: updates to lvmlockd 2019-04-04 14:36:28 -05:00
lvmpolld.8_main man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvmraid.7_main Allow dm-integrity to be used for raid images 2020-04-15 12:10:32 -05:00
lvmreport.7_main man lvm fullreport and lvpoll references 2017-05-03 16:40:44 -05:00
lvmsadc.8_main man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvmsar.8_main man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvmsystemid.7_main man: remove scattered lvmetad references 2018-11-14 09:57:57 -06:00
lvmthin.7_main man lvmthin: change wording about mounting xfs 2019-10-24 10:10:18 -05:00
lvmvdo.7_main man lvmvdo: Correct spellings 2019-10-30 10:38:40 -05:00
lvreduce.8_des man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvreduce.8_end Revert "man: fix lvreduce example" 2018-06-27 09:20:21 -05:00
lvreduce.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
lvremove.8_des man: remove blank lines from end/des files 2017-03-15 15:59:43 -05:00
lvremove.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvremove.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
lvrename.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvrename.8_end man: remove blank lines from end/des files 2017-03-15 15:59:43 -05:00
lvrename.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
lvresize.8_des man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvresize.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
lvresize.8_pregen man: vdo regenerated 2019-01-28 22:39:10 +01:00
lvs.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvs.8_end man: document dD attrs for VDO lvs 2019-01-21 12:39:23 +01:00
lvs.8_pregen build: make generate 2019-06-15 08:30:04 +02:00
lvscan.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvscan.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
lvscan.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
Makefile.in man: initial man page for VDO support 2019-01-21 12:39:23 +01:00
pvchange.8_des man pvchange: mention one option is required 2017-05-03 15:10:10 -05:00
pvchange.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
pvchange.8_pregen build: make generate 2019-06-15 08:30:04 +02:00
pvck.8_des man: pvck dump description improvements 2020-01-22 15:01:00 -06:00
pvck.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
pvck.8_pregen generate: remake 2020-02-04 17:22:06 +01:00
pvcreate.8_des Place the first PE at 1 MiB for all defaults 2018-11-26 16:36:50 -06:00
pvcreate.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
pvcreate.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
pvdisplay.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
pvdisplay.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
pvdisplay.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
pvmove.8_des man: remove blank lines from end/des files 2017-03-15 15:59:43 -05:00
pvmove.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
pvmove.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
pvremove.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
pvremove.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
pvremove.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
pvresize.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
pvresize.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
pvresize.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
pvs.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
pvs.8_end man: remove blank lines from end/des files 2017-03-15 15:59:43 -05:00
pvs.8_pregen build: make generate 2019-06-15 08:30:04 +02:00
pvscan.8_des man: pvscan updates 2018-11-14 09:34:30 -06:00
pvscan.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
pvscan.8_pregen build: make generate 2019-09-25 08:27:49 +02:00
see_also.end man: remove scattered lvmetad references 2018-11-14 09:57:57 -06:00
vgcfgbackup.8_des man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
vgcfgbackup.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgcfgbackup.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgcfgrestore.8_des man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
vgcfgrestore.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
vgcfgrestore.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgchange.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgchange.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
vgchange.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgck.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgck.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgck.8_pregen build: make generate 2019-06-15 08:30:04 +02:00
vgconvert.8_des Remove vgconvert 2018-06-13 14:14:03 -05:00
vgconvert.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgconvert.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgcreate.8_des Place the first PE at 1 MiB for all defaults 2018-11-26 16:36:50 -06:00
vgcreate.8_end man: remove blank lines from end/des files 2017-03-15 15:59:43 -05:00
vgcreate.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgdisplay.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgdisplay.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgdisplay.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgexport.8_des man vgexport: expand description 2018-05-21 16:26:49 -05:00
vgexport.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgexport.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgextend.8_des man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
vgextend.8_end man: remove blank lines from end/des files 2017-03-15 15:59:43 -05:00
vgextend.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgimport.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgimport.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgimport.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgimportclone.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgimportclone.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
vgimportclone.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgmerge.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgmerge.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
vgmerge.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgmknodes.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgmknodes.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgmknodes.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgreduce.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgreduce.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgreduce.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgremove.8_des man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
vgremove.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgremove.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgrename.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgrename.8_end man-generator/man/help: simplify hyphen escaping 2017-03-27 16:49:39 +02:00
vgrename.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgs.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgs.8_end man: remove blank lines 2017-03-15 11:05:31 -05:00
vgs.8_pregen build: make generate 2019-06-15 08:30:04 +02:00
vgscan.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgscan.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgscan.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00
vgsplit.8_des man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgsplit.8_end man: Revise internal man page generation process. 2017-03-14 00:47:46 +00:00
vgsplit.8_pregen make: generate man update 2018-11-29 23:10:08 +01:00