* master - make generate
@ 2017-04-12 23:30 Alasdair Kergon
0 siblings, 0 replies; 5+ messages in thread
From: Alasdair Kergon @ 2017-04-12 23:30 UTC (permalink / raw)
To: lvm-devel
Gitweb: https://sourceware.org/git/?p=lvm2.git;a=commitdiff;h=5ac230095c72c578cb76996b5b8ae687d04e98a9
Commit: 5ac230095c72c578cb76996b5b8ae687d04e98a9
Parent: a3e8354479f2b6c3d35fdc992d4114b244326833
Author: Alasdair G Kergon <agk@redhat.com>
AuthorDate: Thu Apr 13 00:30:05 2017 +0100
Committer: Alasdair G Kergon <agk@redhat.com>
CommitterDate: Thu Apr 13 00:30:05 2017 +0100
make generate
---
conf/example.conf.in | 28 +++++++++------
man/lvchange.8_pregen | 48 +++++++++++++++++++++----
man/lvconvert.8_pregen | 81 +++++++++++++++++++++++-------------------
man/lvcreate.8_pregen | 15 ++++----
man/lvdisplay.8_pregen | 13 -------
man/lvm-fullreport.8_pregen | 13 -------
man/lvs.8_pregen | 13 -------
man/lvscan.8_pregen | 13 -------
man/pvs.8_pregen | 13 -------
man/vgcfgbackup.8_pregen | 13 -------
man/vgchange.8_pregen | 16 ++++----
man/vgdisplay.8_pregen | 13 -------
man/vgs.8_pregen | 13 -------
man/vgscan.8_pregen | 13 -------
14 files changed, 116 insertions(+), 189 deletions(-)
diff --git a/conf/example.conf.in b/conf/example.conf.in
index 614ce53..78f11d1 100644
--- a/conf/example.conf.in
+++ b/conf/example.conf.in
@@ -389,6 +389,17 @@ allocation {
# Cache pool metadata and data will always use different PVs.
cache_pool_metadata_require_separate_pvs = 0
+ # Configuration option allocation/cache_metadata_format.
+ # Sets default metadata format for new cache.
+ #
+ # Accepted values:
+ # 0 Automatically detected best available format
+ # 1 Original format
+ # 2 Improved 2nd. generation format
+ #
+ # This configuration option has an automatic default value.
+ # cache_metadata_format = 0
+
# Configuration option allocation/cache_mode.
# The default cache mode used for new cache.
#
@@ -403,17 +414,6 @@ allocation {
# This configuration option has an automatic default value.
# cache_mode = "writethrough"
- # Configuration option allocation/cache_metadata_format.
- # Sets default metadata format for new cache.
- #
- # Accepted values:
- # 0 Automatically detected best available format
- # 1 Original format
- # 2 Improved 2nd. generation format
- #
- # This configuration option has an automatic default value.
- # cache_metadata_format = 0
-
# Configuration option allocation/cache_policy.
# The default cache policy used for new cache volume.
# Since kernel 4.2 the default policy is smq (Stochastic multiqueue),
@@ -1069,6 +1069,12 @@ global {
# This configuration option has an automatic default value.
# cache_repair_options = [ "" ]
+ # Configuration option global/fsadm_executable.
+ # The full path to the fsadm command.
+ # LVM uses this command to help with lvresize -r operations.
+ # This configuration option has an automatic default value.
+ # fsadm_executable = "@FSADM_PATH@"
+
# Configuration option global/system_id_source.
# The method LVM uses to set the local system ID.
# Volume Groups can also be given a system ID (by vgcreate, vgchange,
diff --git a/man/lvchange.8_pregen b/man/lvchange.8_pregen
index 199e4cc..174ad32 100644
--- a/man/lvchange.8_pregen
+++ b/man/lvchange.8_pregen
@@ -323,6 +323,14 @@ required, after which the others are optional.
[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ]
.ad b
.br
+.ad l
+[ \fB--poll\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
+.ad l
+[ \fB--monitor\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -384,6 +392,14 @@ Activate or deactivate an LV.
.ad b
.br
.ad l
+[ \fB--poll\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
+.ad l
+[ \fB--monitor\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
+.ad l
[ \fB--ignorelockingfailure\fP ]
.ad b
.br
@@ -407,9 +423,17 @@ Reactivate an LV using the latest metadata.
.ad b
.br
.ad l
+[ \fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ]
+.ad b
+.br
+.ad l
[ \fB--poll\fP \fBy\fP|\fBn\fP ]
.ad b
.br
+.ad l
+[ \fB--monitor\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -421,10 +445,6 @@ Start or stop monitoring an LV from dmeventd.
\fBlvchange\fP \fB--monitor\fP \fBy\fP|\fBn\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ...
.br
.RS 4
-.ad l
-[ \fB--poll\fP \fBy\fP|\fBn\fP ]
-.ad b
-.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -455,6 +475,18 @@ Make the minor device number persistent for an LV.
[ \fB-j\fP|\fB--major\fP \fINumber\fP ]
.ad b
.br
+.ad l
+[ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ]
+.ad b
+.br
+.ad l
+[ \fB--poll\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
+.ad l
+[ \fB--monitor\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -840,10 +872,10 @@ ignore the devices LVM creates.
.ad l
\fB-P\fP|\fB--partial\fP
.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
+Commands will do their best to activate LVs with missing PV extents.
+Missing extents may be replaced with error or zero segments
+according to the lvm.conf missing_stripe_filler setting.
+Metadata may not be changed with this option.
.ad b
.HP
.ad l
diff --git a/man/lvconvert.8_pregen b/man/lvconvert.8_pregen
index e56b6de..3652303 100644
--- a/man/lvconvert.8_pregen
+++ b/man/lvconvert.8_pregen
@@ -243,6 +243,17 @@ To display the current LV type, run the command:
.B lvs -o name,segtype
.I LV
+In some cases, an LV is a single device mapper (dm) layer above physical
+devices. In other cases, hidden LVs (dm devices) are layered between the
+visible LV and physical devices. LVs in the middle layers are called sub LVs.
+A command run on a visible LV sometimes operates on a sub LV rather than
+the specified LV. In other cases, a sub LV must be specified directly on
+the command line.
+
+Sub LVs can be displayed with the command:
+
+.B lvs -a
+
The
.B linear
type is equivalent to the
@@ -256,48 +267,44 @@ type is deprecated and the
.B raid1
type should be used. They are both implementations of mirroring.
-In some cases, an LV is a single device mapper (dm) layer above physical
-devices. In other cases, hidden LVs (dm devices) are layered between the
-visible LV and physical devices. LVs in the middle layers are called sub LVs.
-A command run on a visible LV sometimes operates on a sub LV rather than
-the specified LV. In other cases, a sub LV must be specified directly on
-the command line.
-
Striped raid types are
-.B raid0/raid0_meta
-,
-.B raid5
-(an alias for raid5_ls),
-.B raid6
-(an alias for raid6_zr) and
-.B raid10
-(an alias for raid10_near).
+\fBraid0/raid0_meta\fP,
+\fBraid5\fP (an alias for raid5_ls),
+\fBraid6\fP (an alias for raid6_zr) and
+\fBraid10\fP (an alias for raid10_near).
As opposed to mirroring, raid5 and raid6 stripe data and calculate parity
-blocks. The parity blocks can be used for data block recovery in case devices
-fail. A maximum number of one device in a raid5 LV may fail and two in case
-of raid6. Striped raid types typically rotate the parity blocks for performance
-reasons thus avoiding contention on a single device. Layouts of raid5 rotating
-parity blocks can be one of left-asymmetric (raid5_la), left-symmetric (raid5_ls
-with alias raid5), right-asymmetric (raid5_ra), right-symmetric (raid5_rs) and raid5_n,
-which doesn't rotate parity blocks. Any \"_n\" layouts allow for conversion between
-raid levels (raid5_n -> raid6 or raid5_n -> striped/raid0/raid0_meta).
-raid6 layouts are zero-restart (raid6_zr with alias raid6), next-restart (raid6_nr),
-next-continue (raid6_nc). Additionally, special raid6 layouts for raid level conversions
-between raid5 and raid6 are raid6_ls_6, raid6_rs_6, raid6_la_6 and raid6_ra_6. Those
-correspond to their raid5 counterparts (e.g. raid5_rs can be directly converted to raid6_rs_6
-and vice-versa).
-raid10 (an alias for raid10_near) is currently limited to one data copy and even number of
-sub LVs. This is a mirror group layout thus a single sub LV may fail per mirror group
-without data loss.
-Striped raid types support converting the layout, their stripesize
-and their number of stripes.
-
-The striped raid types combined with raid1 allow for conversion from linear -> striped/raid0/raid0_meta
-and vice-versa by e.g. linear <-> raid1 <-> raid5_n (then adding stripes) <-> striped/raid0/raid0_meta.
-
-Sub LVs can be displayed with the command
-.B lvs -a
+blocks. The parity blocks can be used for data block recovery in case
+devices fail. A maximum number of one device in a raid5 LV may fail, and
+two in case of raid6. Striped raid types typically rotate the parity and
+data blocks for performance reasons, thus avoiding contention on a single
+device. Specific arrangements of parity and data blocks (layouts) can be
+used to optimize I/O performance, or to convert between raid levels. See
+\fBlvmraid\fP(7) for more information.
+
+Layouts of raid5 rotating parity blocks can be: left-asymmetric
+(raid5_la), left-symmetric (raid5_ls with alias raid5), right-asymmetric
+(raid5_ra), right-symmetric (raid5_rs) and raid5_n, which doesn't rotate
+parity blocks. Layouts of raid6 are: zero-restart (raid6_zr with alias
+raid6), next-restart (raid6_nr), and next-continue (raid6_nc).
+
+Layouts including _n allow for conversion between raid levels (raid5_n to
+raid6 or raid5_n to striped/raid0/raid0_meta). Additionally, special raid6
+layouts for raid level conversions between raid5 and raid6 are:
+raid6_ls_6, raid6_rs_6, raid6_la_6 and raid6_ra_6. Those correspond to
+their raid5 counterparts (e.g. raid5_rs can be directly converted to
+raid6_rs_6 and vice-versa).
+
+raid10 (an alias for raid10_near) is currently limited to one data copy
+and even number of sub LVs. This is a mirror group layout, thus a single
+sub LV may fail per mirror group without data loss.
+
+Striped raid types support converting the layout, their stripesize and
+their number of stripes.
+
+The striped raid types combined with raid1 allow for conversion from
+linear -> striped/raid0/raid0_meta and vice-versa by e.g. linear <-> raid1
+<-> raid5_n (then adding stripes) <-> striped/raid0/raid0_meta.
.SH USAGE
Convert LV to linear.
.br
diff --git a/man/lvcreate.8_pregen b/man/lvcreate.8_pregen
index 6663087..38edc85 100644
--- a/man/lvcreate.8_pregen
+++ b/man/lvcreate.8_pregen
@@ -244,9 +244,9 @@ lvcreate - Create a logical volume
.SH DESCRIPTION
lvcreate creates a new LV in a VG. For standard LVs, this requires
allocating logical extents from the VG's free physical extents. If there
-is not enough free space, then the VG can be extended (see
-\fBvgextend\fP(8)) with other PVs, or existing LVs can be reduced or
-removed (see \fBlvremove\fP, \fBlvreduce\fP.)
+is not enough free space, the VG can be extended with other PVs
+(\fBvgextend\fP(8)), or existing LVs can be reduced or removed
+(\fBlvremove\fP(8), \fBlvreduce\fP(8).)
To control which PVs a new LV will use, specify one or more PVs as
position args at the end of the command line. lvcreate will allocate
@@ -263,7 +263,7 @@ unique PVs be available in the VG for allocation.
Thin pools (for thin provisioning) and cache pools (for caching) are
represented by special LVs with types thin-pool and cache-pool (see
\fBlvmthin\fP(7) and \fBlvmcache\fP(7)). The pool LVs are not usable as
-standard block devices, but the LV names act references to the pools.
+standard block devices, but the LV names act as references to the pools.
Thin LVs are thinly provisioned from a thin pool, and are created with a
virtual size rather than a physical size. A cache LV is the combination of
@@ -271,13 +271,12 @@ a standard LV with a cache pool, used to cache active portions of the LV
to improve performance.
.SS Usage notes
In the usage section below, \fB--size\fP \fISize\fP can be replaced
-with \fB--extents\fP \fINumber\fP. See both descriptions
-the options section.
+with \fB--extents\fP \fINumber\fP. See descriptions in the options section.
In the usage section below, \fB--name\fP is omitted from the required
-options, even though it is typically used. When the name is not
+options, even though it is typically used. When the name is not
specified, a new LV name is generated with the "lvol" prefix and a unique
-numeric suffix. Also see the description in the options section.
+numeric suffix.
.SH USAGE
Create a linear LV.
.br
diff --git a/man/lvdisplay.8_pregen b/man/lvdisplay.8_pregen
index 25ce5b8..49de9cf 100644
--- a/man/lvdisplay.8_pregen
+++ b/man/lvdisplay.8_pregen
@@ -48,10 +48,6 @@ and more, using a more compact and configurable output format.
.ad b
.br
.ad l
-[ \fB-P\fP|\fB--partial\fP ]
-.ad b
-.br
-.ad l
[ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b
.br
@@ -343,15 +339,6 @@ See lvmreport(7) for more information about reporting.
.ad b
.HP
.ad l
-\fB-P\fP|\fB--partial\fP
-.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
-.ad b
-.HP
-.ad l
\fB--profile\fP \fIString\fP
.br
An alias for --commandprofile or --metadataprofile, depending
diff --git a/man/lvm-fullreport.8_pregen b/man/lvm-fullreport.8_pregen
index bfc5cd3..11ba4b8 100644
--- a/man/lvm-fullreport.8_pregen
+++ b/man/lvm-fullreport.8_pregen
@@ -29,10 +29,6 @@ if information changes between commands.
.ad b
.br
.ad l
-[ \fB-P\fP|\fB--partial\fP ]
-.ad b
-.br
-.ad l
[ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b
.br
@@ -325,15 +321,6 @@ See lvmreport(7) for more information about reporting.
.ad b
.HP
.ad l
-\fB-P\fP|\fB--partial\fP
-.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
-.ad b
-.HP
-.ad l
\fB--profile\fP \fIString\fP
.br
An alias for --commandprofile or --metadataprofile, depending
diff --git a/man/lvs.8_pregen b/man/lvs.8_pregen
index 2ac6f3f..31244e2 100644
--- a/man/lvs.8_pregen
+++ b/man/lvs.8_pregen
@@ -28,10 +28,6 @@ lvs produces formatted output about LVs.
.ad b
.br
.ad l
-[ \fB-P\fP|\fB--partial\fP ]
-.ad b
-.br
-.ad l
[ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b
.br
@@ -339,15 +335,6 @@ See lvmreport(7) for more information about reporting.
.ad b
.HP
.ad l
-\fB-P\fP|\fB--partial\fP
-.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
-.ad b
-.HP
-.ad l
\fB--profile\fP \fIString\fP
.br
An alias for --commandprofile or --metadataprofile, depending
diff --git a/man/lvscan.8_pregen b/man/lvscan.8_pregen
index a2c32a0..12211b2 100644
--- a/man/lvscan.8_pregen
+++ b/man/lvscan.8_pregen
@@ -45,10 +45,6 @@ Common options for command:
.ad b
.br
.ad l
-[ \fB-P\fP|\fB--partial\fP ]
-.ad b
-.br
-.ad l
[ \fB--ignorelockingfailure\fP ]
.ad b
.br
@@ -184,15 +180,6 @@ Display long help text.
.ad b
.HP
.ad l
-\fB-P\fP|\fB--partial\fP
-.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
-.ad b
-.HP
-.ad l
\fB--profile\fP \fIString\fP
.br
An alias for --commandprofile or --metadataprofile, depending
diff --git a/man/pvs.8_pregen b/man/pvs.8_pregen
index d6afbb9..d0742df 100644
--- a/man/pvs.8_pregen
+++ b/man/pvs.8_pregen
@@ -24,10 +24,6 @@ pvs produces formatted output about PVs.
.ad b
.br
.ad l
-[ \fB-P\fP|\fB--partial\fP ]
-.ad b
-.br
-.ad l
[ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b
.br
@@ -326,15 +322,6 @@ See lvmreport(7) for more information about reporting.
.ad b
.HP
.ad l
-\fB-P\fP|\fB--partial\fP
-.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
-.ad b
-.HP
-.ad l
\fB--profile\fP \fIString\fP
.br
An alias for --commandprofile or --metadataprofile, depending
diff --git a/man/vgcfgbackup.8_pregen b/man/vgcfgbackup.8_pregen
index b3f41af..d085a34 100644
--- a/man/vgcfgbackup.8_pregen
+++ b/man/vgcfgbackup.8_pregen
@@ -35,10 +35,6 @@ It may also be useful to regularly back up the files in
.ad b
.br
.ad l
-[ \fB-P\fP|\fB--partial\fP ]
-.ad b
-.br
-.ad l
[ \fB--foreign\fP ]
.ad b
.br
@@ -179,15 +175,6 @@ Display long help text.
.ad b
.HP
.ad l
-\fB-P\fP|\fB--partial\fP
-.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
-.ad b
-.HP
-.ad l
\fB--profile\fP \fIString\fP
.br
An alias for --commandprofile or --metadataprofile, depending
diff --git a/man/vgchange.8_pregen b/man/vgchange.8_pregen
index df5c946..d3514b9 100644
--- a/man/vgchange.8_pregen
+++ b/man/vgchange.8_pregen
@@ -270,6 +270,10 @@ required, after which the others are optional.
.RE
.br
.RS 4
+.ad l
+[ \fB--poll\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -379,10 +383,6 @@ Reactivate LVs using the latest metadata.
.ad b
.br
.ad l
-[ \fB--monitor\fP \fBy\fP|\fBn\fP ]
-.ad b
-.br
-.ad l
[ \fB--poll\fP \fBy\fP|\fBn\fP ]
.ad b
.br
@@ -761,10 +761,10 @@ ignore the devices LVM creates.
.ad l
\fB-P\fP|\fB--partial\fP
.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
+Commands will do their best to activate LVs with missing PV extents.
+Missing extents may be replaced with error or zero segments
+according to the lvm.conf missing_stripe_filler setting.
+Metadata may not be changed with this option.
.ad b
.HP
.ad l
diff --git a/man/vgdisplay.8_pregen b/man/vgdisplay.8_pregen
index 2aa9188..a9a9463 100644
--- a/man/vgdisplay.8_pregen
+++ b/man/vgdisplay.8_pregen
@@ -35,10 +35,6 @@ and more, using a more compact and configurable output format.
.ad b
.br
.ad l
-[ \fB-P\fP|\fB--partial\fP ]
-.ad b
-.br
-.ad l
[ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b
.br
@@ -317,15 +313,6 @@ See lvmreport(7) for more information about reporting.
.ad b
.HP
.ad l
-\fB-P\fP|\fB--partial\fP
-.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
-.ad b
-.HP
-.ad l
\fB--profile\fP \fIString\fP
.br
An alias for --commandprofile or --metadataprofile, depending
diff --git a/man/vgs.8_pregen b/man/vgs.8_pregen
index 012697c..b621666 100644
--- a/man/vgs.8_pregen
+++ b/man/vgs.8_pregen
@@ -24,10 +24,6 @@ vgs produces formatted output about VGs.
.ad b
.br
.ad l
-[ \fB-P\fP|\fB--partial\fP ]
-.ad b
-.br
-.ad l
[ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b
.br
@@ -321,15 +317,6 @@ See lvmreport(7) for more information about reporting.
.ad b
.HP
.ad l
-\fB-P\fP|\fB--partial\fP
-.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
-.ad b
-.HP
-.ad l
\fB--profile\fP \fIString\fP
.br
An alias for --commandprofile or --metadataprofile, depending
diff --git a/man/vgscan.8_pregen b/man/vgscan.8_pregen
index 011747c..df36e3a 100644
--- a/man/vgscan.8_pregen
+++ b/man/vgscan.8_pregen
@@ -14,10 +14,6 @@ vgscan scans all supported LVM block devices in the system for VGs.
.br
.RS 4
.ad l
-[ \fB-P\fP|\fB--partial\fP ]
-.ad b
-.br
-.ad l
[ \fB--cache\fP ]
.ad b
.br
@@ -165,15 +161,6 @@ notify_dbus config setting is disabled.
.ad b
.HP
.ad l
-\fB-P\fP|\fB--partial\fP
-.br
-When set, the tools will do their best to provide access to VGs
-that are only partially available (one or more PVs belonging
-to the VG are missing from the system). Metadata may not be
-changed with this option.
-.ad b
-.HP
-.ad l
\fB--profile\fP \fIString\fP
.br
An alias for --commandprofile or --metadataprofile, depending
^ permalink raw reply related [flat|nested] 5+ messages in thread
* master - make generate
@ 2017-07-25 0:27 Alasdair Kergon
0 siblings, 0 replies; 5+ messages in thread
From: Alasdair Kergon @ 2017-07-25 0:27 UTC (permalink / raw)
To: lvm-devel
Gitweb: https://sourceware.org/git/?p=lvm2.git;a=commitdiff;h=a1dbefe9c8cd7f9bcbf19d0516082a3f354703b4
Commit: a1dbefe9c8cd7f9bcbf19d0516082a3f354703b4
Parent: 5fd7c0aa3340a58318d0bcfb0ae5aeb9924881f6
Author: Alasdair G Kergon <agk@redhat.com>
AuthorDate: Tue Jul 25 01:26:58 2017 +0100
Committer: Alasdair G Kergon <agk@redhat.com>
CommitterDate: Tue Jul 25 01:26:58 2017 +0100
make generate
---
man/lvconvert.8_pregen | 14 ++--
man/lvcreate.8_pregen | 60 +++++++-------
man/vgchange.8_pregen | 203 ++++++++++++++++++++++++++++++++++++++++--------
3 files changed, 208 insertions(+), 69 deletions(-)
diff --git a/man/lvconvert.8_pregen b/man/lvconvert.8_pregen
index 6855550..93a8b27 100644
--- a/man/lvconvert.8_pregen
+++ b/man/lvconvert.8_pregen
@@ -1424,7 +1424,7 @@ Alternate command forms, advanced command usage, and listing of all valid syntax
.P
Convert LV to type mirror (also see type raid1),
.br
-(also see lvconvert \-\-mirrors).
+(also see lvconvert --mirrors).
.br
.P
\fBlvconvert\fP \fB--type\fP \fBmirror\fP \fILV\fP
@@ -1481,7 +1481,7 @@ Change the type of mirror log used by a mirror LV.
Convert LV to a thin LV, using the original LV as an external origin
.br
-(infers \-\-type thin).
+(infers --type thin).
.br
.P
\fBlvconvert\fP \fB-T\fP|\fB--thin\fP \fB--thinpool\fP \fILV\fP \fILV\fP\fI_linear_striped_cache_raid\fP
@@ -1528,7 +1528,7 @@ Convert LV to a thin LV, using the original LV as an external origin
.br
-
-Convert LV to type cache (infers \-\-type cache).
+Convert LV to type cache (infers --type cache).
.br
.P
\fBlvconvert\fP \fB-H\fP|\fB--cache\fP \fB--cachepool\fP \fILV\fP \fILV\fP\fI_linear_striped_thinpool_raid\fP
@@ -1613,11 +1613,11 @@ Swap metadata LV in a thin pool or cache pool (for repair only).
.br
-
-Merge LV that was split from a mirror (variant, use \-\-mergemirrors).
+Merge LV that was split from a mirror (variant, use --mergemirrors).
.br
-Merge thin LV into its origin LV (variant, use \-\-mergethin).
+Merge thin LV into its origin LV (variant, use --mergethin).
.br
-Merge COW snapshot LV into its origin (variant, use \-\-mergesnapshot).
+Merge COW snapshot LV into its origin (variant, use --mergesnapshot).
.br
.P
\fBlvconvert\fP \fB--merge\fP \fIVG\fP|\fILV\fP\fI_linear_striped_snapshot_thin_raid\fP|\fITag\fP ...
@@ -1693,7 +1693,7 @@ origin LV (first arg) to reverse a splitsnapshot command.
.br
-
-Poll LV to continue conversion (also see \-\-startpoll).
+Poll LV to continue conversion (also see --startpoll).
.br
.P
\fBlvconvert\fP \fILV\fP\fI_mirror_raid\fP
diff --git a/man/lvcreate.8_pregen b/man/lvcreate.8_pregen
index 6b05147..71bd82b 100644
--- a/man/lvcreate.8_pregen
+++ b/man/lvcreate.8_pregen
@@ -300,7 +300,7 @@ Create a linear LV.
.RE
-
-Create a striped LV (infers \-\-type striped).
+Create a striped LV (infers --type striped).
.br
.P
\fBlvcreate\fP \fB-i\fP|\fB--stripes\fP \fINumber\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
@@ -322,7 +322,7 @@ Create a striped LV (infers \-\-type striped).
.RE
-
-Create a raid1 or mirror LV (infers \-\-type raid1|mirror).
+Create a raid1 or mirror LV (infers --type raid1|mirror).
.br
.P
\fBlvcreate\fP \fB-m\fP|\fB--mirrors\fP \fINumber\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
@@ -569,7 +569,7 @@ Create a cache pool.
.RE
-
-Create a thin LV in a thin pool (infers \-\-type thin).
+Create a thin LV in a thin pool (infers --type thin).
.br
.P
\fBlvcreate\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fB--thinpool\fP \fILV\fP\fI_thinpool\fP \fIVG\fP
@@ -598,7 +598,7 @@ Create a thin LV in a thin pool (infers \-\-type thin).
Create a thin LV that is a snapshot of an existing thin LV
.br
-(infers \-\-type thin).
+(infers --type thin).
.br
.P
\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fILV\fP\fI_thin\fP
@@ -658,7 +658,7 @@ Create a thin LV that is a snapshot of an external origin LV.
Create a thin LV, first creating a thin pool for it,
.br
-where the new thin pool is named by the \-\-thinpool arg.
+where the new thin pool is named by the --thinpool arg.
.br
.P
\fBlvcreate\fP \fB--type\fP \fBthin\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT]
@@ -715,7 +715,7 @@ Create a cache LV, first creating a new origin LV,
.br
then combining it with the existing cache pool named
.br
-by the \-\-cachepool arg.
+by the --cachepool arg.
.br
.P
\fBlvcreate\fP \fB--type\fP \fBcache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
@@ -1606,7 +1606,7 @@ Create a linear LV.
.RE
-
-Create a striped LV (also see lvcreate \-\-stripes).
+Create a striped LV (also see lvcreate --stripes).
.br
.P
\fBlvcreate\fP \fB--type\fP \fBstriped\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
@@ -1632,7 +1632,7 @@ Create a striped LV (also see lvcreate \-\-stripes).
.RE
-
-Create a mirror LV (also see \-\-type raid1).
+Create a mirror LV (also see --type raid1).
.br
.P
\fBlvcreate\fP \fB--type\fP \fBmirror\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
@@ -1672,7 +1672,7 @@ Create a mirror LV (also see \-\-type raid1).
Create a COW snapshot LV of an origin LV
.br
-(also see \-\-snapshot).
+(also see --snapshot).
.br
.P
\fBlvcreate\fP \fB--type\fP \fBsnapshot\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV\fP
@@ -1708,7 +1708,7 @@ Create a COW snapshot LV of an origin LV
Create a sparse COW snapshot LV of a virtual origin LV
.br
-(also see \-\-snapshot).
+(also see --snapshot).
.br
.P
\fBlvcreate\fP \fB--type\fP \fBsnapshot\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
@@ -1766,7 +1766,7 @@ Create a sparse COW snapshot LV of a virtual origin LV.
.RE
-
-Create a thin pool (infers \-\-type thin-pool).
+Create a thin pool (infers --type thin-pool).
.br
.P
\fBlvcreate\fP \fB-T\fP|\fB--thin\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fIVG\fP
@@ -1816,9 +1816,9 @@ Create a thin pool (infers \-\-type thin-pool).
.RE
-
-Create a thin pool named by the \-\-thinpool arg
+Create a thin pool named by the --thinpool arg
.br
-(infers \-\-type thin-pool).
+(infers --type thin-pool).
.br
.P
\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fB--thinpool\fP \fILV\fP\fI_new\fP \fIVG\fP
@@ -1872,9 +1872,9 @@ Create a thin pool named by the \-\-thinpool arg
.RE
-
-Create a cache pool named by the \-\-cachepool arg
+Create a cache pool named by the --cachepool arg
.br
-(variant, uses \-\-cachepool in place of \-\-name).
+(variant, uses --cachepool in place of --name).
.br
.P
\fBlvcreate\fP \fB--type\fP \fBcache-pool\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
@@ -1967,7 +1967,7 @@ Create a thin LV in a thin pool.
Create a thin LV in a thin pool named in the first arg
.br
-(variant, also see \-\-thinpool for naming pool).
+(variant, also see --thinpool for naming pool).
.br
.P
\fBlvcreate\fP \fB--type\fP \fBthin\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP
@@ -1992,7 +1992,7 @@ Create a thin LV in a thin pool named in the first arg
Create a thin LV in the thin pool named in the first arg
.br
-(variant, infers \-\-type thin, also see \-\-thinpool for
+(variant, infers --type thin, also see --thinpool for
.br
naming pool.)
.br
@@ -2046,7 +2046,7 @@ Create a thin LV that is a snapshot of an existing thin LV.
Create a thin LV that is a snapshot of an existing thin LV
.br
-(infers \-\-type thin).
+(infers --type thin).
.br
.P
\fBlvcreate\fP \fB-T\fP|\fB--thin\fP \fILV\fP\fI_thin\fP
@@ -2071,7 +2071,7 @@ Create a thin LV that is a snapshot of an existing thin LV
Create a thin LV that is a snapshot of an external origin LV
.br
-(infers \-\-type thin).
+(infers --type thin).
.br
.P
\fBlvcreate\fP \fB-s\fP|\fB--snapshot\fP \fB--thinpool\fP \fILV\fP\fI_thinpool\fP \fILV\fP
@@ -2096,9 +2096,9 @@ Create a thin LV that is a snapshot of an external origin LV
Create a thin LV, first creating a thin pool for it,
.br
-where the new thin pool is named by the \-\-thinpool arg
+where the new thin pool is named by the --thinpool arg
.br
-(variant, infers \-\-type thin).
+(variant, infers --type thin).
.br
.P
\fBlvcreate\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
@@ -2153,9 +2153,9 @@ where the new thin pool is named by the \-\-thinpool arg
Create a thin LV, first creating a thin pool for it,
.br
-where the new thin pool is named by the \-\-thinpool arg
+where the new thin pool is named by the --thinpool arg
.br
-(variant, infers \-\-type thin).
+(variant, infers --type thin).
.br
.P
\fBlvcreate\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT] \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT]
@@ -2273,7 +2273,7 @@ where the new thin pool is named in the first arg,
.br
or the new thin pool name is generated when the first
.br
-arg is a VG name (variant, infers \-\-type thin).
+arg is a VG name (variant, infers --type thin).
.br
.P
\fBlvcreate\fP \fB-T\fP|\fB--thin\fP \fB-V\fP|\fB--virtualsize\fP \fISize\fP[m|UNIT]
@@ -2324,13 +2324,13 @@ arg is a VG name (variant, infers \-\-type thin).
Create a thin LV, first creating a thin pool for it
.br
-(infers \-\-type thin).
+(infers --type thin).
.br
Create a sparse snapshot of a virtual origin LV
.br
-(infers \-\-type snapshot).
+(infers --type snapshot).
.br
-Chooses \-\-type thin or \-\-type snapshot according to
+Chooses --type thin or --type snapshot according to
.br
config setting sparse_segtype_default.
.br
@@ -2390,7 +2390,7 @@ Create a cache LV, first creating a new origin LV,
.br
then combining it with the existing cache pool named
.br
-by the \-\-cachepool arg (variant, infers \-\-type cache).
+by the --cachepool arg (variant, infers --type cache).
.br
.P
\fBlvcreate\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fB--cachepool\fP \fILV\fP\fI_cachepool\fP \fIVG\fP
@@ -2448,7 +2448,7 @@ Create a cache LV, first creating a new origin LV,
.br
then combining it with the existing cache pool named
.br
-in the first arg (variant, also use \-\-cachepool).
+in the first arg (variant, also use --cachepool).
.br
.P
\fBlvcreate\fP \fB--type\fP \fBcache\fP \fB-L\fP|\fB--size\fP \fISize\fP[m|UNIT] \fILV\fP\fI_cachepool\fP
@@ -2512,7 +2512,7 @@ first creating a new origin LV, then combining it with
.br
the existing cache pool named in the first arg
.br
-(variant, infers \-\-type cache, also use \-\-cachepool).
+(variant, infers --type cache, also use --cachepool).
.br
When LV is not a cache pool, convert the specified LV
.br
diff --git a/man/vgchange.8_pregen b/man/vgchange.8_pregen
index b08c2f9..c1628a7 100644
--- a/man/vgchange.8_pregen
+++ b/man/vgchange.8_pregen
@@ -3,7 +3,7 @@
vgchange - Change volume group attributes
.
.SH SYNOPSIS
-\fBvgchange\fP \fIoption_args\fP
+\fBvgchange\fP \fIoption_args\fP \fIposition_args\fP
.br
[ \fIoption_args\fP ]
.br
@@ -250,30 +250,50 @@ required, after which the others are optional.
.ad b
.br
.ad l
- \fB--systemid\fP \fIString\fP,
+ \fB--profile\fP \fIString\fP,
.ad b
.br
.ad l
- \fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP,
+ \fB--detachprofile\fP,
.ad b
.br
.ad l
- \fB--profile\fP \fIString\fP,
+ \fB--metadataprofile\fP \fIString\fP )
+.RE
+.br
+.RS 4
+.ad l
+[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b
.br
.ad l
- \fB--detachprofile\fP,
+[ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b
.br
.ad l
- \fB--metadataprofile\fP \fIString\fP )
-.RE
+[ \fB-f\fP|\fB--force\fP ]
+.ad b
.br
-.RS 4
.ad l
[ \fB--poll\fP \fBy\fP|\fBn\fP ]
.ad b
.br
+.ad l
+[ \fB--ignoremonitoring\fP ]
+.ad b
+.br
+.ad l
+[ \fB--ignoreskippedcluster\fP ]
+.ad b
+.br
+.ad l
+[ \fB--noudevsync\fP ]
+.ad b
+.br
+.ad l
+[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -289,6 +309,18 @@ Start or stop monitoring LVs from dmeventd.
.br
.RS 4
.ad l
+[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
+.ad l
+[ \fB-S\fP|\fB--select\fP \fIString\fP ]
+.ad b
+.br
+.ad l
+[ \fB-f\fP|\fB--force\fP ]
+.ad b
+.br
+.ad l
[ \fB--sysinit\fP ]
.ad b
.br
@@ -300,6 +332,22 @@ Start or stop monitoring LVs from dmeventd.
[ \fB--poll\fP \fBy\fP|\fBn\fP ]
.ad b
.br
+.ad l
+[ \fB--ignoremonitoring\fP ]
+.ad b
+.br
+.ad l
+[ \fB--ignoreskippedcluster\fP ]
+.ad b
+.br
+.ad l
+[ \fB--noudevsync\fP ]
+.ad b
+.br
+.ad l
+[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -315,9 +363,37 @@ Start or stop processing LV conversions.
.br
.RS 4
.ad l
+[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
+.ad l
+[ \fB-S\fP|\fB--select\fP \fIString\fP ]
+.ad b
+.br
+.ad l
+[ \fB-f\fP|\fB--force\fP ]
+.ad b
+.br
+.ad l
[ \fB--ignorelockingfailure\fP ]
.ad b
.br
+.ad l
+[ \fB--ignoremonitoring\fP ]
+.ad b
+.br
+.ad l
+[ \fB--ignoreskippedcluster\fP ]
+.ad b
+.br
+.ad l
+[ \fB--noudevsync\fP ]
+.ad b
+.br
+.ad l
+[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -341,6 +417,18 @@ Activate or deactivate LVs.
.ad b
.br
.ad l
+[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
+.ad l
+[ \fB-S\fP|\fB--select\fP \fIString\fP ]
+.ad b
+.br
+.ad l
+[ \fB-f\fP|\fB--force\fP ]
+.ad b
+.br
+.ad l
[ \fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ]
.ad b
.br
@@ -360,6 +448,22 @@ Activate or deactivate LVs.
[ \fB--poll\fP \fBy\fP|\fBn\fP ]
.ad b
.br
+.ad l
+[ \fB--ignoremonitoring\fP ]
+.ad b
+.br
+.ad l
+[ \fB--ignoreskippedcluster\fP ]
+.ad b
+.br
+.ad l
+[ \fB--noudevsync\fP ]
+.ad b
+.br
+.ad l
+[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -375,6 +479,18 @@ Reactivate LVs using the latest metadata.
.br
.RS 4
.ad l
+[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
+.ad b
+.br
+.ad l
+[ \fB-S\fP|\fB--select\fP \fIString\fP ]
+.ad b
+.br
+.ad l
+[ \fB-f\fP|\fB--force\fP ]
+.ad b
+.br
+.ad l
[ \fB--sysinit\fP ]
.ad b
.br
@@ -386,6 +502,22 @@ Reactivate LVs using the latest metadata.
[ \fB--poll\fP \fBy\fP|\fBn\fP ]
.ad b
.br
+.ad l
+[ \fB--ignoremonitoring\fP ]
+.ad b
+.br
+.ad l
+[ \fB--ignoreskippedcluster\fP ]
+.ad b
+.br
+.ad l
+[ \fB--noudevsync\fP ]
+.ad b
+.br
+.ad l
+[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -394,6 +526,17 @@ Reactivate LVs using the latest metadata.
.RE
-
+Change the system ID of a VG.
+.br
+.P
+\fBvgchange\fP \fB--systemid\fP \fIString\fP \fIVG\fP
+.br
+.RS 4
+[ COMMON_OPTIONS ]
+.RE
+.br
+-
+
Start the lockspace of a shared VG in lvmlockd.
.br
.P
@@ -401,6 +544,10 @@ Start the lockspace of a shared VG in lvmlockd.
.br
.RS 4
.ad l
+[ \fB-S\fP|\fB--select\fP \fIString\fP ]
+.ad b
+.br
+.ad l
[ \fB--lockopt\fP \fIString\fP ]
.ad b
.br
@@ -419,6 +566,10 @@ Stop the lockspace of a shared VG in lvmlockd.
.br
.RS 4
.ad l
+[ \fB-S\fP|\fB--select\fP \fIString\fP ]
+.ad b
+.br
+.ad l
[ \fB--lockopt\fP \fIString\fP ]
.ad b
.br
@@ -430,36 +581,24 @@ Stop the lockspace of a shared VG in lvmlockd.
.RE
-
-Common options for command:
-.
-.RS 4
-.ad l
-[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
-.ad b
-.br
-.ad l
-[ \fB-f\fP|\fB--force\fP ]
-.ad b
+Change the lock type for a shared VG.
.br
-.ad l
-[ \fB-S\fP|\fB--select\fP \fIString\fP ]
-.ad b
-.br
-.ad l
-[ \fB--ignoremonitoring\fP ]
-.ad b
+.P
+\fBvgchange\fP \fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP \fIVG\fP
.br
+.RS 4
.ad l
-[ \fB--ignoreskippedcluster\fP ]
+[ \fB--lockopt\fP \fIString\fP ]
.ad b
.br
-.ad l
-[ \fB--noudevsync\fP ]
-.ad b
+[ COMMON_OPTIONS ]
+.RE
.br
-.ad l
-[ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
-.ad b
+-
+
+Common options for command:
+.
+.RS 4
.RE
Common options for lvm:
^ permalink raw reply related [flat|nested] 5+ messages in thread
* master - make: generate
@ 2019-08-09 10:58 Zdenek Kabelac
0 siblings, 0 replies; 5+ messages in thread
From: Zdenek Kabelac @ 2019-08-09 10:58 UTC (permalink / raw)
To: lvm-devel
Gitweb: https://sourceware.org/git/?p=lvm2.git;a=commitdiff;h=08396b4bce45fb8311979250623f04ec0ddb628c
Commit: 08396b4bce45fb8311979250623f04ec0ddb628c
Parent: 728435e7d680c95fd21fe496d707d1c77adf7d85
Author: Zdenek Kabelac <zkabelac@redhat.com>
AuthorDate: Fri Aug 9 12:56:28 2019 +0200
Committer: Zdenek Kabelac <zkabelac@redhat.com>
CommitterDate: Fri Aug 9 12:57:07 2019 +0200
make: generate
Run make generate.
---
conf/example.conf.in | 18 +++++++-----
man/lvconvert.8_pregen | 70 ++++++++++++++++++++++++++----------------------
2 files changed, 48 insertions(+), 40 deletions(-)
diff --git a/conf/example.conf.in b/conf/example.conf.in
index 154f621..91ce5be 100644
--- a/conf/example.conf.in
+++ b/conf/example.conf.in
@@ -142,7 +142,7 @@ devices {
#
# Example
# Accept every block device:
- # filter = [ "a|.*/|" ]
+ # filter = [ "a|.*|" ]
# Reject the cdrom drive:
# filter = [ "r|/dev/cdrom|" ]
# Work with just loopback devices, e.g. for testing:
@@ -150,10 +150,10 @@ devices {
# Accept all loop devices and ide drives except hdc:
# filter = [ "a|loop|", "r|/dev/hdc|", "a|/dev/ide|", "r|.*|" ]
# Use anchors to be very specific:
- # filter = [ "a|^/dev/hda8$|", "r|.*/|" ]
+ # filter = [ "a|^/dev/hda8$|", "r|.*|" ]
#
# This configuration option has an automatic default value.
- # filter = [ "a|.*/|" ]
+ # filter = [ "a|.*|" ]
# Configuration option devices/global_filter.
# Limit the block devices that are used by LVM system components.
@@ -163,7 +163,7 @@ devices {
# The syntax is the same as devices/filter. Devices rejected by
# global_filter are not opened by LVM.
# This configuration option has an automatic default value.
- # global_filter = [ "a|.*/|" ]
+ # global_filter = [ "a|.*|" ]
# Configuration option devices/types.
# List of additional acceptable block device types.
@@ -347,6 +347,12 @@ devices {
# Enabling this setting allows the VG to be used as usual even with
# uncertain devices.
allow_changes_with_duplicate_pvs = 0
+
+ # Configuration option devices/allow_mixed_block_sizes.
+ # Allow PVs in the same VG with different logical block sizes.
+ # When allowed, the user is responsible to ensure that an LV is
+ # using PVs with matching block sizes when necessary.
+ allow_mixed_block_sizes = 0
}
# Configuration section allocation.
@@ -899,9 +905,6 @@ global {
# the error messages.
activation = 1
- # Configuration option global/segment_libraries.
- # This configuration option does not have a default value defined.
-
# Configuration option global/proc.
# Location of proc filesystem.
# This configuration option is advanced.
@@ -1751,7 +1754,6 @@ activation {
# additional space for VG metadata. The --metadatasize option overrides
# this setting.
# This configuration option does not have a default value defined.
- # This configuration option has an automatic default value.
# Configuration option metadata/pvmetadataignore.
# Ignore metadata areas on a new PV.
diff --git a/man/lvconvert.8_pregen b/man/lvconvert.8_pregen
index 7252f6f..846ea2d 100644
--- a/man/lvconvert.8_pregen
+++ b/man/lvconvert.8_pregen
@@ -378,6 +378,44 @@ Convert LV to striped.
.RE
-
+Convert LV to type mirror (also see type raid1),
+.br
+.P
+\fBlvconvert\fP \fB--type\fP \fBmirror\fP \fILV\fP
+.br
+.RS 4
+.ad l
+[ \fB-m\fP|\fB--mirrors\fP [\fB+\fP|\fB-\fP]\fINumber\fP ]
+.ad b
+.br
+.ad l
+[ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
+.ad b
+.br
+.ad l
+[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ]
+.ad b
+.br
+.ad l
+[ \fB-i\fP|\fB--interval\fP \fINumber\fP ]
+.ad b
+.br
+.ad l
+[ \fB--stripes\fP \fINumber\fP ]
+.ad b
+.br
+.ad l
+[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ]
+.ad b
+.br
+[ COMMON_OPTIONS ]
+.RE
+.br
+.RS 4
+[ \fIPV\fP ... ]
+.RE
+-
+
Convert LV to raid or change raid layout
.br
(a specific raid level must be used, e.g. raid1).
@@ -1636,38 +1674,6 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete
.SH ADVANCED USAGE
Alternate command forms, advanced command usage, and listing of all valid syntax for completeness.
.P
-Convert LV to type mirror (also see type raid1),
-.br
-(also see lvconvert --mirrors).
-.br
-.P
-\fBlvconvert\fP \fB--type\fP \fBmirror\fP \fILV\fP
-.br
-.RS 4
-.ad l
-[ \fB-m\fP|\fB--mirrors\fP [\fB+\fP|\fB-\fP]\fINumber\fP ]
-.ad b
-.br
-.ad l
-[ \fB-R\fP|\fB--regionsize\fP \fISize\fP[m|UNIT] ]
-.ad b
-.br
-.ad l
-[ \fB-i\fP|\fB--interval\fP \fINumber\fP ]
-.ad b
-.br
-.ad l
-[ \fB--mirrorlog\fP \fBcore\fP|\fBdisk\fP ]
-.ad b
-.br
-[ COMMON_OPTIONS ]
-.RE
-.br
-.RS 4
-[ \fIPV\fP ... ]
-.RE
--
-
Change the region size of an LV.
.br
.P
^ permalink raw reply related [flat|nested] 5+ messages in thread
* master - make: generate
@ 2020-10-15 9:17 Marian Csontos
0 siblings, 0 replies; 5+ messages in thread
From: Marian Csontos @ 2020-10-15 9:17 UTC (permalink / raw)
To: lvm-devel
Gitweb: https://sourceware.org/git/?p=lvm2.git;a=commitdiff;h=b50134dc14296bf9bee96f3b4021ba5b123d54c9
Commit: b50134dc14296bf9bee96f3b4021ba5b123d54c9
Parent: 616e5b854c23a781372b2d05564959b4ba593069
Author: Marian Csontos <mcsontos@redhat.com>
AuthorDate: Thu Oct 15 11:16:54 2020 +0200
Committer: Marian Csontos <mcsontos@redhat.com>
CommitterDate: Thu Oct 15 11:16:54 2020 +0200
make: generate
---
man/lvconvert.8_pregen | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/man/lvconvert.8_pregen b/man/lvconvert.8_pregen
index b3902a51c..9e22c85ff 100644
--- a/man/lvconvert.8_pregen
+++ b/man/lvconvert.8_pregen
@@ -929,6 +929,10 @@ Detach a cache from an LV.
\fBlvconvert\fP \fB--splitcache\fP \fILV\fP\fI_thinpool_cache_cachepool_vdopool_writecache\fP
.br
.RS 4
+.ad l
+[ \fB--cachesettings\fP \fIString\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
@@ -2004,6 +2008,10 @@ Detach and delete a cache from an LV.
\fBlvconvert\fP \fB--uncache\fP \fILV\fP\fI_thinpool_cache_vdopool_writecache\fP
.br
.RS 4
+.ad l
+[ \fB--cachesettings\fP \fIString\fP ]
+.ad b
+.br
[ COMMON_OPTIONS ]
.RE
.br
^ permalink raw reply related [flat|nested] 5+ messages in thread
* master - make: generate
@ 2021-06-28 18:42 Zdenek Kabelac
0 siblings, 0 replies; 5+ messages in thread
From: Zdenek Kabelac @ 2021-06-28 18:42 UTC (permalink / raw)
To: lvm-devel
Gitweb: https://sourceware.org/git/?p=lvm2.git;a=commitdiff;h=580e64e93ba469b64cf11e400c4cb2f759eaf579
Commit: 580e64e93ba469b64cf11e400c4cb2f759eaf579
Parent: 2c6a2b6e86b57aeb96e93618193426ee129b00a6
Author: Zdenek Kabelac <zkabelac@redhat.com>
AuthorDate: Mon Jun 28 18:10:41 2021 +0200
Committer: Zdenek Kabelac <zkabelac@redhat.com>
CommitterDate: Mon Jun 28 20:41:07 2021 +0200
make: generate
---
man/lvconvert.8_pregen | 2 +-
man/lvmdevices.8_pregen | 86 +++++++++++++++++++++++++++++++++++++------------
man/vgchange.8_pregen | 7 ----
man/vgck.8_pregen | 7 ----
4 files changed, 66 insertions(+), 36 deletions(-)
diff --git a/man/lvconvert.8_pregen b/man/lvconvert.8_pregen
index d733ab64f..4fafe5d29 100644
--- a/man/lvconvert.8_pregen
+++ b/man/lvconvert.8_pregen
@@ -670,7 +670,7 @@ Convert LV to type thin-pool.
.RE
.P
.RS 4
-LV1 types: linear striped cache raid error zero
+LV1 types: linear striped cache raid error zero writecache
.RE
.P
\(em
diff --git a/man/lvmdevices.8_pregen b/man/lvmdevices.8_pregen
index 267ce965f..e581a8d01 100644
--- a/man/lvmdevices.8_pregen
+++ b/man/lvmdevices.8_pregen
@@ -27,6 +27,8 @@ lvmdevices \(em Manage the devices file
\fB--deldev\fP \fIPV\fP
.br
\fB--delpvid\fP \fIString\fP
+.br
+ \fB--deviceidtype\fP \fIString\fP
.br
\fB--devices\fP \fIPV\fP
.br
@@ -70,18 +72,18 @@ remove it from the devices file with lvmdevices --deldev. The
vgimportdevices(8) command adds all PVs from a VG to the devices file,
and updates the VG metadata to include device IDs of the PVs.
.P
-Commands adding new devices to the devices file necessarily look outside
-the existing devices file to find the devices to add. pvcreate, vgcreate,
-and vgextend also look outside the devices file to create new PVs and add
-them to the devices file.
+Commands that add new devices to the devices file necessarily look outside
+the existing devices file to find the devices being added. pvcreate,
+vgcreate, and vgextend also look outside the devices file to create new
+PVs and add those PVs to the devices file.
.P
LVM records devices in the devices file using hardware-specific IDs, such
as the WWID, and attempts to use subsystem-specific IDs for virtual device
-types (which also aim to be as unique and stable as possible.)
-These device IDs are also written in the VG metadata. When no hardware or
+types (which also aim to be as unique and stable as possible.) These
+device IDs are also written in the VG metadata. When no hardware or
virtual ID is available, lvm falls back using the unstable device name as
-the device ID. When devnames are used, lvm performs extra scanning to
-find devices if their devname changes, e.g. after reboot.
+the device ID. When devnames are used as IDs, lvm performs extra scanning
+to find devices if their devname changes, e.g. after reboot.
.P
When proper device IDs are used, an lvm command will not look at devices
outside the devices file, but when devnames are used as a fallback, lvm
@@ -95,12 +97,13 @@ overriding the devices file. The listed devices act as a sort of devices
file in terms of limiting which devices lvm will see and use. Devices
that are not listed will appear to be missing to the lvm command.
.P
-Multiple devices files can be kept in \fI#DEFAULT_SYS_DIR#/devices\fP, which allows lvm
-to be used with different sets of devices, e.g. system devices do not need
-to be exposed to a specific application, and the application can use lvm on
-its own devices that are not exposed to the system. The option
---devicesfile <filename> is used to select the devices file to use with the
-command. Without the option set, the default system devices file is used.
+Multiple devices files can be kept \fI#DEFAULT_SYS_DIR#/devices\fP, which
+allows lvm to be used with different sets of devices. For example, system
+devices do not need to be exposed to a specific application, and the
+application can use lvm on its own devices that are not exposed to the
+system. The option --devicesfile <filename> is used to select the devices
+file to use with the command. Without the option set, the default system
+devices file is used.
.P
Setting --devicesfile "" causes lvm to not use a devices file.
.P
@@ -120,6 +123,45 @@ if it does not yet exist.
.P
It is recommended to use lvm commands to make changes to the devices file to
ensure proper updates.
+.P
+The device ID and device ID type are included in the VG metadata and can
+be reported with pvs -o deviceid,deviceidtype. (Note that the lvmdevices
+command does not update VG metadata, but subsequent lvm commands modifying
+the metadata will include the device ID.)
+.P
+Possible device ID types are:
+.br
+.IP \[bu] 2
+.B sys_wwid
+uses the wwid reported by sysfs. This is the first choice for non-virtual
+devices.
+.IP \[bu] 2
+.B sys_serial
+uses the serial number reported by sysfs. This is the second choice for
+non-virtual devices.
+.IP \[bu] 2
+.B mpath_uuid
+is used for dm multipath devices, reported by sysfs.
+.IP \[bu] 2
+.B crypt_uuid
+is used for dm crypt devices, reported by sysfs.
+.IP \[bu] 2
+.B md_uuid
+is used for md devices, reported by sysfs.
+.B lvmlv_uuid
+is used if a PV is placed on top of an lvm LV, reported by sysfs.
+.IP \[bu] 2
+.B loop_file
+is used for loop devices, the backing file name repored by sysfs.
+.IP \[bu] 2
+.B devname
+the device name is used if no other type applies.
+.P
+
+The default choice for device ID type can be overriden using lvmdevices
+--addev --deviceidtype <type>. If the specified type is available for the
+device it will be used, otherwise the device will be added using the type
+that would otherwise be chosen.
.
.SH USAGE
.
@@ -169,6 +211,8 @@ Add a device to the devices file.
.br
.RS 4
.ad l
+[ \fB--deviceidtype\fP \fIString\fP ]
+.br
[ COMMON_OPTIONS ]
.ad b
.RE
@@ -214,13 +258,6 @@ Remove the devices file entry for the given PVID.
.P
\(em
.P
-Common options for command:
-.
-.RS 4
-.ad l
-.ad b
-.RE
-.P
Common options for lvm:
.
.RS 4
@@ -308,6 +345,13 @@ Remove a device from the devices file.
Remove a device with the PVID from the devices file.
.
.HP
+\fB--deviceidtype\fP \fIString\fP
+.br
+The type of device ID to use for the device.
+If the specified type is available for the device,
+then it will override the default type that lvm would use.
+.
+.HP
\fB--devices\fP \fIPV\fP
.br
Devices that the command can use. This option can be repeated
diff --git a/man/vgchange.8_pregen b/man/vgchange.8_pregen
index 857dabf04..31fc458da 100644
--- a/man/vgchange.8_pregen
+++ b/man/vgchange.8_pregen
@@ -393,13 +393,6 @@ Change the lock type for a shared VG.
.P
\(em
.P
-Common options for command:
-.
-.RS 4
-.ad l
-.ad b
-.RE
-.P
Common options for lvm:
.
.RS 4
diff --git a/man/vgck.8_pregen b/man/vgck.8_pregen
index f177dfbdd..ae312424a 100644
--- a/man/vgck.8_pregen
+++ b/man/vgck.8_pregen
@@ -46,13 +46,6 @@ Rewrite VG metadata to correct problems.
.ad b
.RE
.P
-Common options for command:
-.
-.RS 4
-.ad l
-.ad b
-.RE
-.P
Common options for lvm:
.
.RS 4
^ permalink raw reply related [flat|nested] 5+ messages in thread
end of thread, other threads:[~2021-06-28 18:42 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2020-10-15 9:17 master - make: generate Marian Csontos
-- strict thread matches above, loose matches on Subject: below --
2021-06-28 18:42 Zdenek Kabelac
2019-08-09 10:58 Zdenek Kabelac
2017-07-25 0:27 master - make generate Alasdair Kergon
2017-04-12 23:30 Alasdair Kergon
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.