mirror of
git://sourceware.org/git/lvm2.git
synced 2025-03-11 20:58:50 +03:00
3be3eb2995
lvmconfig --type list displays plain list of configuration settings. Some of the existing decorations can be used (--withsummary and --withversions) as well as existing options/switches (--ignoreadvanced, --ignoreunsupported, --ignorelocal, --atversion). For example (displaying only "config" section so the list is not long): $lvmconfig --type list config config/checks config/abort_on_errors config/profile_dir $ lvmconfig --type list --withsummary config config/checks - If enabled, any LVM configuration mismatch is reported. config/abort_on_errors - Abort the LVM process if a configuration mismatch is found. config/profile_dir - Directory where LVM looks for configuration profiles. $ lvmconfig -l config config/checks - If enabled, any LVM configuration mismatch is reported. config/abort_on_errors - Abort the LVM process if a configuration mismatch is found. config/profile_dir - Directory where LVM looks for configuration profiles. $ lvmconfig --type list --withsummary --withversions config config/checks - If enabled, any LVM configuration mismatch is reported. [2.2.99] config/abort_on_errors - Abort the LVM process if a configuration mismatch is found. [2.2.99] config/profile_dir - Directory where LVM looks for configuration profiles. [2.2.99] Example with --atversion (displaying global section): $ lvmconfig --type list global global/umask global/test global/units global/si_unit_consistency global/suffix global/activation global/fallback_to_lvm1 global/format global/format_libraries global/segment_libraries global/proc global/etc global/locking_type global/wait_for_locks global/fallback_to_clustered_locking global/fallback_to_local_locking global/locking_dir global/prioritise_write_locks global/library_dir global/locking_library global/abort_on_internal_errors global/detect_internal_vg_cache_corruption global/metadata_read_only global/mirror_segtype_default global/raid10_segtype_default global/sparse_segtype_default global/lvdisplay_shows_full_device_path global/use_lvmetad global/thin_check_executable global/thin_dump_executable global/thin_repair_executable global/thin_check_options global/thin_repair_options global/thin_disabled_features global/cache_check_executable global/cache_dump_executable global/cache_repair_executable global/cache_check_options global/cache_repair_options global/system_id_source global/system_id_file $ lvmconfig --type list global --atversion 2.2.50 global/umask global/test global/units global/suffix global/activation global/fallback_to_lvm1 global/format global/format_libraries global/segment_libraries global/proc global/locking_type global/wait_for_locks global/fallback_to_clustered_locking global/fallback_to_local_locking global/locking_dir global/library_dir global/locking_library
175 lines
6.2 KiB
Groff
175 lines
6.2 KiB
Groff
.TH "LVMCONFIG" "8" "LVM TOOLS #VERSION#" "Red Hat, Inc" "\""
|
|
.SH "NAME"
|
|
lvmconfig, lvm dumpconfig, lvm config \(em Display LVM configuration
|
|
.SH SYNOPSIS
|
|
.B lvmconfig
|
|
.RB [ \-f | \-\-file
|
|
.IR filename ]
|
|
.RB [ \-\-type
|
|
.RI { current | default | diff | missing | new | profilable | profilable-command | profilable-metadata }
|
|
.RB [ \-\-atversion
|
|
.IR version ]
|
|
.RB [ \-\-ignoreadvanced ]
|
|
.RB [ \-\-ignoreunsupported ]
|
|
.RB [ \-\-ignorelocal ]
|
|
.RB [ \-l | \-\-list ]
|
|
.RB [ \-\-config
|
|
.IR ConfigurationString ]
|
|
.RB [ \-\-commandprofile
|
|
.IR ProfileName ]
|
|
.RB [ \-\-profile
|
|
.IR ProfileName ]
|
|
.RB [ \-\-metadataprofile
|
|
.IR ProfileName ]
|
|
.RB [ \-\-mergedconfig ]
|
|
.RB [ \-\-validate ]
|
|
.RB [ \-\-withsummary ]
|
|
.RB [ \-\-withcomments ]
|
|
.RB [ \-\-withversions ]
|
|
.RB [ ConfigurationNode... ]
|
|
|
|
.SH DESCRIPTION
|
|
lvmconfig produces formatted output from the LVM configuration tree.
|
|
The command was added in release 2.02.119 and has an identical longer form
|
|
\fBlvm dumpconfig\fP.
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-f ", " \-\-file " \fIfilename"
|
|
Send output to a file named 'filename'.
|
|
|
|
.TP
|
|
.BR \-l ", " \-\-list
|
|
List configuration settings with summarizing comment. This is the same as using
|
|
\fBlvmconfig --type list --withsummary\fP.
|
|
|
|
.TP
|
|
.IR \fB\-\-type " {" current | default | diff | missing | new | profilable }
|
|
Select the type of configuration to display. The configuration settings
|
|
displayed have either default values or currently-used values assigned based on
|
|
the type selected. If no type is selected, \fB\-\-type current\fP is used
|
|
by default. Whenever a configuration setting with a default value is
|
|
commented out, it means the setting does not have any concrete default
|
|
value defined. Output can be saved and used as a proper \fBlvm.conf\fP(5)
|
|
file.
|
|
.RS
|
|
.IP current 3
|
|
Display the current \fBlvm.conf\fP configuration merged with any \fBtag
|
|
config\fP if used. See also \fBlvm.conf\fP(5) for more info about LVM
|
|
configuration methods.
|
|
.IP default 3
|
|
Display all possible configuration settings with default values assigned.
|
|
.IP diff 3
|
|
Display all configuration settings for which the values used differ from defaults.
|
|
The value assigned for each configuration setting is the value currently used.
|
|
This is actually minimal LVM configuration which can be used without
|
|
a change to current configured behaviour.
|
|
.IP list 3
|
|
Display plain list of configuration settings.
|
|
.IP missing 3
|
|
Display all configuration settings with default values assigned which are
|
|
missing in the configuration currently used and for which LVM automatically
|
|
fallbacks to using these default values.
|
|
.IP new 3
|
|
Display all new configuration settings introduced in current LVM version
|
|
or specific version as defined by \fB\-\-atversion\fP option.
|
|
.IP profilable 3
|
|
Display 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
|
|
Display all profilable configuration settings with default values assigned
|
|
that can be used in command profile. This is a subset of settings displayed
|
|
by \fB\-\-type \-\-profilable\fP.
|
|
.IP profilable-metadata 3
|
|
Display all profilable configuration settings with default values assigned
|
|
that can be used in metadata profile. This is a subset of settings displayed
|
|
by \fB\-\-type \-\-profilable\fP.
|
|
.RE
|
|
|
|
.TP
|
|
.BI \-\-atversion " version"
|
|
Specify an LVM version in x.y.z format where x is the major version,
|
|
the y is the minor version and z is the patchlevel (e.g. 2.2.106).
|
|
When configuration is displayed, the configuration settings recognized
|
|
at this LVM version will be considered only. This can be used
|
|
to display a configuration that a certain LVM version understands and
|
|
which does not contain any newer settings for which LVM would
|
|
issue a warning message when checking the configuration.
|
|
|
|
.TP
|
|
.B \-\-ignoreadvanced
|
|
Exclude advanced configuration settings from the output.
|
|
|
|
.TP
|
|
.B \-\-ignoreunsupported
|
|
Exclude unsupported configuration settings from the output. These settings are
|
|
either used for debugging purposes only or their support is not yet
|
|
complete and they are not meant to be used in production.
|
|
|
|
.TP
|
|
.B \-\-ignorelocal
|
|
Ignore local section.
|
|
|
|
.TP
|
|
.BI \-\-config " ConfigurationString"
|
|
Use \fBConfigurationString\fP to override existing configuration.
|
|
This configuration is then applied for the lvmconfig 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 the lvmconfig command itself.
|
|
See also \fB\-\-mergedconfig\fP option and \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 the lvmconfig command itself.
|
|
|
|
.TP
|
|
.BI \-\-metadataprofile " ProfileName"
|
|
Use \fBProfileName\fP to override existing configuration.
|
|
The configuration defined in metadata profile has no effect for
|
|
the lvmconfig command itself. lvmconfig displays the configuration only.
|
|
See also \fB\-\-mergedconfig\fP option and \fBlvm.conf\fP(5) for more
|
|
info about \fBconfig cascade\fP.
|
|
|
|
.TP
|
|
.B \-\-mergedconfig
|
|
When the lvmconfig command is run with the \fB\-\-config\fP option
|
|
and/or \fB\-\-commandprofile\fP (or using \fBLVM_COMMAND_PROFILE\fP
|
|
environment variable), \fB\-\-profile\fP, \fB\-\-metadataprofile\fP
|
|
option, merge all the contents of the \fBconfig cascade\fP before displaying it.
|
|
Without the \fB\-\-mergeconfig\fP option used, only the configuration at
|
|
the front of the cascade is displayed. 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 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 \-\-withsummary
|
|
Display a one line comment for each configuration node.
|
|
|
|
.TP
|
|
.B \-\-withcomments
|
|
Display a full comment for each configuration node.
|
|
|
|
.TP
|
|
.B \-\-withversions
|
|
Also display a comment containing the version of introduction for
|
|
each configuration node.
|
|
|
|
.SH SEE ALSO
|
|
.BR lvm (8)
|
|
.BR lvmconf (8)
|
|
.BR lvm.conf (5)
|