1LVCHANGE(8) System Manager's Manual LVCHANGE(8)
2
3
4
6 lvchange - change attributes of a logical volume
7
9 lvchange [--addtag Tag] [-A|--autobackup y|n] [-a|--available
10 y|n|ey|en|ly|ln] [--alloc AllocationPolicy] [-C|--contiguous y|n]
11 [-d|--debug] [--deltag Tag] [--resync] [-h|-?|--help] [--ignorelocking‐
12 failure] [--ignoremonitoring] [--monitor {y|n}] [--poll {y|n}]
13 [--sysinit] [--noudevsync] [-M|--persistent y|n] [--minor minor]
14 [-P|--partial] [-p|--permission r|rw] [-r/--readahead ReadAheadSec‐
15 tors|auto|none] [--refresh] [-t|--test] [-v|--verbose] LogicalVol‐
16 umePath [LogicalVolumePath...]
17
19 lvchange allows you to change the attributes of a logical volume
20 including making them known to the kernel ready for use.
21
23 See lvm for common options.
24
25 -a, --available y|n|ey|en|ly|ln
26 Controls the availability of the logical volumes for use. Com‐
27 municates with the kernel device-mapper driver via libdevmapper
28 to activate (-ay) or deactivate (-an) the logical volumes.
29
30 If clustered locking is enabled, -aey will activate exclusively
31 on one node and -aly will activate only on the local node. To
32 deactivate only on the local node use -aln. Logical volumes
33 with single-host snapshots are always activated exclusively
34 because they can only be used on one node at once.
35
36 -C, --contiguous y|n
37 Tries to set or reset the contiguous allocation policy for logi‐
38 cal volumes. It's only possible to change a non-contiguous logi‐
39 cal volume's allocation policy to contiguous, if all of the
40 allocated physical extents are already contiguous.
41
42 --resync
43 Forces the complete resynchronization of a mirror. In normal
44 circumstances you should not need this option because synchro‐
45 nization happens automatically. Data is read from the primary
46 mirror device and copied to the others, so this can take a con‐
47 siderable amount of time - and during this time you are without
48 a complete redundant copy of your data.
49
50 --minor minor
51 Set the minor number.
52
53 --monitor y|n
54 Start or stop monitoring a mirrored or snapshot logical volume
55 with dmeventd, if it is installed. If a device used by a moni‐
56 tored mirror reports an I/O error, the failure is handled
57 according to mirror_image_fault_policy and mirror_log_fault_pol‐
58 icy set in lvm.conf.
59
60 --poll y|n
61 Without polling a logical volume's backgrounded transformation
62 process will never complete. If there is an incomplete pvmove
63 or lvconvert (for example, on rebooting after a crash), use
64 --poll y to restart the process from its last checkpoint. How‐
65 ever, it may not be appropriate to immediately poll a logical
66 volume when it is activated, use --poll n to defer and then
67 --poll y to restart the process.
68
69 --sysinit
70 Indicates that lvchange(8) is being invoked from early system
71 initialisation scripts (e.g. rc.sysinit or an initrd), before
72 writeable filesystems are available. As such, some functionality
73 needs to be disabled and this option acts as a shortcut which
74 selects an appropriate set of options. Currently this is equiva‐
75 lent to using --ignorelockingfailure, --ignoremonitoring,
76 --poll n and setting LVM_SUPPRESS_LOCKING_FAILURE_MESSAGES envi‐
77 ronment variable.
78
79 --noudevsync
80 Disable udev synchronisation. The process will not wait for
81 notification from udev. It will continue irrespective of any
82 possible udev processing in the background. You should only use
83 this if udev is not running or has rules that ignore the devices
84 LVM2 creates.
85
86 --ignoremonitoring
87 Make no attempt to interact with dmeventd unless --monitor is
88 specified. Do not use this if dmeventd is already monitoring a
89 device.
90
91 -M, --persistent y|n
92 Set to y to make the minor number specified persistent.
93
94 -p, --permission r|rw
95 Change access permission to read-only or read/write.
96
97 -r, --readahead ReadAheadSectors|auto|none
98 Set read ahead sector count of this logical volume. For volume
99 groups with metadata in lvm1 format, this must be a value
100 between 2 and 120 sectors. The default value is "auto" which
101 allows the kernel to choose a suitable value automatically.
102 "None" is equivalent to specifying zero.
103
104 --refresh
105 If the logical volume is active, reload its metadata. This is
106 not necessary in normal operation, but may be useful if some‐
107 thing has gone wrong or if you're doing clustering manually
108 without a clustered lock manager.
109
111 "lvchange -pr vg00/lvol1" changes the permission on volume lvol1 in
112 volume group vg00 to be read-only.
113
114
116 lvm(8), lvcreate(8), vgchange(8)
117
118
119
120Sistina Software UK LVM TOOLS 2.02.84(2) (2011-02-09) LVCHANGE(8)