Subversion Repositories configs

Rev

Rev 193 | Rev 203 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
192 - 1
# This is an example configuration file for the LVM2 system.
2
# It contains the default settings that would be used if there was no
3
# /etc/lvm/lvm.conf file.
4
#
5
# Refer to 'man lvm.conf' for further information including the file layout.
6
#
7
# Refer to 'man lvm.conf' for information about how settings configured in
8
# this file are combined with built-in values and command line options to
9
# arrive at the final values used by LVM.
10
#
11
# Refer to 'man lvmconfig' for information about displaying the built-in
12
# and configured values used by LVM.
13
#
14
# If a default value is set in this file (not commented out), then a
15
# new version of LVM using this file will continue using that value,
16
# even if the new version of LVM changes the built-in default value.
17
#
18
# To put this file in a different directory and override /etc/lvm set
19
# the environment variable LVM_SYSTEM_DIR before running the tools.
20
#
21
# N.B. Take care that each setting only appears once if uncommenting
22
# example settings in this file.
23
 
24
 
25
# Configuration section config.
26
# How LVM configuration settings are handled.
27
config {
28
 
29
	# Configuration option config/checks.
30
	# If enabled, any LVM configuration mismatch is reported.
31
	# This implies checking that the configuration key is understood by
32
	# LVM and that the value of the key is the proper type. If disabled,
33
	# any configuration mismatch is ignored and the default value is used
34
	# without any warning (a message about the configuration key not being
35
	# found is issued in verbose mode only).
36
	checks = 1
37
 
38
	# Configuration option config/abort_on_errors.
39
	# Abort the LVM process if a configuration mismatch is found.
40
	abort_on_errors = 0
41
 
42
	# Configuration option config/profile_dir.
43
	# Directory where LVM looks for configuration profiles.
44
	profile_dir = "/etc/lvm/profile"
45
}
46
 
47
# Configuration section devices.
48
# How LVM uses block devices.
49
devices {
50
 
51
	# Configuration option devices/dir.
52
	# Directory in which to create volume group device nodes.
53
	# Commands also accept this as a prefix on volume group names.
54
	# This configuration option is advanced.
55
	dir = "/dev"
56
 
57
	# Configuration option devices/scan.
58
	# Directories containing device nodes to use with LVM.
59
	# This configuration option is advanced.
60
	scan = [ "/dev" ]
61
 
62
	# Configuration option devices/obtain_device_list_from_udev.
63
	# Obtain the list of available devices from udev.
64
	# This avoids opening or using any inapplicable non-block devices or
65
	# subdirectories found in the udev directory. Any device node or
66
	# symlink not managed by udev in the udev directory is ignored. This
67
	# setting applies only to the udev-managed device directory; other
68
	# directories will be scanned fully. LVM needs to be compiled with
69
	# udev support for this setting to apply.
70
	obtain_device_list_from_udev = 1
71
 
72
	# Configuration option devices/external_device_info_source.
73
	# Select an external device information source.
74
	# Some information may already be available in the system and LVM can
75
	# use this information to determine the exact type or use of devices it
76
	# processes. Using an existing external device information source can
77
	# speed up device processing as LVM does not need to run its own native
78
	# routines to acquire this information. For example, this information
79
	# is used to drive LVM filtering like MD component detection, multipath
80
	# component detection, partition detection and others.
81
	#
82
	# Accepted values:
83
	#   none
84
	#     No external device information source is used.
85
	#   udev
86
	#     Reuse existing udev database records. Applicable only if LVM is
87
	#     compiled with udev support.
88
	#
89
	external_device_info_source = "none"
90
 
91
	# Configuration option devices/hints.
92
	# Use a local file to remember which devices have PVs on them.
93
	# Some commands will use this as an optimization to reduce device
94
	# scanning, and will only scan the listed PVs. Removing the hint file
95
	# will cause lvm to generate a new one. Disable hints if PVs will
96
	# be copied onto devices using non-lvm commands, like dd.
97
	#
98
	# Accepted values:
99
	#   all
100
	#     Use all hints.
101
	#   none
102
	#     Use no hints.
103
	#
104
	# This configuration option has an automatic default value.
105
	# hints = "all"
106
 
107
	# Configuration option devices/preferred_names.
108
	# Select which path name to display for a block device.
109
	# If multiple path names exist for a block device, and LVM needs to
110
	# display a name for the device, the path names are matched against
111
	# each item in this list of regular expressions. The first match is
112
	# used. Try to avoid using undescriptive /dev/dm-N names, if present.
113
	# If no preferred name matches, or if preferred_names are not defined,
114
	# the following built-in preferences are applied in order until one
115
	# produces a preferred name:
116
	# Prefer names with path prefixes in the order of:
117
	# /dev/mapper, /dev/disk, /dev/dm-*, /dev/block.
118
	# Prefer the name with the least number of slashes.
119
	# Prefer a name that is a symlink.
120
	# Prefer the path with least value in lexicographical order.
121
	#
122
	# Example
123
	# preferred_names = [ "^/dev/mpath/", "^/dev/mapper/mpath", "^/dev/[hs]d" ]
124
	#
125
	# This configuration option has an automatic default value.
126
	# preferred_names = [ "^/dev/mpath/", "^/dev/mapper/mpath", "^/dev/[hs]d" ]
127
 
128
	# Configuration option devices/filter.
129
	# Limit the block devices that are used by LVM commands.
130
	# This is a list of regular expressions used to accept or reject block
131
	# device path names. Each regex is delimited by a vertical bar '|'
132
	# (or any character) and is preceded by 'a' to accept the path, or
133
	# by 'r' to reject the path. The first regex in the list to match the
134
	# path is used, producing the 'a' or 'r' result for the device.
135
	# When multiple path names exist for a block device, if any path name
136
	# matches an 'a' pattern before an 'r' pattern, then the device is
137
	# accepted. If all the path names match an 'r' pattern first, then the
138
	# device is rejected. Unmatching path names do not affect the accept
139
	# or reject decision. If no path names for a device match a pattern,
140
	# then the device is accepted. Be careful mixing 'a' and 'r' patterns,
141
	# as the combination might produce unexpected results (test changes.)
142
	# Run vgscan after changing the filter to regenerate the cache.
143
	#
144
	# Example
145
	# Accept every block device:
146
	# filter = [ "a|.*|" ]
147
	# Reject the cdrom drive:
148
	# filter = [ "r|/dev/cdrom|" ]
149
	# Work with just loopback devices, e.g. for testing:
150
	# filter = [ "a|loop|", "r|.*|" ]
151
	# Accept all loop devices and ide drives except hdc:
152
	# filter = [ "a|loop|", "r|/dev/hdc|", "a|/dev/ide|", "r|.*|" ]
153
	# Use anchors to be very specific:
154
	# filter = [ "a|^/dev/hda8$|", "r|.*|" ]
155
	#
156
	# This configuration option has an automatic default value.
157
	# filter = [ "a|.*|" ]
158
 
159
	# Configuration option devices/global_filter.
160
	# Limit the block devices that are used by LVM system components.
161
	# Because devices/filter may be overridden from the command line, it is
162
	# not suitable for system-wide device filtering, e.g. udev.
163
	# Use global_filter to hide devices from these LVM system components.
164
	# The syntax is the same as devices/filter. Devices rejected by
165
	# global_filter are not opened by LVM.
166
	# This configuration option has an automatic default value.
167
	# global_filter = [ "a|.*|" ]
168
 
169
	# Configuration option devices/types.
170
	# List of additional acceptable block device types.
171
	# These are of device type names from /proc/devices, followed by the
172
	# maximum number of partitions.
173
	#
174
	# Example
175
	# types = [ "fd", 16 ]
176
	#
177
	# This configuration option is advanced.
178
	# This configuration option does not have a default value defined.
179
 
180
	# Configuration option devices/sysfs_scan.
181
	# Restrict device scanning to block devices appearing in sysfs.
182
	# This is a quick way of filtering out block devices that are not
183
	# present on the system. sysfs must be part of the kernel and mounted.)
184
	sysfs_scan = 1
185
 
186
	# Configuration option devices/scan_lvs.
187
	# Scan LVM LVs for layered PVs, allowing LVs to be used as PVs.
188
	# When 1, LVM will detect PVs layered on LVs, and caution must be
189
	# taken to avoid a host accessing a layered VG that may not belong
190
	# to it, e.g. from a guest image. This generally requires excluding
191
	# the LVs with device filters. Also, when this setting is enabled,
192
	# every LVM command will scan every active LV on the system (unless
193
	# filtered), which can cause performance problems on systems with
194
	# many active LVs. When this setting is 0, LVM will not detect or
195
	# use PVs that exist on LVs, and will not allow a PV to be created on
196
	# an LV. The LVs are ignored using a built in device filter that
197
	# identifies and excludes LVs.
198
	scan_lvs = 0
199
 
200
	# Configuration option devices/multipath_component_detection.
201
	# Ignore devices that are components of DM multipath devices.
202
	multipath_component_detection = 1
203
 
204
	# Configuration option devices/md_component_detection.
205
	# Enable detection and exclusion of MD component devices.
206
	# An MD component device is a block device that MD uses as part
207
	# of a software RAID virtual device. When an LVM PV is created
208
	# on an MD device, LVM must only use the top level MD device as
209
	# the PV, and should ignore the underlying component devices.
210
	# In cases where the MD superblock is located at the end of the
211
	# component devices, it is more difficult for LVM to consistently
212
	# identify an MD component, see the md_component_checks setting.
213
	md_component_detection = 1
214
 
215
	# Configuration option devices/md_component_checks.
216
	# The checks LVM should use to detect MD component devices.
217
	# MD component devices are block devices used by MD software RAID.
218
	#
219
	# Accepted values:
220
	#   auto
221
	#     LVM will skip scanning the end of devices when it has other
222
	#     indications that the device is not an MD component.
223
	#   start
224
	#     LVM will only scan the start of devices for MD superblocks.
225
	#     This does not incur extra I/O by LVM.
226
	#   full
227
	#     LVM will scan the start and end of devices for MD superblocks.
228
	#     This requires an extra read at the end of devices.
229
	#
230
	# This configuration option has an automatic default value.
231
	# md_component_checks = "auto"
232
 
233
	# Configuration option devices/fw_raid_component_detection.
234
	# Ignore devices that are components of firmware RAID devices.
235
	# LVM must use an external_device_info_source other than none for this
236
	# detection to execute.
237
	fw_raid_component_detection = 0
238
 
239
	# Configuration option devices/md_chunk_alignment.
240
	# Align the start of a PV data area with md device's stripe-width.
241
	# This applies if a PV is placed directly on an md device.
242
	# default_data_alignment will be overriden if it is not aligned
243
	# with the value detected for this setting.
244
	# This setting is overriden by data_alignment_detection,
245
	# data_alignment, and the --dataalignment option.
246
	md_chunk_alignment = 1
247
 
248
	# Configuration option devices/default_data_alignment.
249
	# Align the start of a PV data area with this number of MiB.
250
	# Set to 1 for 1MiB, 2 for 2MiB, etc. Set to 0 to disable.
251
	# This setting is overriden by data_alignment and the --dataalignment
252
	# option.
253
	# This configuration option has an automatic default value.
254
	# default_data_alignment = 1
255
 
256
	# Configuration option devices/data_alignment_detection.
257
	# Align the start of a PV data area with sysfs io properties.
258
	# The start of a PV data area will be a multiple of minimum_io_size or
259
	# optimal_io_size exposed in sysfs. minimum_io_size is the smallest
260
	# request the device can perform without incurring a read-modify-write
261
	# penalty, e.g. MD chunk size. optimal_io_size is the device's
262
	# preferred unit of receiving I/O, e.g. MD stripe width.
263
	# minimum_io_size is used if optimal_io_size is undefined (0).
264
	# If md_chunk_alignment is enabled, that detects the optimal_io_size.
265
	# default_data_alignment and md_chunk_alignment will be overriden
266
	# if they are not aligned with the value detected for this setting.
267
	# This setting is overriden by data_alignment and the --dataalignment
268
	# option.
269
	data_alignment_detection = 1
270
 
271
	# Configuration option devices/data_alignment.
272
	# Align the start of a PV data area with this number of KiB.
273
	# When non-zero, this setting overrides default_data_alignment.
274
	# Set to 0 to disable, in which case default_data_alignment
275
	# is used to align the first PE in units of MiB.
276
	# This setting is overriden by the --dataalignment option.
277
	data_alignment = 0
278
 
279
	# Configuration option devices/data_alignment_offset_detection.
280
	# Shift the start of an aligned PV data area based on sysfs information.
281
	# After a PV data area is aligned, it will be shifted by the
282
	# alignment_offset exposed in sysfs. This offset is often 0, but may
283
	# be non-zero. Certain 4KiB sector drives that compensate for windows
284
	# partitioning will have an alignment_offset of 3584 bytes (sector 7
285
	# is the lowest aligned logical block, the 4KiB sectors start at
286
	# LBA -1, and consequently sector 63 is aligned on a 4KiB boundary).
287
	# This setting is overriden by the --dataalignmentoffset option.
288
	data_alignment_offset_detection = 1
289
 
290
	# Configuration option devices/ignore_suspended_devices.
291
	# Ignore DM devices that have I/O suspended while scanning devices.
292
	# Otherwise, LVM waits for a suspended device to become accessible.
293
	# This should only be needed in recovery situations.
294
	ignore_suspended_devices = 0
295
 
296
	# Configuration option devices/ignore_lvm_mirrors.
297
	# Do not scan 'mirror' LVs to avoid possible deadlocks.
298
	# This avoids possible deadlocks when using the 'mirror' segment type.
299
	# This setting determines whether LVs using the 'mirror' segment type
300
	# are scanned for LVM labels. This affects the ability of mirrors to
301
	# be used as physical volumes. If this setting is enabled, it is
302
	# impossible to create VGs on top of mirror LVs, i.e. to stack VGs on
303
	# mirror LVs. If this setting is disabled, allowing mirror LVs to be
304
	# scanned, it may cause LVM processes and I/O to the mirror to become
305
	# blocked. This is due to the way that the mirror segment type handles
306
	# failures. In order for the hang to occur, an LVM command must be run
307
	# just after a failure and before the automatic LVM repair process
308
	# takes place, or there must be failures in multiple mirrors in the
309
	# same VG at the same time with write failures occurring moments before
310
	# a scan of the mirror's labels. The 'mirror' scanning problems do not
311
	# apply to LVM RAID types like 'raid1' which handle failures in a
312
	# different way, making them a better choice for VG stacking.
313
	ignore_lvm_mirrors = 1
314
 
315
	# Configuration option devices/require_restorefile_with_uuid.
316
	# Allow use of pvcreate --uuid without requiring --restorefile.
317
	require_restorefile_with_uuid = 1
318
 
319
	# Configuration option devices/pv_min_size.
320
	# Minimum size in KiB of block devices which can be used as PVs.
321
	# In a clustered environment all nodes must use the same value.
322
	# Any value smaller than 512KiB is ignored. The previous built-in
323
	# value was 512.
324
	pv_min_size = 2048
325
 
326
	# Configuration option devices/issue_discards.
327
	# Issue discards to PVs that are no longer used by an LV.
328
	# Discards are sent to an LV's underlying physical volumes when the LV
329
	# is no longer using the physical volumes' space, e.g. lvremove,
330
	# lvreduce. Discards inform the storage that a region is no longer
331
	# used. Storage that supports discards advertise the protocol-specific
332
	# way discards should be issued by the kernel (TRIM, UNMAP, or
333
	# WRITE SAME with UNMAP bit set). Not all storage will support or
334
	# benefit from discards, but SSDs and thinly provisioned LUNs
335
	# generally do. If enabled, discards will only be issued if both the
336
	# storage and kernel provide support.
337
	issue_discards = 0
338
 
339
	# Configuration option devices/allow_changes_with_duplicate_pvs.
340
	# Allow VG modification while a PV appears on multiple devices.
341
	# When a PV appears on multiple devices, LVM attempts to choose the
342
	# best device to use for the PV. If the devices represent the same
343
	# underlying storage, the choice has minimal consequence. If the
344
	# devices represent different underlying storage, the wrong choice
345
	# can result in data loss if the VG is modified. Disabling this
346
	# setting is the safest option because it prevents modifying a VG
347
	# or activating LVs in it while a PV appears on multiple devices.
348
	# Enabling this setting allows the VG to be used as usual even with
349
	# uncertain devices.
350
	allow_changes_with_duplicate_pvs = 0
351
 
352
	# Configuration option devices/allow_mixed_block_sizes.
353
	# Allow PVs in the same VG with different logical block sizes.
354
	# When allowed, the user is responsible to ensure that an LV is
355
	# using PVs with matching block sizes when necessary.
356
	allow_mixed_block_sizes = 0
357
}
358
 
359
# Configuration section allocation.
360
# How LVM selects space and applies properties to LVs.
361
allocation {
362
 
363
	# Configuration option allocation/cling_tag_list.
364
	# Advise LVM which PVs to use when searching for new space.
365
	# When searching for free space to extend an LV, the 'cling' allocation
366
	# policy will choose space on the same PVs as the last segment of the
367
	# existing LV. If there is insufficient space and a list of tags is
368
	# defined here, it will check whether any of them are attached to the
369
	# PVs concerned and then seek to match those PV tags between existing
370
	# extents and new extents.
371
	#
372
	# Example
373
	# Use the special tag "@*" as a wildcard to match any PV tag:
374
	# cling_tag_list = [ "@*" ]
375
	# LVs are mirrored between two sites within a single VG, and
376
	# PVs are tagged with either @site1 or @site2 to indicate where
377
	# they are situated:
378
	# cling_tag_list = [ "@site1", "@site2" ]
379
	#
380
	# This configuration option does not have a default value defined.
381
 
382
	# Configuration option allocation/maximise_cling.
383
	# Use a previous allocation algorithm.
384
	# Changes made in version 2.02.85 extended the reach of the 'cling'
385
	# policies to detect more situations where data can be grouped onto
386
	# the same disks. This setting can be used to disable the changes
387
	# and revert to the previous algorithm.
388
	maximise_cling = 1
389
 
390
	# Configuration option allocation/use_blkid_wiping.
391
	# Use blkid to detect and erase existing signatures on new PVs and LVs.
392
	# The blkid library can detect more signatures than the native LVM
393
	# detection code, but may take longer. LVM needs to be compiled with
394
	# blkid wiping support for this setting to apply. LVM native detection
395
	# code is currently able to recognize: MD device signatures,
396
	# swap signature, and LUKS signatures. To see the list of signatures
397
	# recognized by blkid, check the output of the 'blkid -k' command.
398
	use_blkid_wiping = 1
399
 
400
	# Configuration option allocation/wipe_signatures_when_zeroing_new_lvs.
401
	# Look for and erase any signatures while zeroing a new LV.
402
	# The --wipesignatures option overrides this setting.
403
	# Zeroing is controlled by the -Z/--zero option, and if not specified,
404
	# zeroing is used by default if possible. Zeroing simply overwrites the
405
	# first 4KiB of a new LV with zeroes and does no signature detection or
406
	# wiping. Signature wiping goes beyond zeroing and detects exact types
407
	# and positions of signatures within the whole LV. It provides a
408
	# cleaner LV after creation as all known signatures are wiped. The LV
409
	# is not claimed incorrectly by other tools because of old signatures
410
	# from previous use. The number of signatures that LVM can detect
411
	# depends on the detection code that is selected (see
412
	# use_blkid_wiping.) Wiping each detected signature must be confirmed.
413
	# When this setting is disabled, signatures on new LVs are not detected
414
	# or erased unless the --wipesignatures option is used directly.
415
	wipe_signatures_when_zeroing_new_lvs = 1
416
 
417
	# Configuration option allocation/mirror_logs_require_separate_pvs.
418
	# Mirror logs and images will always use different PVs.
419
	# The default setting changed in version 2.02.85.
420
	mirror_logs_require_separate_pvs = 0
421
 
422
	# Configuration option allocation/raid_stripe_all_devices.
423
	# Stripe across all PVs when RAID stripes are not specified.
424
	# If enabled, all PVs in the VG or on the command line are used for
425
	# raid0/4/5/6/10 when the command does not specify the number of
426
	# stripes to use.
427
	# This was the default behaviour until release 2.02.162.
428
	# This configuration option has an automatic default value.
429
	# raid_stripe_all_devices = 0
430
 
431
	# Configuration option allocation/cache_pool_metadata_require_separate_pvs.
432
	# Cache pool metadata and data will always use different PVs.
433
	# This configuration option has an automatic default value.
434
	# cache_pool_metadata_require_separate_pvs = 0
435
 
436
	# Configuration option allocation/cache_metadata_format.
437
	# Sets default metadata format for new cache.
438
	#
439
	# Accepted values:
440
	#   0  Automatically detected best available format
441
	#   1  Original format
442
	#   2  Improved 2nd. generation format
443
	#
444
	# This configuration option has an automatic default value.
445
	# cache_metadata_format = 0
446
 
447
	# Configuration option allocation/cache_mode.
448
	# The default cache mode used for new cache.
449
	#
450
	# Accepted values:
451
	#   writethrough
452
	#     Data blocks are immediately written from the cache to disk.
453
	#   writeback
454
	#     Data blocks are written from the cache back to disk after some
455
	#     delay to improve performance.
456
	#
457
	# This setting replaces allocation/cache_pool_cachemode.
458
	# This configuration option has an automatic default value.
459
	# cache_mode = "writethrough"
460
 
461
	# Configuration option allocation/cache_policy.
462
	# The default cache policy used for new cache volume.
463
	# Since kernel 4.2 the default policy is smq (Stochastic multiqueue),
464
	# otherwise the older mq (Multiqueue) policy is selected.
465
	# This configuration option does not have a default value defined.
466
 
467
	# Configuration section allocation/cache_settings.
468
	# Settings for the cache policy.
469
	# See documentation for individual cache policies for more info.
470
	# This configuration section has an automatic default value.
471
	# cache_settings {
472
	# }
473
 
474
	# Configuration option allocation/cache_pool_chunk_size.
475
	# The minimal chunk size in KiB for cache pool volumes.
476
	# Using a chunk_size that is too large can result in wasteful use of
477
	# the cache, where small reads and writes can cause large sections of
478
	# an LV to be mapped into the cache. However, choosing a chunk_size
479
	# that is too small can result in more overhead trying to manage the
480
	# numerous chunks that become mapped into the cache. The former is
481
	# more of a problem than the latter in most cases, so the default is
482
	# on the smaller end of the spectrum. Supported values range from
483
	# 32KiB to 1GiB in multiples of 32.
484
	# This configuration option does not have a default value defined.
485
 
486
	# Configuration option allocation/cache_pool_max_chunks.
487
	# The maximum number of chunks in a cache pool.
488
	# For cache target v1.9 the recommended maximumm is 1000000 chunks.
489
	# Using cache pool with more chunks may degrade cache performance.
490
	# This configuration option does not have a default value defined.
491
 
492
	# Configuration option allocation/thin_pool_metadata_require_separate_pvs.
493
	# Thin pool metadata and data will always use different PVs.
494
	# This configuration option has an automatic default value.
495
	# thin_pool_metadata_require_separate_pvs = 0
496
 
200 - 497
	# Configuration option allocation/thin_pool_crop_metadata.
498
	# Older version of lvm2 cropped pool's metadata size to 15.81 GiB.
499
	# This is slightly less then the actual maximum 15.88 GiB.
500
	# For compatibility with older version and use of cropped size set to 1.
501
	# This configuration option has an automatic default value.
502
	# thin_pool_crop_metadata = 0
503
 
192 - 504
	# Configuration option allocation/thin_pool_zero.
505
	# Thin pool data chunks are zeroed before they are first used.
506
	# Zeroing with a larger thin pool chunk size reduces performance.
507
	# This configuration option has an automatic default value.
508
	# thin_pool_zero = 1
509
 
510
	# Configuration option allocation/thin_pool_discards.
511
	# The discards behaviour of thin pool volumes.
512
	#
513
	# Accepted values:
514
	#   ignore
515
	#   nopassdown
516
	#   passdown
517
	#
518
	# This configuration option has an automatic default value.
519
	# thin_pool_discards = "passdown"
520
 
521
	# Configuration option allocation/thin_pool_chunk_size_policy.
522
	# The chunk size calculation policy for thin pool volumes.
523
	#
524
	# Accepted values:
525
	#   generic
526
	#     If thin_pool_chunk_size is defined, use it. Otherwise, calculate
527
	#     the chunk size based on estimation and device hints exposed in
528
	#     sysfs - the minimum_io_size. The chunk size is always at least
529
	#     64KiB.
530
	#   performance
531
	#     If thin_pool_chunk_size is defined, use it. Otherwise, calculate
532
	#     the chunk size for performance based on device hints exposed in
533
	#     sysfs - the optimal_io_size. The chunk size is always at least
534
	#     512KiB.
535
	#
536
	# This configuration option has an automatic default value.
537
	# thin_pool_chunk_size_policy = "generic"
538
 
539
	# Configuration option allocation/zero_metadata.
540
	# Zero whole metadata area before use with thin or cache pool.
541
	# This configuration option has an automatic default value.
542
	# zero_metadata = 1
543
 
544
	# Configuration option allocation/thin_pool_chunk_size.
545
	# The minimal chunk size in KiB for thin pool volumes.
546
	# Larger chunk sizes may improve performance for plain thin volumes,
547
	# however using them for snapshot volumes is less efficient, as it
548
	# consumes more space and takes extra time for copying. When unset,
549
	# lvm tries to estimate chunk size starting from 64KiB. Supported
550
	# values are in the range 64KiB to 1GiB.
551
	# This configuration option does not have a default value defined.
552
 
553
	# Configuration option allocation/physical_extent_size.
554
	# Default physical extent size in KiB to use for new VGs.
555
	# This configuration option has an automatic default value.
556
	# physical_extent_size = 4096
557
 
558
	# Configuration option allocation/vdo_use_compression.
559
	# Enables or disables compression when creating a VDO volume.
560
	# Compression may be disabled if necessary to maximize performance
561
	# or to speed processing of data that is unlikely to compress.
562
	# This configuration option has an automatic default value.
563
	# vdo_use_compression = 1
564
 
565
	# Configuration option allocation/vdo_use_deduplication.
566
	# Enables or disables deduplication when creating a VDO volume.
567
	# Deduplication may be disabled in instances where data is not expected
568
	# to have good deduplication rates but compression is still desired.
569
	# This configuration option has an automatic default value.
570
	# vdo_use_deduplication = 1
571
 
572
	# Configuration option allocation/vdo_use_metadata_hints.
573
	# Enables or disables whether VDO volume should tag its latency-critical
574
	# writes with the REQ_SYNC flag. Some device mapper targets such as dm-raid5
575
	# process writes with this flag at a higher priority.
576
	# Default is enabled.
577
	# This configuration option has an automatic default value.
578
	# vdo_use_metadata_hints = 1
579
 
580
	# Configuration option allocation/vdo_minimum_io_size.
581
	# The minimum IO size for VDO volume to accept, in bytes.
582
	# Valid values are 512 or 4096. The recommended and default value is 4096.
583
	# This configuration option has an automatic default value.
584
	# vdo_minimum_io_size = 4096
585
 
586
	# Configuration option allocation/vdo_block_map_cache_size_mb.
587
	# Specifies the amount of memory in MiB allocated for caching block map
588
	# pages for VDO volume. The value must be a multiple of 4096 and must be
589
	# at least 128MiB and less than 16TiB. The cache must be at least 16MiB
590
	# per logical thread. Note that there is a memory overhead of 15%.
591
	# This configuration option has an automatic default value.
592
	# vdo_block_map_cache_size_mb = 128
593
 
594
	# Configuration option allocation/vdo_block_map_period.
595
	# The speed with which the block map cache writes out modified block map pages.
596
	# A smaller era length is likely to reduce the amount time spent rebuilding,
597
	# at the cost of increased block map writes during normal operation.
598
	# The maximum and recommended value is 16380; the minimum value is 1.
599
	# This configuration option has an automatic default value.
600
	# vdo_block_map_period = 16380
601
 
602
	# Configuration option allocation/vdo_check_point_frequency.
603
	# The default check point frequency for VDO volume.
604
	# This configuration option has an automatic default value.
605
	# vdo_check_point_frequency = 0
606
 
607
	# Configuration option allocation/vdo_use_sparse_index.
608
	# Enables sparse indexing for VDO volume.
609
	# This configuration option has an automatic default value.
610
	# vdo_use_sparse_index = 0
611
 
612
	# Configuration option allocation/vdo_index_memory_size_mb.
613
	# Specifies the amount of index memory in MiB for VDO volume.
614
	# The value must be at least 256MiB and at most 1TiB.
615
	# This configuration option has an automatic default value.
616
	# vdo_index_memory_size_mb = 256
617
 
618
	# Configuration option allocation/vdo_slab_size_mb.
619
	# Specifies the size in MiB of the increment by which a VDO is grown.
620
	# Using a smaller size constrains the total maximum physical size
621
	# that can be accommodated. Must be a power of two between 128MiB and 32GiB.
622
	# This configuration option has an automatic default value.
623
	# vdo_slab_size_mb = 2048
624
 
625
	# Configuration option allocation/vdo_ack_threads.
626
	# Specifies the number of threads to use for acknowledging
627
	# completion of requested VDO I/O operations.
628
	# The value must be at in range [0..100].
629
	# This configuration option has an automatic default value.
630
	# vdo_ack_threads = 1
631
 
632
	# Configuration option allocation/vdo_bio_threads.
633
	# Specifies the number of threads to use for submitting I/O
634
	# operations to the storage device of VDO volume.
635
	# The value must be in range [1..100]
636
	# Each additional thread after the first will use an additional 18MiB of RAM,
637
	# plus 1.12 MiB of RAM per megabyte of configured read cache size.
638
	# This configuration option has an automatic default value.
639
	# vdo_bio_threads = 4
640
 
641
	# Configuration option allocation/vdo_bio_rotation.
642
	# Specifies the number of I/O operations to enqueue for each bio-submission
643
	# thread before directing work to the next. The value must be in range [1..1024].
644
	# This configuration option has an automatic default value.
645
	# vdo_bio_rotation = 64
646
 
647
	# Configuration option allocation/vdo_cpu_threads.
648
	# Specifies the number of threads to use for CPU-intensive work such as
649
	# hashing or compression for VDO volume. The value must be in range [1..100]
650
	# This configuration option has an automatic default value.
651
	# vdo_cpu_threads = 2
652
 
653
	# Configuration option allocation/vdo_hash_zone_threads.
654
	# Specifies the number of threads across which to subdivide parts of the VDO
655
	# processing based on the hash value computed from the block data.
656
	# The value must be at in range [0..100].
657
	# vdo_hash_zone_threads, vdo_logical_threads and vdo_physical_threads must be
658
	# either all zero or all non-zero.
659
	# This configuration option has an automatic default value.
660
	# vdo_hash_zone_threads = 1
661
 
662
	# Configuration option allocation/vdo_logical_threads.
663
	# Specifies the number of threads across which to subdivide parts of the VDO
664
	# processing based on the hash value computed from the block data.
665
	# A logical thread count of 9 or more will require explicitly specifying
666
	# a sufficiently large block map cache size, as well.
667
	# The value must be in range [0..100].
668
	# vdo_hash_zone_threads, vdo_logical_threads and vdo_physical_threads must be
669
	# either all zero or all non-zero.
670
	# This configuration option has an automatic default value.
671
	# vdo_logical_threads = 1
672
 
673
	# Configuration option allocation/vdo_physical_threads.
674
	# Specifies the number of threads across which to subdivide parts of the VDO
675
	# processing based on physical block addresses.
676
	# Each additional thread after the first will use an additional 10MiB of RAM.
677
	# The value must be in range [0..16].
678
	# vdo_hash_zone_threads, vdo_logical_threads and vdo_physical_threads must be
679
	# either all zero or all non-zero.
680
	# This configuration option has an automatic default value.
681
	# vdo_physical_threads = 1
682
 
683
	# Configuration option allocation/vdo_write_policy.
684
	# Specifies the write policy:
685
	# auto  - VDO will check the storage device and determine whether it supports flushes.
686
	#         If it does, VDO will run in async mode, otherwise it will run in sync mode.
687
	# sync  - Writes are acknowledged only after data is stably written.
688
	#         This policy is not supported if the underlying storage is not also synchronous.
689
	# async - Writes are acknowledged after data has been cached for writing to stable storage.
690
	#         Data which has not been flushed is not guaranteed to persist in this mode.
691
	# This configuration option has an automatic default value.
692
	# vdo_write_policy = "auto"
693
 
694
	# Configuration option allocation/vdo_max_discard.
695
	# Specified te maximum size of discard bio accepted, in 4096 byte blocks.
696
	# I/O requests to a VDO volume are normally split into 4096-byte blocks,
697
	# and processed up to 2048 at a time. However, discard requests to a VDO volume
698
	# can be automatically split to a larger size, up to <max discard> 4096-byte blocks
699
	# in a single bio, and are limited to 1500 at a time.
700
	# Increasing this value may provide better overall performance, at the cost of
701
	# increased latency for the individual discard requests.
702
	# The default and minimum is 1. The maximum is UINT_MAX / 4096.
703
	# This configuration option has an automatic default value.
704
	# vdo_max_discard = 1
705
}
706
 
707
# Configuration section log.
708
# How LVM log information is reported.
709
log {
710
 
711
	# Configuration option log/report_command_log.
712
	# Enable or disable LVM log reporting.
713
	# If enabled, LVM will collect a log of operations, messages,
714
	# per-object return codes with object identification and associated
715
	# error numbers (errnos) during LVM command processing. Then the
716
	# log is either reported solely or in addition to any existing
717
	# reports, depending on LVM command used. If it is a reporting command
718
	# (e.g. pvs, vgs, lvs, lvm fullreport), then the log is reported in
719
	# addition to any existing reports. Otherwise, there's only log report
720
	# on output. For all applicable LVM commands, you can request that
721
	# the output has only log report by using --logonly command line
722
	# option. Use log/command_log_cols and log/command_log_sort settings
723
	# to define fields to display and sort fields for the log report.
724
	# You can also use log/command_log_selection to define selection
725
	# criteria used each time the log is reported.
726
	# This configuration option has an automatic default value.
727
	# report_command_log = 0
728
 
729
	# Configuration option log/command_log_sort.
730
	# List of columns to sort by when reporting command log.
731
	# See <lvm command> --logonly --configreport log -o help
732
	# for the list of possible fields.
733
	# This configuration option has an automatic default value.
734
	# command_log_sort = "log_seq_num"
735
 
736
	# Configuration option log/command_log_cols.
737
	# List of columns to report when reporting command log.
738
	# See <lvm command> --logonly --configreport log -o help
739
	# for the list of possible fields.
740
	# This configuration option has an automatic default value.
741
	# command_log_cols = "log_seq_num,log_type,log_context,log_object_type,log_object_name,log_object_id,log_object_group,log_object_group_id,log_message,log_errno,log_ret_code"
742
 
743
	# Configuration option log/command_log_selection.
744
	# Selection criteria used when reporting command log.
745
	# You can define selection criteria that are applied each
746
	# time log is reported. This way, it is possible to control the
747
	# amount of log that is displayed on output and you can select
748
	# only parts of the log that are important for you. To define
749
	# selection criteria, use fields from log report. See also
750
	# <lvm command> --logonly --configreport log -S help for the
751
	# list of possible fields and selection operators. You can also
752
	# define selection criteria for log report on command line directly
753
	# using <lvm command> --configreport log -S <selection criteria>
754
	# which has precedence over log/command_log_selection setting.
755
	# For more information about selection criteria in general, see
756
	# lvm(8) man page.
757
	# This configuration option has an automatic default value.
758
	# command_log_selection = "!(log_type=status && message=success)"
759
 
760
	# Configuration option log/verbose.
761
	# Controls the messages sent to stdout or stderr.
762
	verbose = 0
763
 
764
	# Configuration option log/silent.
765
	# Suppress all non-essential messages from stdout.
766
	# This has the same effect as -qq. When enabled, the following commands
767
	# still produce output: dumpconfig, lvdisplay, lvmdiskscan, lvs, pvck,
768
	# pvdisplay, pvs, version, vgcfgrestore -l, vgdisplay, vgs.
769
	# Non-essential messages are shifted from log level 4 to log level 5
770
	# for syslog and lvm2_log_fn purposes.
771
	# Any 'yes' or 'no' questions not overridden by other arguments are
772
	# suppressed and default to 'no'.
773
	silent = 0
774
 
775
	# Configuration option log/syslog.
776
	# Send log messages through syslog.
777
	syslog = 1
778
 
779
	# Configuration option log/file.
780
	# Write error and debug log messages to a file specified here.
781
	# This configuration option does not have a default value defined.
782
 
783
	# Configuration option log/overwrite.
784
	# Overwrite the log file each time the program is run.
785
	overwrite = 0
786
 
787
	# Configuration option log/level.
788
	# The level of log messages that are sent to the log file or syslog.
789
	# There are 6 syslog-like log levels currently in use: 2 to 7 inclusive.
790
	# 7 is the most verbose (LOG_DEBUG).
791
	level = 0
792
 
793
	# Configuration option log/indent.
794
	# Indent messages according to their severity.
795
	# This configuration option has an automatic default value.
796
	# indent = 0
797
 
798
	# Configuration option log/command_names.
799
	# Display the command name on each line of output.
800
	command_names = 0
801
 
802
	# Configuration option log/prefix.
803
	# A prefix to use before the log message text.
804
	# (After the command name, if selected).
805
	# Two spaces allows you to see/grep the severity of each message.
806
	# To make the messages look similar to the original LVM tools use:
807
	# indent = 0, command_names = 1, prefix = " -- "
808
	prefix = "  "
809
 
810
	# Configuration option log/activation.
811
	# Log messages during activation.
812
	# Don't use this in low memory situations (can deadlock).
813
	activation = 0
814
 
815
	# Configuration option log/debug_classes.
816
	# Select log messages by class.
817
	# Some debugging messages are assigned to a class and only appear in
818
	# debug output if the class is listed here. Classes currently
819
	# available: memory, devices, io, activation, allocation,
820
	# metadata, cache, locking, lvmpolld. Use "all" to see everything.
821
	debug_classes = [ "memory", "devices", "io", "activation", "allocation", "metadata", "cache", "locking", "lvmpolld", "dbus" ]
822
 
823
	# Configuration option log/debug_file_fields.
824
	# The fields included in debug output written to log file.
825
	# Use "all" to include everything (the default).
826
	# This configuration option is advanced.
827
	# This configuration option has an automatic default value.
828
	# debug_file_fields = [ "time", "command", "fileline", "message" ]
829
 
830
	# Configuration option log/debug_output_fields.
831
	# The fields included in debug output written to stderr.
832
	# Use "all" to include everything (the default).
833
	# This configuration option is advanced.
834
	# This configuration option has an automatic default value.
835
	# debug_output_fields = [ "time", "command", "fileline", "message" ]
836
}
837
 
838
# Configuration section backup.
839
# How LVM metadata is backed up and archived.
840
# In LVM, a 'backup' is a copy of the metadata for the current system,
841
# and an 'archive' contains old metadata configurations. They are
842
# stored in a human readable text format.
843
backup {
844
 
845
	# Configuration option backup/backup.
846
	# Maintain a backup of the current metadata configuration.
847
	# Think very hard before turning this off!
848
	backup = 1
849
 
850
	# Configuration option backup/backup_dir.
851
	# Location of the metadata backup files.
852
	# Remember to back up this directory regularly!
853
	backup_dir = "/etc/lvm/backup"
854
 
855
	# Configuration option backup/archive.
856
	# Maintain an archive of old metadata configurations.
857
	# Think very hard before turning this off.
858
	archive = 1
859
 
860
	# Configuration option backup/archive_dir.
861
	# Location of the metdata archive files.
862
	# Remember to back up this directory regularly!
863
	archive_dir = "/etc/lvm/archive"
864
 
865
	# Configuration option backup/retain_min.
866
	# Minimum number of archives to keep.
867
	retain_min = 10
868
 
869
	# Configuration option backup/retain_days.
870
	# Minimum number of days to keep archive files.
871
	retain_days = 30
872
}
873
 
874
# Configuration section shell.
875
# Settings for running LVM in shell (readline) mode.
876
shell {
877
 
878
	# Configuration option shell/history_size.
879
	# Number of lines of history to store in ~/.lvm_history.
880
	history_size = 100
881
}
882
 
883
# Configuration section global.
884
# Miscellaneous global LVM settings.
885
global {
886
 
887
	# Configuration option global/umask.
888
	# The file creation mask for any files and directories created.
889
	# Interpreted as octal if the first digit is zero.
890
	umask = 077
891
 
892
	# Configuration option global/test.
893
	# No on-disk metadata changes will be made in test mode.
894
	# Equivalent to having the -t option on every command.
895
	test = 0
896
 
897
	# Configuration option global/units.
898
	# Default value for --units argument.
899
	units = "r"
900
 
901
	# Configuration option global/si_unit_consistency.
902
	# Distinguish between powers of 1024 and 1000 bytes.
903
	# The LVM commands distinguish between powers of 1024 bytes,
904
	# e.g. KiB, MiB, GiB, and powers of 1000 bytes, e.g. KB, MB, GB.
905
	# If scripts depend on the old behaviour, disable this setting
906
	# temporarily until they are updated.
907
	si_unit_consistency = 1
908
 
909
	# Configuration option global/suffix.
910
	# Display unit suffix for sizes.
911
	# This setting has no effect if the units are in human-readable form
912
	# (global/units = "h") in which case the suffix is always displayed.
913
	suffix = 1
914
 
915
	# Configuration option global/activation.
916
	# Enable/disable communication with the kernel device-mapper.
917
	# Disable to use the tools to manipulate LVM metadata without
918
	# activating any logical volumes. If the device-mapper driver
919
	# is not present in the kernel, disabling this should suppress
920
	# the error messages.
921
	activation = 1
922
 
923
	# Configuration option global/proc.
924
	# Location of proc filesystem.
925
	# This configuration option is advanced.
926
	proc = "/proc"
927
 
928
	# Configuration option global/etc.
929
	# Location of /etc system configuration directory.
930
	etc = "/etc"
931
 
932
	# Configuration option global/wait_for_locks.
933
	# When disabled, fail if a lock request would block.
934
	wait_for_locks = 1
935
 
936
	# Configuration option global/locking_dir.
937
	# Directory to use for LVM command file locks.
938
	# Local non-LV directory that holds file-based locks while commands are
939
	# in progress. A directory like /tmp that may get wiped on reboot is OK.
940
	locking_dir = "/run/lock/lvm"
941
 
942
	# Configuration option global/prioritise_write_locks.
943
	# Allow quicker VG write access during high volume read access.
944
	# When there are competing read-only and read-write access requests for
945
	# a volume group's metadata, instead of always granting the read-only
946
	# requests immediately, delay them to allow the read-write requests to
947
	# be serviced. Without this setting, write access may be stalled by a
193 - 948
	# high volume of read-only requests. This option only affects file locks.
192 - 949
	prioritise_write_locks = 1
950
 
951
	# Configuration option global/library_dir.
952
	# Search this directory first for shared libraries.
953
	# This configuration option does not have a default value defined.
954
 
955
	# Configuration option global/abort_on_internal_errors.
956
	# Abort a command that encounters an internal error.
957
	# Treat any internal errors as fatal errors, aborting the process that
958
	# encountered the internal error. Please only enable for debugging.
959
	abort_on_internal_errors = 0
960
 
961
	# Configuration option global/metadata_read_only.
962
	# No operations that change on-disk metadata are permitted.
963
	# Additionally, read-only commands that encounter metadata in need of
964
	# repair will still be allowed to proceed exactly as if the repair had
965
	# been performed (except for the unchanged vg_seqno). Inappropriate
966
	# use could mess up your system, so seek advice first!
967
	metadata_read_only = 0
968
 
969
	# Configuration option global/mirror_segtype_default.
970
	# The segment type used by the short mirroring option -m.
971
	# The --type mirror|raid1 option overrides this setting.
972
	#
973
	# Accepted values:
974
	#   mirror
975
	#     The original RAID1 implementation from LVM/DM. It is
976
	#     characterized by a flexible log solution (core, disk, mirrored),
977
	#     and by the necessity to block I/O while handling a failure.
978
	#     There is an inherent race in the dmeventd failure handling logic
979
	#     with snapshots of devices using this type of RAID1 that in the
980
	#     worst case could cause a deadlock. (Also see
981
	#     devices/ignore_lvm_mirrors.)
982
	#   raid1
983
	#     This is a newer RAID1 implementation using the MD RAID1
984
	#     personality through device-mapper. It is characterized by a
985
	#     lack of log options. (A log is always allocated for every
986
	#     device and they are placed on the same device as the image,
987
	#     so no separate devices are required.) This mirror
988
	#     implementation does not require I/O to be blocked while
989
	#     handling a failure. This mirror implementation is not
990
	#     cluster-aware and cannot be used in a shared (active/active)
991
	#     fashion in a cluster.
992
	#
993
	mirror_segtype_default = "raid1"
994
 
995
	# Configuration option global/support_mirrored_mirror_log.
996
	# Enable mirrored 'mirror' log type for testing.
997
	#
998
	# This type is deprecated to create or convert to but can
999
	# be enabled to test that activation of existing mirrored
1000
	# logs and conversion to disk/core works.
1001
	#
1002
	# Not supported for regular operation!
1003
	# This configuration option has an automatic default value.
1004
	# support_mirrored_mirror_log = 0
1005
 
1006
	# Configuration option global/raid10_segtype_default.
1007
	# The segment type used by the -i -m combination.
1008
	# The --type raid10|mirror option overrides this setting.
1009
	# The --stripes/-i and --mirrors/-m options can both be specified
1010
	# during the creation of a logical volume to use both striping and
1011
	# mirroring for the LV. There are two different implementations.
1012
	#
1013
	# Accepted values:
1014
	#   raid10
1015
	#     LVM uses MD's RAID10 personality through DM. This is the
1016
	#     preferred option.
1017
	#   mirror
1018
	#     LVM layers the 'mirror' and 'stripe' segment types. The layering
1019
	#     is done by creating a mirror LV on top of striped sub-LVs,
1020
	#     effectively creating a RAID 0+1 array. The layering is suboptimal
1021
	#     in terms of providing redundancy and performance.
1022
	#
1023
	raid10_segtype_default = "raid10"
1024
 
1025
	# Configuration option global/sparse_segtype_default.
1026
	# The segment type used by the -V -L combination.
1027
	# The --type snapshot|thin option overrides this setting.
1028
	# The combination of -V and -L options creates a sparse LV. There are
1029
	# two different implementations.
1030
	#
1031
	# Accepted values:
1032
	#   snapshot
1033
	#     The original snapshot implementation from LVM/DM. It uses an old
1034
	#     snapshot that mixes data and metadata within a single COW
1035
	#     storage volume and performs poorly when the size of stored data
1036
	#     passes hundreds of MB.
1037
	#   thin
1038
	#     A newer implementation that uses thin provisioning. It has a
1039
	#     bigger minimal chunk size (64KiB) and uses a separate volume for
1040
	#     metadata. It has better performance, especially when more data
1041
	#     is used. It also supports full snapshots.
1042
	#
1043
	sparse_segtype_default = "thin"
1044
 
1045
	# Configuration option global/lvdisplay_shows_full_device_path.
1046
	# Enable this to reinstate the previous lvdisplay name format.
1047
	# The default format for displaying LV names in lvdisplay was changed
1048
	# in version 2.02.89 to show the LV name and path separately.
1049
	# Previously this was always shown as /dev/vgname/lvname even when that
1050
	# was never a valid path in the /dev filesystem.
1051
	# This configuration option has an automatic default value.
1052
	# lvdisplay_shows_full_device_path = 0
1053
 
1054
	# Configuration option global/event_activation.
1055
	# Activate LVs based on system-generated device events.
1056
	# When a device appears on the system, a system-generated event runs
1057
	# the pvscan command to activate LVs if the new PV completes the VG.
1058
	# Use auto_activation_volume_list to select which LVs should be
1059
	# activated from these events (the default is all.)
1060
	# When event_activation is disabled, the system will generally run
1061
	# a direct activation command to activate LVs in complete VGs.
1062
	# This configuration option has an automatic default value.
1063
	# event_activation = 1
1064
 
1065
	# Configuration option global/use_aio.
1066
	# Use async I/O when reading and writing devices.
1067
	# This configuration option has an automatic default value.
1068
	# use_aio = 1
1069
 
1070
	# Configuration option global/use_lvmlockd.
1071
	# Use lvmlockd for locking among hosts using LVM on shared storage.
1072
	# Applicable only if LVM is compiled with lockd support in which
1073
	# case there is also lvmlockd(8) man page available for more
1074
	# information.
1075
	use_lvmlockd = 0
1076
 
1077
	# Configuration option global/lvmlockd_lock_retries.
1078
	# Retry lvmlockd lock requests this many times.
1079
	# Applicable only if LVM is compiled with lockd support
1080
	# This configuration option has an automatic default value.
1081
	# lvmlockd_lock_retries = 3
1082
 
1083
	# Configuration option global/sanlock_lv_extend.
1084
	# Size in MiB to extend the internal LV holding sanlock locks.
1085
	# The internal LV holds locks for each LV in the VG, and after enough
1086
	# LVs have been created, the internal LV needs to be extended. lvcreate
1087
	# will automatically extend the internal LV when needed by the amount
1088
	# specified here. Setting this to 0 disables the automatic extension
1089
	# and can cause lvcreate to fail. Applicable only if LVM is compiled
1090
	# with lockd support
1091
	# This configuration option has an automatic default value.
1092
	# sanlock_lv_extend = 256
1093
 
1094
	# Configuration option global/thin_check_executable.
1095
	# The full path to the thin_check command.
1096
	# LVM uses this command to check that a thin metadata device is in a
1097
	# usable state. When a thin pool is activated and after it is
1098
	# deactivated, this command is run. Activation will only proceed if
1099
	# the command has an exit status of 0. Set to "" to skip this check.
1100
	# (Not recommended.) Also see thin_check_options.
1101
	# (See package device-mapper-persistent-data or thin-provisioning-tools)
1102
	# This configuration option has an automatic default value.
1103
	# thin_check_executable = "/usr/sbin/thin_check"
1104
 
1105
	# Configuration option global/thin_dump_executable.
1106
	# The full path to the thin_dump command.
1107
	# LVM uses this command to dump thin pool metadata.
1108
	# (See package device-mapper-persistent-data or thin-provisioning-tools)
1109
	# This configuration option has an automatic default value.
1110
	# thin_dump_executable = "/usr/sbin/thin_dump"
1111
 
1112
	# Configuration option global/thin_repair_executable.
1113
	# The full path to the thin_repair command.
1114
	# LVM uses this command to repair a thin metadata device if it is in
1115
	# an unusable state. Also see thin_repair_options.
1116
	# (See package device-mapper-persistent-data or thin-provisioning-tools)
1117
	# This configuration option has an automatic default value.
1118
	# thin_repair_executable = "/usr/sbin/thin_repair"
1119
 
1120
	# Configuration option global/thin_check_options.
1121
	# List of options passed to the thin_check command.
1122
	# With thin_check version 2.1 or newer you can add the option
1123
	# --ignore-non-fatal-errors to let it pass through ignorable errors
1124
	# and fix them later. With thin_check version 3.2 or newer you should
1125
	# include the option --clear-needs-check-flag.
1126
	# This configuration option has an automatic default value.
1127
	# thin_check_options = [ "-q", "--clear-needs-check-flag" ]
1128
 
1129
	# Configuration option global/thin_repair_options.
1130
	# List of options passed to the thin_repair command.
1131
	# This configuration option has an automatic default value.
1132
	# thin_repair_options = [ "" ]
1133
 
1134
	# Configuration option global/thin_disabled_features.
1135
	# Features to not use in the thin driver.
1136
	# This can be helpful for testing, or to avoid using a feature that is
1137
	# causing problems. Features include: block_size, discards,
1138
	# discards_non_power_2, external_origin, metadata_resize,
1139
	# external_origin_extend, error_if_no_space.
1140
	#
1141
	# Example
1142
	# thin_disabled_features = [ "discards", "block_size" ]
1143
	#
1144
	# This configuration option does not have a default value defined.
1145
 
1146
	# Configuration option global/cache_disabled_features.
1147
	# Features to not use in the cache driver.
1148
	# This can be helpful for testing, or to avoid using a feature that is
1149
	# causing problems. Features include: policy_mq, policy_smq, metadata2.
1150
	#
1151
	# Example
1152
	# cache_disabled_features = [ "policy_smq" ]
1153
	#
1154
	# This configuration option does not have a default value defined.
1155
 
1156
	# Configuration option global/cache_check_executable.
1157
	# The full path to the cache_check command.
1158
	# LVM uses this command to check that a cache metadata device is in a
1159
	# usable state. When a cached LV is activated and after it is
1160
	# deactivated, this command is run. Activation will only proceed if the
1161
	# command has an exit status of 0. Set to "" to skip this check.
1162
	# (Not recommended.) Also see cache_check_options.
1163
	# (See package device-mapper-persistent-data or thin-provisioning-tools)
1164
	# This configuration option has an automatic default value.
1165
	# cache_check_executable = "/usr/sbin/cache_check"
1166
 
1167
	# Configuration option global/cache_dump_executable.
1168
	# The full path to the cache_dump command.
1169
	# LVM uses this command to dump cache pool metadata.
1170
	# (See package device-mapper-persistent-data or thin-provisioning-tools)
1171
	# This configuration option has an automatic default value.
1172
	# cache_dump_executable = "/usr/sbin/cache_dump"
1173
 
1174
	# Configuration option global/cache_repair_executable.
1175
	# The full path to the cache_repair command.
1176
	# LVM uses this command to repair a cache metadata device if it is in
1177
	# an unusable state. Also see cache_repair_options.
1178
	# (See package device-mapper-persistent-data or thin-provisioning-tools)
1179
	# This configuration option has an automatic default value.
1180
	# cache_repair_executable = "/usr/sbin/cache_repair"
1181
 
1182
	# Configuration option global/cache_check_options.
1183
	# List of options passed to the cache_check command.
1184
	# With cache_check version 5.0 or newer you should include the option
1185
	# --clear-needs-check-flag.
1186
	# This configuration option has an automatic default value.
1187
	# cache_check_options = [ "-q", "--clear-needs-check-flag" ]
1188
 
1189
	# Configuration option global/cache_repair_options.
1190
	# List of options passed to the cache_repair command.
1191
	# This configuration option has an automatic default value.
1192
	# cache_repair_options = [ "" ]
1193
 
1194
	# Configuration option global/vdo_format_executable.
1195
	# The full path to the vdoformat command.
1196
	# LVM uses this command to initial data volume for VDO type logical volume
1197
	# This configuration option has an automatic default value.
1198
	# vdo_format_executable = "/usr/bin/vdoformat"
1199
 
1200
	# Configuration option global/vdo_format_options.
1201
	# List of options passed added to standard vdoformat command.
1202
	# This configuration option has an automatic default value.
1203
	# vdo_format_options = [ "" ]
1204
 
1205
	# Configuration option global/fsadm_executable.
1206
	# The full path to the fsadm command.
1207
	# LVM uses this command to help with lvresize -r operations.
1208
	# This configuration option has an automatic default value.
1209
	# fsadm_executable = "/usr/sbin/fsadm"
1210
 
1211
	# Configuration option global/system_id_source.
1212
	# The method LVM uses to set the local system ID.
1213
	# Volume Groups can also be given a system ID (by vgcreate, vgchange,
1214
	# or vgimport.) A VG on shared storage devices is accessible only to
1215
	# the host with a matching system ID. See 'man lvmsystemid' for
1216
	# information on limitations and correct usage.
1217
	#
1218
	# Accepted values:
1219
	#   none
1220
	#     The host has no system ID.
1221
	#   lvmlocal
1222
	#     Obtain the system ID from the system_id setting in the 'local'
1223
	#     section of an lvm configuration file, e.g. lvmlocal.conf.
1224
	#   uname
1225
	#     Set the system ID from the hostname (uname) of the system.
1226
	#     System IDs beginning localhost are not permitted.
1227
	#   machineid
1228
	#     Use the contents of the machine-id file to set the system ID.
1229
	#     Some systems create this file at installation time.
1230
	#     See 'man machine-id' and global/etc.
1231
	#   file
1232
	#     Use the contents of another file (system_id_file) to set the
1233
	#     system ID.
1234
	#
1235
	system_id_source = "none"
1236
 
1237
	# Configuration option global/system_id_file.
1238
	# The full path to the file containing a system ID.
1239
	# This is used when system_id_source is set to 'file'.
1240
	# Comments starting with the character # are ignored.
1241
	# This configuration option does not have a default value defined.
1242
 
1243
	# Configuration option global/use_lvmpolld.
1244
	# Use lvmpolld to supervise long running LVM commands.
1245
	# When enabled, control of long running LVM commands is transferred
1246
	# from the original LVM command to the lvmpolld daemon. This allows
1247
	# the operation to continue independent of the original LVM command.
1248
	# After lvmpolld takes over, the LVM command displays the progress
1249
	# of the ongoing operation. lvmpolld itself runs LVM commands to
1250
	# manage the progress of ongoing operations. lvmpolld can be used as
1251
	# a native systemd service, which allows it to be started on demand,
1252
	# and to use its own control group. When this option is disabled, LVM
1253
	# commands will supervise long running operations by forking themselves.
1254
	# Applicable only if LVM is compiled with lvmpolld support.
1255
	use_lvmpolld = 1
1256
 
1257
	# Configuration option global/notify_dbus.
1258
	# Enable D-Bus notification from LVM commands.
1259
	# When enabled, an LVM command that changes PVs, changes VG metadata,
1260
	# or changes the activation state of an LV will send a notification.
1261
	notify_dbus = 1
1262
 
1263
	# Configuration option global/io_memory_size.
1264
	# The amount of memory in KiB that LVM allocates to perform disk io.
1265
	# LVM performance may benefit from more io memory when there are many
1266
	# disks or VG metadata is large. Increasing this size may be necessary
1267
	# when a single copy of VG metadata is larger than the current setting.
1268
	# This value should usually not be decreased from the default; setting
1269
	# it too low can result in lvm failing to read VGs.
1270
	# This configuration option has an automatic default value.
1271
	# io_memory_size = 8192
1272
}
1273
 
1274
# Configuration section activation.
1275
activation {
1276
 
1277
	# Configuration option activation/checks.
1278
	# Perform internal checks of libdevmapper operations.
1279
	# Useful for debugging problems with activation. Some of the checks may
1280
	# be expensive, so it's best to use this only when there seems to be a
1281
	# problem.
1282
	checks = 0
1283
 
1284
	# Configuration option activation/udev_sync.
1285
	# Use udev notifications to synchronize udev and LVM.
1286
	# The --nodevsync option overrides this setting.
1287
	# When disabled, LVM commands will not wait for notifications from
1288
	# udev, but continue irrespective of any possible udev processing in
1289
	# the background. Only use this if udev is not running or has rules
1290
	# that ignore the devices LVM creates. If enabled when udev is not
1291
	# running, and LVM processes are waiting for udev, run the command
1292
	# 'dmsetup udevcomplete_all' to wake them up.
1293
	udev_sync = 1
1294
 
1295
	# Configuration option activation/udev_rules.
1296
	# Use udev rules to manage LV device nodes and symlinks.
1297
	# When disabled, LVM will manage the device nodes and symlinks for
1298
	# active LVs itself. Manual intervention may be required if this
1299
	# setting is changed while LVs are active.
1300
	udev_rules = 1
1301
 
1302
	# Configuration option activation/verify_udev_operations.
1303
	# Use extra checks in LVM to verify udev operations.
1304
	# This enables additional checks (and if necessary, repairs) on entries
1305
	# in the device directory after udev has completed processing its
1306
	# events. Useful for diagnosing problems with LVM/udev interactions.
1307
	# This configuration option has an automatic default value.
1308
	# verify_udev_operations = 0
1309
 
1310
	# Configuration option activation/retry_deactivation.
1311
	# Retry failed LV deactivation.
1312
	# If LV deactivation fails, LVM will retry for a few seconds before
1313
	# failing. This may happen because a process run from a quick udev rule
1314
	# temporarily opened the device.
1315
	retry_deactivation = 1
1316
 
1317
	# Configuration option activation/missing_stripe_filler.
1318
	# Method to fill missing stripes when activating an incomplete LV.
1319
	# Using 'error' will make inaccessible parts of the device return I/O
1320
	# errors on access. Using 'zero' will return success (and zero) on I/O
1321
	# You can instead use a device path, in which case,
1322
	# that device will be used in place of missing stripes. Using anything
1323
	# other than 'error' with mirrored or snapshotted volumes is likely to
1324
	# result in data corruption.
1325
	# This configuration option is advanced.
1326
	missing_stripe_filler = "error"
1327
 
1328
	# Configuration option activation/use_linear_target.
1329
	# Use the linear target to optimize single stripe LVs.
1330
	# When disabled, the striped target is used. The linear target is an
1331
	# optimised version of the striped target that only handles a single
1332
	# stripe.
1333
	# This configuration option has an automatic default value.
1334
	# use_linear_target = 1
1335
 
1336
	# Configuration option activation/reserved_stack.
1337
	# Stack size in KiB to reserve for use while devices are suspended.
1338
	# Insufficent reserve risks I/O deadlock during device suspension.
1339
	# This configuration option has an automatic default value.
1340
	# reserved_stack = 64
1341
 
1342
	# Configuration option activation/reserved_memory.
1343
	# Memory size in KiB to reserve for use while devices are suspended.
1344
	# Insufficent reserve risks I/O deadlock during device suspension.
1345
	# This configuration option has an automatic default value.
1346
	# reserved_memory = 8192
1347
 
1348
	# Configuration option activation/process_priority.
1349
	# Nice value used while devices are suspended.
1350
	# Use a high priority so that LVs are suspended
1351
	# for the shortest possible time.
1352
	# This configuration option has an automatic default value.
1353
	# process_priority = -18
1354
 
1355
	# Configuration option activation/volume_list.
1356
	# Only LVs selected by this list are activated.
1357
	# If this list is defined, an LV is only activated if it matches an
1358
	# entry in this list. If this list is undefined, it imposes no limits
1359
	# on LV activation (all are allowed).
1360
	#
1361
	# Accepted values:
1362
	#   vgname
1363
	#     The VG name is matched exactly and selects all LVs in the VG.
1364
	#   vgname/lvname
1365
	#     The VG name and LV name are matched exactly and selects the LV.
1366
	#   @tag
1367
	#     Selects an LV if the specified tag matches a tag set on the LV
1368
	#     or VG.
1369
	#   @*
1370
	#     Selects an LV if a tag defined on the host is also set on the LV
1371
	#     or VG. See tags/hosttags. If any host tags exist but volume_list
1372
	#     is not defined, a default single-entry list containing '@*'
1373
	#     is assumed.
1374
	#
1375
	# Example
1376
	# volume_list = [ "vg1", "vg2/lvol1", "@tag1", "@*" ]
1377
	#
1378
	# This configuration option does not have a default value defined.
1379
 
1380
	# Configuration option activation/auto_activation_volume_list.
1381
	# Only LVs selected by this list are auto-activated.
1382
	# This list works like volume_list, but it is used only by
1383
	# auto-activation commands. It does not apply to direct activation
1384
	# commands. If this list is defined, an LV is only auto-activated
1385
	# if it matches an entry in this list. If this list is undefined, it
1386
	# imposes no limits on LV auto-activation (all are allowed.) If this
1387
	# list is defined and empty, i.e. "[]", then no LVs are selected for
1388
	# auto-activation. An LV that is selected by this list for
1389
	# auto-activation, must also be selected by volume_list (if defined)
1390
	# before it is activated. Auto-activation is an activation command that
1391
	# includes the 'a' argument: --activate ay or -a ay. The 'a' (auto)
1392
	# argument for auto-activation is meant to be used by activation
1393
	# commands that are run automatically by the system, as opposed to LVM
1394
	# commands run directly by a user. A user may also use the 'a' flag
1395
	# directly to perform auto-activation. Also see pvscan(8) for more
1396
	# information about auto-activation.
1397
	#
1398
	# Accepted values:
1399
	#   vgname
1400
	#     The VG name is matched exactly and selects all LVs in the VG.
1401
	#   vgname/lvname
1402
	#     The VG name and LV name are matched exactly and selects the LV.
1403
	#   @tag
1404
	#     Selects an LV if the specified tag matches a tag set on the LV
1405
	#     or VG.
1406
	#   @*
1407
	#     Selects an LV if a tag defined on the host is also set on the LV
1408
	#     or VG. See tags/hosttags. If any host tags exist but volume_list
1409
	#     is not defined, a default single-entry list containing '@*'
1410
	#     is assumed.
1411
	#
1412
	# Example
1413
	# auto_activation_volume_list = [ "vg1", "vg2/lvol1", "@tag1", "@*" ]
1414
	#
1415
	# This configuration option does not have a default value defined.
1416
 
1417
	# Configuration option activation/read_only_volume_list.
1418
	# LVs in this list are activated in read-only mode.
1419
	# If this list is defined, each LV that is to be activated is checked
1420
	# against this list, and if it matches, it is activated in read-only
1421
	# mode. This overrides the permission setting stored in the metadata,
1422
	# e.g. from --permission rw.
1423
	#
1424
	# Accepted values:
1425
	#   vgname
1426
	#     The VG name is matched exactly and selects all LVs in the VG.
1427
	#   vgname/lvname
1428
	#     The VG name and LV name are matched exactly and selects the LV.
1429
	#   @tag
1430
	#     Selects an LV if the specified tag matches a tag set on the LV
1431
	#     or VG.
1432
	#   @*
1433
	#     Selects an LV if a tag defined on the host is also set on the LV
1434
	#     or VG. See tags/hosttags. If any host tags exist but volume_list
1435
	#     is not defined, a default single-entry list containing '@*'
1436
	#     is assumed.
1437
	#
1438
	# Example
1439
	# read_only_volume_list = [ "vg1", "vg2/lvol1", "@tag1", "@*" ]
1440
	#
1441
	# This configuration option does not have a default value defined.
1442
 
1443
	# Configuration option activation/raid_region_size.
1444
	# Size in KiB of each raid or mirror synchronization region.
1445
	# The clean/dirty state of data is tracked for each region.
1446
	# The value is rounded down to a power of two if necessary, and
1447
	# is ignored if it is not a multiple of the machine memory page size.
1448
	raid_region_size = 2048
1449
 
1450
	# Configuration option activation/error_when_full.
1451
	# Return errors if a thin pool runs out of space.
1452
	# The --errorwhenfull option overrides this setting.
1453
	# When enabled, writes to thin LVs immediately return an error if the
1454
	# thin pool is out of data space. When disabled, writes to thin LVs
1455
	# are queued if the thin pool is out of space, and processed when the
1456
	# thin pool data space is extended. New thin pools are assigned the
1457
	# behavior defined here.
1458
	# This configuration option has an automatic default value.
1459
	# error_when_full = 0
1460
 
1461
	# Configuration option activation/readahead.
1462
	# Setting to use when there is no readahead setting in metadata.
1463
	#
1464
	# Accepted values:
1465
	#   none
1466
	#     Disable readahead.
1467
	#   auto
1468
	#     Use default value chosen by kernel.
1469
	#
1470
	# This configuration option has an automatic default value.
1471
	# readahead = "auto"
1472
 
1473
	# Configuration option activation/raid_fault_policy.
1474
	# Defines how a device failure in a RAID LV is handled.
1475
	# This includes LVs that have the following segment types:
1476
	# raid1, raid4, raid5*, and raid6*.
1477
	# If a device in the LV fails, the policy determines the steps
1478
	# performed by dmeventd automatically, and the steps perfomed by the
1479
	# manual command lvconvert --repair --use-policies.
1480
	# Automatic handling requires dmeventd to be monitoring the LV.
1481
	#
1482
	# Accepted values:
1483
	#   warn
1484
	#     Use the system log to warn the user that a device in the RAID LV
1485
	#     has failed. It is left to the user to run lvconvert --repair
1486
	#     manually to remove or replace the failed device. As long as the
1487
	#     number of failed devices does not exceed the redundancy of the LV
1488
	#     (1 device for raid4/5, 2 for raid6), the LV will remain usable.
1489
	#   allocate
1490
	#     Attempt to use any extra physical volumes in the VG as spares and
1491
	#     replace faulty devices.
1492
	#
1493
	raid_fault_policy = "warn"
1494
 
1495
	# Configuration option activation/mirror_image_fault_policy.
1496
	# Defines how a device failure in a 'mirror' LV is handled.
1497
	# An LV with the 'mirror' segment type is composed of mirror images
1498
	# (copies) and a mirror log. A disk log ensures that a mirror LV does
1499
	# not need to be re-synced (all copies made the same) every time a
1500
	# machine reboots or crashes. If a device in the LV fails, this policy
1501
	# determines the steps perfomed by dmeventd automatically, and the steps
1502
	# performed by the manual command lvconvert --repair --use-policies.
1503
	# Automatic handling requires dmeventd to be monitoring the LV.
1504
	#
1505
	# Accepted values:
1506
	#   remove
1507
	#     Simply remove the faulty device and run without it. If the log
1508
	#     device fails, the mirror would convert to using an in-memory log.
1509
	#     This means the mirror will not remember its sync status across
1510
	#     crashes/reboots and the entire mirror will be re-synced. If a
1511
	#     mirror image fails, the mirror will convert to a non-mirrored
1512
	#     device if there is only one remaining good copy.
1513
	#   allocate
1514
	#     Remove the faulty device and try to allocate space on a new
1515
	#     device to be a replacement for the failed device. Using this
1516
	#     policy for the log is fast and maintains the ability to remember
1517
	#     sync state through crashes/reboots. Using this policy for a
1518
	#     mirror device is slow, as it requires the mirror to resynchronize
1519
	#     the devices, but it will preserve the mirror characteristic of
1520
	#     the device. This policy acts like 'remove' if no suitable device
1521
	#     and space can be allocated for the replacement.
1522
	#   allocate_anywhere
1523
	#     Not yet implemented. Useful to place the log device temporarily
1524
	#     on the same physical volume as one of the mirror images. This
1525
	#     policy is not recommended for mirror devices since it would break
1526
	#     the redundant nature of the mirror. This policy acts like
1527
	#     'remove' if no suitable device and space can be allocated for the
1528
	#     replacement.
1529
	#
1530
	mirror_image_fault_policy = "remove"
1531
 
1532
	# Configuration option activation/mirror_log_fault_policy.
1533
	# Defines how a device failure in a 'mirror' log LV is handled.
1534
	# The mirror_image_fault_policy description for mirrored LVs also
1535
	# applies to mirrored log LVs.
1536
	mirror_log_fault_policy = "allocate"
1537
 
1538
	# Configuration option activation/snapshot_autoextend_threshold.
1539
	# Auto-extend a snapshot when its usage exceeds this percent.
1540
	# Setting this to 100 disables automatic extension.
1541
	# The minimum value is 50 (a smaller value is treated as 50.)
1542
	# Also see snapshot_autoextend_percent.
1543
	# Automatic extension requires dmeventd to be monitoring the LV.
1544
	#
1545
	# Example
1546
	# Using 70% autoextend threshold and 20% autoextend size, when a 1G
1547
	# snapshot exceeds 700M, it is extended to 1.2G, and when it exceeds
1548
	# 840M, it is extended to 1.44G:
1549
	# snapshot_autoextend_threshold = 70
1550
	#
1551
	snapshot_autoextend_threshold = 100
1552
 
1553
	# Configuration option activation/snapshot_autoextend_percent.
1554
	# Auto-extending a snapshot adds this percent extra space.
1555
	# The amount of additional space added to a snapshot is this
1556
	# percent of its current size.
1557
	#
1558
	# Example
1559
	# Using 70% autoextend threshold and 20% autoextend size, when a 1G
1560
	# snapshot exceeds 700M, it is extended to 1.2G, and when it exceeds
1561
	# 840M, it is extended to 1.44G:
1562
	# snapshot_autoextend_percent = 20
1563
	#
1564
	snapshot_autoextend_percent = 20
1565
 
1566
	# Configuration option activation/thin_pool_autoextend_threshold.
1567
	# Auto-extend a thin pool when its usage exceeds this percent.
1568
	# Setting this to 100 disables automatic extension.
1569
	# The minimum value is 50 (a smaller value is treated as 50.)
1570
	# Also see thin_pool_autoextend_percent.
1571
	# Automatic extension requires dmeventd to be monitoring the LV.
1572
	#
1573
	# Example
1574
	# Using 70% autoextend threshold and 20% autoextend size, when a 1G
1575
	# thin pool exceeds 700M, it is extended to 1.2G, and when it exceeds
1576
	# 840M, it is extended to 1.44G:
1577
	# thin_pool_autoextend_threshold = 70
1578
	#
1579
	thin_pool_autoextend_threshold = 100
1580
 
1581
	# Configuration option activation/thin_pool_autoextend_percent.
1582
	# Auto-extending a thin pool adds this percent extra space.
1583
	# The amount of additional space added to a thin pool is this
1584
	# percent of its current size.
1585
	#
1586
	# Example
1587
	# Using 70% autoextend threshold and 20% autoextend size, when a 1G
1588
	# thin pool exceeds 700M, it is extended to 1.2G, and when it exceeds
1589
	# 840M, it is extended to 1.44G:
1590
	# thin_pool_autoextend_percent = 20
1591
	#
1592
	thin_pool_autoextend_percent = 20
1593
 
1594
	# Configuration option activation/vdo_pool_autoextend_threshold.
1595
	# Auto-extend a VDO pool when its usage exceeds this percent.
1596
	# Setting this to 100 disables automatic extension.
1597
	# The minimum value is 50 (a smaller value is treated as 50.)
1598
	# Also see vdo_pool_autoextend_percent.
1599
	# Automatic extension requires dmeventd to be monitoring the LV.
1600
	#
1601
	# Example
1602
	# Using 70% autoextend threshold and 20% autoextend size, when a 10G
1603
	# VDO pool exceeds 7G, it is extended to 12G, and when it exceeds
1604
	# 8.4G, it is extended to 14.4G:
1605
	# vdo_pool_autoextend_threshold = 70
1606
	#
1607
	# This configuration option has an automatic default value.
1608
	# vdo_pool_autoextend_threshold = 100
1609
 
1610
	# Configuration option activation/vdo_pool_autoextend_percent.
1611
	# Auto-extending a VDO pool adds this percent extra space.
1612
	# The amount of additional space added to a VDO pool is this
1613
	# percent of its current size.
1614
	#
1615
	# Example
1616
	# Using 70% autoextend threshold and 20% autoextend size, when a 10G
1617
	# VDO pool exceeds 7G, it is extended to 12G, and when it exceeds
1618
	# 8.4G, it is extended to 14.4G:
1619
	# This configuration option has an automatic default value.
1620
	# vdo_pool_autoextend_percent = 20
1621
 
1622
	# Configuration option activation/mlock_filter.
1623
	# Do not mlock these memory areas.
1624
	# While activating devices, I/O to devices being (re)configured is
1625
	# suspended. As a precaution against deadlocks, LVM pins memory it is
1626
	# using so it is not paged out, and will not require I/O to reread.
1627
	# Groups of pages that are known not to be accessed during activation
1628
	# do not need to be pinned into memory. Each string listed in this
1629
	# setting is compared against each line in /proc/self/maps, and the
1630
	# pages corresponding to lines that match are not pinned. On some
1631
	# systems, locale-archive was found to make up over 80% of the memory
1632
	# used by the process.
1633
	#
1634
	# Example
1635
	# mlock_filter = [ "locale/locale-archive", "gconv/gconv-modules.cache" ]
1636
	#
1637
	# This configuration option is advanced.
1638
	# This configuration option does not have a default value defined.
1639
 
1640
	# Configuration option activation/use_mlockall.
1641
	# Use the old behavior of mlockall to pin all memory.
1642
	# Prior to version 2.02.62, LVM used mlockall() to pin the whole
1643
	# process's memory while activating devices.
1644
	# This configuration option has an automatic default value.
1645
	# use_mlockall = 0
1646
 
1647
	# Configuration option activation/monitoring.
1648
	# Monitor LVs that are activated.
1649
	# The --ignoremonitoring option overrides this setting.
1650
	# When enabled, LVM will ask dmeventd to monitor activated LVs.
1651
	monitoring = 1
1652
 
1653
	# Configuration option activation/polling_interval.
1654
	# Check pvmove or lvconvert progress at this interval (seconds).
1655
	# When pvmove or lvconvert must wait for the kernel to finish
1656
	# synchronising or merging data, they check and report progress at
1657
	# intervals of this number of seconds. If this is set to 0 and there
1658
	# is only one thing to wait for, there are no progress reports, but
1659
	# the process is awoken immediately once the operation is complete.
1660
	# This configuration option has an automatic default value.
1661
	# polling_interval = 15
1662
 
1663
	# Configuration option activation/auto_set_activation_skip.
1664
	# Set the activation skip flag on new thin snapshot LVs.
1665
	# The --setactivationskip option overrides this setting.
1666
	# An LV can have a persistent 'activation skip' flag. The flag causes
1667
	# the LV to be skipped during normal activation. The lvchange/vgchange
1668
	# -K option is required to activate LVs that have the activation skip
1669
	# flag set. When this setting is enabled, the activation skip flag is
1670
	# set on new thin snapshot LVs.
1671
	# This configuration option has an automatic default value.
1672
	# auto_set_activation_skip = 1
1673
 
1674
	# Configuration option activation/activation_mode.
1675
	# How LVs with missing devices are activated.
1676
	# The --activationmode option overrides this setting.
1677
	#
1678
	# Accepted values:
1679
	#   complete
1680
	#     Only allow activation of an LV if all of the Physical Volumes it
1681
	#     uses are present. Other PVs in the Volume Group may be missing.
1682
	#   degraded
1683
	#     Like complete, but additionally RAID LVs of segment type raid1,
1684
	#     raid4, raid5, radid6 and raid10 will be activated if there is no
1685
	#     data loss, i.e. they have sufficient redundancy to present the
1686
	#     entire addressable range of the Logical Volume.
1687
	#   partial
1688
	#     Allows the activation of any LV even if a missing or failed PV
1689
	#     could cause data loss with a portion of the LV inaccessible.
1690
	#     This setting should not normally be used, but may sometimes
1691
	#     assist with data recovery.
1692
	#
1693
	activation_mode = "degraded"
1694
 
1695
	# Configuration option activation/lock_start_list.
1696
	# Locking is started only for VGs selected by this list.
1697
	# The rules are the same as those for volume_list.
1698
	# This configuration option does not have a default value defined.
1699
 
1700
	# Configuration option activation/auto_lock_start_list.
1701
	# Locking is auto-started only for VGs selected by this list.
1702
	# The rules are the same as those for auto_activation_volume_list.
1703
	# This configuration option does not have a default value defined.
1704
}
1705
 
1706
# Configuration section metadata.
1707
# This configuration section has an automatic default value.
1708
# metadata {
1709
 
1710
	# Configuration option metadata/check_pv_device_sizes.
1711
	# Check device sizes are not smaller than corresponding PV sizes.
1712
	# If device size is less than corresponding PV size found in metadata,
1713
	# there is always a risk of data loss. If this option is set, then LVM
1714
	# issues a warning message each time it finds that the device size is
1715
	# less than corresponding PV size. You should not disable this unless
1716
	# you are absolutely sure about what you are doing!
1717
	# This configuration option is advanced.
1718
	# This configuration option has an automatic default value.
1719
	# check_pv_device_sizes = 1
1720
 
1721
	# Configuration option metadata/record_lvs_history.
1722
	# When enabled, LVM keeps history records about removed LVs in
1723
	# metadata. The information that is recorded in metadata for
1724
	# historical LVs is reduced when compared to original
1725
	# information kept in metadata for live LVs. Currently, this
1726
	# feature is supported for thin and thin snapshot LVs only.
1727
	# This configuration option has an automatic default value.
1728
	# record_lvs_history = 0
1729
 
1730
	# Configuration option metadata/lvs_history_retention_time.
1731
	# Retention time in seconds after which a record about individual
1732
	# historical logical volume is automatically destroyed.
1733
	# A value of 0 disables this feature.
1734
	# This configuration option has an automatic default value.
1735
	# lvs_history_retention_time = 0
1736
 
1737
	# Configuration option metadata/pvmetadatacopies.
1738
	# Number of copies of metadata to store on each PV.
1739
	# The --pvmetadatacopies option overrides this setting.
1740
	#
1741
	# Accepted values:
1742
	#   2
1743
	#     Two copies of the VG metadata are stored on the PV, one at the
1744
	#     front of the PV, and one at the end.
1745
	#   1
1746
	#     One copy of VG metadata is stored at the front of the PV.
1747
	#   0
1748
	#     No copies of VG metadata are stored on the PV. This may be
1749
	#     useful for VGs containing large numbers of PVs.
1750
	#
1751
	# This configuration option is advanced.
1752
	# This configuration option has an automatic default value.
1753
	# pvmetadatacopies = 1
1754
 
1755
	# Configuration option metadata/vgmetadatacopies.
1756
	# Number of copies of metadata to maintain for each VG.
1757
	# The --vgmetadatacopies option overrides this setting.
1758
	# If set to a non-zero value, LVM automatically chooses which of the
1759
	# available metadata areas to use to achieve the requested number of
1760
	# copies of the VG metadata. If you set a value larger than the the
1761
	# total number of metadata areas available, then metadata is stored in
1762
	# them all. The value 0 (unmanaged) disables this automatic management
1763
	# and allows you to control which metadata areas are used at the
1764
	# individual PV level using pvchange --metadataignore y|n.
1765
	# This configuration option has an automatic default value.
1766
	# vgmetadatacopies = 0
1767
 
1768
	# Configuration option metadata/pvmetadatasize.
1769
	# The default size of the metadata area in units of 512 byte sectors.
1770
	# The metadata area begins at an offset of the page size from the start
1771
	# of the device. The first PE is by default at 1 MiB from the start of
1772
	# the device. The space between these is the default metadata area size.
1773
	# The actual size of the metadata area may be larger than what is set
1774
	# here due to default_data_alignment making the first PE a MiB multiple.
1775
	# The metadata area begins with a 512 byte header and is followed by a
1776
	# circular buffer used for VG metadata text. The maximum size of the VG
1777
	# metadata is about half the size of the metadata buffer. VGs with large
1778
	# numbers of PVs or LVs, or VGs containing complex LV structures, may need
1779
	# additional space for VG metadata. The --metadatasize option overrides
1780
	# this setting.
1781
	# This configuration option does not have a default value defined.
1782
 
1783
	# Configuration option metadata/pvmetadataignore.
1784
	# Ignore metadata areas on a new PV.
1785
	# The --metadataignore option overrides this setting.
1786
	# If metadata areas on a PV are ignored, LVM will not store metadata
1787
	# in them.
1788
	# This configuration option is advanced.
1789
	# This configuration option has an automatic default value.
1790
	# pvmetadataignore = 0
1791
 
1792
	# Configuration option metadata/stripesize.
1793
	# This configuration option is advanced.
1794
	# This configuration option has an automatic default value.
1795
	# stripesize = 64
1796
# }
1797
 
1798
# Configuration section report.
1799
# LVM report command output formatting.
1800
# This configuration section has an automatic default value.
1801
# report {
1802
 
1803
	# Configuration option report/output_format.
1804
	# Format of LVM command's report output.
1805
	# If there is more than one report per command, then the format
1806
	# is applied for all reports. You can also change output format
1807
	# directly on command line using --reportformat option which
1808
	# has precedence over log/output_format setting.
1809
	# Accepted values:
1810
	#   basic
1811
	#     Original format with columns and rows. If there is more than
1812
	#     one report per command, each report is prefixed with report's
1813
	#     name for identification.
1814
	#   json
1815
	#     JSON format.
1816
	# This configuration option has an automatic default value.
1817
	# output_format = "basic"
1818
 
1819
	# Configuration option report/compact_output.
1820
	# Do not print empty values for all report fields.
1821
	# If enabled, all fields that don't have a value set for any of the
1822
	# rows reported are skipped and not printed. Compact output is
1823
	# applicable only if report/buffered is enabled. If you need to
1824
	# compact only specified fields, use compact_output=0 and define
1825
	# report/compact_output_cols configuration setting instead.
1826
	# This configuration option has an automatic default value.
1827
	# compact_output = 0
1828
 
1829
	# Configuration option report/compact_output_cols.
1830
	# Do not print empty values for specified report fields.
1831
	# If defined, specified fields that don't have a value set for any
1832
	# of the rows reported are skipped and not printed. Compact output
1833
	# is applicable only if report/buffered is enabled. If you need to
1834
	# compact all fields, use compact_output=1 instead in which case
1835
	# the compact_output_cols setting is then ignored.
1836
	# This configuration option has an automatic default value.
1837
	# compact_output_cols = ""
1838
 
1839
	# Configuration option report/aligned.
1840
	# Align columns in report output.
1841
	# This configuration option has an automatic default value.
1842
	# aligned = 1
1843
 
1844
	# Configuration option report/buffered.
1845
	# Buffer report output.
1846
	# When buffered reporting is used, the report's content is appended
1847
	# incrementally to include each object being reported until the report
1848
	# is flushed to output which normally happens at the end of command
1849
	# execution. Otherwise, if buffering is not used, each object is
1850
	# reported as soon as its processing is finished.
1851
	# This configuration option has an automatic default value.
1852
	# buffered = 1
1853
 
1854
	# Configuration option report/headings.
1855
	# Show headings for columns on report.
1856
	# This configuration option has an automatic default value.
1857
	# headings = 1
1858
 
1859
	# Configuration option report/separator.
1860
	# A separator to use on report after each field.
1861
	# This configuration option has an automatic default value.
1862
	# separator = " "
1863
 
1864
	# Configuration option report/list_item_separator.
1865
	# A separator to use for list items when reported.
1866
	# This configuration option has an automatic default value.
1867
	# list_item_separator = ","
1868
 
1869
	# Configuration option report/prefixes.
1870
	# Use a field name prefix for each field reported.
1871
	# This configuration option has an automatic default value.
1872
	# prefixes = 0
1873
 
1874
	# Configuration option report/quoted.
1875
	# Quote field values when using field name prefixes.
1876
	# This configuration option has an automatic default value.
1877
	# quoted = 1
1878
 
1879
	# Configuration option report/columns_as_rows.
1880
	# Output each column as a row.
1881
	# If set, this also implies report/prefixes=1.
1882
	# This configuration option has an automatic default value.
1883
	# columns_as_rows = 0
1884
 
1885
	# Configuration option report/binary_values_as_numeric.
1886
	# Use binary values 0 or 1 instead of descriptive literal values.
1887
	# For columns that have exactly two valid values to report
1888
	# (not counting the 'unknown' value which denotes that the
1889
	# value could not be determined).
1890
	# This configuration option has an automatic default value.
1891
	# binary_values_as_numeric = 0
1892
 
1893
	# Configuration option report/time_format.
1894
	# Set time format for fields reporting time values.
1895
	# Format specification is a string which may contain special character
1896
	# sequences and ordinary character sequences. Ordinary character
1897
	# sequences are copied verbatim. Each special character sequence is
1898
	# introduced by the '%' character and such sequence is then
1899
	# substituted with a value as described below.
1900
	#
1901
	# Accepted values:
1902
	#   %a
1903
	#     The abbreviated name of the day of the week according to the
1904
	#     current locale.
1905
	#   %A
1906
	#     The full name of the day of the week according to the current
1907
	#     locale.
1908
	#   %b
1909
	#     The abbreviated month name according to the current locale.
1910
	#   %B
1911
	#     The full month name according to the current locale.
1912
	#   %c
1913
	#     The preferred date and time representation for the current
1914
	#     locale (alt E)
1915
	#   %C
1916
	#     The century number (year/100) as a 2-digit integer. (alt E)
1917
	#   %d
1918
	#     The day of the month as a decimal number (range 01 to 31).
1919
	#     (alt O)
1920
	#   %D
1921
	#     Equivalent to %m/%d/%y. (For Americans only. Americans should
1922
	#     note that in other countries%d/%m/%y is rather common. This
1923
	#     means that in international context this format is ambiguous and
1924
	#     should not be used.
1925
	#   %e
1926
	#     Like %d, the day of the month as a decimal number, but a leading
1927
	#     zero is replaced by a space. (alt O)
1928
	#   %E
1929
	#     Modifier: use alternative local-dependent representation if
1930
	#     available.
1931
	#   %F
1932
	#     Equivalent to %Y-%m-%d (the ISO 8601 date format).
1933
	#   %G
1934
	#     The ISO 8601 week-based year with century as adecimal number.
1935
	#     The 4-digit year corresponding to the ISO week number (see %V).
1936
	#     This has the same format and value as %Y, except that if the
1937
	#     ISO week number belongs to the previous or next year, that year
1938
	#     is used instead.
1939
	#   %g
1940
	#     Like %G, but without century, that is, with a 2-digit year
1941
	#     (00-99).
1942
	#   %h
1943
	#     Equivalent to %b.
1944
	#   %H
1945
	#     The hour as a decimal number using a 24-hour clock
1946
	#     (range 00 to 23). (alt O)
1947
	#   %I
1948
	#     The hour as a decimal number using a 12-hour clock
1949
	#     (range 01 to 12). (alt O)
1950
	#   %j
1951
	#     The day of the year as a decimal number (range 001 to 366).
1952
	#   %k
1953
	#     The hour (24-hour clock) as a decimal number (range 0 to 23);
1954
	#     single digits are preceded by a blank. (See also %H.)
1955
	#   %l
1956
	#     The hour (12-hour clock) as a decimal number (range 1 to 12);
1957
	#     single digits are preceded by a blank. (See also %I.)
1958
	#   %m
1959
	#     The month as a decimal number (range 01 to 12). (alt O)
1960
	#   %M
1961
	#     The minute as a decimal number (range 00 to 59). (alt O)
1962
	#   %O
1963
	#     Modifier: use alternative numeric symbols.
1964
	#   %p
1965
	#     Either "AM" or "PM" according to the given time value,
1966
	#     or the corresponding strings for the current locale. Noon is
1967
	#     treated as "PM" and midnight as "AM".
1968
	#   %P
1969
	#     Like %p but in lowercase: "am" or "pm" or a corresponding
1970
	#     string for the current locale.
1971
	#   %r
1972
	#     The time in a.m. or p.m. notation. In the POSIX locale this is
1973
	#     equivalent to %I:%M:%S %p.
1974
	#   %R
1975
	#     The time in 24-hour notation (%H:%M). For a version including
1976
	#     the seconds, see %T below.
1977
	#   %s
1978
	#     The number of seconds since the Epoch,
1979
	#     1970-01-01 00:00:00 +0000 (UTC)
1980
	#   %S
1981
	#     The second as a decimal number (range 00 to 60). (The range is
1982
	#     up to 60 to allow for occasional leap seconds.) (alt O)
1983
	#   %t
1984
	#     A tab character.
1985
	#   %T
1986
	#     The time in 24-hour notation (%H:%M:%S).
1987
	#   %u
1988
	#     The day of the week as a decimal, range 1 to 7, Monday being 1.
1989
	#     See also %w. (alt O)
1990
	#   %U
1991
	#     The week number of the current year as a decimal number,
1992
	#     range 00 to 53, starting with the first Sunday as the first
1993
	#     day of week 01. See also %V and %W. (alt O)
1994
	#   %V
1995
	#     The ISO 8601 week number of the current year as a decimal number,
1996
	#     range 01 to 53, where week 1 is the first week that has at least
1997
	#     4 days in the new year. See also %U and %W. (alt O)
1998
	#   %w
1999
	#     The day of the week as a decimal, range 0 to 6, Sunday being 0.
2000
	#     See also %u. (alt O)
2001
	#   %W
2002
	#     The week number of the current year as a decimal number,
2003
	#     range 00 to 53, starting with the first Monday as the first day
2004
	#     of week 01. (alt O)
2005
	#   %x
2006
	#     The preferred date representation for the current locale without
2007
	#     the time. (alt E)
2008
	#   %X
2009
	#     The preferred time representation for the current locale without
2010
	#     the date. (alt E)
2011
	#   %y
2012
	#     The year as a decimal number without a century (range 00 to 99).
2013
	#     (alt E, alt O)
2014
	#   %Y
2015
	#     The year as a decimal number including the century. (alt E)
2016
	#   %z
2017
	#     The +hhmm or -hhmm numeric timezone (that is, the hour and minute
2018
	#     offset from UTC).
2019
	#   %Z
2020
	#     The timezone name or abbreviation.
2021
	#   %%
2022
	#     A literal '%' character.
2023
	#
2024
	# This configuration option has an automatic default value.
2025
	# time_format = "%Y-%m-%d %T %z"
2026
 
2027
	# Configuration option report/devtypes_sort.
2028
	# List of columns to sort by when reporting 'lvm devtypes' command.
2029
	# See 'lvm devtypes -o help' for the list of possible fields.
2030
	# This configuration option has an automatic default value.
2031
	# devtypes_sort = "devtype_name"
2032
 
2033
	# Configuration option report/devtypes_cols.
2034
	# List of columns to report for 'lvm devtypes' command.
2035
	# See 'lvm devtypes -o help' for the list of possible fields.
2036
	# This configuration option has an automatic default value.
2037
	# devtypes_cols = "devtype_name,devtype_max_partitions,devtype_description"
2038
 
2039
	# Configuration option report/devtypes_cols_verbose.
2040
	# List of columns to report for 'lvm devtypes' command in verbose mode.
2041
	# See 'lvm devtypes -o help' for the list of possible fields.
2042
	# This configuration option has an automatic default value.
2043
	# devtypes_cols_verbose = "devtype_name,devtype_max_partitions,devtype_description"
2044
 
2045
	# Configuration option report/lvs_sort.
2046
	# List of columns to sort by when reporting 'lvs' command.
2047
	# See 'lvs -o help' for the list of possible fields.
2048
	# This configuration option has an automatic default value.
2049
	# lvs_sort = "vg_name,lv_name"
2050
 
2051
	# Configuration option report/lvs_cols.
2052
	# List of columns to report for 'lvs' command.
2053
	# See 'lvs -o help' for the list of possible fields.
2054
	# This configuration option has an automatic default value.
2055
	# lvs_cols = "lv_name,vg_name,lv_attr,lv_size,pool_lv,origin,data_percent,metadata_percent,move_pv,mirror_log,copy_percent,convert_lv"
2056
 
2057
	# Configuration option report/lvs_cols_verbose.
2058
	# List of columns to report for 'lvs' command in verbose mode.
2059
	# See 'lvs -o help' for the list of possible fields.
2060
	# This configuration option has an automatic default value.
2061
	# lvs_cols_verbose = "lv_name,vg_name,seg_count,lv_attr,lv_size,lv_major,lv_minor,lv_kernel_major,lv_kernel_minor,pool_lv,origin,data_percent,metadata_percent,move_pv,copy_percent,mirror_log,convert_lv,lv_uuid,lv_profile"
2062
 
2063
	# Configuration option report/vgs_sort.
2064
	# List of columns to sort by when reporting 'vgs' command.
2065
	# See 'vgs -o help' for the list of possible fields.
2066
	# This configuration option has an automatic default value.
2067
	# vgs_sort = "vg_name"
2068
 
2069
	# Configuration option report/vgs_cols.
2070
	# List of columns to report for 'vgs' command.
2071
	# See 'vgs -o help' for the list of possible fields.
2072
	# This configuration option has an automatic default value.
2073
	# vgs_cols = "vg_name,pv_count,lv_count,snap_count,vg_attr,vg_size,vg_free"
2074
 
2075
	# Configuration option report/vgs_cols_verbose.
2076
	# List of columns to report for 'vgs' command in verbose mode.
2077
	# See 'vgs -o help' for the list of possible fields.
2078
	# This configuration option has an automatic default value.
2079
	# vgs_cols_verbose = "vg_name,vg_attr,vg_extent_size,pv_count,lv_count,snap_count,vg_size,vg_free,vg_uuid,vg_profile"
2080
 
2081
	# Configuration option report/pvs_sort.
2082
	# List of columns to sort by when reporting 'pvs' command.
2083
	# See 'pvs -o help' for the list of possible fields.
2084
	# This configuration option has an automatic default value.
2085
	# pvs_sort = "pv_name"
2086
 
2087
	# Configuration option report/pvs_cols.
2088
	# List of columns to report for 'pvs' command.
2089
	# See 'pvs -o help' for the list of possible fields.
2090
	# This configuration option has an automatic default value.
2091
	# pvs_cols = "pv_name,vg_name,pv_fmt,pv_attr,pv_size,pv_free"
2092
 
2093
	# Configuration option report/pvs_cols_verbose.
2094
	# List of columns to report for 'pvs' command in verbose mode.
2095
	# See 'pvs -o help' for the list of possible fields.
2096
	# This configuration option has an automatic default value.
2097
	# pvs_cols_verbose = "pv_name,vg_name,pv_fmt,pv_attr,pv_size,pv_free,dev_size,pv_uuid"
2098
 
2099
	# Configuration option report/segs_sort.
2100
	# List of columns to sort by when reporting 'lvs --segments' command.
2101
	# See 'lvs --segments -o help' for the list of possible fields.
2102
	# This configuration option has an automatic default value.
2103
	# segs_sort = "vg_name,lv_name,seg_start"
2104
 
2105
	# Configuration option report/segs_cols.
2106
	# List of columns to report for 'lvs --segments' command.
2107
	# See 'lvs --segments -o help' for the list of possible fields.
2108
	# This configuration option has an automatic default value.
2109
	# segs_cols = "lv_name,vg_name,lv_attr,stripes,segtype,seg_size"
2110
 
2111
	# Configuration option report/segs_cols_verbose.
2112
	# List of columns to report for 'lvs --segments' command in verbose mode.
2113
	# See 'lvs --segments -o help' for the list of possible fields.
2114
	# This configuration option has an automatic default value.
2115
	# segs_cols_verbose = "lv_name,vg_name,lv_attr,seg_start,seg_size,stripes,segtype,stripesize,chunksize"
2116
 
2117
	# Configuration option report/pvsegs_sort.
2118
	# List of columns to sort by when reporting 'pvs --segments' command.
2119
	# See 'pvs --segments -o help' for the list of possible fields.
2120
	# This configuration option has an automatic default value.
2121
	# pvsegs_sort = "pv_name,pvseg_start"
2122
 
2123
	# Configuration option report/pvsegs_cols.
2124
	# List of columns to sort by when reporting 'pvs --segments' command.
2125
	# See 'pvs --segments -o help' for the list of possible fields.
2126
	# This configuration option has an automatic default value.
2127
	# pvsegs_cols = "pv_name,vg_name,pv_fmt,pv_attr,pv_size,pv_free,pvseg_start,pvseg_size"
2128
 
2129
	# Configuration option report/pvsegs_cols_verbose.
2130
	# List of columns to sort by when reporting 'pvs --segments' command in verbose mode.
2131
	# See 'pvs --segments -o help' for the list of possible fields.
2132
	# This configuration option has an automatic default value.
2133
	# pvsegs_cols_verbose = "pv_name,vg_name,pv_fmt,pv_attr,pv_size,pv_free,pvseg_start,pvseg_size,lv_name,seg_start_pe,segtype,seg_pe_ranges"
2134
 
2135
	# Configuration option report/vgs_cols_full.
2136
	# List of columns to report for lvm fullreport's 'vgs' subreport.
2137
	# See 'vgs -o help' for the list of possible fields.
2138
	# This configuration option has an automatic default value.
2139
	# vgs_cols_full = "vg_all"
2140
 
2141
	# Configuration option report/pvs_cols_full.
2142
	# List of columns to report for lvm fullreport's 'vgs' subreport.
2143
	# See 'pvs -o help' for the list of possible fields.
2144
	# This configuration option has an automatic default value.
2145
	# pvs_cols_full = "pv_all"
2146
 
2147
	# Configuration option report/lvs_cols_full.
2148
	# List of columns to report for lvm fullreport's 'lvs' subreport.
2149
	# See 'lvs -o help' for the list of possible fields.
2150
	# This configuration option has an automatic default value.
2151
	# lvs_cols_full = "lv_all"
2152
 
2153
	# Configuration option report/pvsegs_cols_full.
2154
	# List of columns to report for lvm fullreport's 'pvseg' subreport.
2155
	# See 'pvs --segments -o help' for the list of possible fields.
2156
	# This configuration option has an automatic default value.
2157
	# pvsegs_cols_full = "pvseg_all,pv_uuid,lv_uuid"
2158
 
2159
	# Configuration option report/segs_cols_full.
2160
	# List of columns to report for lvm fullreport's 'seg' subreport.
2161
	# See 'lvs --segments -o help' for the list of possible fields.
2162
	# This configuration option has an automatic default value.
2163
	# segs_cols_full = "seg_all,lv_uuid"
2164
 
2165
	# Configuration option report/vgs_sort_full.
2166
	# List of columns to sort by when reporting lvm fullreport's 'vgs' subreport.
2167
	# See 'vgs -o help' for the list of possible fields.
2168
	# This configuration option has an automatic default value.
2169
	# vgs_sort_full = "vg_name"
2170
 
2171
	# Configuration option report/pvs_sort_full.
2172
	# List of columns to sort by when reporting lvm fullreport's 'vgs' subreport.
2173
	# See 'pvs -o help' for the list of possible fields.
2174
	# This configuration option has an automatic default value.
2175
	# pvs_sort_full = "pv_name"
2176
 
2177
	# Configuration option report/lvs_sort_full.
2178
	# List of columns to sort by when reporting lvm fullreport's 'lvs' subreport.
2179
	# See 'lvs -o help' for the list of possible fields.
2180
	# This configuration option has an automatic default value.
2181
	# lvs_sort_full = "vg_name,lv_name"
2182
 
2183
	# Configuration option report/pvsegs_sort_full.
2184
	# List of columns to sort by when reporting for lvm fullreport's 'pvseg' subreport.
2185
	# See 'pvs --segments -o help' for the list of possible fields.
2186
	# This configuration option has an automatic default value.
2187
	# pvsegs_sort_full = "pv_uuid,pvseg_start"
2188
 
2189
	# Configuration option report/segs_sort_full.
2190
	# List of columns to sort by when reporting lvm fullreport's 'seg' subreport.
2191
	# See 'lvs --segments -o help' for the list of possible fields.
2192
	# This configuration option has an automatic default value.
2193
	# segs_sort_full = "lv_uuid,seg_start"
2194
 
2195
	# Configuration option report/mark_hidden_devices.
2196
	# Use brackets [] to mark hidden devices.
2197
	# This configuration option has an automatic default value.
2198
	# mark_hidden_devices = 1
2199
 
2200
	# Configuration option report/two_word_unknown_device.
2201
	# Use the two words 'unknown device' in place of '[unknown]'.
2202
	# This is displayed when the device for a PV is not known.
2203
	# This configuration option has an automatic default value.
2204
	# two_word_unknown_device = 0
2205
# }
2206
 
2207
# Configuration section dmeventd.
2208
# Settings for the LVM event daemon.
2209
dmeventd {
2210
 
2211
	# Configuration option dmeventd/mirror_library.
2212
	# The library dmeventd uses when monitoring a mirror device.
2213
	# libdevmapper-event-lvm2mirror.so attempts to recover from
2214
	# failures. It removes failed devices from a volume group and
2215
	# reconfigures a mirror as necessary. If no mirror library is
2216
	# provided, mirrors are not monitored through dmeventd.
2217
	# This configuration option has an automatic default value.
2218
	# mirror_library = "libdevmapper-event-lvm2mirror.so"
2219
 
2220
	# Configuration option dmeventd/raid_library.
2221
	# This configuration option has an automatic default value.
2222
	# raid_library = "libdevmapper-event-lvm2raid.so"
2223
 
2224
	# Configuration option dmeventd/snapshot_library.
2225
	# The library dmeventd uses when monitoring a snapshot device.
2226
	# libdevmapper-event-lvm2snapshot.so monitors the filling of snapshots
2227
	# and emits a warning through syslog when the usage exceeds 80%. The
2228
	# warning is repeated when 85%, 90% and 95% of the snapshot is filled.
2229
	# This configuration option has an automatic default value.
2230
	# snapshot_library = "libdevmapper-event-lvm2snapshot.so"
2231
 
2232
	# Configuration option dmeventd/thin_library.
2233
	# The library dmeventd uses when monitoring a thin device.
2234
	# libdevmapper-event-lvm2thin.so monitors the filling of a pool
2235
	# and emits a warning through syslog when the usage exceeds 80%. The
2236
	# warning is repeated when 85%, 90% and 95% of the pool is filled.
2237
	# This configuration option has an automatic default value.
2238
	# thin_library = "libdevmapper-event-lvm2thin.so"
2239
 
2240
	# Configuration option dmeventd/thin_command.
2241
	# The plugin runs command with each 5% increment when thin-pool data volume
2242
	# or metadata volume gets above 50%.
2243
	# Command which starts with 'lvm ' prefix is internal lvm command.
2244
	# You can write your own handler to customise behaviour in more details.
2245
	# User handler is specified with the full path starting with '/'.
2246
	# This configuration option has an automatic default value.
2247
	# thin_command = "lvm lvextend --use-policies"
2248
 
2249
	# Configuration option dmeventd/vdo_library.
2250
	# The library dmeventd uses when monitoring a VDO pool device.
2251
	# libdevmapper-event-lvm2vdo.so monitors the filling of a pool
2252
	# and emits a warning through syslog when the usage exceeds 80%. The
2253
	# warning is repeated when 85%, 90% and 95% of the pool is filled.
2254
	# This configuration option has an automatic default value.
2255
	# vdo_library = "libdevmapper-event-lvm2vdo.so"
2256
 
2257
	# Configuration option dmeventd/vdo_command.
2258
	# The plugin runs command with each 5% increment when VDO pool volume
2259
	# gets above 50%.
2260
	# Command which starts with 'lvm ' prefix is internal lvm command.
2261
	# You can write your own handler to customise behaviour in more details.
2262
	# User handler is specified with the full path starting with '/'.
2263
	# This configuration option has an automatic default value.
2264
	# vdo_command = "lvm lvextend --use-policies"
2265
 
2266
	# Configuration option dmeventd/executable.
2267
	# The full path to the dmeventd binary.
2268
	# This configuration option has an automatic default value.
2269
	# executable = "/usr/sbin/dmeventd"
2270
}
2271
 
2272
# Configuration section tags.
2273
# Host tag settings.
2274
# This configuration section has an automatic default value.
2275
# tags {
2276
 
2277
	# Configuration option tags/hosttags.
2278
	# Create a host tag using the machine name.
2279
	# The machine name is nodename returned by uname(2).
2280
	# This configuration option has an automatic default value.
2281
	# hosttags = 0
2282
 
2283
	# Configuration section tags/<tag>.
2284
	# Replace this subsection name with a custom tag name.
2285
	# Multiple subsections like this can be created. The '@' prefix for
2286
	# tags is optional. This subsection can contain host_list, which is a
2287
	# list of machine names. If the name of the local machine is found in
2288
	# host_list, then the name of this subsection is used as a tag and is
2289
	# applied to the local machine as a 'host tag'. If this subsection is
2290
	# empty (has no host_list), then the subsection name is always applied
2291
	# as a 'host tag'.
2292
	#
2293
	# Example
2294
	# The host tag foo is given to all hosts, and the host tag
2295
	# bar is given to the hosts named machine1 and machine2.
2296
	# tags { foo { } bar { host_list = [ "machine1", "machine2" ] } }
2297
	#
2298
	# This configuration section has variable name.
2299
	# This configuration section has an automatic default value.
2300
	# tag {
2301
 
2302
		# Configuration option tags/<tag>/host_list.
2303
		# A list of machine names.
2304
		# These machine names are compared to the nodename returned
2305
		# by uname(2). If the local machine name matches an entry in
2306
		# this list, the name of the subsection is applied to the
2307
		# machine as a 'host tag'.
2308
		# This configuration option does not have a default value defined.
2309
	# }
2310
# }