1
0
mirror of git://sourceware.org/git/lvm2.git synced 2025-01-04 09:18:36 +03:00
LVM2 mirror repository https://sourceware.org/lvm2/
Go to file
David Teigland aa9019d8a2 dm-integrity support
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.

Create a linear LV with an integrity layer above it:

lvcreate --type integrity --integrity String [options]

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

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

Add an integrity layer to an existing linear LV,
or to each image of an existing raid LV:

lvconvert --integrity y LV

Remove the integrity layer from a linear LV, or
from the images of a raid LV:

lvconvert --integrity n LV

Integrity metadata:

The --integrity String specifies if the dm-integrity
metadata (checksums) should be interleaved with data
blocks, or written to a separate external LV.

  --integrity external (default)
  Use integrity with metadata on a separate LV.
  Allows removing integrity from the LV later.

  --integrity y
  Same as integrity external.

  --integrity n
  Remove integrity (external metadata only.)

  --integrity internal
  Use integrity with metadata interleaved with
  data on the same LV.
  Only allowed with new linear LVs.
  Internal integrity cannot be removed from an LV.
  Around 1% of the LV size is used for integrity metadata.

Command variations:

lvcreate --type integrity -n Name -L Size VG
  [Uses integrity external, the default.]

lvcreate --integrity y|external -n Name -L Size VG
  [Uses type integrity, which is implied.]

lvcreate --integrity internal -n Name -L Size VG
  [Uses type integrity, which is implied.]

lvcreate --type raidN --integrity y -m Num -n Name -L Size VG
  [Uses type integrity for each raid image.]

lvconvert --type integrity LV
  [Converts linear LV to type integrity.]

lvconvert --integrity y|external LV
  [Converts linear LV to type integrity, or each
   image to type integrity in a raid LV.]

Options:

  --integritymetadata LV|PV
  Use a specified LV for external metadata, or allocate
  a integrity metadata LV(s) from the named PV.
  With raid, only a PV can be specified (because multiple
  metadata LVs are required.)
  When this option is not used, the command allocates
  integrity metadata LVs using any PVs in the VG.

  --integritysettings String
  set dm-integrity parameters, e.g. to use a journal
  instead of bitmap, --integritysettings "mode=J".

Example:

$ lvcreate --integrity external -n lvex -L1G vg
$ lvs -a vg
  LV           VG Attr       LSize  Origin
  lvex         vg gwi-a-----  1.00g [lvex_iorig]
  [lvex_imeta] vg ewi-ao---- 12.00m
  [lvex_iorig] vg -wi-ao----  1.00g

$ lvcreate --integrity internal -n lvin -L1G vg
$ lvs -a vg
  LV           VG Attr       LSize Origin
  lvin         vg gwi-a----- 1.00g [lvin_iorig]
  [lvin_iorig] vg -wi-ao---- 1.00g

$ lvcreate --type raid1 --integrity y -m 1 -n lver -L1G vg
$ lvs -a vg
  LV                    VG Attr       LSize  Origin
  lver                  vg rwi-a-r---  1.00g
  [lver_rimage_0]       vg gwi-aor---  1.00g [lver_rimage_0_iorig]
  [lver_rimage_0_imeta] vg ewi-ao---- 12.00m
  [lver_rimage_0_iorig] vg -wi-ao----  1.00g
  [lver_rimage_1]       vg gwi-aor---  1.00g [lver_rimage_1_iorig]
  [lver_rimage_1_imeta] vg ewi-ao---- 12.00m
  [lver_rimage_1_iorig] vg -wi-ao----  1.00g
  [lver_rmeta_0]        vg ewi-aor---  4.00m
  [lver_rmeta_1]        vg ewi-aor---  4.00m
2020-01-15 15:44:31 -06:00
autoconf autoconf: Fix py-compile permissions 2016-02-18 01:05:05 +00:00
base configure: avoid repeative inclusion of configure.h 2018-12-21 19:19:50 +01:00
conf build: make generate 2019-10-23 09:51:07 +02:00
coverity coverity: model few more functions 2017-06-27 12:17:16 +02:00
daemons lvmdbusd: Add function to convert LV into a VDO pool 2020-01-09 13:07:55 -06:00
device_mapper dm-integrity support 2020-01-15 15:44:31 -06:00
doc Merge branch 'master' into 2018-05-11-fork-libdm 2018-06-01 13:04:12 +01:00
include dm-integrity support 2020-01-15 15:44:31 -06:00
lib dm-integrity support 2020-01-15 15:44:31 -06:00
libdaemon cov: more checks for failing syscalls 2019-11-14 18:06:42 +01:00
libdm libdm: set maj:min while creating and reloading device 2019-12-10 15:42:59 +01:00
man man pvck: describe settings 2019-12-06 16:24:27 -06:00
nix lockd: Clean up spec 2015-07-04 14:36:57 +02:00
po doc: change fsf address 2016-01-21 12:11:37 +01:00
scripts systemd: put back DefaultDependencies=no for lvmpolld socket unit 2019-04-11 12:18:02 +02:00
spec spec: Fix lvm2-activation-generator man page handling 2019-10-04 16:29:38 +02:00
test dm-integrity support 2020-01-15 15:44:31 -06:00
tools dm-integrity support 2020-01-15 15:44:31 -06:00
udev udev: remove unsupported OPTIONS+="event_timeout" rule 2019-08-13 15:18:30 +02:00
.gitignore gitignore: update 2019-03-20 14:35:09 +01:00
acinclude.m4 [build] uncomment 'serial 3' in an m4 file. 2018-04-30 09:44:27 +01:00
aclocal.m4 liblvm: remove lvmapi 2018-06-08 09:38:05 +01:00
configure configure: continue build if prlimit is missing 2019-08-26 17:34:45 +02:00
configure.ac dm-integrity support 2020-01-15 15:44:31 -06:00
COPYING doc: change fsf address 2016-01-21 12:11:37 +01:00
COPYING.BSD Add BSD 2-Clause License 2018-07-27 17:09:46 +02:00
COPYING.LIB Fix inconsistent licence notices: executables are GPLv2; libraries LGPLv2.1. 2007-08-20 20:55:30 +00:00
INSTALL quick review of docs 2008-11-04 17:49:22 +00:00
make.tmpl.in make: support comments in exported symbols 2019-08-09 12:57:07 +02:00
Makefile.in makefiles: correcting login of makefile 2018-12-17 10:55:20 +01:00
README pre-release 2018-10-10 11:26:53 +02:00
TESTING docs: Add TESTING file 2017-12-14 16:45:47 +01:00
VERSION post-release 2019-11-30 14:46:56 +01:00
VERSION_DM post-release 2019-11-30 14:46:56 +01:00
WHATS_NEW WHATS_NEW: update 2020-01-13 17:42:53 +01:00
WHATS_NEW_DM libdm: support device RELOAD with maj:min and devname set 2019-12-10 15:42:59 +01:00

This tree contains the LVM2 and device-mapper tools and libraries.

This is development branch, for stable 2.02 release see 2018-06-01-stable
branch.

For more information about LVM2 read the changelog in the WHATS_NEW file.
Installation instructions are in INSTALL.

There is no warranty - see COPYING and COPYING.LIB.

Tarballs are available from:
  ftp://sourceware.org/pub/lvm2/
  ftp://sources.redhat.com/pub/lvm2/
  https://github.com/lvmteam/lvm2/releases

The source code is stored in git:
  https://sourceware.org/git/?p=lvm2.git
  git clone git://sourceware.org/git/lvm2.git
mirrored to:
  https://github.com/lvmteam/lvm2
  git clone https://github.com/lvmteam/lvm2.git
  git clone git@github.com:lvmteam/lvm2.git

Mailing list for general discussion related to LVM2:
  linux-lvm@redhat.com
  Subscribe from https://www.redhat.com/mailman/listinfo/linux-lvm

Mailing lists for LVM2 development, patches and commits:
  lvm-devel@redhat.com
  Subscribe from https://www.redhat.com/mailman/listinfo/lvm-devel

  lvm2-commits@lists.fedorahosted.org (Read-only archive of commits)
  Subscribe from https://fedorahosted.org/mailman/listinfo/lvm2-commits

Mailing list for device-mapper development, including kernel patches
and multipath-tools:
  dm-devel@redhat.com
  Subscribe from https://www.redhat.com/mailman/listinfo/dm-devel

Website:
  https://sourceware.org/lvm2/

Report upstream bugs at:
  https://bugzilla.redhat.com/enter_bug.cgi?product=LVM%20and%20device-mapper
or open issues at:
  https://github.com/lvmteam/lvm2/issues

The source code repository used until 7th June 2012 is accessible here:
  http://sources.redhat.com/cgi-bin/cvsweb.cgi/LVM2/?cvsroot=lvm2.