shaba/lvm2
1
0
Fork 0
mirror of git://sourceware.org/git/lvm2.git synced 2024-12-21 13:34:40 +03:00
Code Releases Activity

config: update descriptions

Browse Source 
- filter, preferred_names
This commit is contained in:
David Teigland 2015-04-13 13:39:30 -05:00
parent e4261ba037
commit 29220a181a
1 changed files with 24 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
lib/config/config_settings.h
View File

@ -159,10 +159,11 @@ cfg(devices_external_device_info_source_CFG, "external_device_info_source", devi
"only if LVM is compiled with udev support.\n") "only if LVM is compiled with udev support.\n")
cfg_array(devices_preferred_names_CFG, "preferred_names", devices_CFG_SECTION, CFG_ALLOW_EMPTY | CFG_DEFAULT_UNDEFINED, CFG_TYPE_STRING, NULL, vsn(1, 2, 19), cfg_array(devices_preferred_names_CFG, "preferred_names", devices_CFG_SECTION, CFG_ALLOW_EMPTY | CFG_DEFAULT_UNDEFINED, CFG_TYPE_STRING, NULL, vsn(1, 2, 19),
"If several entries in the scanned directories correspond to the\n" "Select which path name to display for a block device.\n"
"same block device and the tools need to display a name for the device,\n" "If multiple path names exist for a block device,\n"
"all the path names are matched against each item in this list of\n" "and LVM needs to display a name for the device,\n"
"regular expressions. The first match is used.\n" "the path names are matched against each item in\n"
"this list of regular expressions. The first match is used.\n"
"Try to avoid using undescriptive /dev/dm-N names, if present.\n" "Try to avoid using undescriptive /dev/dm-N names, if present.\n"
"If no preferred name matches, or if preferred_names are not\n" "If no preferred name matches, or if preferred_names are not\n"
"defined, built-in rules are used until one produces a preference.\n" "defined, built-in rules are used until one produces a preference.\n"
@ -175,33 +176,39 @@ cfg_array(devices_preferred_names_CFG, "preferred_names", devices_CFG_SECTION, C
"preferred_names = [ \"^/dev/mpath/\", \"^/dev/mapper/mpath\", \"^/dev/[hs]d\" ]\n") "preferred_names = [ \"^/dev/mpath/\", \"^/dev/mapper/mpath\", \"^/dev/[hs]d\" ]\n")
cfg_array(devices_filter_CFG, "filter", devices_CFG_SECTION, CFG_DEFAULT_UNDEFINED, CFG_TYPE_STRING, NULL, vsn(1, 0, 0), cfg_array(devices_filter_CFG, "filter", devices_CFG_SECTION, CFG_DEFAULT_UNDEFINED, CFG_TYPE_STRING, NULL, vsn(1, 0, 0),
"Patterns used to accept or reject devices found by a scan.\n" "Limit the block devices that are used by LVM.\n"
"Patterns are regular expressions delimited by any character\n" "This is a list of regular expressions used to accept or\n"
"and preceded by 'a' for accept or 'r' for reject.\n" "reject block device path names. Each regex is delimited\n"
"The list is traversed in order, and the first regex that matches\n" "by a vertical bar '|' (or any character) and is preceded\n"
"determines if the device is accepted or rejected (ignored).\n" "by 'a' to accept the path, or by 'r' to reject the path.\n"
"Devices that don't match any patterns are accepted.\n" "The first regex in the list to match the path is used,\n"
"If there are several names for the same device, e.g. from symlinks,\n" "producing the 'a' or 'r' result for the device.\n"
"the first pattern matching any of the names determines if the\n" "When multiple path names exist for a block device, if any\n"
"device is accepted or rejected (depending on whether the first\n" "path name matches an 'a' pattern before an 'r' pattern,\n"
"matching pattern is 'a' or 'r'.)\n" "then the device is accepted. If all the path names match\n"
"an 'r' pattern first, then the device is rejected.\n"
"Unmatching path names do not affect the accept or reject\n"
"decision. If no path names for a device match a pattern,\n"
"then the device is accepted.\n"
"Be careful mixing 'a' and 'r' patterns, as the combination\n"
"might produce unexpected results (test any changes.)\n"
"Run vgscan after changing the filter to regenerate the cache.\n" "Run vgscan after changing the filter to regenerate the cache.\n"
"See the use_lvmetad comment for a special case regarding filters.\n" "See the use_lvmetad comment for a special case regarding filters.\n"
"Example:\n" "Example:\n"
"Accept every block device.\n" "Accept every block device.\n"
"filter = [ \"a/.*/\" ]\n" "filter = [ \"a|.*/|" ]\n"
"Example:\n" "Example:\n"
"Reject the cdrom drive.\n" "Reject the cdrom drive.\n"
"filter = [ \"r|/dev/cdrom|\" ]\n" "filter = [ \"r|/dev/cdrom|\" ]\n"
"Example:\n" "Example:\n"
"Work with just loopback devices, e.g. for testing.\n" "Work with just loopback devices, e.g. for testing.\n"
"filter = [ \"a/loop/\", \"r/.*/\" ]\n" "filter = [ \"a|loop|\", \"r|.*|\" ]\n"
"Example:\n" "Example:\n"
"Accept all loop devices and ide drives except hdc.\n" "Accept all loop devices and ide drives except hdc.\n"
"filter =[ \"a|loop|\", \"r|/dev/hdc|\", \"a|/dev/ide|\", \"r|.*|\" ]\n" "filter =[ \"a|loop|\", \"r|/dev/hdc|\", \"a|/dev/ide|\", \"r|.*|\" ]\n"
"Example:\n" "Example:\n"
"Use anchors to be very specific.\n" "Use anchors to be very specific.\n"
"filter = [ \"a|^/dev/hda8$|\", \"r/.*/\" ]\n") "filter = [ \"a|^/dev/hda8$|\", \"r|.*/|" ]\n")
cfg_array(devices_global_filter_CFG, "global_filter", devices_CFG_SECTION, CFG_DEFAULT_UNDEFINED, CFG_TYPE_STRING, NULL, vsn(2, 2, 98), cfg_array(devices_global_filter_CFG, "global_filter", devices_CFG_SECTION, CFG_DEFAULT_UNDEFINED, CFG_TYPE_STRING, NULL, vsn(2, 2, 98),
"Since filter is often overridden from the command line,\n" "Since filter is often overridden from the command line,\n"