diff options
author | Alasdair G Kergon <agk@redhat.com> | 2017-04-13 00:30:05 +0100 |
---|---|---|
committer | Alasdair G Kergon <agk@redhat.com> | 2017-04-13 00:30:05 +0100 |
commit | 5ac230095c72c578cb76996b5b8ae687d04e98a9 (patch) | |
tree | 543654b6346de2b867f8abbe35ed43e89d9de8cd | |
parent | a3e8354479f2b6c3d35fdc992d4114b244326833 (diff) | |
download | lvm2-5ac230095c72c578cb76996b5b8ae687d04e98a9.tar.gz |
make generate
-rw-r--r-- | conf/example.conf.in | 28 | ||||
-rw-r--r-- | man/lvchange.8_pregen | 48 | ||||
-rw-r--r-- | man/lvconvert.8_pregen | 85 | ||||
-rw-r--r-- | man/lvcreate.8_pregen | 15 | ||||
-rw-r--r-- | man/lvdisplay.8_pregen | 13 | ||||
-rw-r--r-- | man/lvm-fullreport.8_pregen | 13 | ||||
-rw-r--r-- | man/lvs.8_pregen | 13 | ||||
-rw-r--r-- | man/lvscan.8_pregen | 13 | ||||
-rw-r--r-- | man/pvs.8_pregen | 13 | ||||
-rw-r--r-- | man/vgcfgbackup.8_pregen | 13 | ||||
-rw-r--r-- | man/vgchange.8_pregen | 16 | ||||
-rw-r--r-- | man/vgdisplay.8_pregen | 13 | ||||
-rw-r--r-- | man/vgs.8_pregen | 13 | ||||
-rw-r--r-- | man/vgscan.8_pregen | 13 |
14 files changed, 118 insertions, 191 deletions
diff --git a/conf/example.conf.in b/conf/example.conf.in index 614ce53e7..78f11d1aa 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 199e4cce0..174ad321d 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 e56b6deb7..36523036b 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 6663087da..38edc8519 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 25ce5b851..49de9cf82 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 bfc5cd337..11ba4b88f 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 2ac6f3ffc..31244e206 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 a2c32a062..12211b236 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 d6afbb976..d0742df24 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 b3f41afe8..d085a341b 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 df5c94693..d3514b96a 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 2aa9188ff..a9a9463a6 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 012697c22..b62166673 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 011747c71..df36e3aa0 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 |