From 29c0763480c1e830824c922aa9226a100cceb8c1 Mon Sep 17 00:00:00 2001
From: Marian Csontos <mcsontos@redhat.com>
Date: Wed, 15 Nov 2023 13:35:52 +0100
Subject: [PATCH] make: generate

---
 conf/example.conf.in    |  2 +-
 man/lvmdevices.8_pregen | 19 +++++++++++++++++++
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/conf/example.conf.in b/conf/example.conf.in
index 773f2f483..779ea5129 100644
--- a/conf/example.conf.in
+++ b/conf/example.conf.in
@@ -149,7 +149,7 @@ devices {
 	# at other devices, but only those that are likely to have the PV.
 	# If "all", lvm will look at all devices on the system.
 	# This configuration option has an automatic default value.
-	# search_for_devnames = "auto"
+	# search_for_devnames = "all"
 
 	# Configuration option devices/device_ids_refresh.
 	# Find PVs on new devices and update the device IDs in the devices file.
diff --git a/man/lvmdevices.8_pregen b/man/lvmdevices.8_pregen
index 84fedec9f..228b7aaa2 100644
--- a/man/lvmdevices.8_pregen
+++ b/man/lvmdevices.8_pregen
@@ -53,6 +53,8 @@ lvmdevices \(em Manage the devices file
     \fB--profile\fP \fIString\fP
 .br
  \fB-q\fP|\fB--quiet\fP
+.br
+    \fB--refresh\fP
 .br
  \fB-t\fP|\fB--test\fP
 .br
@@ -222,6 +224,8 @@ Check the devices file and report incorrect values.
 .br
 .RS 4
 .ad l
+[    \fB--refresh\fP ]
+.br
 [ COMMON_OPTIONS ]
 .ad b
 .RE
@@ -237,6 +241,8 @@ Update the devices file to fix incorrect values.
 .ad l
 [    \fB--delnotfound\fP ]
 .br
+[    \fB--refresh\fP ]
+.br
 [ COMMON_OPTIONS ]
 .ad b
 .RE
@@ -481,6 +487,19 @@ Suppress output and log messages. Overrides --debug and --verbose.
 Repeat once to also suppress any prompts with answer 'no'.
 .
 .HP
+\fB--refresh\fP
+.br
+Search for missing PVs on new devices, and update the devices file
+with new device IDs for the PVs if they are found on new devices.
+This is useful if PVs have been moved to new devices with new WWIDs,
+for example. The device ID type and name may both change for a PV.
+WARNING: if a PV is detached from the system, but a device containing a
+clone or snapshot of that PV is present, then refresh would replace the
+correct device ID with the clone/snapshot device ID, and lvm would begin
+using the wrong device for the PV. Use deldev/adddev to safely change
+a PV device ID in this scenario.
+.
+.HP
 \fB-t\fP|\fB--test\fP
 .br
 Run in test mode. Commands will not update metadata.