2002-01-04 23:35:19 +03:00
.TH LVCHANGE 8 "LVM TOOLS" "Sistina Software UK" \" -*- nroff -*-
.SH NAME
lvchange \- change attributes of a logical volume
.SH SYNOPSIS
.B lvchange
2004-03-22 18:08:50 +03:00
[\- \- addtag Tag]
2004-11-12 18:59:09 +03:00
[\- A/\- \- autobackup y/n] [\- a/\- \- available y/n/ey/en/ly/ln]
2004-11-16 21:09:32 +03:00
[\- \- alloc AllocationPolicy]
2004-03-22 18:08:50 +03:00
[\- C/\- \- contiguous y/n] [\- d/\- \- debug] [\- \- deltag Tag]
2006-10-24 03:03:55 +04:00
[\- \- forcesync]
2004-03-22 18:08:50 +03:00
[\- h/\- ?/\- \- help]
2002-11-18 17:04:08 +03:00
[\- \- ignorelockingfailure]
2006-08-19 01:49:19 +04:00
[\- \- monitor {y|n}]
2002-11-18 17:04:08 +03:00
[\- M/\- \- persistent y/n] [\- \- minor minor]
[\- P/\- \- partial y/n]
2002-01-04 23:35:19 +03:00
[\- p/\- \- permission r/w] [\- r/\- \- readahead ReadAheadSectors]
2004-11-12 18:59:09 +03:00
[\- \- refresh]
2002-11-18 17:04:08 +03:00
[\- t/\- \- test]
2002-01-04 23:35:19 +03:00
[\- v/\- \- verbose] LogicalVolumePath [LogicalVolumePath...]
.SH DESCRIPTION
2004-11-12 18:59:09 +03:00
lvchange allows you to change the attributes of a logical volume
including making them known to the kernel ready for use.
2002-01-04 23:35:19 +03:00
.SH OPTIONS
See \fB lvm\fP for common options.
.TP
2004-11-12 18:59:09 +03:00
.I \- a, \- \- available y/n/ey/en/ly/ln
2002-01-04 23:35:19 +03:00
Controls the availability of the logical volumes for use.
2004-11-12 18:59:09 +03:00
Communicates with the kernel device-mapper driver via
libdevmapper to activate (-ay) or deactivate (-an) the
logical volumes.
.IP
If clustered locking is enabled, -ae will activate exclusively
on one node and -aly will activate only on the local node.
To deactivate only on the local node use -aln.
Logical volumes with single-host snapshots are always activated
exclusively because they can only be used on one node at once.
2002-01-04 23:35:19 +03:00
.TP
.I \- C, \- \- contiguous y/n
2002-11-18 17:04:08 +03:00
Tries to set or reset the contiguous allocation policy for
2002-01-04 23:35:19 +03:00
logical volumes. It's only possible to change a non-contiguous
logical volume's allocation policy to contiguous, if all of the
allocated physical extents are already contiguous.
.TP
2006-10-24 03:03:55 +04:00
.I \- \- forcesync
This option only make sense if the logical volume being operated
on is a mirrored logical volume. This option is used to
resynchronize the devices in a mirrored logical volume. Since
resynchronization can take considerable time and resources, you
should consider using this option only if you have reason to
believe that the devices in your mirror are no longer the same.
.TP
2002-11-18 17:04:08 +03:00
.I \- \- minor minor
Set the minor number.
.TP
2006-08-19 01:49:19 +04:00
.I \- \- monitor y/n
2006-08-19 02:27:01 +04:00
Controls whether or not a mirrored logical volume is monitored by
dmeventd, if it is installed.
If a device used by a monitored mirror reports an I/O error,
the failure is handled according to
\fB mirror_image_fault_policy\fP and \fB mirror_log_fault_policy\fP
set in \fB lvm.conf\fP .
2006-08-19 01:49:19 +04:00
.TP
2002-11-18 17:04:08 +03:00
.I \- M, \- \- persistent y/n
Set to y to make the minor number specified persistent.
.TP
2002-01-04 23:35:19 +03:00
.I \- p, \- \- permission r/w
Change access permission to read-only or read/write.
.TP
.I \- r, \- \- readahead ReadAheadSectors
Change read ahead sector count per logical between 2 and 120.
2004-11-12 18:59:09 +03:00
For compatability with LVM1 only. Ignored by LVM2.
.TP
.I \- \- refresh
If the logical volume is active, reload its metadata.
This is not necessary in normal operation, but may be useful
if something has gone wrong or if you're doing clustering
manually without a clustered lock manager.
2002-01-04 23:35:19 +03:00
.SH Examples
2004-11-12 18:59:09 +03:00
"lvchange -pr vg00/lvol1" changes the permission on
2004-09-13 12:01:54 +04:00
volume lvol1 in volume group vg00 to be read-only.
2002-01-04 23:35:19 +03:00
.SH SEE ALSO
.BR lvm (8),
2004-11-12 18:59:09 +03:00
.BR lvcreate (8),
.BR vgchange (8)