Gitweb: http://git.fedorahosted.org/git/?p=lvm2.git;a=commitdiff;h=b7431f69ed0e8b3b…
Commit: b7431f69ed0e8b3b153b5c5dc1e3fbf990d059b0
Parent: 23f9c45a1bd610c455eb24a1264c07b27cd89fd2
Author: Peter Rajnoha <prajnoha(a)redhat.com>
AuthorDate: Wed May 21 13:25:09 2014 +0200
Committer: Peter Rajnoha <prajnoha(a)redhat.com>
CommitterDate: Wed May 21 13:25:09 2014 +0200
man: update lvm.conf man page for latest changes
---
man/lvm.conf.5.in | 90 ++++++++++++++++++++++++++++++++--------------------
1 files changed, 55 insertions(+), 35 deletions(-)
diff --git a/man/lvm.conf.5.in b/man/lvm.conf.5.in
index 1bed3d9..e64e2a3 100644
--- a/man/lvm.conf.5.in
+++ b/man/lvm.conf.5.in
@@ -13,62 +13,82 @@ any have changed, all the files are reloaded.
The settings defined in lvm.conf can be overridden by any
of these extended configuration methods:
.TP
-.B tag config
-.br
-See \fBtags\fP configuration setting description below.
+.B direct config override on command line
+The \fB\-\-config ConfigurationString\fP command line option takes the
+ConfigurationString as direct string representation of the configuration
+to override the existing configuration. The ConfigurationString is of
+exactly the same format as used in any LVM configuration file.
.TP
.B profile config
.br
A profile is a set of selected customizable configuration settings
that are aimed to achieve a certain characteristics in various
-environments or uses. Normally, the name of the profile should
-reflect that environment or use.
+environments or uses. It's used to override existing configuration.
+Normally, the name of the profile should reflect that environment or use.
+
+There are two groups of profiles recognised: \fBcommand profiles\fP and
+\fBmetadata profiles\fP.
+
+The \fBcommand profile\fP is used to override selected configuration
+settings at global LVM command level - it is applied at the very beginning
+of LVM command execution and it is used throughout the whole time of LVM
+command execution. The command profile is applied by using the
+\fB\-\-commandprofile ProfileName\fP command line option that is recognised by
+all LVM2 commands.
+
+The \fBmetadata profile\fP is used to override selected configuration
+settings at Volume Group/Logical Volume level - it is applied independently
+for each Volume Group/Logical Volume that is being processed. As such,
+each Volume Group/Logical Volume can store the profile name used
+in its metadata so next time the Volume Group/Logical Volume is
+processed, the profile is applied automatically. If Volume Group and
+any of its Logical Volumes have different profiles defined, the profile
+defined for the Logical Volume is preferred. The metadata profile can be
+attached/detached by using the \fBlvchange\fP and \fBvgchange\fP commands
+and their \fB\-\-metadataprofile ProfileName\fP and
+\fB\-\-detachprofile ProfileName\fP options or the \fB\-\-metadataprofile\fP
+option during creation when using \fBvgcreate\fP or \fBlvcreate\fP command.
+The \fBvgs\fP and \fBlvs\fP reporting commands provide \fB-o vg_profile\fP
+and \fB-o lv_profile\fP output options to show the metadata profile
+currently attached to a Volume Group or a Logical Volume.
+
+The set of options allowed for command profiles is mutually exclusive
+when compared to the set of options allowed for metadata profiles. The
+settings that belong to either of these two sets can't be mixed together
+and LVM tools will reject such profiles.
LVM itself provides a few predefined configuration profiles.
Users are allowed to add more profiles with different values if needed.
-For this purpose, there's the \fBdefault.profile\fP which contains all
-settings that are customizable by profiles. Users are encouraged
-to copy this default profile and edit it as needed. Alternatively,
-the \fBlvm dumpconfig --file <ProfileName.profile> --type profilable <section>\fP
-can be used to generate a configuration with profilable settings for
-given section and save it to new ProfileName.profile (if the section
-is not specified, all profilable settings are reported).
+For this purpose, there's the \fBcommand_profile_template.profile\fP
+(for command profiles) and \fBmetadata_profile_template.profile\fP
+(for metadata profiles) which contain all settings that are customizable
+by profiles of certain type. Users are encouraged to copy these template
+profiles and edit it as needed. Alternatively, the
+\fBlvm dumpconfig --file <ProfileName.profile> --type profilable-command <section>\fP
+or \fBlvm dumpconfig --file <ProfileName.profile> --type profilable-metadata <section>\fP
+can be used to generate a configuration with profilable settings in either
+of the type for given section and save it to new ProfileName.profile
+(if the section is not specified, all profilable settings are reported).
The profiles are stored in #DEFAULT_PROFILE_DIR# directory by default.
-This location can be changed using the \fBconfig/profile_dir\fP setting.
+This location can be changed by using the \fBconfig/profile_dir\fP setting.
Each profile configuration is stored in \fBProfileName.profile\fP file
in the profile directory. When referencing the profile, the \fB.profile\fP
suffix is left out.
-The profile to use can be defined for each LVM command using the \fB\-\-profile ProfileName\fP
-command line option. When using a profile while creating Volume
-Groups or Logical Volumes, the ProfileName is stored in Volume Group
-metadata. When using such volumes later on, the profile is automatically
-loaded and applied. If Volume Group and any of its Logical Volumes have different
-profiles defined, the profile defined for the Logical Volume is used. Profiles
-attached to Volume Groups or Logical Volumes can be changed or detached
-using the \fBvgchange\fP(8) and \fBlvchange\fP(8) commands with \fB\-\-profile ProfileName\fP
-or \fB\-\-detachprofile\fP options. For any other LVM command, the \fB\-\-profile ProfileName\fP
-option causes the profile to be applied only temporarily during the command
-execution for any existing Volume Group or Logical Volume.
-
-The \fBvgs\fP and \fBlvs\fP reporting commands provide \fB-o vg_profile\fP and
-\fB-o lv_profile\fP output options to show the profile currently attached to a
-Volume Group or a Logical Volume.
-
.TP
-.B direct config override on command line
-The \fB\-\-config ConfigurationString\fP command line option takes the
-ConfigurationString as direct string representation of the configuration
-to override the existing configuration. The ConfigurationString is of
-exactly the same format as used in any LVM configuration file.
+.B tag config
+.br
+See \fBtags\fP configuration setting description below.
.LP
When several configuration methods are used at the same time
and when LVM looks for the value of a particular setting, it traverses
this \fBconfig cascade\fP from left to right:
-\fBdirect config override on command line\fP -> \fBprofile config\fP -> \fBtag config\fP -> \fBlvm.conf\fP.
+
+\fBdirect config override on command line\fP -> \fBcommand profile config\fP -> \fBmetadata profile config\fP -> \fBtag config\fP -> \fBlvm.conf\fP
+
No part of this cascade is compulsory. If there's no setting value found at
the end of the cascade, a default value is used for that setting.
Use \fBlvm dumpconfig\fP to check what settings are in use and what
Gitweb: http://git.fedorahosted.org/git/?p=lvm2.git;a=commitdiff;h=97c91b020e234d40…
Commit: 97c91b020e234d40a43ccde9edc2e8f9a4c3bb2b
Parent: 1ddc68ccd72036d00b6d89c1baa9fa544d093095
Author: Peter Rajnoha <prajnoha(a)redhat.com>
AuthorDate: Wed May 21 11:00:55 2014 +0200
Committer: Peter Rajnoha <prajnoha(a)redhat.com>
CommitterDate: Wed May 21 11:01:19 2014 +0200
man: update dumpconfig man page for latest changes
---
man/lvm-dumpconfig.8.in | 60 +++++++++++++++++++++++++++++++++++++++-------
1 files changed, 51 insertions(+), 9 deletions(-)
diff --git a/man/lvm-dumpconfig.8.in b/man/lvm-dumpconfig.8.in
index e9fe84e..4b21ef1 100644
--- a/man/lvm-dumpconfig.8.in
+++ b/man/lvm-dumpconfig.8.in
@@ -6,11 +6,19 @@ lvm-dumpconfig \- dump LVM configuration
.RB [ \-f | \-\-file ]
.IR filename ]
.RB [ \-\-type
-.RI { current | default | diff | missing | new | profilable }
+.RI { current | default | diff | missing | new | profilable | profilable-command | profilable-metadata }
.RB [ \-\-atversion
.IR version ]
.RB [ \-\-ignoreadvanced ]
.RB [ \-\-ignoreunsupported ]
+.RB [ \-\-config
+.IR ConfigurationString ]
+.RB [ \-\-commandprofile
+.IR ProfileName ]
+.RB [ \-\-profile
+.IR ProfileName ]
+.RB [ \-\-metadataprofile
+.IR ProfileName ]
.RB [ \-\-mergedconfig ]
.RB [ \-\-validate ]
.RB [ \-\-withcomments ]
@@ -55,6 +63,14 @@ or specific version as defined by \fB\-\-atversion\fP option.
.IP profilable 3
Dump all profilable configuration settings with default values assigned.
See \fBlvm.conf\fP(5) for more info about \fBprofile config\fP method.
+.IP profilable-command 3
+Dump all profilable configuration settings with default values assigned
+that can be used in command profile. This is a subset of settings dumped
+by \fB\-\-type \-\-profilable\fP.
+.IP profilable-metadata 3
+Dump all profilable configuration settings with default values assigned
+that can be used in metadata profile. This is a subset of settings dumped
+by \fB\-\-type \-\-profilable\fP.
.RE
.TP
@@ -78,20 +94,46 @@ either used for debugging purposes only or their support is not yet
complete and they are not meant to be used in production.
.TP
+.BI \-\-config " ConfigurationString"
+Use \fBConfigurationString\fP to override existing configuration.
+This configuration is then applied for dumpconfig command itself.
+See also \fBlvm.conf\fP(5) for more info about \fBconfig cascade\fP.
+
+.TP
+.BI \-\-commandprofile " ProfileName"
+Use \fBProfileName\fP to override existing configuration.
+This configuration is then applied for dumpconfig command itself.
+See also \fBlvm.conf\fP(5) for more info about \fBconfig cascade\fP.
+
+.TP
+.BI \-\-profile " ProfileName"
+The same as using \fB\-\-commandprofile\fP but the configuration is not
+applied for dumpconfig command itself.
+
+.TP
+.BI \-\-metadataprofile " ProfileName"
+Use \fBProfileName\fP to override existing configuration.
+The configuration defined in metadata profile has no effect for
+dumpconfig command itself, the dumpconfig dumps the configuration only.
+See also \fBlvm.conf\fP(5) for more info about \fBconfig cascade\fP.
+
+.TP
.B \-\-mergedconfig
When the dumpconfig command is run with the \fB\-\-config\fP option
-and/or \fB\-\-profile\fP option (common options that are recognized
-by all LVM tools, see also \fBlvm\fP(8)), merge the \fB\-\-config\fP
-and/or \fB\-\-profile\fP config with current configuration used
-(see \fB\-\-type current\fP above). Otherwise, only the configuration
-specified within \fB\-\-config\fP or \fB\-\-profile\fP option is dumped
-(see also \fBlvm.conf\fP(5) for more info about \fBconfig cascade\fP).
+and/or \fB\-\-commandprofile\fP, \fB\-\-profile\fP, \fB\-\-metadataprofile\fP
+option, merge all the contents of the \fBconfig cascade\fP before dumping it.
+Without the \fB\-\-mergeconfig\fP option used, only the configuration at
+the front of the cascade is dumped. See also \fBlvm.conf\fP(5) for more
+info about \fBconfig cascade\fP.
.TP
.B \-\-validate
Validate current configuration used and exit with appropriate
-return code. The validation is done even if \fBconfig/checks\fP
-\fBlvm.conf\fP(5) option is disabled.
+return code. The validation is done only for the configuration
+at the front of the \fBconfig cascade\fP. To validate the whole
+merged configuration tree, use also the \fB\-\-mergedconfig\fP option.
+The validation is done even if \fBconfig/checks\fP \fBlvm.conf\fP(5)
+option is disabled.
.TP
.B \-\-withcomments