summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorDavid Teigland <teigland@redhat.com>2023-01-19 17:37:31 -0600
committerDavid Teigland <teigland@redhat.com>2023-01-31 15:30:35 -0600
commit17a3585cbb55d9a15ced9775a18b50c53a50ee8e (patch)
tree6a4d9620ead498a87456174b494a810e67c78a67 /man
parentd9f8acb65a78c20ac806efaeb7a1e39208e1a443 (diff)
downloadlvm2-17a3585cbb55d9a15ced9775a18b50c53a50ee8e.tar.gz
pvscan: use alternate device names from DEVLINKS to check filter
pvscan --cache <dev> is called by our udev rule at a time when all the symlinks for <dev> may not be created yet (by other udev rules.) The regex filter in lvm.conf may refer to <dev> using a symlink name that hasn't yet been created, which would cause <dev> to not match the filter regex. The DEVLINKS env var, set by udev, contains all the symlink names for <dev> that have been or will be created. So, we add all these symlink names to dev->aliases, as if we had found them in /dev. This allows <dev> to be recognized by a regex filter containing a symlink for <dev>.
Diffstat (limited to 'man')
-rw-r--r--man/lvmautoactivation.7_main13
1 files changed, 13 insertions, 0 deletions
diff --git a/man/lvmautoactivation.7_main b/man/lvmautoactivation.7_main
index 808ea0d9f..0f7734557 100644
--- a/man/lvmautoactivation.7_main
+++ b/man/lvmautoactivation.7_main
@@ -184,6 +184,19 @@ system from booting. A custom systemd service could be written to run
autoactivation during system startup, in which case disabling event
autoactivation may be useful.
.
+.SS lvm.conf filter
+.P
+Device symlinks from /dev/disk/ can be used in the lvm.conf filter to
+guard against changes in kernel device names. The /dev/disk/by-path/ or
+/dev/disk/by-id/ prefixes should be included in the filter names; these
+prefixes help lvm detect that symlink names are used. Filters containing
+symlinks require special matching by commands run in the lvm udev rule.
+.P
+Common symlinks, e.g. beginning with wwn-, scsi-, pci-, or lvm-pv-uuid-,
+are recommended. Uncommon or custom symlinks created by custom udev rules
+may be less reliable. If a custom udev rule creates symlinks used in the
+lvm filter, then the udev rule should be started prior to the lvm rule.
+.
.SH EXAMPLES
.P
VG "vg" contains two PVs: