diff options
Diffstat (limited to 'man/lvchange.8.in')
| -rw-r--r-- | man/lvchange.8.in | 58 |
1 files changed, 46 insertions, 12 deletions
diff --git a/man/lvchange.8.in b/man/lvchange.8.in index 4577cce7a..9199b49be 100644 --- a/man/lvchange.8.in +++ b/man/lvchange.8.in @@ -8,7 +8,7 @@ lvchange \(em change attributes of a logical volume .RB [ \-A | \-\-autobackup .RI { y | n }] .RB [ \-a | \-\-activate -.RI [ a | e | l ]{ y | n }] +.RI [ a | e | s | l ]{ y | n }] .RB [ \-\-activationmode .RI { complete | degraded | partial }] .RB [ \-k | \-\-setactivationskip @@ -31,6 +31,8 @@ lvchange \(em change attributes of a logical volume .RB [ \-\-detachprofile ] .RB [ \-\-discards .RI { ignore | nopassdown | passdown }] +.RB [ \-\-errorwhenfull +.RI { y | n }] .RB [ \-\-resync ] .RB [ \-h | \-? | \-\-help ] .RB [ \-\-ignorelockingfailure ] @@ -66,11 +68,12 @@ lvchange \(em change attributes of a logical volume .RB [ \-r | \-\-readahead .RI { ReadAheadSectors | auto | none }] .RB [ \-\-refresh ] +.RB [ \-S | \-\-select +.IR Selection ] .RB [ \-t | \-\-test ] .RB [ \-v | \-\-verbose ] .RB [ \-Z | \-\-zero .RI { y | n }] -.I LogicalVolumePath .RI [ LogicalVolumePath ...] .SH DESCRIPTION lvchange allows you to change the attributes of a logical volume @@ -78,19 +81,19 @@ including making them known to the kernel ready for use. .SH OPTIONS See \fBlvm\fP(8) for common options. .TP -.BR \-a ", " \-\-activate " [" \fIa | \fIe | \fIl ]{ \fIy | \fIn } +.BR \-a ", " \-\-activate " [" \fIa | \fIe | \fIs | \fIl ]{ \fIy | \fIn } Controls the availability of the logical volumes for use. Communicates with the kernel device-mapper driver via libdevmapper to activate (\-ay) or deactivate (\-an) the -logical volumes. +logical volumes. .IP Activation of a logical volume creates a symbolic link /dev/VolumeGroupName/LogicalVolumeName pointing to the device node. This link is removed on deactivation. All software and scripts should access the device through this symbolic link and present this as the name of the device. -The location and name of the underlying device node may depend on -the distribution and configuration (e.g. udev) and might change +The location and name of the underlying device node may depend on +the distribution and configuration (e.g. udev) and might change from release to release. .IP If autoactivation option is used (\-aay), @@ -101,11 +104,36 @@ activation. The \-aay option should be also used during system boot so it's possible to select which volumes to activate using the activation/auto_activation_volume_list setting. .IP -If clustered locking is enabled, -aey 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. +In a clustered VG, clvmd is used for activation, and the +following options are possible: + +With \-aey, clvmd activates the LV in exclusive mode +(with an exclusive lock), allowing a single node to activate the LV. + +With \-asy, clvmd activates the LV in shared mode +(with a shared lock), allowing multiple nodes to activate the LV concurrently. +If the LV type prohibits shared access, such as an LV with a snapshot, +the 's' option is ignored and an exclusive lock is used. + +With \-ay (no mode specified), clvmd activates the LV in shared mode +if the LV type allows concurrent access, such as a linear LV. +Otherwise, clvmd activates the LV in exclusive mode. + +With \-aey, \-asy, and \-ay, clvmd attempts to activate the LV +on all nodes. If exclusive mode is used, then only one of the +nodes will be successful. + +With \-an, clvmd attempts to deactivate the LV on all nodes. + +With \-aly, clvmd activates the LV only on the local node, and \-aln +deactivates only on the local node. If the LV type allows concurrent +access, then shared mode is used, otherwise exclusive. + +LVs with snapshots are always activated exclusively because they can only +be used on one node at once. + +For local VGs, \-ay, \-aey, and \-asy are all equivalent. + .TP .BR \-\-activationmode " {" \fIcomplete | \fIdegraded | \fIpartial } The activation mode determines whether logical volumes are allowed to @@ -156,9 +184,14 @@ Set this to \fIignore\fP to ignore any discards received by a thin pool Logical Volume. Set to \fInopassdown\fP to process such discards within the thin pool itself and allow the no-longer-needed extents to be overwritten by new data. Set to \fIpassdown\fP (the -default) to process them both within the thin pool itself and to +default) to process them both within the thin pool itself and to pass them down the underlying device. .TP +.BR \-\-errorwhenfull " {" \fIy | \fIn } +Sets thin pool behavior when data space is exhaused. See +.BR lvcreate (8) +for information. +.TP .B \-\-resync Forces the complete resynchronization of a mirror. In normal circumstances you should not need this option because synchronization @@ -271,6 +304,7 @@ Do not use this if dmeventd is already monitoring a device. .TP .BR \-M ", " \-\-persistent " {" \fIy | \fIn } Set to y to make the minor number specified persistent. +Change of persistent numbers is not supported for pool volumes. .TP .BR \-p ", " \-\-permission " {" \fIr | \fIrw } Change access permission to read-only or read/write. |