man: mention force behavior in various places

diff --git a/man/lvremove.8.des b/man/lvremove.8.des
index d049c635f732cdc83f7fb665b8f17beabe442df1..14587c13497b2f9de04cf35bd698396ce568be22 100644 (file)
--- a/man/lvremove.8.des
+++ b/man/lvremove.8.des
@@ -6,6 +6,11 @@ removal.  LVs cannot be deactivated or removed while they are open (e.g.
 if they contain a mounted filesystem). Removing an origin LV will also
 remove all dependent snapshots.
 
+When a single force option is used, LVs are removed without confirmation,
+and the command will try to deactivate unused LVs.
+
+To remove damaged LVs, two force options may be required (\fB-ff\fP).
+
 \fBHistorical LVs\fP
 
 If the configuration setting \fBmetadata/record_lvs_history\fP is enabled

diff --git a/man/pvcreate.8.des b/man/pvcreate.8.des
index 3dfddbcb704e2880ecbb213ff2012f12a0c02125..1b00e9e2c3417325551985b439e4446def909730 100644 (file)
--- a/man/pvcreate.8.des
+++ b/man/pvcreate.8.des
@@ -16,3 +16,6 @@ data on that disk. This can be done by zeroing the first sector with:
 Use \fBvgcreate\fP(8) to create a new VG on the PV, or \fBvgextend\fP(8)
 to add the PV to existing VG.
 
+The force option will create a PV without confirmation.  Repeating the
+force option (\fB-ff\fP) will forcibly create a PV, overriding checks that
+normally prevent it, e.g. if the PV is already in a VG.

diff --git a/man/pvremove.8.des b/man/pvremove.8.des
index f12b76e638f32a889ca523572ec886e4dcf3b80f..cc84148a127c13f6e58ef95efb156ad7c24ec2c5 100644 (file)
--- a/man/pvremove.8.des
+++ b/man/pvremove.8.des
@@ -1,2 +1,7 @@
 pvremove wipes the label on a device so that LVM will no longer recognise
 it as a PV.
+
+A PV cannot be removed from a VG while it is used by an active LV.
+
+Repeat the force option (\fB-ff\fP) to forcibly remove a PV belonging to
+an existing VG. Normally, \fBvgreduce\fP(8) should be used instead.

diff --git a/man/vgcfgrestore.8.des b/man/vgcfgrestore.8.des
index cb7867d3b1554bd3fbbabcb0540b1297cdbe48ef..ee3a99e6d24169d1b5229a237e2954881917befc 100644 (file)
--- a/man/vgcfgrestore.8.des
+++ b/man/vgcfgrestore.8.des
@@ -6,3 +6,6 @@ A back up file can be specified with \fB\-\-file\fP.  If no backup file is
 specified, the most recent one is used. Use \fB\-\-list\fP for a list of
 the available back up and archive files of a VG.
 
+WARNING: When a VG contains thin pools, changes to thin metadata cannot be
+reverted, and data loss may occur if thin metadata has changed. The force
+option is required to restore in this case.

diff --git a/man/vgremove.8.des b/man/vgremove.8.des
index 04dc0e30ab25fa743559106aa2ab2af05dea076b..6414c734ade8d174dc50bcbf0b85d5e72a077a50 100644 (file)
--- a/man/vgremove.8.des
+++ b/man/vgremove.8.des
@@ -4,3 +4,6 @@ to confirm LV removal.
 If one or more PVs in the VG are lost, consider
 \fBvgreduce \-\-removemissing\fP to make the VG
 metadata consistent again.
+
+Repeat the force option (\fB-ff\fP) to forcibly remove LVs in the VG
+without confirmation.