external/gpl2/lvm2/dist/man/lvconvert.8

   1 .\"    $NetBSD$
   2 .\"
   3 .TH LVCONVERT 8 "LVM TOOLS 2.02.44-cvs (02-17-09)" "Red Hat, Inc" \" -*- nroff -*-
   4 .SH NAME
   5 lvconvert \- convert a logical volume from linear to mirror or snapshot
   6 .SH SYNOPSIS
   7 .B lvconvert
   8 \-m|\-\-mirrors Mirrors [\-\-mirrorlog {disk|core}] [\-\-corelog] [\-R|\-\-regionsize MirrorLogRegionSize]
   9 [\-A|\-\-alloc AllocationPolicy]
  10 [\-b|\-\-background] [\-i|\-\-interval Seconds]
  11 [\-h|\-?|\-\-help]
  12 [\-v|\-\-verbose]
  13 [\-\-version]
  14 .br
  15 LogicalVolume[Path] [PhysicalVolume[Path]...]
  16 .br
  17
  18 .br
  19 .B lvconvert
  20 \-s|\-\-snapshot [\-c|\-\-chunksize ChunkSize]
  21 [\-h|\-?|\-\-help]
  22 [\-v|\-\-verbose]
  23 [\-Z|\-\-zero y|n]
  24 [\-\-version]
  25 .br
  26 OriginalLogicalVolume[Path] SnapshotLogicalVolume[Path]
  27 .SH DESCRIPTION
  28 lvconvert will change a linear logical volume to a mirror
  29 logical volume or to a snapshot of linear volume and vice versa.
  30 It is also used to add and remove disk logs from mirror devices.
  31 .SH OPTIONS
  32 See \fBlvm\fP for common options.
  33 .br
  34 Exactly one of \-\-mirrors or \-\-snapshot arguments required.
  35 .br
  36 .TP
  37 .I \-m, \-\-mirrors Mirrors
  38 Specifies the degree of the mirror you wish to create.
  39 For example, "-m 1" would convert the original logical
  40 volume to a mirror volume with 2-sides; that is, a
  41 linear volume plus one copy.
  42 .TP
  43 .I \-\-mirrorlog {disk|core}
  44 Specifies the type of log to use.
  45 The default is disk, which is persistent and requires
  46 a small amount of storage space, usually on a separate device
  47 from the data being mirrored.
  48 Core may be useful for short-lived mirrors: It means the mirror is
  49 regenerated by copying the data from the first device again every
  50 time the device is activated - perhaps, for example, after every reboot.
  51 .TP
  52 .I \-\-corelog
  53 The optional argument "--corelog" is the same as specifying "--mirrorlog core".
  54 .TP
  55 .I \-R, \-\-regionsize MirrorLogRegionSize
  56 A mirror is divided into regions of this size (in MB), and the mirror log
  57 uses this granularity to track which regions are in sync.
  58 .TP
  59 .I \-b, \-\-background
  60 Run the daemon in the background.
  61 .TP
  62 .I \-i, \-\-interval Seconds
  63 Report progress as a percentage at regular intervals.
  64 .br
  65 .TP
  66 .I \-s, \-\-snapshot
  67 Create a snapshot from existing logical volume using another
  68 existing logical volume as its origin.
  69 .TP
  70 .I \-c, \-\-chunksize ChunkSize
  71 Power of 2 chunk size for the snapshot logical volume between 4k and 512k.
  72 .TP
  73 .I \-Z, \-\-zero y|n
  74 Controls zeroing of the first KB of data in the snapshot.
  75 If the volume is read-only the snapshot will not be zeroed.
  76 .br
  77 .SH Examples
  78 "lvconvert -m1 vg00/lvol1"
  79 .br
  80 converts the linear logical volume "vg00/lvol1" to
  81 a two-way mirror logical volume.
  82
  83 "lvconvert --mirrorlog core vg00/lvol1"
  84 .br
  85 converts a mirror with a disk log to a
  86 mirror with an in-memory log.
  87
  88 "lvconvert --mirrorlog disk vg00/lvol1"
  89 .br
  90 converts a mirror with an in-memory log
  91 to a mirror with a disk log.
  92
  93 "lvconvert -m0 vg00/lvol1"
  94 .br
  95 converts a mirror logical volume to a linear logical
  96 volume.
  97 .br
  98
  99 .br
 100 "lvconvert -s vg00/lvol1 vg00/lvol2"
 101 .br
 102 converts logical volume "vg00/lvol2" to snapshot of original volume "vg00/lvol1"
 103
 104 .SH SEE ALSO
 105 .BR lvm (8),
 106 .BR vgcreate (8),
 107 .BR lvremove (8),
 108 .BR lvrename (8),
 109 .BR lvextend (8),
 110 .BR lvreduce (8),
 111 .BR lvdisplay (8),
 112 .BR lvscan (8)