mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-21 13:34:40 +03:00
doc: fix typos in documentation
Typos found with codespell.
This commit is contained in:
parent
118145b072
commit
aec5e573af
2
TESTING
2
TESTING
@ -24,7 +24,7 @@ You MUST disable (or mask) any LVM daemons:
|
|||||||
For running cluster tests, we are using singlenode locking. Pass
|
For running cluster tests, we are using singlenode locking. Pass
|
||||||
`--with-clvmd=singlenode` to configure.
|
`--with-clvmd=singlenode` to configure.
|
||||||
|
|
||||||
NOTE: This is useful only for testing, and should not be used in produciton
|
NOTE: This is useful only for testing, and should not be used in production
|
||||||
code.
|
code.
|
||||||
|
|
||||||
To run D-Bus daemon tests, existing D-Bus session is required.
|
To run D-Bus daemon tests, existing D-Bus session is required.
|
||||||
|
@ -757,7 +757,7 @@ allocation {
|
|||||||
# vdo_max_discard = 1
|
# vdo_max_discard = 1
|
||||||
|
|
||||||
# Configuration option allocation/vdo_pool_header_size.
|
# Configuration option allocation/vdo_pool_header_size.
|
||||||
# Specified the emptry header size in KiB at the front and end of vdo pool device.
|
# Specified the empty header size in KiB at the front and end of vdo pool device.
|
||||||
# This configuration option has an automatic default value.
|
# This configuration option has an automatic default value.
|
||||||
# vdo_pool_header_size = 512
|
# vdo_pool_header_size = 512
|
||||||
}
|
}
|
||||||
@ -936,7 +936,7 @@ backup {
|
|||||||
# archive = 1
|
# archive = 1
|
||||||
|
|
||||||
# Configuration option backup/archive_dir.
|
# Configuration option backup/archive_dir.
|
||||||
# Location of the metdata archive files.
|
# Location of the metadata archive files.
|
||||||
# Remember to back up this directory regularly!
|
# Remember to back up this directory regularly!
|
||||||
# This configuration option has an automatic default value.
|
# This configuration option has an automatic default value.
|
||||||
# archive_dir = "@DEFAULT_SYS_DIR@/@DEFAULT_ARCHIVE_SUBDIR@"
|
# archive_dir = "@DEFAULT_SYS_DIR@/@DEFAULT_ARCHIVE_SUBDIR@"
|
||||||
@ -1463,13 +1463,13 @@ activation {
|
|||||||
|
|
||||||
# Configuration option activation/reserved_stack.
|
# Configuration option activation/reserved_stack.
|
||||||
# Stack size in KiB to reserve for use while devices are suspended.
|
# Stack size in KiB to reserve for use while devices are suspended.
|
||||||
# Insufficent reserve risks I/O deadlock during device suspension.
|
# Insufficient reserve risks I/O deadlock during device suspension.
|
||||||
# This configuration option has an automatic default value.
|
# This configuration option has an automatic default value.
|
||||||
# reserved_stack = 64
|
# reserved_stack = 64
|
||||||
|
|
||||||
# Configuration option activation/reserved_memory.
|
# Configuration option activation/reserved_memory.
|
||||||
# Memory size in KiB to reserve for use while devices are suspended.
|
# Memory size in KiB to reserve for use while devices are suspended.
|
||||||
# Insufficent reserve risks I/O deadlock during device suspension.
|
# Insufficient reserve risks I/O deadlock during device suspension.
|
||||||
# This configuration option has an automatic default value.
|
# This configuration option has an automatic default value.
|
||||||
# reserved_memory = 8192
|
# reserved_memory = 8192
|
||||||
|
|
||||||
@ -1604,7 +1604,7 @@ activation {
|
|||||||
# This includes LVs that have the following segment types:
|
# This includes LVs that have the following segment types:
|
||||||
# raid1, raid4, raid5*, and raid6*.
|
# raid1, raid4, raid5*, and raid6*.
|
||||||
# If a device in the LV fails, the policy determines the steps
|
# If a device in the LV fails, the policy determines the steps
|
||||||
# performed by dmeventd automatically, and the steps perfomed by the
|
# performed by dmeventd automatically, and the steps performed by the
|
||||||
# manual command lvconvert --repair --use-policies.
|
# manual command lvconvert --repair --use-policies.
|
||||||
# Automatic handling requires dmeventd to be monitoring the LV.
|
# Automatic handling requires dmeventd to be monitoring the LV.
|
||||||
#
|
#
|
||||||
@ -1628,7 +1628,7 @@ activation {
|
|||||||
# (copies) and a mirror log. A disk log ensures that a mirror LV does
|
# (copies) and a mirror log. A disk log ensures that a mirror LV does
|
||||||
# not need to be re-synced (all copies made the same) every time a
|
# not need to be re-synced (all copies made the same) every time a
|
||||||
# machine reboots or crashes. If a device in the LV fails, this policy
|
# machine reboots or crashes. If a device in the LV fails, this policy
|
||||||
# determines the steps perfomed by dmeventd automatically, and the steps
|
# determines the steps performed by dmeventd automatically, and the steps
|
||||||
# performed by the manual command lvconvert --repair --use-policies.
|
# performed by the manual command lvconvert --repair --use-policies.
|
||||||
# Automatic handling requires dmeventd to be monitoring the LV.
|
# Automatic handling requires dmeventd to be monitoring the LV.
|
||||||
#
|
#
|
||||||
|
@ -67,7 +67,7 @@ the entries (each hotspot block covers a larger area than a single
|
|||||||
cache block).
|
cache block).
|
||||||
|
|
||||||
All this means smq uses ~25bytes per cache block. Still a lot of
|
All this means smq uses ~25bytes per cache block. Still a lot of
|
||||||
memory, but a substantial improvement nontheless.
|
memory, but a substantial improvement nonetheless.
|
||||||
|
|
||||||
Level balancing:
|
Level balancing:
|
||||||
mq placed entries in different levels of the multiqueue structures
|
mq placed entries in different levels of the multiqueue structures
|
||||||
|
@ -35,7 +35,7 @@ Parameters: <cipher> <key> <iv_offset> <device path> \
|
|||||||
capi:authenc(hmac(sha256),xts(aes))-random
|
capi:authenc(hmac(sha256),xts(aes))-random
|
||||||
capi:rfc7539(chacha20,poly1305)-random
|
capi:rfc7539(chacha20,poly1305)-random
|
||||||
|
|
||||||
The /proc/crypto contains a list of curently loaded crypto modes.
|
The /proc/crypto contains a list of currently loaded crypto modes.
|
||||||
|
|
||||||
<key>
|
<key>
|
||||||
Key used for encryption. It is encoded either as a hexadecimal number
|
Key used for encryption. It is encoded either as a hexadecimal number
|
||||||
@ -81,7 +81,7 @@ Parameters: <cipher> <key> <iv_offset> <device path> \
|
|||||||
|
|
||||||
<#opt_params>
|
<#opt_params>
|
||||||
Number of optional parameters. If there are no optional parameters,
|
Number of optional parameters. If there are no optional parameters,
|
||||||
the optional paramaters section can be skipped or #opt_params can be zero.
|
the optional parameters section can be skipped or #opt_params can be zero.
|
||||||
Otherwise #opt_params is the number of following arguments.
|
Otherwise #opt_params is the number of following arguments.
|
||||||
|
|
||||||
Example of optional parameters section:
|
Example of optional parameters section:
|
||||||
|
@ -120,7 +120,7 @@ journal_crypt:algorithm(:key) (the key is optional)
|
|||||||
"salsa20", "ctr(aes)" or "ecb(arc4)").
|
"salsa20", "ctr(aes)" or "ecb(arc4)").
|
||||||
|
|
||||||
The journal contains history of last writes to the block device,
|
The journal contains history of last writes to the block device,
|
||||||
an attacker reading the journal could see the last sector nubmers
|
an attacker reading the journal could see the last sector numbers
|
||||||
that were written. From the sector numbers, the attacker can infer
|
that were written. From the sector numbers, the attacker can infer
|
||||||
the size of files that were written. To protect against this
|
the size of files that were written. To protect against this
|
||||||
situation, you can encrypt the journal.
|
situation, you can encrypt the journal.
|
||||||
|
@ -65,7 +65,7 @@ Construction Parameters
|
|||||||
|
|
||||||
<#opt_params>
|
<#opt_params>
|
||||||
Number of optional parameters. If there are no optional parameters,
|
Number of optional parameters. If there are no optional parameters,
|
||||||
the optional paramaters section can be skipped or #opt_params can be zero.
|
the optional parameters section can be skipped or #opt_params can be zero.
|
||||||
Otherwise #opt_params is the number of following arguments.
|
Otherwise #opt_params is the number of following arguments.
|
||||||
|
|
||||||
Example of optional parameters section:
|
Example of optional parameters section:
|
||||||
|
@ -37,7 +37,7 @@ segment type. The available RAID types are:
|
|||||||
"raid6_nr" - RAID6 Rotating parity N with data restart
|
"raid6_nr" - RAID6 Rotating parity N with data restart
|
||||||
"raid6_nc" - RAID6 Rotating parity N with data continuation
|
"raid6_nc" - RAID6 Rotating parity N with data continuation
|
||||||
The exception to 'no shorthand options' will be where the RAID implementations
|
The exception to 'no shorthand options' will be where the RAID implementations
|
||||||
can displace traditional tagets. This is the case with 'mirror' and 'raid1'.
|
can displace traditional targets. This is the case with 'mirror' and 'raid1'.
|
||||||
In this case, "mirror_segtype_default" - found under the "global" section in
|
In this case, "mirror_segtype_default" - found under the "global" section in
|
||||||
lvm.conf - can be set to "mirror" or "raid1". The segment type inferred when
|
lvm.conf - can be set to "mirror" or "raid1". The segment type inferred when
|
||||||
the '-m' option is used will be taken from this setting. The default segment
|
the '-m' option is used will be taken from this setting. The default segment
|
||||||
@ -104,7 +104,7 @@ and 4 devices for RAID 6/10.
|
|||||||
|
|
||||||
lvconvert should work exactly as it does now when dealing with mirrors -
|
lvconvert should work exactly as it does now when dealing with mirrors -
|
||||||
even if(when) we switch to MD RAID1. Of course, there are no plans to
|
even if(when) we switch to MD RAID1. Of course, there are no plans to
|
||||||
allow the presense of the metadata area to be configurable (e.g. --corelog).
|
allow the presence of the metadata area to be configurable (e.g. --corelog).
|
||||||
It will be simple enough to detect if the LV being up/down-converted is
|
It will be simple enough to detect if the LV being up/down-converted is
|
||||||
new or old-style mirroring.
|
new or old-style mirroring.
|
||||||
|
|
||||||
@ -120,7 +120,7 @@ RAID4 to RAID5 or RAID5 to RAID6.
|
|||||||
Line 02/03/04:
|
Line 02/03/04:
|
||||||
These are familiar options - all of which would now be available as options
|
These are familiar options - all of which would now be available as options
|
||||||
for change. (However, it'd be nice if we didn't have regionsize in there.
|
for change. (However, it'd be nice if we didn't have regionsize in there.
|
||||||
It's simple on the kernel side, but is just an extra - often unecessary -
|
It's simple on the kernel side, but is just an extra - often unnecessary -
|
||||||
parameter to many functions in the LVM codebase.)
|
parameter to many functions in the LVM codebase.)
|
||||||
|
|
||||||
Line 05:
|
Line 05:
|
||||||
@ -375,8 +375,8 @@ the slot. Even the names of the images will be renamed to properly reflect
|
|||||||
their index in the array. Unlike the "mirror" segment type, you will never have
|
their index in the array. Unlike the "mirror" segment type, you will never have
|
||||||
an image named "*_rimage_1" occupying the index position 0.
|
an image named "*_rimage_1" occupying the index position 0.
|
||||||
|
|
||||||
As with adding images, removing images holds off on commiting LVM metadata
|
As with adding images, removing images holds off on committing LVM metadata
|
||||||
until all possible changes have been made. This reduces the likelyhood of bad
|
until all possible changes have been made. This reduces the likelihood of bad
|
||||||
intermediate stages being left due to a failure of operation or machine crash.
|
intermediate stages being left due to a failure of operation or machine crash.
|
||||||
|
|
||||||
RAID1 '--splitmirrors', '--trackchanges', and '--merge' operations
|
RAID1 '--splitmirrors', '--trackchanges', and '--merge' operations
|
||||||
|
@ -87,7 +87,7 @@ are as follows:
|
|||||||
/etc/lvm/lvm.conf. Once this operation is complete, the logical volumes
|
/etc/lvm/lvm.conf. Once this operation is complete, the logical volumes
|
||||||
will be consistent. However, the volume group will still be inconsistent -
|
will be consistent. However, the volume group will still be inconsistent -
|
||||||
due to the refernced-but-missing device/PV - and operations will still be
|
due to the refernced-but-missing device/PV - and operations will still be
|
||||||
restricted to the aformentioned actions until either the device is
|
restricted to the aforementioned actions until either the device is
|
||||||
restored or 'vgreduce --removemissing' is run.
|
restored or 'vgreduce --removemissing' is run.
|
||||||
|
|
||||||
Device Revival (transient failures):
|
Device Revival (transient failures):
|
||||||
@ -135,9 +135,9 @@ If a mirror is not 'in-sync', a read failure will produce an I/O error.
|
|||||||
This error will propagate all the way up to the applications above the
|
This error will propagate all the way up to the applications above the
|
||||||
logical volume (e.g. the file system). No automatic intervention will
|
logical volume (e.g. the file system). No automatic intervention will
|
||||||
take place in this case either. It is up to the user to decide what
|
take place in this case either. It is up to the user to decide what
|
||||||
can be done/salvaged in this senario. If the user is confident that the
|
can be done/salvaged in this scenario. If the user is confident that the
|
||||||
images of the mirror are the same (or they are willing to simply attempt
|
images of the mirror are the same (or they are willing to simply attempt
|
||||||
to retreive whatever data they can), 'lvconvert' can be used to eliminate
|
to retrieve whatever data they can), 'lvconvert' can be used to eliminate
|
||||||
the failed image and proceed.
|
the failed image and proceed.
|
||||||
|
|
||||||
Mirror resynchronization errors:
|
Mirror resynchronization errors:
|
||||||
@ -191,11 +191,11 @@ command are set in the LVM configuration file. They are:
|
|||||||
3-way mirror fails, the mirror will be converted to a 2-way mirror.
|
3-way mirror fails, the mirror will be converted to a 2-way mirror.
|
||||||
The "allocate" policy takes the further action of trying to replace
|
The "allocate" policy takes the further action of trying to replace
|
||||||
the failed image using space that is available in the volume group.
|
the failed image using space that is available in the volume group.
|
||||||
Replacing a failed mirror image will incure the cost of
|
Replacing a failed mirror image will incur the cost of
|
||||||
resynchronizing - degrading the performance of the mirror. The
|
resynchronizing - degrading the performance of the mirror. The
|
||||||
default policy for handling an image failure is "remove". This
|
default policy for handling an image failure is "remove". This
|
||||||
allows the mirror to still function, but gives the administrator the
|
allows the mirror to still function, but gives the administrator the
|
||||||
choice of when to incure the extra performance costs of replacing
|
choice of when to incur the extra performance costs of replacing
|
||||||
the failed image.
|
the failed image.
|
||||||
|
|
||||||
RAID logical volume device failures are handled differently from the "mirror"
|
RAID logical volume device failures are handled differently from the "mirror"
|
||||||
|
@ -63,7 +63,7 @@ classical snapshot merge, thin snapshot merge.
|
|||||||
|
|
||||||
The second store is suited only for pvmove --abort operations in-progress. Both
|
The second store is suited only for pvmove --abort operations in-progress. Both
|
||||||
stores are independent and identical LVs (pvmove /dev/sda3 and pvmove --abort /dev/sda3)
|
stores are independent and identical LVs (pvmove /dev/sda3 and pvmove --abort /dev/sda3)
|
||||||
can be run concurently from lvmpolld point of view (on lvm2 side the consistency is
|
can be run concurrently from lvmpolld point of view (on lvm2 side the consistency is
|
||||||
guaranteed by lvm2 locking mechanism).
|
guaranteed by lvm2 locking mechanism).
|
||||||
|
|
||||||
Locking order
|
Locking order
|
||||||
|
@ -126,7 +126,7 @@ Usage Examples
|
|||||||
followed by 'vgchange -ay vg2'
|
followed by 'vgchange -ay vg2'
|
||||||
|
|
||||||
|
|
||||||
Option (ii) - localised admin & configuation
|
Option (ii) - localised admin & configuration
|
||||||
(i.e. each host holds *locally* which classes of volumes to activate)
|
(i.e. each host holds *locally* which classes of volumes to activate)
|
||||||
# Add @database tag to vg1's metadata
|
# Add @database tag to vg1's metadata
|
||||||
vgchange --addtag @database vg1
|
vgchange --addtag @database vg1
|
||||||
|
@ -35,7 +35,7 @@ VGs from PVs as they appear, and at the same time collect information on what is
|
|||||||
already available. A command, pvscan --cache is expected to be used to
|
already available. A command, pvscan --cache is expected to be used to
|
||||||
implement udev rules. It is relatively easy to make this command print out a
|
implement udev rules. It is relatively easy to make this command print out a
|
||||||
list of VGs (and possibly LVs) that have been made available by adding any
|
list of VGs (and possibly LVs) that have been made available by adding any
|
||||||
particular device to the set of visible devices. In othe words, udev says "hey,
|
particular device to the set of visible devices. In other words, udev says "hey,
|
||||||
/dev/sdb just appeared", calls pvscan --cache, which talks to lvmetad, which
|
/dev/sdb just appeared", calls pvscan --cache, which talks to lvmetad, which
|
||||||
says "cool, that makes vg0 complete". Pvscan takes this info and prints it out,
|
says "cool, that makes vg0 complete". Pvscan takes this info and prints it out,
|
||||||
and the udev rule can then somehow decide whether anything needs to be done
|
and the udev rule can then somehow decide whether anything needs to be done
|
||||||
|
@ -262,7 +262,7 @@ endif
|
|||||||
# end of fPIC protection
|
# end of fPIC protection
|
||||||
endif
|
endif
|
||||||
|
|
||||||
# Combination of DEBUG_POOL and DEBUG_ENFORCE_POOL_LOCKING is not suppored.
|
# Combination of DEBUG_POOL and DEBUG_ENFORCE_POOL_LOCKING is not supported.
|
||||||
#DEFS += -DDEBUG_POOL
|
#DEFS += -DDEBUG_POOL
|
||||||
# Default pool locking is using the crc checksum. With mprotect memory
|
# Default pool locking is using the crc checksum. With mprotect memory
|
||||||
# enforcing compilation faulty memory write could be easily found.
|
# enforcing compilation faulty memory write could be easily found.
|
||||||
|
@ -301,7 +301,7 @@ ifeq ("@BUILD_DMEVENTD@", "yes")
|
|||||||
DMEVENT_LIBS = -L$(top_builddir)/daemons/dmeventd -ldevmapper-event -L$(interfacebuilddir) -ldevmapper
|
DMEVENT_LIBS = -L$(top_builddir)/daemons/dmeventd -ldevmapper-event -L$(interfacebuilddir) -ldevmapper
|
||||||
endif
|
endif
|
||||||
|
|
||||||
# Combination of DEBUG_POOL and DEBUG_ENFORCE_POOL_LOCKING is not suppored.
|
# Combination of DEBUG_POOL and DEBUG_ENFORCE_POOL_LOCKING is not supported.
|
||||||
#DEFS += -DDEBUG_POOL
|
#DEFS += -DDEBUG_POOL
|
||||||
# Default pool locking is using the crc checksum. With mprotect memory
|
# Default pool locking is using the crc checksum. With mprotect memory
|
||||||
# enforcing compilation faulty memory write could be easily found.
|
# enforcing compilation faulty memory write could be easily found.
|
||||||
|
@ -103,7 +103,7 @@ when it's been filled above configured threshold
|
|||||||
\fBactivation/thin_pool_autoextend_threshold\fP.
|
\fBactivation/thin_pool_autoextend_threshold\fP.
|
||||||
If the command fails, dmeventd thin plugin will keep
|
If the command fails, dmeventd thin plugin will keep
|
||||||
retrying execution with increasing time delay between
|
retrying execution with increasing time delay between
|
||||||
retries upto 42 minutes.
|
retries up to 42 minutes.
|
||||||
User may also configure external command to support more advanced
|
User may also configure external command to support more advanced
|
||||||
maintenance operations of a thin pool.
|
maintenance operations of a thin pool.
|
||||||
Such external command can e.g. remove some unneeded snapshots,
|
Such external command can e.g. remove some unneeded snapshots,
|
||||||
@ -133,7 +133,7 @@ when it's been filled above the configured threshold
|
|||||||
\fBactivation/vdo_pool_autoextend_threshold\fP.
|
\fBactivation/vdo_pool_autoextend_threshold\fP.
|
||||||
If the command fails, dmeventd vdo plugin will keep
|
If the command fails, dmeventd vdo plugin will keep
|
||||||
retrying execution with increasing time delay between
|
retrying execution with increasing time delay between
|
||||||
retries upto 42 minutes.
|
retries up to 42 minutes.
|
||||||
User may also configure external command to support more advanced
|
User may also configure external command to support more advanced
|
||||||
maintenance operations of a VDO pool.
|
maintenance operations of a VDO pool.
|
||||||
Such external command can e.g. remove some unneeded space
|
Such external command can e.g. remove some unneeded space
|
||||||
@ -166,7 +166,7 @@ actual usage of VDO pool data volume. Variable is not set when error event
|
|||||||
is processed.
|
is processed.
|
||||||
.TP
|
.TP
|
||||||
.B LVM_RUN_BY_DMEVENTD
|
.B LVM_RUN_BY_DMEVENTD
|
||||||
Variable is set by thin and vdo plugin to prohibit recursive interation
|
Variable is set by thin and vdo plugin to prohibit recursive interaction
|
||||||
with dmeventd by any executed lvm2 command from
|
with dmeventd by any executed lvm2 command from
|
||||||
a thin_command, vdo_command environment.
|
a thin_command, vdo_command environment.
|
||||||
.
|
.
|
||||||
|
@ -572,7 +572,7 @@ See below for more information on the table format.
|
|||||||
.B --udevcookie \fIcookie
|
.B --udevcookie \fIcookie
|
||||||
Use cookie for udev synchronisation.
|
Use cookie for udev synchronisation.
|
||||||
Note: Same cookie should be used for same type of operations i.e. creation of
|
Note: Same cookie should be used for same type of operations i.e. creation of
|
||||||
multiple different devices. It's not adviced to combine different
|
multiple different devices. It's not advised to combine different
|
||||||
operations on the single device.
|
operations on the single device.
|
||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
|
@ -292,7 +292,7 @@ region identifier.
|
|||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
.B --area
|
.B --area
|
||||||
When peforming a list or report, include objects of type area in the
|
When performing a list or report, include objects of type area in the
|
||||||
results.
|
results.
|
||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
@ -317,7 +317,7 @@ argument is zero reports will continue to repeat until interrupted.
|
|||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
.B --group
|
.B --group
|
||||||
When peforming a list or report, include objects of type group in the
|
When performing a list or report, include objects of type group in the
|
||||||
results.
|
results.
|
||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
@ -389,7 +389,7 @@ region as a comma separated list of latency values. Latency values are
|
|||||||
given in nanoseconds. An optional unit suffix of
|
given in nanoseconds. An optional unit suffix of
|
||||||
.BR ns , us , ms ,
|
.BR ns , us , ms ,
|
||||||
or \fBs\fP may be given after each value to specify units of
|
or \fBs\fP may be given after each value to specify units of
|
||||||
nanoseconds, microseconds, miliseconds or seconds respectively.
|
nanoseconds, microseconds, milliseconds or seconds respectively.
|
||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
.B --histogram
|
.B --histogram
|
||||||
@ -456,7 +456,7 @@ default program ID for dmstats-managed regions is "dmstats".
|
|||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
.B --region
|
.B --region
|
||||||
When peforming a list or report, include objects of type region in the
|
When performing a list or report, include objects of type region in the
|
||||||
results.
|
results.
|
||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
@ -530,7 +530,7 @@ Produce additional output.
|
|||||||
.HP
|
.HP
|
||||||
.CMD_CLEAR
|
.CMD_CLEAR
|
||||||
.br
|
.br
|
||||||
Instructs the kernel to clear statistics counters for the speficied
|
Instructs the kernel to clear statistics counters for the specified
|
||||||
regions (with the exception of in-flight IO counters).
|
regions (with the exception of in-flight IO counters).
|
||||||
.
|
.
|
||||||
.HP
|
.HP
|
||||||
@ -556,10 +556,10 @@ configured interval duration) on the final bin.
|
|||||||
.sp
|
.sp
|
||||||
Latencies are given in nanoseconds. An optional unit suffix of ns, us,
|
Latencies are given in nanoseconds. An optional unit suffix of ns, us,
|
||||||
ms, or s may be given after each value to specify units of nanoseconds,
|
ms, or s may be given after each value to specify units of nanoseconds,
|
||||||
microseconds, miliseconds or seconds respectively, so for example, 10ms
|
microseconds, milliseconds or seconds respectively, so for example, 10ms
|
||||||
is equivalent to 10000000. Latency values with a precision of less than
|
is equivalent to 10000000. Latency values with a precision of less than
|
||||||
one milisecond can only be used when precise timestamps are enabled: if
|
one millisecond can only be used when precise timestamps are enabled: if
|
||||||
\fB--precise\fP is not given and values less than one milisecond are
|
\fB--precise\fP is not given and values less than one millisecond are
|
||||||
used it will be enabled automatically.
|
used it will be enabled automatically.
|
||||||
.sp
|
.sp
|
||||||
An optional \fBprogram_id\fP or \fBuser_data\fP string may be associated
|
An optional \fBprogram_id\fP or \fBuser_data\fP string may be associated
|
||||||
@ -627,7 +627,7 @@ group.
|
|||||||
The list of regions to be grouped is specified with \fB--regions\fP
|
The list of regions to be grouped is specified with \fB--regions\fP
|
||||||
and an optional alias may be assigned with \fB--alias\fP. The set of
|
and an optional alias may be assigned with \fB--alias\fP. The set of
|
||||||
regions is given as a comma-separated list of region identifiers. A
|
regions is given as a comma-separated list of region identifiers. A
|
||||||
continuous range of identifers spanning from \fBR1\fP to \fBR2\fP may
|
continuous range of identifiers spanning from \fBR1\fP to \fBR2\fP may
|
||||||
be expressed as '\fBR1\fP-\fBR2\fP'.
|
be expressed as '\fBR1\fP-\fBR2\fP'.
|
||||||
.sp
|
.sp
|
||||||
Regions that have a histogram configured can be grouped: in this case
|
Regions that have a histogram configured can be grouped: in this case
|
||||||
@ -711,7 +711,7 @@ that were previously created with \fB--filemap\fP, either directly,
|
|||||||
or by starting the monitoring daemon, \fBdmfilemapd\fP.
|
or by starting the monitoring daemon, \fBdmfilemapd\fP.
|
||||||
.sp
|
.sp
|
||||||
This will add and remove regions to reflect changes in the allocated
|
This will add and remove regions to reflect changes in the allocated
|
||||||
extents of the file on-disk, since the time that it was crated or last
|
extents of the file on-disk, since the time that it was created or last
|
||||||
updated.
|
updated.
|
||||||
.sp
|
.sp
|
||||||
Use of this command is not normally needed since the \fBdmfilemapd\fP
|
Use of this command is not normally needed since the \fBdmfilemapd\fP
|
||||||
@ -1090,13 +1090,13 @@ bounds.
|
|||||||
.B hist_bounds
|
.B hist_bounds
|
||||||
A list of the histogram boundary values for the current statistics area
|
A list of the histogram boundary values for the current statistics area
|
||||||
in order of ascending latency value. The values are expressed in whole
|
in order of ascending latency value. The values are expressed in whole
|
||||||
units of seconds, miliseconds, microseconds or nanoseconds with a suffix
|
units of seconds, milliseconds, microseconds or nanoseconds with a suffix
|
||||||
indicating the unit.
|
indicating the unit.
|
||||||
.TP
|
.TP
|
||||||
.B hist_ranges
|
.B hist_ranges
|
||||||
A list of the histogram bin ranges for the current statistics area in
|
A list of the histogram bin ranges for the current statistics area in
|
||||||
order of ascending latency value. The values are expressed as
|
order of ascending latency value. The values are expressed as
|
||||||
"LOWER-UPPER" in whole units of seconds, miliseconds, microseconds or
|
"LOWER-UPPER" in whole units of seconds, milliseconds, microseconds or
|
||||||
nanoseconds with a suffix indicating the unit.
|
nanoseconds with a suffix indicating the unit.
|
||||||
.TP
|
.TP
|
||||||
.B hist_bins
|
.B hist_bins
|
||||||
|
@ -745,7 +745,7 @@ See \fBlvmraid\fP(7) for more information.
|
|||||||
.br
|
.br
|
||||||
Start (yes) or stop (no) monitoring an LV with dmeventd.
|
Start (yes) or stop (no) monitoring an LV with dmeventd.
|
||||||
dmeventd monitors kernel events for an LV, and performs
|
dmeventd monitors kernel events for an LV, and performs
|
||||||
automated maintenance for the LV in reponse to specific events.
|
automated maintenance for the LV in response to specific events.
|
||||||
See \fBdmeventd\fP(8) for more information.
|
See \fBdmeventd\fP(8) for more information.
|
||||||
.
|
.
|
||||||
.HP
|
.HP
|
||||||
|
@ -23,7 +23,7 @@ The
|
|||||||
type is equivalent to the
|
type is equivalent to the
|
||||||
.B striped
|
.B striped
|
||||||
type when one stripe exists.
|
type when one stripe exists.
|
||||||
In that case, the types can sometimes be used interchangably.
|
In that case, the types can sometimes be used interchangeably.
|
||||||
.P
|
.P
|
||||||
In most cases, the
|
In most cases, the
|
||||||
.B mirror
|
.B mirror
|
||||||
|
@ -196,7 +196,7 @@ The
|
|||||||
type is equivalent to the
|
type is equivalent to the
|
||||||
.B striped
|
.B striped
|
||||||
type when one stripe exists.
|
type when one stripe exists.
|
||||||
In that case, the types can sometimes be used interchangably.
|
In that case, the types can sometimes be used interchangeably.
|
||||||
.P
|
.P
|
||||||
In most cases, the
|
In most cases, the
|
||||||
.B mirror
|
.B mirror
|
||||||
|
@ -1176,7 +1176,7 @@ See \fBlvmraid\fP(7) for more information.
|
|||||||
.br
|
.br
|
||||||
Start (yes) or stop (no) monitoring an LV with dmeventd.
|
Start (yes) or stop (no) monitoring an LV with dmeventd.
|
||||||
dmeventd monitors kernel events for an LV, and performs
|
dmeventd monitors kernel events for an LV, and performs
|
||||||
automated maintenance for the LV in reponse to specific events.
|
automated maintenance for the LV in response to specific events.
|
||||||
See \fBdmeventd\fP(8) for more information.
|
See \fBdmeventd\fP(8) for more information.
|
||||||
.
|
.
|
||||||
.HP
|
.HP
|
||||||
|
@ -73,7 +73,7 @@ using dm-writecache (with cachevol):
|
|||||||
.P
|
.P
|
||||||
# lvconvert --type writecache --cachevol fast vg/main
|
# lvconvert --type writecache --cachevol fast vg/main
|
||||||
.P
|
.P
|
||||||
For more alteratives see:
|
For more alternatives see:
|
||||||
.br
|
.br
|
||||||
dm-cache command shortcut
|
dm-cache command shortcut
|
||||||
.br
|
.br
|
||||||
@ -252,7 +252,7 @@ when selecting the writecache cachevol size and the writecache block size.
|
|||||||
.P
|
.P
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
writecache block size 4096: each 100 GiB of writecache cachevol uses
|
writecache block size 4096: each 100 GiB of writecache cachevol uses
|
||||||
slighly over 2 GiB of system memory.
|
slightly over 2 GiB of system memory.
|
||||||
.IP \[bu] 2
|
.IP \[bu] 2
|
||||||
writecache block size 512: each 100 GiB of writecache cachevol uses
|
writecache block size 512: each 100 GiB of writecache cachevol uses
|
||||||
a little over 16 GiB of system memory.
|
a little over 16 GiB of system memory.
|
||||||
@ -311,11 +311,11 @@ read requests.
|
|||||||
.TP
|
.TP
|
||||||
autocommit_blocks = <count>
|
autocommit_blocks = <count>
|
||||||
When the application writes this amount of blocks without issuing the
|
When the application writes this amount of blocks without issuing the
|
||||||
FLUSH request, the blocks are automatically commited.
|
FLUSH request, the blocks are automatically committed.
|
||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
autocommit_time = <milliseconds>
|
autocommit_time = <milliseconds>
|
||||||
The data is automatically commited if this time passes and no FLUSH
|
The data is automatically committed if this time passes and no FLUSH
|
||||||
request is received.
|
request is received.
|
||||||
.
|
.
|
||||||
.TP
|
.TP
|
||||||
@ -478,7 +478,7 @@ cache, in which small reads and writes cause large sections of an LV to be
|
|||||||
stored in the cache. It can also require increasing migration threshold
|
stored in the cache. It can also require increasing migration threshold
|
||||||
which defaults to 2048 sectors (1 MiB). Lvm2 ensures migration threshold is
|
which defaults to 2048 sectors (1 MiB). Lvm2 ensures migration threshold is
|
||||||
at least 8 chunks in size. This may in some cases result in very
|
at least 8 chunks in size. This may in some cases result in very
|
||||||
high bandwidth load of transfering data between the cache LV and its
|
high bandwidth load of transferring data between the cache LV and its
|
||||||
cache origin LV. However, choosing a chunk size that is too small
|
cache origin LV. However, choosing a chunk size that is too small
|
||||||
can result in more overhead trying to manage the numerous chunks that
|
can result in more overhead trying to manage the numerous chunks that
|
||||||
become mapped into the cache. Overhead can include both excessive CPU
|
become mapped into the cache. Overhead can include both excessive CPU
|
||||||
|
@ -96,7 +96,7 @@ is used for loop devices, the backing file name repored by sysfs.
|
|||||||
the device name is used if no other type applies.
|
the device name is used if no other type applies.
|
||||||
.P
|
.P
|
||||||
|
|
||||||
The default choice for device ID type can be overriden using lvmdevices
|
The default choice for device ID type can be overridden using lvmdevices
|
||||||
--addev --deviceidtype <type>. If the specified type is available for the
|
--addev --deviceidtype <type>. If the specified type is available for the
|
||||||
device it will be used, otherwise the device will be added using the type
|
device it will be used, otherwise the device will be added using the type
|
||||||
that would otherwise be chosen.
|
that would otherwise be chosen.
|
||||||
|
@ -163,7 +163,7 @@ is used for loop devices, the backing file name repored by sysfs.
|
|||||||
the device name is used if no other type applies.
|
the device name is used if no other type applies.
|
||||||
.P
|
.P
|
||||||
|
|
||||||
The default choice for device ID type can be overriden using lvmdevices
|
The default choice for device ID type can be overridden using lvmdevices
|
||||||
--addev --deviceidtype <type>. If the specified type is available for the
|
--addev --deviceidtype <type>. If the specified type is available for the
|
||||||
device it will be used, otherwise the device will be added using the type
|
device it will be used, otherwise the device will be added using the type
|
||||||
that would otherwise be chosen.
|
that would otherwise be chosen.
|
||||||
|
@ -1197,7 +1197,7 @@ But let's still use the original "," character for list_item_separator
|
|||||||
for subsequent examples.
|
for subsequent examples.
|
||||||
.P
|
.P
|
||||||
Format for any of time values displayed in reports can be configured with
|
Format for any of time values displayed in reports can be configured with
|
||||||
\fBreport/time_format\fP configuretion setting. By default complete date
|
\fBreport/time_format\fP configuration setting. By default complete date
|
||||||
and time is displayed, including timezone.
|
and time is displayed, including timezone.
|
||||||
.P
|
.P
|
||||||
.nf
|
.nf
|
||||||
@ -1302,11 +1302,11 @@ binary_values_as_numeric=1
|
|||||||
.SS Changing output format
|
.SS Changing output format
|
||||||
.
|
.
|
||||||
LVM can output reports in different formats - use \fBreport/output_format\fP
|
LVM can output reports in different formats - use \fBreport/output_format\fP
|
||||||
configuration setting (or \fB--reportformat\fP command line option) to swith
|
configuration setting (or \fB--reportformat\fP command line option) to switch
|
||||||
the report output format.
|
the report output format.
|
||||||
|
|
||||||
.P
|
.P
|
||||||
Currently, LVM supports these outpout formats:
|
Currently, LVM supports these output formats:
|
||||||
.RS
|
.RS
|
||||||
- \fB"basic"\fP (all the examples we used above used this format),
|
- \fB"basic"\fP (all the examples we used above used this format),
|
||||||
.br
|
.br
|
||||||
|
@ -1,6 +1,6 @@
|
|||||||
vgcfgrestore restores the metadata of a VG from a text back up file
|
vgcfgrestore restores the metadata of a VG from a text back up file
|
||||||
produced by \fBvgcfgbackup\fP. This writes VG metadata onto the devices
|
produced by \fBvgcfgbackup\fP. This writes VG metadata onto the devices
|
||||||
specifed in back up file.
|
specified in back up file.
|
||||||
.P
|
.P
|
||||||
A back up file can be specified with \fB--file\fP. If no backup file is
|
A back up file can be specified with \fB--file\fP. If no backup file is
|
||||||
specified, the most recent one is used. Use \fB--list\fP for a list of
|
specified, the most recent one is used. Use \fB--list\fP for a list of
|
||||||
|
@ -63,7 +63,7 @@ vgcfgrestore \(em Restore volume group configuration
|
|||||||
.
|
.
|
||||||
vgcfgrestore restores the metadata of a VG from a text back up file
|
vgcfgrestore restores the metadata of a VG from a text back up file
|
||||||
produced by \fBvgcfgbackup\fP. This writes VG metadata onto the devices
|
produced by \fBvgcfgbackup\fP. This writes VG metadata onto the devices
|
||||||
specifed in back up file.
|
specified in back up file.
|
||||||
.P
|
.P
|
||||||
A back up file can be specified with \fB--file\fP. If no backup file is
|
A back up file can be specified with \fB--file\fP. If no backup file is
|
||||||
specified, the most recent one is used. Use \fB--list\fP for a list of
|
specified, the most recent one is used. Use \fB--list\fP for a list of
|
||||||
|
@ -684,7 +684,7 @@ See \fBlvm.conf\fP(5) for more information about profiles.
|
|||||||
.br
|
.br
|
||||||
Start (yes) or stop (no) monitoring an LV with dmeventd.
|
Start (yes) or stop (no) monitoring an LV with dmeventd.
|
||||||
dmeventd monitors kernel events for an LV, and performs
|
dmeventd monitors kernel events for an LV, and performs
|
||||||
automated maintenance for the LV in reponse to specific events.
|
automated maintenance for the LV in response to specific events.
|
||||||
See \fBdmeventd\fP(8) for more information.
|
See \fBdmeventd\fP(8) for more information.
|
||||||
.
|
.
|
||||||
.HP
|
.HP
|
||||||
|
@ -87,7 +87,7 @@ LABEL="systemd_background"
|
|||||||
#
|
#
|
||||||
# In this case, we simply set up the dependency between the device and the pvscan
|
# In this case, we simply set up the dependency between the device and the pvscan
|
||||||
# job using SYSTEMD_ALIAS (which sets up a simplified device identifier that
|
# job using SYSTEMD_ALIAS (which sets up a simplified device identifier that
|
||||||
# allows using "BindsTo" in the sytemd unit file) and SYSTEMD_WANTS (which tells
|
# allows using "BindsTo" in the systemd unit file) and SYSTEMD_WANTS (which tells
|
||||||
# systemd to start the pvscan job once the device is ready).
|
# systemd to start the pvscan job once the device is ready).
|
||||||
# We need to set these variables for both "add" and "change" events, otherwise
|
# We need to set these variables for both "add" and "change" events, otherwise
|
||||||
# systemd may loose information about the device/unit dependencies.
|
# systemd may loose information about the device/unit dependencies.
|
||||||
|
Loading…
Reference in New Issue
Block a user