1
0
mirror of git://sourceware.org/git/lvm2.git synced 2025-01-03 05:18:29 +03:00

man: pre-generated files weren't committed

This commit is contained in:
Alasdair G Kergon 2017-03-28 01:32:59 +01:00
parent 19a72e601f
commit b9399f2148
45 changed files with 3468 additions and 3417 deletions

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -1,6 +1,6 @@
.TH LVDISPLAY 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVDISPLAY 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvdisplay \- Display information about a logical volume lvdisplay - Display information about a logical volume
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvdisplay\fP \fBlvdisplay\fP
@ -20,103 +20,103 @@ and more, using a more compact and configurable output format.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-a\fP|\fB\-\-all\fP ] [ \fB-a\fP|\fB--all\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-c\fP|\fB\-\-colon\fP ] [ \fB-c\fP|\fB--colon\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-C\fP|\fB\-\-columns\fP ] [ \fB-C\fP|\fB--columns\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-H\fP|\fB\-\-history\fP ] [ \fB-H\fP|\fB--history\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-m\fP|\fB\-\-maps\fP ] [ \fB-m\fP|\fB--maps\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] [ \fB-o\fP|\fB--options\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] [ \fB-O\fP|\fB--sort\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-P\fP|\fB\-\-partial\fP ] [ \fB-P\fP|\fB--partial\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-aligned\fP ] [ \fB--aligned\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-binary\fP ] [ \fB--binary\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] [ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-foreign\fP ] [ \fB--foreign\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreskippedcluster\fP ] [ \fB--ignoreskippedcluster\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-logonly\fP ] [ \fB--logonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noheadings\fP ] [ \fB--noheadings\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nosuffix\fP ] [ \fB--nosuffix\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-readonly\fP ] [ \fB--readonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-segments\fP ] [ \fB--segments\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-separator\fP \fIString\fP ] [ \fB--separator\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-shared\fP ] [ \fB--shared\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unbuffered\fP ] [ \fB--unbuffered\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] [ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -130,63 +130,63 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-aligned\fP \fB--aligned\fP
.br .br
Use with \-\-separator to align the output columns Use with --separator to align the output columns
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
Show information about internal LVs. Show information about internal LVs.
These are components of normal LVs, such as mirrors, These are components of normal LVs, such as mirrors,
@ -194,7 +194,7 @@ which are not independently accessible, e.g. not mountable.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-binary\fP \fB--binary\fP
.br .br
Use binary values "0" or "1" instead of descriptive literal values Use binary values "0" or "1" instead of descriptive literal values
for columns that have exactly two valid values to report (not counting for columns that have exactly two valid values to report (not counting
@ -202,28 +202,28 @@ the "unknown" value which denotes that the value could not be determined).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-c\fP|\fB\-\-colon\fP \fB-c\fP|\fB--colon\fP
.br .br
Generate colon separated output for easier parsing in scripts or programs. Generate colon separated output for easier parsing in scripts or programs.
Also see vgs(8) which provides considerably more control over the output. Also see vgs(8) which provides considerably more control over the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-C\fP|\fB\-\-columns\fP \fB-C\fP|\fB--columns\fP
.br .br
Display output in columns, the equivalent of vgs(8). Display output in columns, the equivalent of vgs(8).
Options listed are the same as options given in vgs(8). Options listed are the same as options given in vgs(8).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -232,40 +232,40 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP
.br .br
See lvmreport(7). See lvmreport(7).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-foreign\fP \fB--foreign\fP
.br .br
Report/display foreign VGs that would otherwise be skipped. Report/display foreign VGs that would otherwise be skipped.
See lvmsystemid(7) for more information about foreign VGs. See lvmsystemid(7) for more information about foreign VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-H\fP|\fB\-\-history\fP \fB-H\fP|\fB--history\fP
.br .br
Include historical LVs in the output. Include historical LVs in the output.
(This has no effect unless LVs were removed while (This has no effect unless LVs were removed while
@ -273,55 +273,55 @@ lvm.conf metadata/record_lvs_history was enabled.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreskippedcluster\fP \fB--ignoreskippedcluster\fP
.br .br
Use to avoid exiting with an non-zero status code if the command is run Use to avoid exiting with an non-zero status code if the command is run
without clustered locking and clustered VGs are skipped. without clustered locking and clustered VGs are skipped.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-logonly\fP \fB--logonly\fP
.br .br
Suppress command report and display only log report. Suppress command report and display only log report.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-m\fP|\fB\-\-maps\fP \fB-m\fP|\fB--maps\fP
.br .br
Display the mapping of logical extents to PVs and physical extents. Display the mapping of logical extents to PVs and physical extents.
To map physical extents to logical extents use: To map physical extents to logical extents use:
pvs \-\-segments -o+lv_name,seg_start_pe,segtype pvs --segments -o+lv_name,seg_start_pe,segtype
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noheadings\fP \fB--noheadings\fP
.br .br
Suppress the headings line that is normally the first line of output. Suppress the headings line that is normally the first line of output.
Useful if grepping the output. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nosuffix\fP \fB--nosuffix\fP
.br .br
Suppress the suffix on output sizes. Use with \-\-units Suppress the suffix on output sizes. Use with --units
(except h and H) if processing the output. (except h and H) if processing the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-o\fP|\fB\-\-options\fP \fIString\fP \fB-o\fP|\fB--options\fP \fIString\fP
.br .br
Comma-separated, ordered list of fields to display in columns. Comma-separated, ordered list of fields to display in columns.
String arg syntax is: [+|-|#]Field1[,Field2 ...] String arg syntax is: [+|-|#]Field1[,Field2 ...]
@ -343,7 +343,7 @@ See lvmreport(7) for more information about reporting.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.br .br
When set, the tools will do their best to provide access to VGs When set, the tools will do their best to provide access to VGs
that are only partially available (one or more PVs belonging that are only partially available (one or more PVs belonging
@ -352,21 +352,21 @@ changed with this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-readonly\fP \fB--readonly\fP
.br .br
Run the command in a special read-only mode which will read on-disk Run the command in a special read-only mode which will read on-disk
metadata without needing to take any locks. This can be used to peek metadata without needing to take any locks. This can be used to peek
@ -380,7 +380,7 @@ actually in use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -391,17 +391,17 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-segments\fP \fB--segments\fP
.br .br
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -409,13 +409,13 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-separator\fP \fIString\fP \fB--separator\fP \fIString\fP
.br .br
String to use to separate each column. Useful if grepping the output. String to use to separate each column. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-shared\fP \fB--shared\fP
.br .br
Report/display shared VGs that would otherwise be skipped when Report/display shared VGs that would otherwise be skipped when
lvmlockd is not being used on the host. lvmlockd is not being used on the host.
@ -423,14 +423,14 @@ See lvmlockd(8) for more information about shared VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-O\fP|\fB\-\-sort\fP \fIString\fP \fB-O\fP|\fB--sort\fP \fIString\fP
.br .br
Comma-separated ordered list of columns to sort by. Replaces the default Comma-separated ordered list of columns to sort by. Replaces the default
selection. Precede any column with \fB-\fP for a reverse sort on that column. selection. Precede any column with \fB-\fP for a reverse sort on that column.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -440,37 +440,37 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unbuffered\fP \fB--unbuffered\fP
.br .br
Produce output immediately without sorting or aligning the columns properly. Produce output immediately without sorting or aligning the columns properly.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP
.br .br
All sizes are output in these units: All sizes are output in these units:
human-(r)eadable with '<' rounding indicator, human-(r)eadable with '<' rounding indicator,
(h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes,
(g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes.
Capitalise to use multiples of 1000 (S.I.) instead of 1024. Capitalise to use multiples of 1000 (S.I.) instead of 1024.
Custom units can be specified, e.g. \-\-units 3M. Custom units can be specified, e.g. --units 3M.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -506,7 +506,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH LVEXTEND 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVEXTEND 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvextend \- Add space to a logical volume lvextend - Add space to a logical volume
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvextend\fP \fIoption_args\fP \fIposition_args\fP \fBlvextend\fP \fIoption_args\fP \fIposition_args\fP
@ -11,154 +11,154 @@ lvextend \- Add space to a logical volume
.br .br
.P .P
.ad l .ad l
\fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP \fB-d\fP|\fB--debug\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-l\fP|\fB\-\-extents\fP [\fB+\fP]\fINumber\fP[PERCENT] \fB-l\fP|\fB--extents\fP [\fB+\fP]\fINumber\fP[PERCENT]
.ad b .ad b
.br .br
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP \fB-f\fP|\fB--force\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-m\fP|\fB\-\-mirrors\fP \fINumber\fP \fB-m\fP|\fB--mirrors\fP \fINumber\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-n\fP|\fB\-\-nofsck\fP \fB-n\fP|\fB--nofsck\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-nosync\fP \fB--nosync\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT]
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP \fB-q\fP|\fB--quiet\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-r\fP|\fB\-\-resizefs\fP \fB-r\fP|\fB--resizefs\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-L\fP|\fB\-\-size\fP [\fB+\fP]\fISize\fP[m|UNIT] \fB-L\fP|\fB--size\fP [\fB+\fP]\fISize\fP[m|UNIT]
.ad b .ad b
.br .br
.ad l .ad l
\fB-i\fP|\fB\-\-stripes\fP \fINumber\fP \fB-i\fP|\fB--stripes\fP \fINumber\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT]
.ad b .ad b
.br .br
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP \fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-usepolicies\fP \fB--usepolicies\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP \fB-v\fP|\fB--verbose\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.ad b .ad b
.SH DESCRIPTION .SH DESCRIPTION
lvextend extends the size of an LV. This requires allocating logical lvextend extends the size of an LV. This requires allocating logical
extents from the VG's free physical extents. If the extension adds a new extents from the VG's free physical extents. If the extension adds a new
LV segment, the new segment will use the existing segment type of the LV. LV segment, the new segment will use the existing segment type of the LV.
Extending a copy\-on\-write snapshot LV adds space for COW blocks. Extending a copy-on-write snapshot LV adds space for COW blocks.
Use \fBlvconvert\fP(8) to change the number of data images in a RAID or Use \fBlvconvert\fP(8) to change the number of data images in a RAID or
mirrored LV. mirrored LV.
In the usage section below, \fB\-\-size\fP \fISize\fP can be replaced In the usage section below, \fB--size\fP \fISize\fP can be replaced
with \fB\-\-extents\fP \fINumber\fP. See both descriptions with \fB--extents\fP \fINumber\fP. See both descriptions
the options section. the options section.
.SH USAGE .SH USAGE
Extend an LV by a specified size. Extend an LV by a specified size.
.br .br
.P .P
\fBlvextend\fP \fB-L\fP|\fB\-\-size\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP \fBlvextend\fP \fB-L\fP|\fB--size\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-l\fP|\fB\-\-extents\fP [\fB+\fP]\fINumber\fP[PERCENT] ] [ \fB-l\fP|\fB--extents\fP [\fB+\fP]\fINumber\fP[PERCENT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-r\fP|\fB\-\-resizefs\fP ] [ \fB-r\fP|\fB--resizefs\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] [ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] [ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] ] [ \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -176,15 +176,15 @@ Extend an LV by specified PV extents.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-r\fP|\fB\-\-resizefs\fP ] [ \fB-r\fP|\fB--resizefs\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] [ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] [ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -195,15 +195,15 @@ Extend an LV by specified PV extents.
Extend a pool metadata SubLV by a specified size. Extend a pool metadata SubLV by a specified size.
.br .br
.P .P
\fBlvextend\fP \fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP \fBlvextend\fP \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] [ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] [ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -217,11 +217,11 @@ Extend a pool metadata SubLV by a specified size.
Extend an LV according to a predefined policy. Extend an LV according to a predefined policy.
.br .br
.P .P
\fBlvextend\fP \fB\-\-usepolicies\fP \fILV\fP\fI_snapshot_thinpool\fP \fBlvextend\fP \fB--usepolicies\fP \fILV\fP\fI_snapshot_thinpool\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-r\fP|\fB\-\-resizefs\fP ] [ \fB-r\fP|\fB--resizefs\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -236,39 +236,39 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-m\fP|\fB\-\-mirrors\fP \fINumber\fP ] [ \fB-m\fP|\fB--mirrors\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-n\fP|\fB\-\-nofsck\fP ] [ \fB-n\fP|\fB--nofsck\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] [ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nosync\fP ] [ \fB--nosync\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noudevsync\fP ] [ \fB--noudevsync\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP ] [ \fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP ]
.ad b .ad b
.RE .RE
@ -276,57 +276,57 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP
.br .br
Determines the allocation policy when a command needs to allocate Determines the allocation policy when a command needs to allocate
Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy
@ -347,21 +347,21 @@ See \fBlvm\fP(8) for more information about allocation.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -370,24 +370,24 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-extents\fP [\fB+\fP]\fINumber\fP[PERCENT] \fB-l\fP|\fB--extents\fP [\fB+\fP]\fINumber\fP[PERCENT]
.br .br
Specifies the new size of the LV in logical extents. Specifies the new size of the LV in logical extents.
The \-\-size and \-\-extents options are alternate methods of specifying size. The --size and --extents options are alternate methods of specifying size.
The total number of physical extents used will be The total number of physical extents used will be
greater when redundant data is needed for RAID levels. greater when redundant data is needed for RAID levels.
An alternate syntax allows the size to be determined indirectly An alternate syntax allows the size to be determined indirectly
@ -407,40 +407,40 @@ from the current size.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-m\fP|\fB\-\-mirrors\fP \fINumber\fP \fB-m\fP|\fB--mirrors\fP \fINumber\fP
.br .br
Not used. Not used.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-n\fP|\fB\-\-nofsck\fP \fB-n\fP|\fB--nofsck\fP
.br .br
Do not perform fsck before resizing filesystem when filesystem Do not perform fsck before resizing filesystem when filesystem
requires it. You may need to use \-\-force to proceed with requires it. You may need to use --force to proceed with
this option. this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nosync\fP \fB--nosync\fP
.br .br
Causes the creation of mirror, raid1, raid4, raid5 and raid10 to skip the Causes the creation of mirror, raid1, raid4, raid5 and raid10 to skip the
initial synchronization. In case of mirror, raid1 and raid10, any data initial synchronization. In case of mirror, raid1 and raid10, any data
@ -457,7 +457,7 @@ and thus do not support initial synchronization.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.br .br
Disables udev synchronisation. The process will not wait for notification Disables udev synchronisation. The process will not wait for notification
from udev. It will continue irrespective of any possible udev processing from udev. It will continue irrespective of any possible udev processing
@ -466,7 +466,7 @@ ignore the devices LVM creates.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT]
.br .br
Specifies the new size of the pool metadata LV. Specifies the new size of the pool metadata LV.
The plus prefix \fB+\fP can be used, in which case The plus prefix \fB+\fP can be used, in which case
@ -474,21 +474,21 @@ the value is added to the current size.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -499,16 +499,16 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-r\fP|\fB\-\-resizefs\fP \fB-r\fP|\fB--resizefs\fP
.br .br
Resize underlying filesystem together with the LV using fsadm(8). Resize underlying filesystem together with the LV using fsadm(8).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-L\fP|\fB\-\-size\fP [\fB+\fP]\fISize\fP[m|UNIT] \fB-L\fP|\fB--size\fP [\fB+\fP]\fISize\fP[m|UNIT]
.br .br
Specifies the new size of the LV. Specifies the new size of the LV.
The \-\-size and \-\-extents options are alternate methods of specifying size. The --size and --extents options are alternate methods of specifying size.
The total number of physical extents used will be The total number of physical extents used will be
greater when redundant data is needed for RAID levels. greater when redundant data is needed for RAID levels.
When the plus \fB+\fP or minus \fB-\fP prefix is used, When the plus \fB+\fP or minus \fB-\fP prefix is used,
@ -517,31 +517,31 @@ from the current size.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-i\fP|\fB\-\-stripes\fP \fINumber\fP \fB-i\fP|\fB--stripes\fP \fINumber\fP
.br .br
Specifies the number of stripes in a striped LV. This is the number of Specifies the number of stripes in a striped LV. This is the number of
PVs (devices) that a striped LV is spread across. Data that PVs (devices) that a striped LV is spread across. Data that
appears sequential in the LV is spread across multiple devices in units of appears sequential in the LV is spread across multiple devices in units of
the stripe size (see \-\-stripesize). This does not change existing the stripe size (see --stripesize). This does not change existing
allocated space, but only applies to space being allocated by the command. allocated space, but only applies to space being allocated by the command.
When creating a RAID 4/5/6 LV, this number does not include the extra When creating a RAID 4/5/6 LV, this number does not include the extra
devices that are required for parity. The largest number depends on devices that are required for parity. The largest number depends on
the RAID type (raid0: 64, raid10: 32, raid4/5: 63, raid6: 62), and the RAID type (raid0: 64, raid10: 32, raid4/5: 63, raid6: 62), and
when unspecified, the default depends on the RAID type when unspecified, the default depends on the RAID type
(raid0: 2, raid10: 4, raid4/5: 3, raid6: 5.) (raid0: 2, raid10: 2, raid4/5: 3, raid6: 5.)
To stripe a new raid LV across all PVs by default, To stripe a new raid LV across all PVs by default,
see lvm.conf allocation/raid_stripe_all_devices. see lvm.conf allocation/raid_stripe_all_devices.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT]
.br .br
The amount of data that is written to one device before The amount of data that is written to one device before
moving to the next in a striped LV. moving to the next in a striped LV.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -551,7 +551,7 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP \fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP
.br .br
The LV type, also known as "segment type" or "segtype". The LV type, also known as "segment type" or "segtype".
See usage descriptions for the specific ways to use these types. See usage descriptions for the specific ways to use these types.
@ -561,32 +561,32 @@ For performance caching (\fBcache\fP, \fBcache-pool\fP) see \fBlvmcache\fP(7).
For copy-on-write snapshots (\fBsnapshot\fP) see usage definitions. For copy-on-write snapshots (\fBsnapshot\fP) see usage definitions.
Several commands omit an explicit type option because the type Several commands omit an explicit type option because the type
is inferred from other options or shortcuts is inferred from other options or shortcuts
(e.g. \-\-stripes, \-\-mirrors, \-\-snapshot, \-\-virtualsize, \-\-thin, \-\-cache). (e.g. --stripes, --mirrors, --snapshot, --virtualsize, --thin, --cache).
Use inferred types with care because it can lead to unexpected results. Use inferred types with care because it can lead to unexpected results.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-usepolicies\fP \fB--usepolicies\fP
.br .br
Perform an operation according to the policy configured in lvm.conf Perform an operation according to the policy configured in lvm.conf
or a profile. or a profile.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -625,7 +625,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -633,17 +633,17 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete
.SH EXAMPLES .SH EXAMPLES
Extend the size of an LV by 54MiB, using a specific PV. Extend the size of an LV by 54MiB, using a specific PV.
.br .br
.B lvextend \-L +54 vg01/lvol10 /dev/sdk3 .B lvextend -L +54 vg01/lvol10 /dev/sdk3
Extend the size of an LV by the amount of free Extend the size of an LV by the amount of free
space on PV /dev/sdk3. This is equivalent to specifying space on PV /dev/sdk3. This is equivalent to specifying
"\-l +100%PVS" on the command line. "-l +100%PVS" on the command line.
.br .br
.B lvextend vg01/lvol01 /dev/sdk3 .B lvextend vg01/lvol01 /dev/sdk3
Extend an LV by 16MiB using specific physical extents. Extend an LV by 16MiB using specific physical extents.
.br .br
.B lvextend \-L+16m vg01/lvol01 /dev/sda:8\-9 /dev/sdb:8\-9 .B lvextend -L+16m vg01/lvol01 /dev/sda:8-9 /dev/sdb:8-9
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH LVM CONFIG 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVM CONFIG 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvm config \- Display and manipulate configuration information lvm config - Display and manipulate configuration information
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvm config\fP \fBlvm config\fP
@ -14,81 +14,81 @@ This command is the same as \fBlvmconfig\fP(8).
lvm config produces formatted output from the LVM configuration tree. The lvm config produces formatted output from the LVM configuration tree. The
sources of the configuration data include \fBlvm.conf\fP(5) and command sources of the configuration data include \fBlvm.conf\fP(5) and command
line settings from \-\-config. line settings from --config.
.SH USAGE .SH USAGE
\fBlvm config\fP \fBlvm config\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-f\fP|\fB\-\-file\fP \fIString\fP ] [ \fB-f\fP|\fB--file\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-l\fP|\fB\-\-list\fP ] [ \fB-l\fP|\fB--list\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-atversion\fP \fIString\fP ] [ \fB--atversion\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ] [ \fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreadvanced\fP ] [ \fB--ignoreadvanced\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreunsupported\fP ] [ \fB--ignoreunsupported\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelocal\fP ] [ \fB--ignorelocal\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-mergedconfig\fP ] [ \fB--mergedconfig\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-metadataprofile\fP \fIString\fP ] [ \fB--metadataprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-sinceversion\fP \fIString\fP ] [ \fB--sinceversion\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-showdeprecated\fP ] [ \fB--showdeprecated\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-showunsupported\fP ] [ \fB--showunsupported\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-validate\fP ] [ \fB--validate\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withsummary\fP ] [ \fB--withsummary\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withcomments\fP ] [ \fB--withcomments\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withspaces\fP ] [ \fB--withspaces\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unconfigured\fP ] [ \fB--unconfigured\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withversions\fP ] [ \fB--withversions\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -102,57 +102,57 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-atversion\fP \fIString\fP \fB--atversion\fP \fIString\fP
.br .br
Specify an LVM version in x.y.z format where x is the major 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). the y is the minor version and z is the patchlevel (e.g. 2.2.106).
@ -164,14 +164,14 @@ issue a warning message when checking the configuration.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -180,45 +180,45 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-file\fP \fIString\fP \fB-f\fP|\fB--file\fP \fIString\fP
.br .br
Write output to the named file. Write output to the named file.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreadvanced\fP \fB--ignoreadvanced\fP
.br .br
Exclude advanced configuration settings from the output. Exclude advanced configuration settings from the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelocal\fP \fB--ignorelocal\fP
.br .br
Ignore local section. Ignore local section.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreunsupported\fP \fB--ignoreunsupported\fP
.br .br
Exclude unsupported configuration settings from the output. These settings are Exclude unsupported configuration settings from the output. These settings are
either used for debugging and development purposes only or their support is not either used for debugging and development purposes only or their support is not
@ -228,24 +228,24 @@ all the other types ignore unsupported settings.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-list\fP \fB-l\fP|\fB--list\fP
.br .br
List config settings with summarizing comment. This is the same as using List config settings with summarizing comment. This is the same as using
options \-\-typeconfig list \-\-withsummary. options --typeconfig list --withsummary.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-mergedconfig\fP \fB--mergedconfig\fP
.br .br
When the command is run with \-\-config When the command is run with --config
and/or \-\-commandprofile (or using LVM_COMMAND_PROFILE and/or --commandprofile (or using LVM_COMMAND_PROFILE
environment variable), \-\-profile, or \-\-metadataprofile, environment variable), --profile, or --metadataprofile,
merge all the contents of the "config cascade" before displaying it. merge all the contents of the "config cascade" before displaying it.
Without merging, only the configuration at the front of the Without merging, only the configuration at the front of the
cascade is displayed. cascade is displayed.
@ -253,39 +253,39 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadataprofile\fP \fIString\fP \fB--metadataprofile\fP \fIString\fP
.br .br
The metadata profile to use for command configuration. The metadata profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-showdeprecated\fP \fB--showdeprecated\fP
.br .br
Include deprecated configuration settings in the output. These settings Include deprecated configuration settings in the output. These settings
are deprecated after a certain version. If a concrete version is specified are deprecated after a certain version. If a concrete version is specified
with \-\-atversion, deprecated settings are automatically included with --atversion, deprecated settings are automatically included
if the specified version is lower than the version in which the settings were if the specified version is lower than the version in which the settings were
deprecated. The current and diff types include deprecated settings deprecated. The current and diff types include deprecated settings
in their output by default, all the other types ignore deprecated settings. in their output by default, all the other types ignore deprecated settings.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-showunsupported\fP \fB--showunsupported\fP
.br .br
Include unsupported configuration settings in the output. These settings Include unsupported configuration settings in the output. These settings
are either used for debugging or development purposes only, or their support are either used for debugging or development purposes only, or their support
@ -295,16 +295,16 @@ output by default, all the other types ignore unsupported settings.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-sinceversion\fP \fIString\fP \fB--sinceversion\fP \fIString\fP
.br .br
Specify an LVM version in x.y.z format where x is the major 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). the y is the minor version and z is the patchlevel (e.g. 2.2.106).
This option is currently applicable only with \-\-typeconfig new This option is currently applicable only with --typeconfig new
to display all configuration settings introduced since given version. to display all configuration settings introduced since given version.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -314,61 +314,61 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP \fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP
.br .br
See lvmreport(7). See lvmreport(7).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unconfigured\fP \fB--unconfigured\fP
.br .br
Internal option used for generating config file during build. Internal option used for generating config file during build.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-validate\fP \fB--validate\fP
.br .br
Validate current configuration used and exit with appropriate Validate current configuration used and exit with appropriate
return code. The validation is done only for the configuration return code. The validation is done only for the configuration
at the front of the "config cascade". To validate the whole at the front of the "config cascade". To validate the whole
merged configuration tree, also use \-\-mergedconfig. merged configuration tree, also use --mergedconfig.
The validation is done even if lvm.conf config/checks is disabled. The validation is done even if lvm.conf config/checks is disabled.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withcomments\fP \fB--withcomments\fP
.br .br
Display a full comment for each configuration node. For deprecated Display a full comment for each configuration node. For deprecated
settings, also display comments about deprecation. settings, also display comments about deprecation.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withspaces\fP \fB--withspaces\fP
.br .br
Where appropriate, add more spaces in output for better readability. Where appropriate, add more spaces in output for better readability.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withsummary\fP \fB--withsummary\fP
.br .br
Display a one line comment for each configuration node. Display a one line comment for each configuration node.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withversions\fP \fB--withversions\fP
.br .br
Also display a comment containing the version of introduction for Also display a comment containing the version of introduction for
each configuration node. If the setting is deprecated, also display each configuration node. If the setting is deprecated, also display
@ -376,7 +376,7 @@ the version since which it is deprecated.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -398,7 +398,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH LVM DUMPCONFIG 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVM DUMPCONFIG 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvm dumpconfig \- Display and manipulate configuration information lvm dumpconfig - Display and manipulate configuration information
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvm dumpconfig\fP \fBlvm dumpconfig\fP
@ -14,81 +14,81 @@ This command is the same as \fBlvmconfig\fP(8).
lvm dumpconfig produces formatted output from the LVM configuration tree. The lvm dumpconfig produces formatted output from the LVM configuration tree. The
sources of the configuration data include \fBlvm.conf\fP(5) and command sources of the configuration data include \fBlvm.conf\fP(5) and command
line settings from \-\-config. line settings from --config.
.SH USAGE .SH USAGE
\fBlvm dumpconfig\fP \fBlvm dumpconfig\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-f\fP|\fB\-\-file\fP \fIString\fP ] [ \fB-f\fP|\fB--file\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-l\fP|\fB\-\-list\fP ] [ \fB-l\fP|\fB--list\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-atversion\fP \fIString\fP ] [ \fB--atversion\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ] [ \fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreadvanced\fP ] [ \fB--ignoreadvanced\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreunsupported\fP ] [ \fB--ignoreunsupported\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelocal\fP ] [ \fB--ignorelocal\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-mergedconfig\fP ] [ \fB--mergedconfig\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-metadataprofile\fP \fIString\fP ] [ \fB--metadataprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-sinceversion\fP \fIString\fP ] [ \fB--sinceversion\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-showdeprecated\fP ] [ \fB--showdeprecated\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-showunsupported\fP ] [ \fB--showunsupported\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-validate\fP ] [ \fB--validate\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withsummary\fP ] [ \fB--withsummary\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withcomments\fP ] [ \fB--withcomments\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withspaces\fP ] [ \fB--withspaces\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unconfigured\fP ] [ \fB--unconfigured\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withversions\fP ] [ \fB--withversions\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -102,57 +102,57 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-atversion\fP \fIString\fP \fB--atversion\fP \fIString\fP
.br .br
Specify an LVM version in x.y.z format where x is the major 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). the y is the minor version and z is the patchlevel (e.g. 2.2.106).
@ -164,14 +164,14 @@ issue a warning message when checking the configuration.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -180,45 +180,45 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-file\fP \fIString\fP \fB-f\fP|\fB--file\fP \fIString\fP
.br .br
Write output to the named file. Write output to the named file.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreadvanced\fP \fB--ignoreadvanced\fP
.br .br
Exclude advanced configuration settings from the output. Exclude advanced configuration settings from the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelocal\fP \fB--ignorelocal\fP
.br .br
Ignore local section. Ignore local section.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreunsupported\fP \fB--ignoreunsupported\fP
.br .br
Exclude unsupported configuration settings from the output. These settings are Exclude unsupported configuration settings from the output. These settings are
either used for debugging and development purposes only or their support is not either used for debugging and development purposes only or their support is not
@ -228,24 +228,24 @@ all the other types ignore unsupported settings.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-list\fP \fB-l\fP|\fB--list\fP
.br .br
List config settings with summarizing comment. This is the same as using List config settings with summarizing comment. This is the same as using
options \-\-typeconfig list \-\-withsummary. options --typeconfig list --withsummary.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-mergedconfig\fP \fB--mergedconfig\fP
.br .br
When the command is run with \-\-config When the command is run with --config
and/or \-\-commandprofile (or using LVM_COMMAND_PROFILE and/or --commandprofile (or using LVM_COMMAND_PROFILE
environment variable), \-\-profile, or \-\-metadataprofile, environment variable), --profile, or --metadataprofile,
merge all the contents of the "config cascade" before displaying it. merge all the contents of the "config cascade" before displaying it.
Without merging, only the configuration at the front of the Without merging, only the configuration at the front of the
cascade is displayed. cascade is displayed.
@ -253,39 +253,39 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadataprofile\fP \fIString\fP \fB--metadataprofile\fP \fIString\fP
.br .br
The metadata profile to use for command configuration. The metadata profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-showdeprecated\fP \fB--showdeprecated\fP
.br .br
Include deprecated configuration settings in the output. These settings Include deprecated configuration settings in the output. These settings
are deprecated after a certain version. If a concrete version is specified are deprecated after a certain version. If a concrete version is specified
with \-\-atversion, deprecated settings are automatically included with --atversion, deprecated settings are automatically included
if the specified version is lower than the version in which the settings were if the specified version is lower than the version in which the settings were
deprecated. The current and diff types include deprecated settings deprecated. The current and diff types include deprecated settings
in their output by default, all the other types ignore deprecated settings. in their output by default, all the other types ignore deprecated settings.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-showunsupported\fP \fB--showunsupported\fP
.br .br
Include unsupported configuration settings in the output. These settings Include unsupported configuration settings in the output. These settings
are either used for debugging or development purposes only, or their support are either used for debugging or development purposes only, or their support
@ -295,16 +295,16 @@ output by default, all the other types ignore unsupported settings.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-sinceversion\fP \fIString\fP \fB--sinceversion\fP \fIString\fP
.br .br
Specify an LVM version in x.y.z format where x is the major 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). the y is the minor version and z is the patchlevel (e.g. 2.2.106).
This option is currently applicable only with \-\-typeconfig new This option is currently applicable only with --typeconfig new
to display all configuration settings introduced since given version. to display all configuration settings introduced since given version.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -314,61 +314,61 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP \fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP
.br .br
See lvmreport(7). See lvmreport(7).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unconfigured\fP \fB--unconfigured\fP
.br .br
Internal option used for generating config file during build. Internal option used for generating config file during build.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-validate\fP \fB--validate\fP
.br .br
Validate current configuration used and exit with appropriate Validate current configuration used and exit with appropriate
return code. The validation is done only for the configuration return code. The validation is done only for the configuration
at the front of the "config cascade". To validate the whole at the front of the "config cascade". To validate the whole
merged configuration tree, also use \-\-mergedconfig. merged configuration tree, also use --mergedconfig.
The validation is done even if lvm.conf config/checks is disabled. The validation is done even if lvm.conf config/checks is disabled.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withcomments\fP \fB--withcomments\fP
.br .br
Display a full comment for each configuration node. For deprecated Display a full comment for each configuration node. For deprecated
settings, also display comments about deprecation. settings, also display comments about deprecation.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withspaces\fP \fB--withspaces\fP
.br .br
Where appropriate, add more spaces in output for better readability. Where appropriate, add more spaces in output for better readability.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withsummary\fP \fB--withsummary\fP
.br .br
Display a one line comment for each configuration node. Display a one line comment for each configuration node.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withversions\fP \fB--withversions\fP
.br .br
Also display a comment containing the version of introduction for Also display a comment containing the version of introduction for
each configuration node. If the setting is deprecated, also display each configuration node. If the setting is deprecated, also display
@ -376,7 +376,7 @@ the version since which it is deprecated.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -398,7 +398,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH LVM FULLREPORT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVM FULLREPORT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvm fullreport \- Display full report lvm fullreport - Display full report
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvm fullreport\fP \fBlvm fullreport\fP
@ -21,103 +21,103 @@ if information changes between commands.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-a\fP|\fB\-\-all\fP ] [ \fB-a\fP|\fB--all\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] [ \fB-o\fP|\fB--options\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-P\fP|\fB\-\-partial\fP ] [ \fB-P\fP|\fB--partial\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] [ \fB-O\fP|\fB--sort\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-aligned\fP ] [ \fB--aligned\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-binary\fP ] [ \fB--binary\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] [ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-foreign\fP ] [ \fB--foreign\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreskippedcluster\fP ] [ \fB--ignoreskippedcluster\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-logonly\fP ] [ \fB--logonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nameprefixes\fP ] [ \fB--nameprefixes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noheadings\fP ] [ \fB--noheadings\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nolocking\fP ] [ \fB--nolocking\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nosuffix\fP ] [ \fB--nosuffix\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-readonly\fP ] [ \fB--readonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-rows\fP ] [ \fB--rows\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-separator\fP \fIString\fP ] [ \fB--separator\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-shared\fP ] [ \fB--shared\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-trustcache\fP ] [ \fB--trustcache\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unbuffered\fP ] [ \fB--unbuffered\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] [ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unquoted\fP ] [ \fB--unquoted\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -131,68 +131,68 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-aligned\fP \fB--aligned\fP
.br .br
Use with \-\-separator to align the output columns Use with --separator to align the output columns
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-binary\fP \fB--binary\fP
.br .br
Use binary values "0" or "1" instead of descriptive literal values Use binary values "0" or "1" instead of descriptive literal values
for columns that have exactly two valid values to report (not counting for columns that have exactly two valid values to report (not counting
@ -200,14 +200,14 @@ the "unknown" value which denotes that the value could not be determined).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -216,94 +216,94 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP
.br .br
See lvmreport(7). See lvmreport(7).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-foreign\fP \fB--foreign\fP
.br .br
Report/display foreign VGs that would otherwise be skipped. Report/display foreign VGs that would otherwise be skipped.
See lvmsystemid(7) for more information about foreign VGs. See lvmsystemid(7) for more information about foreign VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreskippedcluster\fP \fB--ignoreskippedcluster\fP
.br .br
Use to avoid exiting with an non-zero status code if the command is run Use to avoid exiting with an non-zero status code if the command is run
without clustered locking and clustered VGs are skipped. without clustered locking and clustered VGs are skipped.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-logonly\fP \fB--logonly\fP
.br .br
Suppress command report and display only log report. Suppress command report and display only log report.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nameprefixes\fP \fB--nameprefixes\fP
.br .br
Add an "LVM2_" prefix plus the field name to the output. Useful Add an "LVM2_" prefix plus the field name to the output. Useful
with \-\-noheadings to produce a list of field=value pairs that can with --noheadings to produce a list of field=value pairs that can
be used to set environment variables (for example, in udev rules). be used to set environment variables (for example, in udev rules).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noheadings\fP \fB--noheadings\fP
.br .br
Suppress the headings line that is normally the first line of output. Suppress the headings line that is normally the first line of output.
Useful if grepping the output. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nolocking\fP \fB--nolocking\fP
.br .br
Disable locking. Disable locking.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nosuffix\fP \fB--nosuffix\fP
.br .br
Suppress the suffix on output sizes. Use with \-\-units Suppress the suffix on output sizes. Use with --units
(except h and H) if processing the output. (except h and H) if processing the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-o\fP|\fB\-\-options\fP \fIString\fP \fB-o\fP|\fB--options\fP \fIString\fP
.br .br
Comma-separated, ordered list of fields to display in columns. Comma-separated, ordered list of fields to display in columns.
String arg syntax is: [+|-|#]Field1[,Field2 ...] String arg syntax is: [+|-|#]Field1[,Field2 ...]
@ -325,7 +325,7 @@ See lvmreport(7) for more information about reporting.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.br .br
When set, the tools will do their best to provide access to VGs When set, the tools will do their best to provide access to VGs
that are only partially available (one or more PVs belonging that are only partially available (one or more PVs belonging
@ -334,21 +334,21 @@ changed with this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-readonly\fP \fB--readonly\fP
.br .br
Run the command in a special read-only mode which will read on-disk Run the command in a special read-only mode which will read on-disk
metadata without needing to take any locks. This can be used to peek metadata without needing to take any locks. This can be used to peek
@ -362,7 +362,7 @@ actually in use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -373,18 +373,18 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-rows\fP \fB--rows\fP
.br .br
Output columns as rows. Output columns as rows.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -392,13 +392,13 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-separator\fP \fIString\fP \fB--separator\fP \fIString\fP
.br .br
String to use to separate each column. Useful if grepping the output. String to use to separate each column. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-shared\fP \fB--shared\fP
.br .br
Report/display shared VGs that would otherwise be skipped when Report/display shared VGs that would otherwise be skipped when
lvmlockd is not being used on the host. lvmlockd is not being used on the host.
@ -406,14 +406,14 @@ See lvmlockd(8) for more information about shared VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-O\fP|\fB\-\-sort\fP \fIString\fP \fB-O\fP|\fB--sort\fP \fIString\fP
.br .br
Comma-separated ordered list of columns to sort by. Replaces the default Comma-separated ordered list of columns to sort by. Replaces the default
selection. Precede any column with \fB-\fP for a reverse sort on that column. selection. Precede any column with \fB-\fP for a reverse sort on that column.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -423,50 +423,50 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-trustcache\fP \fB--trustcache\fP
.br .br
Avoids certain device scanning during command processing. Do not use. Avoids certain device scanning during command processing. Do not use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unbuffered\fP \fB--unbuffered\fP
.br .br
Produce output immediately without sorting or aligning the columns properly. Produce output immediately without sorting or aligning the columns properly.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP
.br .br
All sizes are output in these units: All sizes are output in these units:
human-(r)eadable with '<' rounding indicator, human-(r)eadable with '<' rounding indicator,
(h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes,
(g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes.
Capitalise to use multiples of 1000 (S.I.) instead of 1024. Capitalise to use multiples of 1000 (S.I.) instead of 1024.
Custom units can be specified, e.g. \-\-units 3M. Custom units can be specified, e.g. --units 3M.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unquoted\fP \fB--unquoted\fP
.br .br
When used with \-\-nameprefixes, output values in the field=value When used with --nameprefixes, output values in the field=value
pairs are not quoted. pairs are not quoted.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -492,7 +492,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH LVM LVPOLL 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVM LVPOLL 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvm lvpoll \- Continue already initiated poll operation on a logical volume lvm lvpoll - Continue already initiated poll operation on a logical volume
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvm lvpoll\fP \fIoption_args\fP \fIposition_args\fP \fBlvm lvpoll\fP \fIoption_args\fP \fIposition_args\fP
@ -13,23 +13,23 @@ complete \fBlvconvert\fP(8) and \fBpvmove\fP(8) operations. lvpoll itself
does not initiate these operations and should not normally need to be run does not initiate these operations and should not normally need to be run
directly. directly.
.SH USAGE .SH USAGE
\fBlvm lvpoll\fP \fB\-\-polloperation\fP \fBpvmove\fP|\fBconvert\fP|\fBmerge\fP|\fBmerge_thin\fP \fILV\fP ... \fBlvm lvpoll\fP \fB--polloperation\fP \fBpvmove\fP|\fBconvert\fP|\fBmerge\fP|\fBmerge_thin\fP \fILV\fP ...
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] [ \fB-i\fP|\fB--interval\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-abort\fP ] [ \fB--abort\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-handlemissingpvs\fP ] [ \fB--handlemissingpvs\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -40,77 +40,77 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-abort\fP \fB--abort\fP
.br .br
Stop processing a poll operation in lvmpolld. Stop processing a poll operation in lvmpolld.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -119,66 +119,66 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-handlemissingpvs\fP \fB--handlemissingpvs\fP
.br .br
Allows a polling operation to continue when PVs are missing, Allows a polling operation to continue when PVs are missing,
e.g. for repairs due to faulty devices. e.g. for repairs due to faulty devices.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-i\fP|\fB\-\-interval\fP \fINumber\fP \fB-i\fP|\fB--interval\fP \fINumber\fP
.br .br
Report progress at regular intervals. Report progress at regular intervals.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-polloperation\fP \fBpvmove\fP|\fBconvert\fP|\fBmerge\fP|\fBmerge_thin\fP \fB--polloperation\fP \fBpvmove\fP|\fBconvert\fP|\fBmerge\fP|\fBmerge_thin\fP
.br .br
The command to perform from lvmpolld. The command to perform from lvmpolld.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -188,20 +188,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -228,7 +228,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -243,27 +243,27 @@ To find the name of the pvmove LV that was created by an original
Continue polling a pvmove operation. Continue polling a pvmove operation.
.br .br
.B lvm lvpoll \-\-polloperation pvmove vg00/pvmove0 .B lvm lvpoll --polloperation pvmove vg00/pvmove0
Abort a pvmove operation. Abort a pvmove operation.
.br .br
.B lvm lvpoll \-\-polloperation pvmove \-\-abort vg00/pvmove0 .B lvm lvpoll --polloperation pvmove --abort vg00/pvmove0
Continue polling a mirror conversion. Continue polling a mirror conversion.
.br .br
.B lvm lvpoll \-\-polloperation convert vg00/lvmirror .B lvm lvpoll --polloperation convert vg00/lvmirror
Continue mirror repair. Continue mirror repair.
.br .br
.B lvm lvpoll \-\-polloperation convert vg/damaged_mirror \-\-handlemissingpvs .B lvm lvpoll --polloperation convert vg/damaged_mirror --handlemissingpvs
Continue snapshot merge. Continue snapshot merge.
.br .br
.B lvm lvpoll \-\-polloperation merge vg/snapshot_old .B lvm lvpoll --polloperation merge vg/snapshot_old
Continue thin snapshot merge. Continue thin snapshot merge.
.br .br
.B lvm lvpoll \-\-polloperation merge_thin vg/thin_snapshot .B lvm lvpoll --polloperation merge_thin vg/thin_snapshot
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH LVMCONFIG 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVMCONFIG 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvmconfig \- Display and manipulate configuration information lvmconfig - Display and manipulate configuration information
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvmconfig\fP \fBlvmconfig\fP
@ -12,81 +12,81 @@ lvmconfig \- Display and manipulate configuration information
.SH DESCRIPTION .SH DESCRIPTION
lvmconfig produces formatted output from the LVM configuration tree. The lvmconfig produces formatted output from the LVM configuration tree. The
sources of the configuration data include \fBlvm.conf\fP(5) and command sources of the configuration data include \fBlvm.conf\fP(5) and command
line settings from \-\-config. line settings from --config.
.SH USAGE .SH USAGE
\fBlvmconfig\fP \fBlvmconfig\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-f\fP|\fB\-\-file\fP \fIString\fP ] [ \fB-f\fP|\fB--file\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-l\fP|\fB\-\-list\fP ] [ \fB-l\fP|\fB--list\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-atversion\fP \fIString\fP ] [ \fB--atversion\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ] [ \fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreadvanced\fP ] [ \fB--ignoreadvanced\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreunsupported\fP ] [ \fB--ignoreunsupported\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelocal\fP ] [ \fB--ignorelocal\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-mergedconfig\fP ] [ \fB--mergedconfig\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-metadataprofile\fP \fIString\fP ] [ \fB--metadataprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-sinceversion\fP \fIString\fP ] [ \fB--sinceversion\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-showdeprecated\fP ] [ \fB--showdeprecated\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-showunsupported\fP ] [ \fB--showunsupported\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-validate\fP ] [ \fB--validate\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withsummary\fP ] [ \fB--withsummary\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withcomments\fP ] [ \fB--withcomments\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withspaces\fP ] [ \fB--withspaces\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unconfigured\fP ] [ \fB--unconfigured\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-withversions\fP ] [ \fB--withversions\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -100,57 +100,57 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-atversion\fP \fIString\fP \fB--atversion\fP \fIString\fP
.br .br
Specify an LVM version in x.y.z format where x is the major 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). the y is the minor version and z is the patchlevel (e.g. 2.2.106).
@ -162,14 +162,14 @@ issue a warning message when checking the configuration.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -178,45 +178,45 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-file\fP \fIString\fP \fB-f\fP|\fB--file\fP \fIString\fP
.br .br
Write output to the named file. Write output to the named file.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreadvanced\fP \fB--ignoreadvanced\fP
.br .br
Exclude advanced configuration settings from the output. Exclude advanced configuration settings from the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelocal\fP \fB--ignorelocal\fP
.br .br
Ignore local section. Ignore local section.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreunsupported\fP \fB--ignoreunsupported\fP
.br .br
Exclude unsupported configuration settings from the output. These settings are Exclude unsupported configuration settings from the output. These settings are
either used for debugging and development purposes only or their support is not either used for debugging and development purposes only or their support is not
@ -226,24 +226,24 @@ all the other types ignore unsupported settings.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-list\fP \fB-l\fP|\fB--list\fP
.br .br
List config settings with summarizing comment. This is the same as using List config settings with summarizing comment. This is the same as using
options \-\-typeconfig list \-\-withsummary. options --typeconfig list --withsummary.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-mergedconfig\fP \fB--mergedconfig\fP
.br .br
When the command is run with \-\-config When the command is run with --config
and/or \-\-commandprofile (or using LVM_COMMAND_PROFILE and/or --commandprofile (or using LVM_COMMAND_PROFILE
environment variable), \-\-profile, or \-\-metadataprofile, environment variable), --profile, or --metadataprofile,
merge all the contents of the "config cascade" before displaying it. merge all the contents of the "config cascade" before displaying it.
Without merging, only the configuration at the front of the Without merging, only the configuration at the front of the
cascade is displayed. cascade is displayed.
@ -251,39 +251,39 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadataprofile\fP \fIString\fP \fB--metadataprofile\fP \fIString\fP
.br .br
The metadata profile to use for command configuration. The metadata profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-showdeprecated\fP \fB--showdeprecated\fP
.br .br
Include deprecated configuration settings in the output. These settings Include deprecated configuration settings in the output. These settings
are deprecated after a certain version. If a concrete version is specified are deprecated after a certain version. If a concrete version is specified
with \-\-atversion, deprecated settings are automatically included with --atversion, deprecated settings are automatically included
if the specified version is lower than the version in which the settings were if the specified version is lower than the version in which the settings were
deprecated. The current and diff types include deprecated settings deprecated. The current and diff types include deprecated settings
in their output by default, all the other types ignore deprecated settings. in their output by default, all the other types ignore deprecated settings.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-showunsupported\fP \fB--showunsupported\fP
.br .br
Include unsupported configuration settings in the output. These settings Include unsupported configuration settings in the output. These settings
are either used for debugging or development purposes only, or their support are either used for debugging or development purposes only, or their support
@ -293,16 +293,16 @@ output by default, all the other types ignore unsupported settings.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-sinceversion\fP \fIString\fP \fB--sinceversion\fP \fIString\fP
.br .br
Specify an LVM version in x.y.z format where x is the major 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). the y is the minor version and z is the patchlevel (e.g. 2.2.106).
This option is currently applicable only with \-\-typeconfig new This option is currently applicable only with --typeconfig new
to display all configuration settings introduced since given version. to display all configuration settings introduced since given version.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -312,61 +312,61 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP \fB--typeconfig\fP \fBcurrent\fP|\fBdefault\fP|\fBdiff\fP|\fBfull\fP|\fBlist\fP|\fBmissing\fP|\fBnew\fP|\fBprofilable\fP|\fBprofilable-command\fP|\fBprofilable-metadata\fP
.br .br
See lvmreport(7). See lvmreport(7).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unconfigured\fP \fB--unconfigured\fP
.br .br
Internal option used for generating config file during build. Internal option used for generating config file during build.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-validate\fP \fB--validate\fP
.br .br
Validate current configuration used and exit with appropriate Validate current configuration used and exit with appropriate
return code. The validation is done only for the configuration return code. The validation is done only for the configuration
at the front of the "config cascade". To validate the whole at the front of the "config cascade". To validate the whole
merged configuration tree, also use \-\-mergedconfig. merged configuration tree, also use --mergedconfig.
The validation is done even if lvm.conf config/checks is disabled. The validation is done even if lvm.conf config/checks is disabled.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withcomments\fP \fB--withcomments\fP
.br .br
Display a full comment for each configuration node. For deprecated Display a full comment for each configuration node. For deprecated
settings, also display comments about deprecation. settings, also display comments about deprecation.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withspaces\fP \fB--withspaces\fP
.br .br
Where appropriate, add more spaces in output for better readability. Where appropriate, add more spaces in output for better readability.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withsummary\fP \fB--withsummary\fP
.br .br
Display a one line comment for each configuration node. Display a one line comment for each configuration node.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-withversions\fP \fB--withversions\fP
.br .br
Also display a comment containing the version of introduction for Also display a comment containing the version of introduction for
each configuration node. If the setting is deprecated, also display each configuration node. If the setting is deprecated, also display
@ -374,7 +374,7 @@ the version since which it is deprecated.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -396,7 +396,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH LVMDISKSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVMDISKSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvmdiskscan \- List devices that may be used as physical volumes lvmdiskscan - List devices that may be used as physical volumes
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvmdiskscan\fP \fBlvmdiskscan\fP
@ -20,11 +20,11 @@ This command is deprecated, use \fBpvs\fP instead.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-l\fP|\fB\-\-lvmpartition\fP ] [ \fB-l\fP|\fB--lvmpartition\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-readonly\fP ] [ \fB--readonly\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -35,64 +35,64 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -101,53 +101,53 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-lvmpartition\fP \fB-l\fP|\fB--lvmpartition\fP
.br .br
Only report PVs. Only report PVs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-readonly\fP \fB--readonly\fP
.br .br
Run the command in a special read-only mode which will read on-disk Run the command in a special read-only mode which will read on-disk
metadata without needing to take any locks. This can be used to peek metadata without needing to take any locks. This can be used to peek
@ -161,7 +161,7 @@ actually in use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -171,20 +171,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -206,7 +206,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH LVREDUCE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVREDUCE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvreduce \- Reduce the size of a logical volume lvreduce - Reduce the size of a logical volume
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvreduce\fP \fIoption_args\fP \fIposition_args\fP \fBlvreduce\fP \fIoption_args\fP \fIposition_args\fP
@ -9,7 +9,7 @@ lvreduce \- Reduce the size of a logical volume
.br .br
.SH DESCRIPTION .SH DESCRIPTION
lvreduce reduces the size of an LV. The freed logical extents are returned lvreduce reduces the size of an LV. The freed logical extents are returned
to the VG to be used by other LVs. A copy\-on\-write snapshot LV can also to the VG to be used by other LVs. A copy-on-write snapshot LV can also
be reduced if less space is needed to hold COW blocks. Use be reduced if less space is needed to hold COW blocks. Use
\fBlvconvert\fP(8) to change the number of data images in a RAID or \fBlvconvert\fP(8) to change the number of data images in a RAID or
mirrored LV. mirrored LV.
@ -23,39 +23,39 @@ Sizes will be rounded if necessary. For example, the LV size must be an
exact number of extents, and the size of a striped segment must be a exact number of extents, and the size of a striped segment must be a
multiple of the number of stripes. multiple of the number of stripes.
In the usage section below, \fB\-\-size\fP \fISize\fP can be replaced In the usage section below, \fB--size\fP \fISize\fP can be replaced
with \fB\-\-extents\fP \fINumber\fP. See both descriptions with \fB--extents\fP \fINumber\fP. See both descriptions
the options section. the options section.
.SH USAGE .SH USAGE
\fBlvreduce\fP \fB-L\fP|\fB\-\-size\fP [\fB-\fP]\fISize\fP[m|UNIT] \fILV\fP \fBlvreduce\fP \fB-L\fP|\fB--size\fP [\fB-\fP]\fISize\fP[m|UNIT] \fILV\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-l\fP|\fB\-\-extents\fP [\fB-\fP]\fINumber\fP[PERCENT] ] [ \fB-l\fP|\fB--extents\fP [\fB-\fP]\fINumber\fP[PERCENT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-n\fP|\fB\-\-nofsck\fP ] [ \fB-n\fP|\fB--nofsck\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-r\fP|\fB\-\-resizefs\fP ] [ \fB-r\fP|\fB--resizefs\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noudevsync\fP ] [ \fB--noudevsync\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -66,71 +66,71 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -139,24 +139,24 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-extents\fP [\fB-\fP]\fINumber\fP[PERCENT] \fB-l\fP|\fB--extents\fP [\fB-\fP]\fINumber\fP[PERCENT]
.br .br
Specifies the new size of the LV in logical extents. Specifies the new size of the LV in logical extents.
The \-\-size and \-\-extents options are alternate methods of specifying size. The --size and --extents options are alternate methods of specifying size.
The total number of physical extents used will be The total number of physical extents used will be
greater when redundant data is needed for RAID levels. greater when redundant data is needed for RAID levels.
An alternate syntax allows the size to be determined indirectly An alternate syntax allows the size to be determined indirectly
@ -176,34 +176,34 @@ from the current size.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-n\fP|\fB\-\-nofsck\fP \fB-n\fP|\fB--nofsck\fP
.br .br
Do not perform fsck before resizing filesystem when filesystem Do not perform fsck before resizing filesystem when filesystem
requires it. You may need to use \-\-force to proceed with requires it. You may need to use --force to proceed with
this option. this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.br .br
Disables udev synchronisation. The process will not wait for notification Disables udev synchronisation. The process will not wait for notification
from udev. It will continue irrespective of any possible udev processing from udev. It will continue irrespective of any possible udev processing
@ -212,21 +212,21 @@ ignore the devices LVM creates.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -237,16 +237,16 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-r\fP|\fB\-\-resizefs\fP \fB-r\fP|\fB--resizefs\fP
.br .br
Resize underlying filesystem together with the LV using fsadm(8). Resize underlying filesystem together with the LV using fsadm(8).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-L\fP|\fB\-\-size\fP [\fB-\fP]\fISize\fP[m|UNIT] \fB-L\fP|\fB--size\fP [\fB-\fP]\fISize\fP[m|UNIT]
.br .br
Specifies the new size of the LV. Specifies the new size of the LV.
The \-\-size and \-\-extents options are alternate methods of specifying size. The --size and --extents options are alternate methods of specifying size.
The total number of physical extents used will be The total number of physical extents used will be
greater when redundant data is needed for RAID levels. greater when redundant data is needed for RAID levels.
When the plus \fB+\fP or minus \fB-\fP prefix is used, When the plus \fB+\fP or minus \fB-\fP prefix is used,
@ -255,7 +255,7 @@ from the current size.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -265,20 +265,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -305,7 +305,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -314,7 +314,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete
Reduce the size of an LV by 3 logical extents: Reduce the size of an LV by 3 logical extents:
.br .br
.B lvreduce \-l \-3 vg00/lvol1 .B lvreduce -l -3 vg00/lvol1
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH LVREMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVREMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvremove \- Remove logical volume(s) from the system lvremove - Remove logical volume(s) from the system
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvremove\fP \fIposition_args\fP \fBlvremove\fP \fIposition_args\fP
@ -39,27 +39,27 @@ former LV completely.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nohistory\fP ] [ \fB--nohistory\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noudevsync\fP ] [ \fB--noudevsync\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -70,71 +70,71 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -143,40 +143,40 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nohistory\fP \fB--nohistory\fP
.br .br
Do not record history of LVs being removed. Do not record history of LVs being removed.
This has no effect unless the configuration setting This has no effect unless the configuration setting
@ -184,7 +184,7 @@ metadata/record_lvs_history is enabled.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.br .br
Disables udev synchronisation. The process will not wait for notification Disables udev synchronisation. The process will not wait for notification
from udev. It will continue irrespective of any possible udev processing from udev. It will continue irrespective of any possible udev processing
@ -193,21 +193,21 @@ ignore the devices LVM creates.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -218,12 +218,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -231,7 +231,7 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -241,20 +241,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -279,7 +279,7 @@ in place of a VG, LV or PV.
\fISelect\fP \fISelect\fP
.br .br
Select indicates that a required positional parameter can Select indicates that a required positional parameter can
be omitted if the \fB\-\-select\fP option is used. be omitted if the \fB--select\fP option is used.
No arg appears in this position. No arg appears in this position.
.HP .HP
\fIString\fP \fIString\fP
@ -296,7 +296,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -304,7 +304,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete
.SH EXAMPLES .SH EXAMPLES
Remove an active LV without asking for confirmation. Remove an active LV without asking for confirmation.
.br .br
.B lvremove \-f vg00/lvol1 .B lvremove -f vg00/lvol1
Remove all LVs the specified VG. Remove all LVs the specified VG.
.br .br

View File

@ -1,6 +1,6 @@
.TH LVRENAME 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVRENAME 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvrename \- Rename a logical volume lvrename - Rename a logical volume
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvrename\fP \fIposition_args\fP \fBlvrename\fP \fIposition_args\fP
@ -29,15 +29,15 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noudevsync\fP ] [ \fB--noudevsync\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.RE .RE
@ -45,71 +45,71 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -118,33 +118,33 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.br .br
Disables udev synchronisation. The process will not wait for notification Disables udev synchronisation. The process will not wait for notification
from udev. It will continue irrespective of any possible udev processing from udev. It will continue irrespective of any possible udev processing
@ -153,21 +153,21 @@ ignore the devices LVM creates.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -178,7 +178,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -188,20 +188,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -232,7 +232,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH LVRESIZE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVRESIZE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvresize \- Resize a logical volume lvresize - Resize a logical volume
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvresize\fP \fIoption_args\fP \fIposition_args\fP \fBlvresize\fP \fIoption_args\fP \fIposition_args\fP
@ -11,132 +11,132 @@ lvresize \- Resize a logical volume
.br .br
.P .P
.ad l .ad l
\fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP \fB-d\fP|\fB--debug\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-l\fP|\fB\-\-extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT] \fB-l\fP|\fB--extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT]
.ad b .ad b
.br .br
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP \fB-f\fP|\fB--force\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-n\fP|\fB\-\-nofsck\fP \fB-n\fP|\fB--nofsck\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-nosync\fP \fB--nosync\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT]
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP \fB-q\fP|\fB--quiet\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-r\fP|\fB\-\-resizefs\fP \fB-r\fP|\fB--resizefs\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-L\fP|\fB\-\-size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT] \fB-L\fP|\fB--size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT]
.ad b .ad b
.br .br
.ad l .ad l
\fB-i\fP|\fB\-\-stripes\fP \fINumber\fP \fB-i\fP|\fB--stripes\fP \fINumber\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT]
.ad b .ad b
.br .br
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP \fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP \fB-v\fP|\fB--verbose\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.ad b .ad b
.SH DESCRIPTION .SH DESCRIPTION
lvresize resizes an LV in the same way as lvextend and lvreduce. See lvresize resizes an LV in the same way as lvextend and lvreduce. See
\fBlvextend\fP(8) and \fBlvreduce\fP(8) for more information. \fBlvextend\fP(8) and \fBlvreduce\fP(8) for more information.
In the usage section below, \fB\-\-size\fP \fISize\fP can be replaced In the usage section below, \fB--size\fP \fISize\fP can be replaced
with \fB\-\-extents\fP \fINumber\fP. See both descriptions with \fB--extents\fP \fINumber\fP. See both descriptions
the options section. the options section.
.SH USAGE .SH USAGE
Resize an LV by a specified size. Resize an LV by a specified size.
.br .br
.P .P
\fBlvresize\fP \fB-L\fP|\fB\-\-size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT] \fILV\fP \fBlvresize\fP \fB-L\fP|\fB--size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT] \fILV\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-l\fP|\fB\-\-extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT] ] [ \fB-l\fP|\fB--extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-r\fP|\fB\-\-resizefs\fP ] [ \fB-r\fP|\fB--resizefs\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] ] [ \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -154,7 +154,7 @@ Resize an LV by specified PV extents.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-r\fP|\fB\-\-resizefs\fP ] [ \fB-r\fP|\fB--resizefs\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -165,7 +165,7 @@ Resize an LV by specified PV extents.
Resize a pool metadata SubLV by a specified size. Resize a pool metadata SubLV by a specified size.
.br .br
.P .P
\fBlvresize\fP \fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP \fBlvresize\fP \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fILV\fP\fI_thinpool\fP
.br .br
.RS 4 .RS 4
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -180,43 +180,43 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-n\fP|\fB\-\-nofsck\fP ] [ \fB-n\fP|\fB--nofsck\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-i\fP|\fB\-\-stripes\fP \fINumber\fP ] [ \fB-i\fP|\fB--stripes\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] ] [ \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] [ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nosync\fP ] [ \fB--nosync\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noudevsync\fP ] [ \fB--noudevsync\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP ] [ \fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP ]
.ad b .ad b
.RE .RE
@ -224,57 +224,57 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP
.br .br
Determines the allocation policy when a command needs to allocate Determines the allocation policy when a command needs to allocate
Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy
@ -295,21 +295,21 @@ See \fBlvm\fP(8) for more information about allocation.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -318,24 +318,24 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT] \fB-l\fP|\fB--extents\fP [\fB+\fP|\fB-\fP]\fINumber\fP[PERCENT]
.br .br
Specifies the new size of the LV in logical extents. Specifies the new size of the LV in logical extents.
The \-\-size and \-\-extents options are alternate methods of specifying size. The --size and --extents options are alternate methods of specifying size.
The total number of physical extents used will be The total number of physical extents used will be
greater when redundant data is needed for RAID levels. greater when redundant data is needed for RAID levels.
An alternate syntax allows the size to be determined indirectly An alternate syntax allows the size to be determined indirectly
@ -355,34 +355,34 @@ from the current size.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-n\fP|\fB\-\-nofsck\fP \fB-n\fP|\fB--nofsck\fP
.br .br
Do not perform fsck before resizing filesystem when filesystem Do not perform fsck before resizing filesystem when filesystem
requires it. You may need to use \-\-force to proceed with requires it. You may need to use --force to proceed with
this option. this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nosync\fP \fB--nosync\fP
.br .br
Causes the creation of mirror, raid1, raid4, raid5 and raid10 to skip the Causes the creation of mirror, raid1, raid4, raid5 and raid10 to skip the
initial synchronization. In case of mirror, raid1 and raid10, any data initial synchronization. In case of mirror, raid1 and raid10, any data
@ -399,7 +399,7 @@ and thus do not support initial synchronization.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.br .br
Disables udev synchronisation. The process will not wait for notification Disables udev synchronisation. The process will not wait for notification
from udev. It will continue irrespective of any possible udev processing from udev. It will continue irrespective of any possible udev processing
@ -408,7 +408,7 @@ ignore the devices LVM creates.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT] \fB--poolmetadatasize\fP [\fB+\fP]\fISize\fP[m|UNIT]
.br .br
Specifies the new size of the pool metadata LV. Specifies the new size of the pool metadata LV.
The plus prefix \fB+\fP can be used, in which case The plus prefix \fB+\fP can be used, in which case
@ -416,21 +416,21 @@ the value is added to the current size.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -441,16 +441,16 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-r\fP|\fB\-\-resizefs\fP \fB-r\fP|\fB--resizefs\fP
.br .br
Resize underlying filesystem together with the LV using fsadm(8). Resize underlying filesystem together with the LV using fsadm(8).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-L\fP|\fB\-\-size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT] \fB-L\fP|\fB--size\fP [\fB+\fP|\fB-\fP]\fISize\fP[m|UNIT]
.br .br
Specifies the new size of the LV. Specifies the new size of the LV.
The \-\-size and \-\-extents options are alternate methods of specifying size. The --size and --extents options are alternate methods of specifying size.
The total number of physical extents used will be The total number of physical extents used will be
greater when redundant data is needed for RAID levels. greater when redundant data is needed for RAID levels.
When the plus \fB+\fP or minus \fB-\fP prefix is used, When the plus \fB+\fP or minus \fB-\fP prefix is used,
@ -459,31 +459,31 @@ from the current size.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-i\fP|\fB\-\-stripes\fP \fINumber\fP \fB-i\fP|\fB--stripes\fP \fINumber\fP
.br .br
Specifies the number of stripes in a striped LV. This is the number of Specifies the number of stripes in a striped LV. This is the number of
PVs (devices) that a striped LV is spread across. Data that PVs (devices) that a striped LV is spread across. Data that
appears sequential in the LV is spread across multiple devices in units of appears sequential in the LV is spread across multiple devices in units of
the stripe size (see \-\-stripesize). This does not change existing the stripe size (see --stripesize). This does not change existing
allocated space, but only applies to space being allocated by the command. allocated space, but only applies to space being allocated by the command.
When creating a RAID 4/5/6 LV, this number does not include the extra When creating a RAID 4/5/6 LV, this number does not include the extra
devices that are required for parity. The largest number depends on devices that are required for parity. The largest number depends on
the RAID type (raid0: 64, raid10: 32, raid4/5: 63, raid6: 62), and the RAID type (raid0: 64, raid10: 32, raid4/5: 63, raid6: 62), and
when unspecified, the default depends on the RAID type when unspecified, the default depends on the RAID type
(raid0: 2, raid10: 4, raid4/5: 3, raid6: 5.) (raid0: 2, raid10: 2, raid4/5: 3, raid6: 5.)
To stripe a new raid LV across all PVs by default, To stripe a new raid LV across all PVs by default,
see lvm.conf allocation/raid_stripe_all_devices. see lvm.conf allocation/raid_stripe_all_devices.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-I\fP|\fB\-\-stripesize\fP \fISize\fP[k|UNIT] \fB-I\fP|\fB--stripesize\fP \fISize\fP[k|UNIT]
.br .br
The amount of data that is written to one device before The amount of data that is written to one device before
moving to the next in a striped LV. moving to the next in a striped LV.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -493,7 +493,7 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP \fB--type\fP \fBlinear\fP|\fBstriped\fP|\fBsnapshot\fP|\fBmirror\fP|\fBraid\fP|\fBthin\fP|\fBcache\fP|\fBthin-pool\fP|\fBcache-pool\fP
.br .br
The LV type, also known as "segment type" or "segtype". The LV type, also known as "segment type" or "segtype".
See usage descriptions for the specific ways to use these types. See usage descriptions for the specific ways to use these types.
@ -503,25 +503,25 @@ For performance caching (\fBcache\fP, \fBcache-pool\fP) see \fBlvmcache\fP(7).
For copy-on-write snapshots (\fBsnapshot\fP) see usage definitions. For copy-on-write snapshots (\fBsnapshot\fP) see usage definitions.
Several commands omit an explicit type option because the type Several commands omit an explicit type option because the type
is inferred from other options or shortcuts is inferred from other options or shortcuts
(e.g. \-\-stripes, \-\-mirrors, \-\-snapshot, \-\-virtualsize, \-\-thin, \-\-cache). (e.g. --stripes, --mirrors, --snapshot, --virtualsize, --thin, --cache).
Use inferred types with care because it can lead to unexpected results. Use inferred types with care because it can lead to unexpected results.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -560,7 +560,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -569,7 +569,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete
Extend an LV by 16MB using specific physical extents: Extend an LV by 16MB using specific physical extents:
.br .br
.B lvresize \-L+16M vg1/lv1 /dev/sda:0\-1 /dev/sdb:0\-1 .B lvresize -L+16M vg1/lv1 /dev/sda:0-1 /dev/sdb:0-1
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH LVS 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVS 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvs \- Display information about logical volumes lvs - Display information about logical volumes
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvs\fP \fBlvs\fP
@ -16,111 +16,111 @@ lvs produces formatted output about LVs.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-H\fP|\fB\-\-history\fP ] [ \fB-H\fP|\fB--history\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-a\fP|\fB\-\-all\fP ] [ \fB-a\fP|\fB--all\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] [ \fB-o\fP|\fB--options\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-P\fP|\fB\-\-partial\fP ] [ \fB-P\fP|\fB--partial\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] [ \fB-O\fP|\fB--sort\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-segments\fP ] [ \fB--segments\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-aligned\fP ] [ \fB--aligned\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-binary\fP ] [ \fB--binary\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] [ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-foreign\fP ] [ \fB--foreign\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreskippedcluster\fP ] [ \fB--ignoreskippedcluster\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-logonly\fP ] [ \fB--logonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nameprefixes\fP ] [ \fB--nameprefixes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noheadings\fP ] [ \fB--noheadings\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nolocking\fP ] [ \fB--nolocking\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nosuffix\fP ] [ \fB--nosuffix\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-readonly\fP ] [ \fB--readonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-rows\fP ] [ \fB--rows\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-separator\fP \fIString\fP ] [ \fB--separator\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-shared\fP ] [ \fB--shared\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-trustcache\fP ] [ \fB--trustcache\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unbuffered\fP ] [ \fB--unbuffered\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] [ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unquoted\fP ] [ \fB--unquoted\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -134,63 +134,63 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-aligned\fP \fB--aligned\fP
.br .br
Use with \-\-separator to align the output columns Use with --separator to align the output columns
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
Show information about internal LVs. Show information about internal LVs.
These are components of normal LVs, such as mirrors, These are components of normal LVs, such as mirrors,
@ -198,7 +198,7 @@ which are not independently accessible, e.g. not mountable.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-binary\fP \fB--binary\fP
.br .br
Use binary values "0" or "1" instead of descriptive literal values Use binary values "0" or "1" instead of descriptive literal values
for columns that have exactly two valid values to report (not counting for columns that have exactly two valid values to report (not counting
@ -206,14 +206,14 @@ the "unknown" value which denotes that the value could not be determined).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -222,40 +222,40 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP
.br .br
See lvmreport(7). See lvmreport(7).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-foreign\fP \fB--foreign\fP
.br .br
Report/display foreign VGs that would otherwise be skipped. Report/display foreign VGs that would otherwise be skipped.
See lvmsystemid(7) for more information about foreign VGs. See lvmsystemid(7) for more information about foreign VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-H\fP|\fB\-\-history\fP \fB-H\fP|\fB--history\fP
.br .br
Include historical LVs in the output. Include historical LVs in the output.
(This has no effect unless LVs were removed while (This has no effect unless LVs were removed while
@ -263,61 +263,61 @@ lvm.conf metadata/record_lvs_history was enabled.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreskippedcluster\fP \fB--ignoreskippedcluster\fP
.br .br
Use to avoid exiting with an non-zero status code if the command is run Use to avoid exiting with an non-zero status code if the command is run
without clustered locking and clustered VGs are skipped. without clustered locking and clustered VGs are skipped.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-logonly\fP \fB--logonly\fP
.br .br
Suppress command report and display only log report. Suppress command report and display only log report.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nameprefixes\fP \fB--nameprefixes\fP
.br .br
Add an "LVM2_" prefix plus the field name to the output. Useful Add an "LVM2_" prefix plus the field name to the output. Useful
with \-\-noheadings to produce a list of field=value pairs that can with --noheadings to produce a list of field=value pairs that can
be used to set environment variables (for example, in udev rules). be used to set environment variables (for example, in udev rules).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noheadings\fP \fB--noheadings\fP
.br .br
Suppress the headings line that is normally the first line of output. Suppress the headings line that is normally the first line of output.
Useful if grepping the output. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nolocking\fP \fB--nolocking\fP
.br .br
Disable locking. Disable locking.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nosuffix\fP \fB--nosuffix\fP
.br .br
Suppress the suffix on output sizes. Use with \-\-units Suppress the suffix on output sizes. Use with --units
(except h and H) if processing the output. (except h and H) if processing the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-o\fP|\fB\-\-options\fP \fIString\fP \fB-o\fP|\fB--options\fP \fIString\fP
.br .br
Comma-separated, ordered list of fields to display in columns. Comma-separated, ordered list of fields to display in columns.
String arg syntax is: [+|-|#]Field1[,Field2 ...] String arg syntax is: [+|-|#]Field1[,Field2 ...]
@ -339,7 +339,7 @@ See lvmreport(7) for more information about reporting.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.br .br
When set, the tools will do their best to provide access to VGs When set, the tools will do their best to provide access to VGs
that are only partially available (one or more PVs belonging that are only partially available (one or more PVs belonging
@ -348,21 +348,21 @@ changed with this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-readonly\fP \fB--readonly\fP
.br .br
Run the command in a special read-only mode which will read on-disk Run the command in a special read-only mode which will read on-disk
metadata without needing to take any locks. This can be used to peek metadata without needing to take any locks. This can be used to peek
@ -376,7 +376,7 @@ actually in use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -387,24 +387,24 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-rows\fP \fB--rows\fP
.br .br
Output columns as rows. Output columns as rows.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-segments\fP \fB--segments\fP
.br .br
Use default columns that emphasize segment information. Use default columns that emphasize segment information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -412,13 +412,13 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-separator\fP \fIString\fP \fB--separator\fP \fIString\fP
.br .br
String to use to separate each column. Useful if grepping the output. String to use to separate each column. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-shared\fP \fB--shared\fP
.br .br
Report/display shared VGs that would otherwise be skipped when Report/display shared VGs that would otherwise be skipped when
lvmlockd is not being used on the host. lvmlockd is not being used on the host.
@ -426,14 +426,14 @@ See lvmlockd(8) for more information about shared VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-O\fP|\fB\-\-sort\fP \fIString\fP \fB-O\fP|\fB--sort\fP \fIString\fP
.br .br
Comma-separated ordered list of columns to sort by. Replaces the default Comma-separated ordered list of columns to sort by. Replaces the default
selection. Precede any column with \fB-\fP for a reverse sort on that column. selection. Precede any column with \fB-\fP for a reverse sort on that column.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -443,50 +443,50 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-trustcache\fP \fB--trustcache\fP
.br .br
Avoids certain device scanning during command processing. Do not use. Avoids certain device scanning during command processing. Do not use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unbuffered\fP \fB--unbuffered\fP
.br .br
Produce output immediately without sorting or aligning the columns properly. Produce output immediately without sorting or aligning the columns properly.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP
.br .br
All sizes are output in these units: All sizes are output in these units:
human-(r)eadable with '<' rounding indicator, human-(r)eadable with '<' rounding indicator,
(h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes,
(g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes.
Capitalise to use multiples of 1000 (S.I.) instead of 1024. Capitalise to use multiples of 1000 (S.I.) instead of 1024.
Custom units can be specified, e.g. \-\-units 3M. Custom units can be specified, e.g. --units 3M.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unquoted\fP \fB--unquoted\fP
.br .br
When used with \-\-nameprefixes, output values in the field=value When used with --nameprefixes, output values in the field=value
pairs are not quoted. pairs are not quoted.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -522,7 +522,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH LVSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH LVSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
lvscan \- List all logical volumes in all volume groups lvscan - List all logical volumes in all volume groups
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBlvscan\fP \fIoption_args\fP \fBlvscan\fP \fIoption_args\fP
@ -20,14 +20,14 @@ comprehensive information about LVs.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-a\fP|\fB\-\-all\fP ] [ \fB-a\fP|\fB--all\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
.RE .RE
.br .br
\fBlvscan\fP \fB\-\-cache\fP \fBlvscan\fP \fB--cache\fP
.br .br
.RS 4 .RS 4
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -41,23 +41,23 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-b\fP|\fB\-\-blockdevice\fP ] [ \fB-b\fP|\fB--blockdevice\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-P\fP|\fB\-\-partial\fP ] [ \fB-P\fP|\fB--partial\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-readonly\fP ] [ \fB--readonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.RE .RE
@ -65,57 +65,57 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
Show information about internal LVs. Show information about internal LVs.
These are components of normal LVs, such as mirrors, These are components of normal LVs, such as mirrors,
@ -123,26 +123,26 @@ which are not independently accessible, e.g. not mountable.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-b\fP|\fB\-\-blockdevice\fP \fB-b\fP|\fB--blockdevice\fP
.br .br
No longer used. No longer used.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-cache\fP \fB--cache\fP
.br .br
Scan the devices used by an LV and send the metadata to lvmetad. Scan the devices used by an LV and send the metadata to lvmetad.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -151,40 +151,40 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.br .br
When set, the tools will do their best to provide access to VGs When set, the tools will do their best to provide access to VGs
that are only partially available (one or more PVs belonging that are only partially available (one or more PVs belonging
@ -193,21 +193,21 @@ changed with this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-readonly\fP \fB--readonly\fP
.br .br
Run the command in a special read-only mode which will read on-disk Run the command in a special read-only mode which will read on-disk
metadata without needing to take any locks. This can be used to peek metadata without needing to take any locks. This can be used to peek
@ -221,7 +221,7 @@ actually in use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -232,7 +232,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -242,20 +242,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -282,7 +282,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH PVCHANGE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH PVCHANGE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
pvchange \- Change attributes of physical volume(s) pvchange - Change attributes of physical volume(s)
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBpvchange\fP \fIoption_args\fP \fIposition_args\fP \fBpvchange\fP \fIoption_args\fP \fIposition_args\fP
@ -15,27 +15,27 @@ Change properties of all PVs.
.P .P
\fBpvchange\fP \fBpvchange\fP
.RS 4 .RS 4
( \fB-x\fP|\fB\-\-allocatable\fP \fBy\fP|\fBn\fP, ( \fB-x\fP|\fB--allocatable\fP \fBy\fP|\fBn\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB-u\fP|\fB\-\-uuid\fP, \fB-u\fP|\fB--uuid\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP, \fB-a\fP|\fB--all\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-addtag\fP \fITag\fP, \fB--addtag\fP \fITag\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-deltag\fP \fITag\fP, \fB--deltag\fP \fITag\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-metadataignore\fP \fBy\fP|\fBn\fP ) \fB--metadataignore\fP \fBy\fP|\fBn\fP )
.RE .RE
.br .br
.RS 4 .RS 4
@ -48,23 +48,23 @@ Change properties of specified PVs.
.P .P
\fBpvchange\fP \fBpvchange\fP
.RS 4 .RS 4
( \fB-x\fP|\fB\-\-allocatable\fP \fBy\fP|\fBn\fP, ( \fB-x\fP|\fB--allocatable\fP \fBy\fP|\fBn\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB-u\fP|\fB\-\-uuid\fP, \fB-u\fP|\fB--uuid\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-addtag\fP \fITag\fP, \fB--addtag\fP \fITag\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-deltag\fP \fITag\fP, \fB--deltag\fP \fITag\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-metadataignore\fP \fBy\fP|\fBn\fP ) \fB--metadataignore\fP \fBy\fP|\fBn\fP )
.RE .RE
.RS 4 .RS 4
\fIPV\fP|\fISelect\fP ... \fIPV\fP|\fISelect\fP ...
@ -72,7 +72,7 @@ Change properties of specified PVs.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -83,23 +83,23 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-u\fP|\fB\-\-uuid\fP ] [ \fB-u\fP|\fB--uuid\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreskippedcluster\fP ] [ \fB--ignoreskippedcluster\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.RE .RE
@ -107,89 +107,89 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-addtag\fP \fITag\fP \fB--addtag\fP \fITag\fP
.br .br
Adds a tag to a PV, VG or LV. This option can be repeated to add Adds a tag to a PV, VG or LV. This option can be repeated to add
multiple tags at once. See lvm(8) for information about tags. multiple tags at once. See lvm(8) for information about tags.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-x\fP|\fB\-\-allocatable\fP \fBy\fP|\fBn\fP \fB-x\fP|\fB--allocatable\fP \fBy\fP|\fBn\fP
.br .br
Enable or disable allocation of physical extents on this PV. Enable or disable allocation of physical extents on this PV.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -198,54 +198,54 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-deltag\fP \fITag\fP \fB--deltag\fP \fITag\fP
.br .br
Deletes a tag from a PV, VG or LV. This option can be repeated to delete Deletes a tag from a PV, VG or LV. This option can be repeated to delete
multiple tags at once. See lvm(8) for information about tags. multiple tags at once. See lvm(8) for information about tags.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreskippedcluster\fP \fB--ignoreskippedcluster\fP
.br .br
Use to avoid exiting with an non-zero status code if the command is run Use to avoid exiting with an non-zero status code if the command is run
without clustered locking and clustered VGs are skipped. without clustered locking and clustered VGs are skipped.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadataignore\fP \fBy\fP|\fBn\fP \fB--metadataignore\fP \fBy\fP|\fBn\fP
.br .br
Specifies the metadataignore property of a PV. Specifies the metadataignore property of a PV.
If yes, metadata areas on the PV are ignored, and lvm will If yes, metadata areas on the PV are ignored, and lvm will
@ -254,21 +254,21 @@ If no, lvm will store metadata on the PV.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -279,12 +279,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -292,7 +292,7 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -302,26 +302,26 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-u\fP|\fB\-\-uuid\fP \fB-u\fP|\fB--uuid\fP
.br .br
Generate new random UUID for specified PVs. Generate new random UUID for specified PVs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -342,7 +342,7 @@ Start and length range (counting from 0): \fIPV\fP[\fB:\fP\fIPE\fP\fB+\fP\fIPE\f
\fISelect\fP \fISelect\fP
.br .br
Select indicates that a required positional parameter can Select indicates that a required positional parameter can
be omitted if the \fB\-\-select\fP option is used. be omitted if the \fB--select\fP option is used.
No arg appears in this position. No arg appears in this position.
.HP .HP
\fIString\fP \fIString\fP
@ -359,7 +359,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -369,7 +369,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete
Disallow the allocation of physical extents on a PV (e.g. because of Disallow the allocation of physical extents on a PV (e.g. because of
disk errors, or because it will be removed after freeing it). disk errors, or because it will be removed after freeing it).
.br .br
.B pvchange \-x n /dev/sdk1 .B pvchange -x n /dev/sdk1
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH PVCK 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH PVCK 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
pvck \- Check the consistency of physical volume(s) pvck - Check the consistency of physical volume(s)
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBpvck\fP \fIposition_args\fP \fBpvck\fP \fIposition_args\fP
@ -14,7 +14,7 @@ pvck checks the LVM metadata for consistency on PVs.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-labelsector\fP \fINumber\fP ] [ \fB--labelsector\fP \fINumber\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -25,64 +25,64 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -91,27 +91,27 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-labelsector\fP \fINumber\fP \fB--labelsector\fP \fINumber\fP
.br .br
By default the PV is labelled with an LVM2 identifier in its second By default the PV is labelled with an LVM2 identifier in its second
sector (sector 1). This lets you use a different sector near the sector (sector 1). This lets you use a different sector near the
@ -120,27 +120,27 @@ in the source). Use with care.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -150,20 +150,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -195,7 +195,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -204,10 +204,10 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete
If the partition table is corrupted or lost on /dev/sda, and you suspect If the partition table is corrupted or lost on /dev/sda, and you suspect
there was an LVM partition at approximately 100 MiB, then this there was an LVM partition at approximately 100 MiB, then this
area of the disk can be scanned using the \fB\-\-labelsector\fP area of the disk can be scanned using the \fB--labelsector\fP
parameter with a value of 204800 (100 * 1024 * 1024 / 512 = 204800). parameter with a value of 204800 (100 * 1024 * 1024 / 512 = 204800).
.br .br
.B pvck \-\-labelsector 204800 /dev/sda .B pvck --labelsector 204800 /dev/sda
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH PVCREATE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH PVCREATE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
pvcreate \- Initialize physical volume(s) for use by LVM pvcreate - Initialize physical volume(s) for use by LVM
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBpvcreate\fP \fIposition_args\fP \fBpvcreate\fP \fIposition_args\fP
@ -34,63 +34,63 @@ normally prevent it, e.g. if the PV is already in a VG.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] [ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-u\fP|\fB\-\-uuid\fP \fIString\fP ] [ \fB-u\fP|\fB--uuid\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] [ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-dataalignment\fP \fISize\fP[k|UNIT] ] [ \fB--dataalignment\fP \fISize\fP[k|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] ] [ \fB--dataalignmentoffset\fP \fISize\fP[k|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-bootloaderareasize\fP \fISize\fP[m|UNIT] ] [ \fB--bootloaderareasize\fP \fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-labelsector\fP \fINumber\fP ] [ \fB--labelsector\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-[pv]metadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] [ \fB--[pv]metadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-metadatasize\fP \fISize\fP[m|UNIT] ] [ \fB--metadatasize\fP \fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-metadataignore\fP \fBy\fP|\fBn\fP ] [ \fB--metadataignore\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-norestorefile\fP ] [ \fB--norestorefile\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-setphysicalvolumesize\fP \fISize\fP[m|UNIT] ] [ \fB--setphysicalvolumesize\fP \fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-restorefile\fP \fIString\fP ] [ \fB--restorefile\fP \fIString\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -101,78 +101,78 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-bootloaderareasize\fP \fISize\fP[m|UNIT] \fB--bootloaderareasize\fP \fISize\fP[m|UNIT]
.br .br
Create a separate bootloader area of specified size besides PV's data Create a separate bootloader area of specified size besides PV's data
area. The bootloader area is an area of reserved space on the PV from area. The bootloader area is an area of reserved space on the PV from
which LVM will not allocate any extents and it's kept untouched. This is which LVM will not allocate any extents and it's kept untouched. This is
primarily aimed for use with bootloaders to embed their own data or metadata. primarily aimed for use with bootloaders to embed their own data or metadata.
The start of the bootloader area is always aligned, see also \-\-dataalignment The start of the bootloader area is always aligned, see also --dataalignment
and \-\-dataalignmentoffset. The bootloader area size may eventually and --dataalignmentoffset. The bootloader area size may eventually
end up increased due to the alignment, but it's never less than the end up increased due to the alignment, but it's never less than the
size that is requested. To see the bootloader area start and size of size that is requested. To see the bootloader area start and size of
an existing PV use pvs -o +pv_ba_start,pv_ba_size. an existing PV use pvs -o +pv_ba_start,pv_ba_size.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -181,50 +181,50 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-dataalignment\fP \fISize\fP[k|UNIT] \fB--dataalignment\fP \fISize\fP[k|UNIT]
.br .br
Align the start of the data to a multiple of this number. Align the start of the data to a multiple of this number.
Also specify an appropriate Physical Extent size when creating a VG. Also specify an appropriate Physical Extent size when creating a VG.
To see the location of the first Physical Extent of an existing PV, To see the location of the first Physical Extent of an existing PV,
use pvs -o +pe_start. In addition, it may be shifted by an alignment offset. use pvs -o +pe_start. In addition, it may be shifted by an alignment offset.
See lvm.conf/data_alignment_offset_detection and \-\-dataalignmentoffset. See lvm.conf/data_alignment_offset_detection and --dataalignmentoffset.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] \fB--dataalignmentoffset\fP \fISize\fP[k|UNIT]
.br .br
Shift the start of the data area by this additional offset. Shift the start of the data area by this additional offset.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-labelsector\fP \fINumber\fP \fB--labelsector\fP \fINumber\fP
.br .br
By default the PV is labelled with an LVM2 identifier in its second By default the PV is labelled with an LVM2 identifier in its second
sector (sector 1). This lets you use a different sector near the sector (sector 1). This lets you use a different sector near the
@ -233,13 +233,13 @@ in the source). Use with care.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadataignore\fP \fBy\fP|\fBn\fP \fB--metadataignore\fP \fBy\fP|\fBn\fP
.br .br
Specifies the metadataignore property of a PV. Specifies the metadataignore property of a PV.
If yes, metadata areas on the PV are ignored, and lvm will If yes, metadata areas on the PV are ignored, and lvm will
@ -248,14 +248,14 @@ If no, lvm will store metadata on the PV.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadatasize\fP \fISize\fP[m|UNIT] \fB--metadatasize\fP \fISize\fP[m|UNIT]
.br .br
The approximate amount of space used for each VG metadata area. The approximate amount of space used for each VG metadata area.
The size may be rounded. The size may be rounded.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP
.br .br
Specifies the type of on-disk metadata to use. Specifies the type of on-disk metadata to use.
\fBlvm2\fP (or just \fB2\fP) is the current, standard format. \fBlvm2\fP (or just \fB2\fP) is the current, standard format.
@ -264,21 +264,21 @@ can be used for accessing old data.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-norestorefile\fP \fB--norestorefile\fP
.br .br
In conjunction with \-\-uuid, this allows a uuid to be specified In conjunction with --uuid, this allows a uuid to be specified
without also requiring that a backup of the metadata be provided. without also requiring that a backup of the metadata be provided.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-[pv]metadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP \fB--[pv]metadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP
.br .br
The number of metadata areas to set aside on a PV for storing VG metadata. The number of metadata areas to set aside on a PV for storing VG metadata.
When 2, one copy of the VG metadata is stored at the front of the PV When 2, one copy of the VG metadata is stored at the front of the PV
@ -291,14 +291,14 @@ on the ability to use vgsplit later.)
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -309,9 +309,9 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-restorefile\fP \fIString\fP \fB--restorefile\fP \fIString\fP
.br .br
In conjunction with \-\-uuid, this reads the file (produced by In conjunction with --uuid, this reads the file (produced by
vgcfgbackup), extracts the location and size of the data on the PV, vgcfgbackup), extracts the location and size of the data on the PV,
and ensures that the metadata produced by the program is consistent and ensures that the metadata produced by the program is consistent
with the contents of the file, i.e. the physical extents will be in with the contents of the file, i.e. the physical extents will be in
@ -321,14 +321,14 @@ areas. Use with care.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-setphysicalvolumesize\fP \fISize\fP[m|UNIT] \fB--setphysicalvolumesize\fP \fISize\fP[m|UNIT]
.br .br
Overrides the automatically detected size of the PV. Overrides the automatically detected size of the PV.
Use with care, or prior to reducing the physical size of the device. Use with care, or prior to reducing the physical size of the device.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -338,33 +338,33 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-u\fP|\fB\-\-uuid\fP \fIString\fP \fB-u\fP|\fB--uuid\fP \fIString\fP
.br .br
Specify a UUID for the device. Specify a UUID for the device.
Without this option, a random UUID is generated. Without this option, a random UUID is generated.
This option is needed before restoring a backup of LVM metadata This option is needed before restoring a backup of LVM metadata
onto a replacement device; see vgcfgrestore(8). As such, use of onto a replacement device; see vgcfgrestore(8). As such, use of
\-\-restorefile is compulsory unless the \-\-norestorefile is used. --restorefile is compulsory unless the --norestorefile is used.
All PVs must have unique UUIDs, and LVM will prevent certain operations All PVs must have unique UUIDs, and LVM will prevent certain operations
if multiple devices are seen with the same UUID. if multiple devices are seen with the same UUID.
See vgimportclone(8) for more information. See vgimportclone(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -372,11 +372,11 @@ answer yes. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP
.br .br
Controls if the first 4 sectors (2048 bytes) of the device are wiped. Controls if the first 4 sectors (2048 bytes) of the device are wiped.
The default is to wipe these sectors unless either or both of The default is to wipe these sectors unless either or both of
\-\-restorefile or \-\-uuid are specified. --restorefile or --uuid are specified.
.ad b .ad b
.SH VARIABLES .SH VARIABLES
.HP .HP
@ -404,7 +404,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -420,7 +420,7 @@ partitioning (sector 7 is the lowest aligned logical block, the 4KiB
sectors start at LBA -1, and consequently sector 63 is aligned on a 4KiB sectors start at LBA -1, and consequently sector 63 is aligned on a 4KiB
boundary) manually account for this when initializing for use by LVM. boundary) manually account for this when initializing for use by LVM.
.br .br
.B pvcreate \-\-dataalignmentoffset 7s /dev/sdb .B pvcreate --dataalignmentoffset 7s /dev/sdb
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH PVDISPLAY 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH PVDISPLAY 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
pvdisplay \- Display various attributes of physical volume(s) pvdisplay - Display various attributes of physical volume(s)
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBpvdisplay\fP \fBpvdisplay\fP
@ -20,95 +20,95 @@ and more, using a more compact and configurable output format.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-a\fP|\fB\-\-all\fP ] [ \fB-a\fP|\fB--all\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-c\fP|\fB\-\-colon\fP ] [ \fB-c\fP|\fB--colon\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-C\fP|\fB\-\-columns\fP ] [ \fB-C\fP|\fB--columns\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-m\fP|\fB\-\-maps\fP ] [ \fB-m\fP|\fB--maps\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] [ \fB-o\fP|\fB--options\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-s\fP|\fB\-\-short\fP ] [ \fB-s\fP|\fB--short\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] [ \fB-O\fP|\fB--sort\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-aligned\fP ] [ \fB--aligned\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-binary\fP ] [ \fB--binary\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] [ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-foreign\fP ] [ \fB--foreign\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreskippedcluster\fP ] [ \fB--ignoreskippedcluster\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-logonly\fP ] [ \fB--logonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noheadings\fP ] [ \fB--noheadings\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nosuffix\fP ] [ \fB--nosuffix\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-readonly\fP ] [ \fB--readonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-separator\fP \fIString\fP ] [ \fB--separator\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-shared\fP ] [ \fB--shared\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unbuffered\fP ] [ \fB--unbuffered\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] [ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -122,70 +122,70 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-aligned\fP \fB--aligned\fP
.br .br
Use with \-\-separator to align the output columns Use with --separator to align the output columns
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
Show information about devices that have not been initialized Show information about devices that have not been initialized
by LVM, i.e. they are not PVs. by LVM, i.e. they are not PVs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-binary\fP \fB--binary\fP
.br .br
Use binary values "0" or "1" instead of descriptive literal values Use binary values "0" or "1" instead of descriptive literal values
for columns that have exactly two valid values to report (not counting for columns that have exactly two valid values to report (not counting
@ -193,28 +193,28 @@ the "unknown" value which denotes that the value could not be determined).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-c\fP|\fB\-\-colon\fP \fB-c\fP|\fB--colon\fP
.br .br
Generate colon separated output for easier parsing in scripts or programs. Generate colon separated output for easier parsing in scripts or programs.
Also see vgs(8) which provides considerably more control over the output. Also see vgs(8) which provides considerably more control over the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-C\fP|\fB\-\-columns\fP \fB-C\fP|\fB--columns\fP
.br .br
Display output in columns, the equivalent of vgs(8). Display output in columns, the equivalent of vgs(8).
Options listed are the same as options given in vgs(8). Options listed are the same as options given in vgs(8).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -223,86 +223,86 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP
.br .br
See lvmreport(7). See lvmreport(7).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-foreign\fP \fB--foreign\fP
.br .br
Report/display foreign VGs that would otherwise be skipped. Report/display foreign VGs that would otherwise be skipped.
See lvmsystemid(7) for more information about foreign VGs. See lvmsystemid(7) for more information about foreign VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreskippedcluster\fP \fB--ignoreskippedcluster\fP
.br .br
Use to avoid exiting with an non-zero status code if the command is run Use to avoid exiting with an non-zero status code if the command is run
without clustered locking and clustered VGs are skipped. without clustered locking and clustered VGs are skipped.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-logonly\fP \fB--logonly\fP
.br .br
Suppress command report and display only log report. Suppress command report and display only log report.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-m\fP|\fB\-\-maps\fP \fB-m\fP|\fB--maps\fP
.br .br
Display the mapping of physical extents to LVs and logical extents. Display the mapping of physical extents to LVs and logical extents.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noheadings\fP \fB--noheadings\fP
.br .br
Suppress the headings line that is normally the first line of output. Suppress the headings line that is normally the first line of output.
Useful if grepping the output. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nosuffix\fP \fB--nosuffix\fP
.br .br
Suppress the suffix on output sizes. Use with \-\-units Suppress the suffix on output sizes. Use with --units
(except h and H) if processing the output. (except h and H) if processing the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-o\fP|\fB\-\-options\fP \fIString\fP \fB-o\fP|\fB--options\fP \fIString\fP
.br .br
Comma-separated, ordered list of fields to display in columns. Comma-separated, ordered list of fields to display in columns.
String arg syntax is: [+|-|#]Field1[,Field2 ...] String arg syntax is: [+|-|#]Field1[,Field2 ...]
@ -324,21 +324,21 @@ See lvmreport(7) for more information about reporting.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-readonly\fP \fB--readonly\fP
.br .br
Run the command in a special read-only mode which will read on-disk Run the command in a special read-only mode which will read on-disk
metadata without needing to take any locks. This can be used to peek metadata without needing to take any locks. This can be used to peek
@ -352,7 +352,7 @@ actually in use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -363,12 +363,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -376,13 +376,13 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-separator\fP \fIString\fP \fB--separator\fP \fIString\fP
.br .br
String to use to separate each column. Useful if grepping the output. String to use to separate each column. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-shared\fP \fB--shared\fP
.br .br
Report/display shared VGs that would otherwise be skipped when Report/display shared VGs that would otherwise be skipped when
lvmlockd is not being used on the host. lvmlockd is not being used on the host.
@ -390,20 +390,20 @@ See lvmlockd(8) for more information about shared VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-s\fP|\fB\-\-short\fP \fB-s\fP|\fB--short\fP
.br .br
Only display the size of the given PVs. Only display the size of the given PVs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-O\fP|\fB\-\-sort\fP \fIString\fP \fB-O\fP|\fB--sort\fP \fIString\fP
.br .br
Comma-separated ordered list of columns to sort by. Replaces the default Comma-separated ordered list of columns to sort by. Replaces the default
selection. Precede any column with \fB-\fP for a reverse sort on that column. selection. Precede any column with \fB-\fP for a reverse sort on that column.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -413,37 +413,37 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unbuffered\fP \fB--unbuffered\fP
.br .br
Produce output immediately without sorting or aligning the columns properly. Produce output immediately without sorting or aligning the columns properly.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP
.br .br
All sizes are output in these units: All sizes are output in these units:
human-(r)eadable with '<' rounding indicator, human-(r)eadable with '<' rounding indicator,
(h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes,
(g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes.
Capitalise to use multiples of 1000 (S.I.) instead of 1024. Capitalise to use multiples of 1000 (S.I.) instead of 1024.
Custom units can be specified, e.g. \-\-units 3M. Custom units can be specified, e.g. --units 3M.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -480,7 +480,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH PVMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH PVMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
pvmove \- Move extents from one physical volume to another pvmove - Move extents from one physical volume to another
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBpvmove\fP \fIposition_args\fP \fBpvmove\fP \fIposition_args\fP
@ -33,27 +33,27 @@ Move PV extents.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-n\fP|\fB\-\-name\fP \fILV\fP ] [ \fB-n\fP|\fB--name\fP \fILV\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] [ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-atomic\fP ] [ \fB--atomic\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noudevsync\fP ] [ \fB--noudevsync\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -77,15 +77,15 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-b\fP|\fB\-\-background\fP ] [ \fB-b\fP|\fB--background\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-i\fP|\fB\-\-interval\fP \fINumber\fP ] [ \fB-i\fP|\fB--interval\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-abort\fP ] [ \fB--abort\fP ]
.ad b .ad b
.RE .RE
@ -93,66 +93,66 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-abort\fP \fB--abort\fP
.br .br
Abort any pvmove operations in progress. If a pvmove was started Abort any pvmove operations in progress. If a pvmove was started
with the \-\-atomic option, then all LVs will remain on the source PV. with the --atomic option, then all LVs will remain on the source PV.
Otherwise, segments that have been moved will remain on the Otherwise, segments that have been moved will remain on the
destination PV, while unmoved segments will remain on the source PV. destination PV, while unmoved segments will remain on the source PV.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP
.br .br
Determines the allocation policy when a command needs to allocate Determines the allocation policy when a command needs to allocate
Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy
@ -173,21 +173,21 @@ See \fBlvm\fP(8) for more information about allocation.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-atomic\fP \fB--atomic\fP
.br .br
Makes a pvmove operation atomic, ensuring that all affected LVs are Makes a pvmove operation atomic, ensuring that all affected LVs are
moved to the destination PV, or none are if the operation is aborted. moved to the destination PV, or none are if the operation is aborted.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-b\fP|\fB\-\-background\fP \fB-b\fP|\fB--background\fP
.br .br
If the operation requires polling, this option causes the command to If the operation requires polling, this option causes the command to
return before the operation is complete, and polling is done in the return before the operation is complete, and polling is done in the
@ -195,14 +195,14 @@ background.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -211,45 +211,45 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-i\fP|\fB\-\-interval\fP \fINumber\fP \fB-i\fP|\fB--interval\fP \fINumber\fP
.br .br
Report progress at regular intervals. Report progress at regular intervals.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-n\fP|\fB\-\-name\fP \fIString\fP \fB-n\fP|\fB--name\fP \fIString\fP
.br .br
Move only the extents belonging to the named LV. Move only the extents belonging to the named LV.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.br .br
Disables udev synchronisation. The process will not wait for notification Disables udev synchronisation. The process will not wait for notification
from udev. It will continue irrespective of any possible udev processing from udev. It will continue irrespective of any possible udev processing
@ -258,21 +258,21 @@ ignore the devices LVM creates.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -283,7 +283,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -293,20 +293,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -338,7 +338,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -378,7 +378,7 @@ Note that this new process cannot support the original LVM1
type of on-disk metadata. Metadata can be converted using type of on-disk metadata. Metadata can be converted using
\fBvgconvert\fP(8). \fBvgconvert\fP(8).
If the \fB\-\-atomic\fP option is used, a slightly different approach is If the \fB--atomic\fP option is used, a slightly different approach is
used for the move. Again, a temporary 'pvmove' LV is created to store the used for the move. Again, a temporary 'pvmove' LV is created to store the
details of all the data movements required. This temporary LV contains details of all the data movements required. This temporary LV contains
all the segments of the various LVs that need to be moved. However, in all the segments of the various LVs that need to be moved. However, in
@ -402,13 +402,13 @@ Use a specific destination PV when moving physical extents.
Move extents belonging to a single LV. Move extents belonging to a single LV.
.br .br
.B pvmove \-n lvol1 /dev/sdb1 /dev/sdc1 .B pvmove -n lvol1 /dev/sdb1 /dev/sdc1
Rather than moving the contents of an entire device, it is possible to Rather than moving the contents of an entire device, it is possible to
move a range of physical extents, for example numbers 1000 to 1999 move a range of physical extents, for example numbers 1000 to 1999
inclusive on the specified PV. inclusive on the specified PV.
.br .br
.B pvmove /dev/sdb1:1000\-1999 .B pvmove /dev/sdb1:1000-1999
A range of physical extents to move can be specified as start+length. For A range of physical extents to move can be specified as start+length. For
example, starting from PE 1000. (Counting starts from 0, so this refers to the example, starting from PE 1000. (Counting starts from 0, so this refers to the
@ -419,21 +419,21 @@ example, starting from PE 1000. (Counting starts from 0, so this refers to the
Move a range of physical extents to a specific PV (which must have Move a range of physical extents to a specific PV (which must have
sufficient free extents). sufficient free extents).
.br .br
.B pvmove /dev/sdb1:1000\-1999 /dev/sdc1 .B pvmove /dev/sdb1:1000-1999 /dev/sdc1
Move a range of physical extents to specific new extents on a new PV. Move a range of physical extents to specific new extents on a new PV.
.br .br
.B pvmove /dev/sdb1:1000\-1999 /dev/sdc1:0\-999 .B pvmove /dev/sdb1:1000-1999 /dev/sdc1:0-999
If the source and destination are on the same disk, the If the source and destination are on the same disk, the
\fBanywhere\fP allocation policy is needed. \fBanywhere\fP allocation policy is needed.
.br .br
.B pvmove \-\-alloc anywhere /dev/sdb1:1000\-1999 /dev/sdb1:0\-999 .B pvmove --alloc anywhere /dev/sdb1:1000-1999 /dev/sdb1:0-999
The part of a specific LV present within in a range of physical The part of a specific LV present within in a range of physical
extents can also be picked out and moved. extents can also be picked out and moved.
.br .br
.B pvmove \-n lvol1 /dev/sdb1:1000\-1999 /dev/sdc1 .B pvmove -n lvol1 /dev/sdb1:1000-1999 /dev/sdc1
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH PVREMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH PVREMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
pvremove \- Remove LVM label(s) from physical volume(s) pvremove - Remove LVM label(s) from physical volume(s)
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBpvremove\fP \fIposition_args\fP \fBpvremove\fP \fIposition_args\fP
@ -20,11 +20,11 @@ an existing VG. Normally, \fBvgreduce\fP(8) should be used instead.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -35,64 +35,64 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -101,54 +101,54 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -159,7 +159,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -169,20 +169,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -214,7 +214,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH PVRESIZE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH PVRESIZE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
pvresize \- Resize physical volume(s) pvresize - Resize physical volume(s)
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBpvresize\fP \fIposition_args\fP \fBpvresize\fP \fIposition_args\fP
@ -15,11 +15,11 @@ LVs allocated on it.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-setphysicalvolumesize\fP \fISize\fP[m|UNIT] ] [ \fB--setphysicalvolumesize\fP \fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -30,64 +30,64 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -96,47 +96,47 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -147,14 +147,14 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-setphysicalvolumesize\fP \fISize\fP[m|UNIT] \fB--setphysicalvolumesize\fP \fISize\fP[m|UNIT]
.br .br
Overrides the automatically detected size of the PV. Overrides the automatically detected size of the PV.
Use with care, or prior to reducing the physical size of the device. Use with care, or prior to reducing the physical size of the device.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -164,20 +164,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -209,7 +209,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -225,7 +225,7 @@ Expand a PV after enlarging the partition.
Shrink a PV prior to shrinking the partition (ensure that the PV size is Shrink a PV prior to shrinking the partition (ensure that the PV size is
appropriate for the intended new partition size). appropriate for the intended new partition size).
.br .br
.B pvresize \-\-setphysicalvolumesize 40G /dev/sda1 .B pvresize --setphysicalvolumesize 40G /dev/sda1
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH PVS 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH PVS 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
pvs \- Display information about physical volumes pvs - Display information about physical volumes
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBpvs\fP \fBpvs\fP
@ -16,107 +16,107 @@ pvs produces formatted output about PVs.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-a\fP|\fB\-\-all\fP ] [ \fB-a\fP|\fB--all\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] [ \fB-o\fP|\fB--options\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-P\fP|\fB\-\-partial\fP ] [ \fB-P\fP|\fB--partial\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] [ \fB-O\fP|\fB--sort\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-segments\fP ] [ \fB--segments\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-aligned\fP ] [ \fB--aligned\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-binary\fP ] [ \fB--binary\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] [ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-foreign\fP ] [ \fB--foreign\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreskippedcluster\fP ] [ \fB--ignoreskippedcluster\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-logonly\fP ] [ \fB--logonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nameprefixes\fP ] [ \fB--nameprefixes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noheadings\fP ] [ \fB--noheadings\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nolocking\fP ] [ \fB--nolocking\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nosuffix\fP ] [ \fB--nosuffix\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-readonly\fP ] [ \fB--readonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-rows\fP ] [ \fB--rows\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-separator\fP \fIString\fP ] [ \fB--separator\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-shared\fP ] [ \fB--shared\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-trustcache\fP ] [ \fB--trustcache\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unbuffered\fP ] [ \fB--unbuffered\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] [ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unquoted\fP ] [ \fB--unquoted\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -130,70 +130,70 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-aligned\fP \fB--aligned\fP
.br .br
Use with \-\-separator to align the output columns Use with --separator to align the output columns
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
Show information about devices that have not been initialized Show information about devices that have not been initialized
by LVM, i.e. they are not PVs. by LVM, i.e. they are not PVs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-binary\fP \fB--binary\fP
.br .br
Use binary values "0" or "1" instead of descriptive literal values Use binary values "0" or "1" instead of descriptive literal values
for columns that have exactly two valid values to report (not counting for columns that have exactly two valid values to report (not counting
@ -201,14 +201,14 @@ the "unknown" value which denotes that the value could not be determined).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -217,94 +217,94 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP
.br .br
See lvmreport(7). See lvmreport(7).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-foreign\fP \fB--foreign\fP
.br .br
Report/display foreign VGs that would otherwise be skipped. Report/display foreign VGs that would otherwise be skipped.
See lvmsystemid(7) for more information about foreign VGs. See lvmsystemid(7) for more information about foreign VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreskippedcluster\fP \fB--ignoreskippedcluster\fP
.br .br
Use to avoid exiting with an non-zero status code if the command is run Use to avoid exiting with an non-zero status code if the command is run
without clustered locking and clustered VGs are skipped. without clustered locking and clustered VGs are skipped.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-logonly\fP \fB--logonly\fP
.br .br
Suppress command report and display only log report. Suppress command report and display only log report.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nameprefixes\fP \fB--nameprefixes\fP
.br .br
Add an "LVM2_" prefix plus the field name to the output. Useful Add an "LVM2_" prefix plus the field name to the output. Useful
with \-\-noheadings to produce a list of field=value pairs that can with --noheadings to produce a list of field=value pairs that can
be used to set environment variables (for example, in udev rules). be used to set environment variables (for example, in udev rules).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noheadings\fP \fB--noheadings\fP
.br .br
Suppress the headings line that is normally the first line of output. Suppress the headings line that is normally the first line of output.
Useful if grepping the output. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nolocking\fP \fB--nolocking\fP
.br .br
Disable locking. Disable locking.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nosuffix\fP \fB--nosuffix\fP
.br .br
Suppress the suffix on output sizes. Use with \-\-units Suppress the suffix on output sizes. Use with --units
(except h and H) if processing the output. (except h and H) if processing the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-o\fP|\fB\-\-options\fP \fIString\fP \fB-o\fP|\fB--options\fP \fIString\fP
.br .br
Comma-separated, ordered list of fields to display in columns. Comma-separated, ordered list of fields to display in columns.
String arg syntax is: [+|-|#]Field1[,Field2 ...] String arg syntax is: [+|-|#]Field1[,Field2 ...]
@ -326,7 +326,7 @@ See lvmreport(7) for more information about reporting.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.br .br
When set, the tools will do their best to provide access to VGs When set, the tools will do their best to provide access to VGs
that are only partially available (one or more PVs belonging that are only partially available (one or more PVs belonging
@ -335,21 +335,21 @@ changed with this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-readonly\fP \fB--readonly\fP
.br .br
Run the command in a special read-only mode which will read on-disk Run the command in a special read-only mode which will read on-disk
metadata without needing to take any locks. This can be used to peek metadata without needing to take any locks. This can be used to peek
@ -363,7 +363,7 @@ actually in use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -374,13 +374,13 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-rows\fP \fB--rows\fP
.br .br
Output columns as rows. Output columns as rows.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-segments\fP \fB--segments\fP
.br .br
Produces one line of output for each contiguous allocation of space on each Produces one line of output for each contiguous allocation of space on each
PV, showing the start (pvseg_start) and length (pvseg_size) in units of PV, showing the start (pvseg_start) and length (pvseg_size) in units of
@ -388,12 +388,12 @@ physical extents.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -401,13 +401,13 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-separator\fP \fIString\fP \fB--separator\fP \fIString\fP
.br .br
String to use to separate each column. Useful if grepping the output. String to use to separate each column. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-shared\fP \fB--shared\fP
.br .br
Report/display shared VGs that would otherwise be skipped when Report/display shared VGs that would otherwise be skipped when
lvmlockd is not being used on the host. lvmlockd is not being used on the host.
@ -415,14 +415,14 @@ See lvmlockd(8) for more information about shared VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-O\fP|\fB\-\-sort\fP \fIString\fP \fB-O\fP|\fB--sort\fP \fIString\fP
.br .br
Comma-separated ordered list of columns to sort by. Replaces the default Comma-separated ordered list of columns to sort by. Replaces the default
selection. Precede any column with \fB-\fP for a reverse sort on that column. selection. Precede any column with \fB-\fP for a reverse sort on that column.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -432,50 +432,50 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-trustcache\fP \fB--trustcache\fP
.br .br
Avoids certain device scanning during command processing. Do not use. Avoids certain device scanning during command processing. Do not use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unbuffered\fP \fB--unbuffered\fP
.br .br
Produce output immediately without sorting or aligning the columns properly. Produce output immediately without sorting or aligning the columns properly.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP
.br .br
All sizes are output in these units: All sizes are output in these units:
human-(r)eadable with '<' rounding indicator, human-(r)eadable with '<' rounding indicator,
(h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes,
(g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes.
Capitalise to use multiples of 1000 (S.I.) instead of 1024. Capitalise to use multiples of 1000 (S.I.) instead of 1024.
Custom units can be specified, e.g. \-\-units 3M. Custom units can be specified, e.g. --units 3M.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unquoted\fP \fB--unquoted\fP
.br .br
When used with \-\-nameprefixes, output values in the field=value When used with --nameprefixes, output values in the field=value
pairs are not quoted. pairs are not quoted.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -512,7 +512,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH PVSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH PVSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
pvscan \- List all physical volumes pvscan - List all physical volumes
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBpvscan\fP \fIoption_args\fP \fBpvscan\fP \fIoption_args\fP
@ -32,25 +32,25 @@ commands.
When lvmetad is used, LVM commands avoid scanning disks by reading When lvmetad is used, LVM commands avoid scanning disks by reading
metadata from lvmetad. When new disks appear, they must be scanned so metadata from lvmetad. When new disks appear, they must be scanned so
their metadata can be cached in lvmetad. This is done by the command their metadata can be cached in lvmetad. This is done by the command
pvscan \-\-cache, which scans disks and passes the metadata to lvmetad. pvscan --cache, which scans disks and passes the metadata to lvmetad.
The pvscan \-\-cache command is typically run automatically by system The pvscan --cache command is typically run automatically by system
services when a new device appears. Users do not generally need to run services when a new device appears. Users do not generally need to run
this command if the system and lvmetad are running properly. this command if the system and lvmetad are running properly.
Many scripts contain unnecessary pvscan (or vgscan) commands for Many scripts contain unnecessary pvscan (or vgscan) commands for
historical reasons. To avoid disrupting the system with extraneous disk historical reasons. To avoid disrupting the system with extraneous disk
scanning, an ordinary pvscan (without \-\-cache) will simply read metadata scanning, an ordinary pvscan (without --cache) will simply read metadata
from lvmetad like other LVM commands. It does not do anything beyond from lvmetad like other LVM commands. It does not do anything beyond
displaying the current state of the cache. displaying the current state of the cache.
.IP \[bu] 2 .IP \[bu] 2
When given specific device name arguments, pvscan \-\-cache will only When given specific device name arguments, pvscan --cache will only
read the named devices. read the named devices.
.IP \[bu] 2 .IP \[bu] 2
LVM udev rules and systemd services are used to initiate automatic device LVM udev rules and systemd services are used to initiate automatic device
scanning. scanning.
.IP \[bu] 2 .IP \[bu] 2
To prevent devices from being scanned by pvscan \-\-cache, add them To prevent devices from being scanned by pvscan --cache, add them
to to
.BR lvm.conf (5) .BR lvm.conf (5)
.B devices/global_filter. .B devices/global_filter.
@ -58,11 +58,11 @@ The devices/filter setting does not
apply to system level scanning. apply to system level scanning.
For more information, see: For more information, see:
.br .br
.B lvmconfig \-\-withcomments devices/global_filter .B lvmconfig --withcomments devices/global_filter
.IP \[bu] 2 .IP \[bu] 2
If lvmetad is started or restarted after devices are visible, or If lvmetad is started or restarted after devices are visible, or
if the global_filter has changed, then all devices must be rescanned if the global_filter has changed, then all devices must be rescanned
for metadata with the command pvscan \-\-cache. for metadata with the command pvscan --cache.
.IP \[bu] 2 .IP \[bu] 2
lvmetad does not cache older metadata formats, e.g. lvm1, and will lvmetad does not cache older metadata formats, e.g. lvm1, and will
be temporarily disabled if they are seen. be temporarily disabled if they are seen.
@ -74,9 +74,9 @@ minor numbers must be given, not the path.
When event-driven system services detect a new LVM device, the first step When event-driven system services detect a new LVM device, the first step
is to automatically scan and cache the metadata from the device. This is is to automatically scan and cache the metadata from the device. This is
done by pvscan \-\-cache. A second step is to automatically activate LVs done by pvscan --cache. A second step is to automatically activate LVs
that are present on the new device. This auto-activation is done by the that are present on the new device. This auto-activation is done by the
same pvscan \-\-cache command when the option '\-a|\-\-activate ay' is same pvscan --cache command when the option '-a|--activate ay' is
included. included.
Auto-activation of VGs or LVs can be enabled/disabled using: Auto-activation of VGs or LVs can be enabled/disabled using:
@ -86,17 +86,17 @@ Auto-activation of VGs or LVs can be enabled/disabled using:
For more information, see: For more information, see:
.br .br
.B lvmconfig \-\-withcomments activation/auto_activation_volume_list .B lvmconfig --withcomments activation/auto_activation_volume_list
When this setting is undefined, all LVs are auto-activated (when lvm is When this setting is undefined, all LVs are auto-activated (when lvm is
fully integrated with the event-driven system services.) fully integrated with the event-driven system services.)
When a VG or LV is not auto-activated, traditional activation using When a VG or LV is not auto-activated, traditional activation using
vgchange or lvchange -a|\-\-activate is needed. vgchange or lvchange -a|--activate is needed.
.IP \[bu] 2 .IP \[bu] 2
pvscan auto-activation can be only done in combination with \-\-cache. pvscan auto-activation can be only done in combination with --cache.
.IP \[bu] 2 .IP \[bu] 2
Auto-activation is designated by the "a" argument in '-a|\-\-activate ay'. Auto-activation is designated by the "a" argument in '-a|--activate ay'.
This is meant to distinguish system generated commands from explicit user This is meant to distinguish system generated commands from explicit user
commands, although it can be used in any activation command. Whenever it commands, although it can be used in any activation command. Whenever it
is used, the auto_activation_volume_list is applied. is used, the auto_activation_volume_list is applied.
@ -111,19 +111,19 @@ Display PV information.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-e\fP|\fB\-\-exported\fP ] [ \fB-e\fP|\fB--exported\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-n\fP|\fB\-\-novolumegroup\fP ] [ \fB-n\fP|\fB--novolumegroup\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-s\fP|\fB\-\-short\fP ] [ \fB-s\fP|\fB--short\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-u\fP|\fB\-\-uuid\fP ] [ \fB-u\fP|\fB--uuid\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -133,23 +133,23 @@ Display PV information.
Populate the lvmetad cache by scanning PVs. Populate the lvmetad cache by scanning PVs.
.br .br
.P .P
\fBpvscan\fP \fB\-\-cache\fP \fBpvscan\fP \fB--cache\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-b\fP|\fB\-\-background\fP ] [ \fB-b\fP|\fB--background\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP ] [ \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-j\fP|\fB\-\-major\fP \fINumber\fP ] [ \fB-j\fP|\fB--major\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-minor\fP \fINumber\fP ] [ \fB--minor\fP \fINumber\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -163,11 +163,11 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.RE .RE
@ -175,62 +175,62 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP
.br .br
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-b\fP|\fB\-\-background\fP \fB-b\fP|\fB--background\fP
.br .br
If the operation requires polling, this option causes the command to If the operation requires polling, this option causes the command to
return before the operation is complete, and polling is done in the return before the operation is complete, and polling is done in the
@ -238,20 +238,20 @@ background.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-cache\fP \fB--cache\fP
.br .br
Scan one or more devices and send the metadata to lvmetad. Scan one or more devices and send the metadata to lvmetad.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -260,78 +260,78 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-e\fP|\fB\-\-exported\fP \fB-e\fP|\fB--exported\fP
.br .br
Only show PVs belonging to exported VGs. Only show PVs belonging to exported VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-j\fP|\fB\-\-major\fP \fINumber\fP \fB-j\fP|\fB--major\fP \fINumber\fP
.br .br
The major number of a device. The major number of a device.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-minor\fP \fINumber\fP \fB--minor\fP \fINumber\fP
.br .br
The minor number of a device. The minor number of a device.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-n\fP|\fB\-\-novolumegroup\fP \fB-n\fP|\fB--novolumegroup\fP
.br .br
Only show PVs not belonging to any VG. Only show PVs not belonging to any VG.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -342,13 +342,13 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-s\fP|\fB\-\-short\fP \fB-s\fP|\fB--short\fP
.br .br
Short listing format. Short listing format.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -358,26 +358,26 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-u\fP|\fB\-\-uuid\fP \fB-u\fP|\fB--uuid\fP
.br .br
Show UUIDs in addition to device names. Show UUIDs in addition to device names.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -409,7 +409,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGCFGBACKUP 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGCFGBACKUP 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgcfgbackup \- Backup volume group configuration(s) vgcfgbackup - Backup volume group configuration(s)
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgcfgbackup\fP \fBvgcfgbackup\fP
@ -18,7 +18,7 @@ files.
In a default installation, each VG is backed up into a separate file In a default installation, each VG is backed up into a separate file
bearing the name of the VG in the directory \fI#DEFAULT_BACKUP_DIR#\fP. bearing the name of the VG in the directory \fI#DEFAULT_BACKUP_DIR#\fP.
To use an alternative back up file, use \fB\-f\fP. In this case, when To use an alternative back up file, use \fB-f\fP. In this case, when
backing up multiple VGs, the file name is treated as a template, with %s backing up multiple VGs, the file name is treated as a template, with %s
replaced by the VG name. replaced by the VG name.
@ -31,27 +31,27 @@ It may also be useful to regularly back up the files in
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-f\fP|\fB\-\-file\fP \fIString\fP ] [ \fB-f\fP|\fB--file\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-P\fP|\fB\-\-partial\fP ] [ \fB-P\fP|\fB--partial\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-foreign\fP ] [ \fB--foreign\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-readonly\fP ] [ \fB--readonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -65,64 +65,64 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -131,21 +131,21 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-file\fP \fIString\fP \fB-f\fP|\fB--file\fP \fIString\fP
.br .br
Write the backup to the named file. Write the backup to the named file.
When backing up more than one VG, the file name is When backing up more than one VG, the file name is
@ -153,33 +153,33 @@ treated as a template, and %s is replaced by the VG name.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-foreign\fP \fB--foreign\fP
.br .br
Report/display foreign VGs that would otherwise be skipped. Report/display foreign VGs that would otherwise be skipped.
See lvmsystemid(7) for more information about foreign VGs. See lvmsystemid(7) for more information about foreign VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.br .br
When set, the tools will do their best to provide access to VGs When set, the tools will do their best to provide access to VGs
that are only partially available (one or more PVs belonging that are only partially available (one or more PVs belonging
@ -188,21 +188,21 @@ changed with this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-readonly\fP \fB--readonly\fP
.br .br
Run the command in a special read-only mode which will read on-disk Run the command in a special read-only mode which will read on-disk
metadata without needing to take any locks. This can be used to peek metadata without needing to take any locks. This can be used to peek
@ -216,7 +216,7 @@ actually in use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -227,7 +227,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -237,20 +237,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -276,7 +276,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGCFGRESTORE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGCFGRESTORE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgcfgrestore \- Restore volume group configuration vgcfgrestore - Restore volume group configuration
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgcfgrestore\fP \fIoption_args\fP \fIposition_args\fP \fBvgcfgrestore\fP \fIoption_args\fP \fIposition_args\fP
@ -11,75 +11,75 @@ vgcfgrestore \- Restore volume group configuration
.br .br
.P .P
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP \fB-d\fP|\fB--debug\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-f\fP|\fB\-\-file\fP \fIString\fP \fB-f\fP|\fB--file\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-force\fP \fB--force\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-l\fP|\fB\-\-list\fP \fB-l\fP|\fB--list\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP \fB-q\fP|\fB--quiet\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP \fB-v\fP|\fB--verbose\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.ad b .ad b
.SH DESCRIPTION .SH DESCRIPTION
vgcfgrestore restores the metadata of a VG from a text back up file vgcfgrestore restores the metadata of a VG from a text back up file
produced by \fBvgcfgbackup\fP. This writes VG metadata onto the devices produced by \fBvgcfgbackup\fP. This writes VG metadata onto the devices
specifed in back up file. specifed in back up file.
A back up file can be specified with \fB\-\-file\fP. If no backup file is 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 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. the available back up and archive files of a VG.
WARNING: When a VG contains thin pools, changes to thin metadata cannot be WARNING: When a VG contains thin pools, changes to thin metadata cannot be
@ -100,7 +100,7 @@ Restore VG metadata from last backup.
Restore VG metadata from specified file. Restore VG metadata from specified file.
.br .br
.P .P
\fBvgcfgrestore\fP \fB-f\fP|\fB\-\-file\fP \fIString\fP \fIVG\fP \fBvgcfgrestore\fP \fB-f\fP|\fB--file\fP \fIString\fP \fIVG\fP
.br .br
.RS 4 .RS 4
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -111,7 +111,7 @@ Restore VG metadata from specified file.
List all VG metadata backups. List all VG metadata backups.
.br .br
.P .P
\fBvgcfgrestore\fP \fB-l\fP|\fB\-\-list\fP \fIVG\fP \fBvgcfgrestore\fP \fB-l\fP|\fB--list\fP \fIVG\fP
.br .br
.RS 4 .RS 4
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -122,7 +122,7 @@ List all VG metadata backups.
List one VG metadata backup file. List one VG metadata backup file.
.br .br
.P .P
\fBvgcfgrestore\fP \fB-l\fP|\fB\-\-list\fP \fB-f\fP|\fB\-\-file\fP \fIString\fP \fBvgcfgrestore\fP \fB-l\fP|\fB--list\fP \fB-f\fP|\fB--file\fP \fIString\fP
.br .br
.RS 4 .RS 4
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -137,11 +137,11 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] [ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-force\fP ] [ \fB--force\fP ]
.ad b .ad b
.RE .RE
@ -149,64 +149,64 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -215,28 +215,28 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-file\fP \fIString\fP \fB-f\fP|\fB--file\fP \fIString\fP
.br .br
Read metadata backup from the named file. Read metadata backup from the named file.
Usually this file was created by vgcfgbackup. Usually this file was created by vgcfgbackup.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-force\fP ... \fB--force\fP ...
.br .br
Force metadata restore even with thin pool LVs. Force metadata restore even with thin pool LVs.
Use with extreme caution. Most changes to thin metadata Use with extreme caution. Most changes to thin metadata
@ -246,26 +246,26 @@ thin pool kernel metadata precisely.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-list\fP \fB-l\fP|\fB--list\fP
.br .br
List metadata backup and archive files pertaining to the VG. List metadata backup and archive files pertaining to the VG.
May be used with \-\-file. Does not restore the VG. May be used with --file. Does not restore the VG.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP
.br .br
Specifies the type of on-disk metadata to use. Specifies the type of on-disk metadata to use.
\fBlvm2\fP (or just \fB2\fP) is the current, standard format. \fBlvm2\fP (or just \fB2\fP) is the current, standard format.
@ -274,21 +274,21 @@ can be used for accessing old data.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -298,20 +298,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -337,20 +337,20 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
For example, LVM_VG_NAME can generally be substituted for a required VG parameter. For example, LVM_VG_NAME can generally be substituted for a required VG parameter.
.SH NOTES .SH NOTES
To replace PVs, \fBvgdisplay \-\-partial \-\-verbose\fP will show the To replace PVs, \fBvgdisplay --partial --verbose\fP will show the
UUIDs and sizes of any PVs that are no longer present. If a PV in the VG UUIDs and sizes of any PVs that are no longer present. If a PV in the VG
is lost and you wish to substitute another of the same size, use is lost and you wish to substitute another of the same size, use
\fBpvcreate \-\-restorefile filename \-\-uuid uuid\fP (plus additional \fBpvcreate --restorefile filename --uuid uuid\fP (plus additional
arguments as appropriate) to initialise it with the same UUID as the arguments as appropriate) to initialise it with the same UUID as the
missing PV. Repeat for all other missing PVs in the VG. Then use missing PV. Repeat for all other missing PVs in the VG. Then use
\fBvgcfgrestore \-\-file filename\fP to restore the VG's metadata. \fBvgcfgrestore --file filename\fP to restore the VG's metadata.
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH VGCHANGE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGCHANGE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgchange \- Change volume group attributes vgchange - Change volume group attributes
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgchange\fP \fIoption_args\fP \fBvgchange\fP \fIoption_args\fP
@ -11,187 +11,187 @@ vgchange \- Change volume group attributes
.br .br
.P .P
.ad l .ad l
\fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP \fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-addtag\fP \fITag\fP \fB--addtag\fP \fITag\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP \fB-d\fP|\fB--debug\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-deltag\fP \fITag\fP \fB--deltag\fP \fITag\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-detachprofile\fP \fB--detachprofile\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP \fB-f\fP|\fB--force\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-K\fP|\fB\-\-ignoreactivationskip\fP \fB-K\fP|\fB--ignoreactivationskip\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-ignoremonitoring\fP \fB--ignoremonitoring\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-ignoreskippedcluster\fP \fB--ignoreskippedcluster\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-lockopt\fP \fIString\fP \fB--lockopt\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-lockstart\fP \fB--lockstart\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-lockstop\fP \fB--lockstop\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP \fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-l\fP|\fB\-\-logicalvolume\fP \fINumber\fP \fB-l\fP|\fB--logicalvolume\fP \fINumber\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-metadataprofile\fP \fIString\fP \fB--metadataprofile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-monitor\fP \fBy\fP|\fBn\fP \fB--monitor\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT] \fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT]
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-poll\fP \fBy\fP|\fBn\fP \fB--poll\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP \fB-q\fP|\fB--quiet\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-refresh\fP \fB--refresh\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-x\fP|\fB\-\-resizeable\fP \fBy\fP|\fBn\fP \fB-x\fP|\fB--resizeable\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-sysinit\fP \fB--sysinit\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-systemid\fP \fIString\fP \fB--systemid\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-u\fP|\fB\-\-uuid\fP \fB-u\fP|\fB--uuid\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP \fB-v\fP|\fB--verbose\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.ad b .ad b
.SH DESCRIPTION .SH DESCRIPTION
vgchange changes VG attributes, changes LV activation in the kernel, and vgchange changes VG attributes, changes LV activation in the kernel, and
@ -206,67 +206,67 @@ required, after which the others are optional.
.P .P
\fBvgchange\fP \fBvgchange\fP
.RS 4 .RS 4
( \fB-l\fP|\fB\-\-logicalvolume\fP \fINumber\fP, ( \fB-l\fP|\fB--logicalvolume\fP \fINumber\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP, \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB-u\fP|\fB\-\-uuid\fP, \fB-u\fP|\fB--uuid\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP, \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT], \fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT],
.ad b .ad b
.br .br
.ad l .ad l
\fB-x\fP|\fB\-\-resizeable\fP \fBy\fP|\fBn\fP, \fB-x\fP|\fB--resizeable\fP \fBy\fP|\fBn\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-addtag\fP \fITag\fP, \fB--addtag\fP \fITag\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-deltag\fP \fITag\fP, \fB--deltag\fP \fITag\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP, \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP, \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP, \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-systemid\fP \fIString\fP, \fB--systemid\fP \fIString\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP, \fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-profile\fP \fIString\fP, \fB--profile\fP \fIString\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-detachprofile\fP, \fB--detachprofile\fP,
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-metadataprofile\fP \fIString\fP ) \fB--metadataprofile\fP \fIString\fP )
.RE .RE
.br .br
.RS 4 .RS 4
@ -281,19 +281,19 @@ required, after which the others are optional.
Start or stop monitoring LVs from dmeventd. Start or stop monitoring LVs from dmeventd.
.br .br
.P .P
\fBvgchange\fP \fB\-\-monitor\fP \fBy\fP|\fBn\fP \fBvgchange\fP \fB--monitor\fP \fBy\fP|\fBn\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-sysinit\fP ] [ \fB--sysinit\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-poll\fP \fBy\fP|\fBn\fP ] [ \fB--poll\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -307,11 +307,11 @@ Start or stop monitoring LVs from dmeventd.
Start or stop processing LV conversions. Start or stop processing LV conversions.
.br .br
.P .P
\fBvgchange\fP \fB\-\-poll\fP \fBy\fP|\fBn\fP \fBvgchange\fP \fB--poll\fP \fBy\fP|\fBn\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -325,35 +325,35 @@ Start or stop processing LV conversions.
Activate or deactivate LVs. Activate or deactivate LVs.
.br .br
.P .P
\fBvgchange\fP \fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP \fBvgchange\fP \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-K\fP|\fB\-\-ignoreactivationskip\fP ] [ \fB-K\fP|\fB--ignoreactivationskip\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-P\fP|\fB\-\-partial\fP ] [ \fB-P\fP|\fB--partial\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ] [ \fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-sysinit\fP ] [ \fB--sysinit\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-monitor\fP \fBy\fP|\fBn\fP ] [ \fB--monitor\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-poll\fP \fBy\fP|\fBn\fP ] [ \fB--poll\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -367,23 +367,23 @@ Activate or deactivate LVs.
Reactivate LVs using the latest metadata. Reactivate LVs using the latest metadata.
.br .br
.P .P
\fBvgchange\fP \fB\-\-refresh\fP \fBvgchange\fP \fB--refresh\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-sysinit\fP ] [ \fB--sysinit\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-monitor\fP \fBy\fP|\fBn\fP ] [ \fB--monitor\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-poll\fP \fBy\fP|\fBn\fP ] [ \fB--poll\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -397,11 +397,11 @@ Reactivate LVs using the latest metadata.
Start the lockspace of a shared VG in lvmlockd. Start the lockspace of a shared VG in lvmlockd.
.br .br
.P .P
\fBvgchange\fP \fB\-\-lockstart\fP \fBvgchange\fP \fB--lockstart\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-lockopt\fP \fIString\fP ] [ \fB--lockopt\fP \fIString\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -415,11 +415,11 @@ Start the lockspace of a shared VG in lvmlockd.
Stop the lockspace of a shared VG in lvmlockd. Stop the lockspace of a shared VG in lvmlockd.
.br .br
.P .P
\fBvgchange\fP \fB\-\-lockstop\fP \fBvgchange\fP \fB--lockstop\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-lockopt\fP \fIString\fP ] [ \fB--lockopt\fP \fIString\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -434,31 +434,31 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoremonitoring\fP ] [ \fB--ignoremonitoring\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreskippedcluster\fP ] [ \fB--ignoreskippedcluster\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noudevsync\fP ] [ \fB--noudevsync\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.RE .RE
@ -466,57 +466,57 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP \fB-a\fP|\fB--activate\fP \fBy\fP|\fBn\fP|\fBay\fP
.br .br
Change the active state of LVs. Change the active state of LVs.
An active LV can be used through a block device, An active LV can be used through a block device,
@ -541,7 +541,7 @@ See clvmd(8) for more information about activation options \fBey\fP, \fBsy\fP, \
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP \fB--activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP
.br .br
Determines if LV activation is allowed when PVs are missing, Determines if LV activation is allowed when PVs are missing,
e.g. because of a device failure. e.g. because of a device failure.
@ -556,14 +556,14 @@ See \fBlvmraid\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-addtag\fP \fITag\fP \fB--addtag\fP \fITag\fP
.br .br
Adds a tag to a PV, VG or LV. This option can be repeated to add Adds a tag to a PV, VG or LV. This option can be repeated to add
multiple tags at once. See lvm(8) for information about tags. multiple tags at once. See lvm(8) for information about tags.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP
.br .br
Determines the allocation policy when a command needs to allocate Determines the allocation policy when a command needs to allocate
Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy
@ -584,28 +584,28 @@ See \fBlvm\fP(8) for more information about allocation.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP
.br .br
Change the clustered property of a VG using clvmd. Change the clustered property of a VG using clvmd.
See clvmd(8) for more information about clustered VGs. See clvmd(8) for more information about clustered VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -614,83 +614,83 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-deltag\fP \fITag\fP \fB--deltag\fP \fITag\fP
.br .br
Deletes a tag from a PV, VG or LV. This option can be repeated to delete Deletes a tag from a PV, VG or LV. This option can be repeated to delete
multiple tags at once. See lvm(8) for information about tags. multiple tags at once. See lvm(8) for information about tags.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-detachprofile\fP \fB--detachprofile\fP
.br .br
Detaches a metadata profile from a VG or LV. Detaches a metadata profile from a VG or LV.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-K\fP|\fB\-\-ignoreactivationskip\fP \fB-K\fP|\fB--ignoreactivationskip\fP
.br .br
Ignore the "activation skip" LV flag during activation Ignore the "activation skip" LV flag during activation
to allow LVs with the flag set to be activated. to allow LVs with the flag set to be activated.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoremonitoring\fP \fB--ignoremonitoring\fP
.br .br
Do not interact with dmeventd unless \-\-monitor is specified. Do not interact with dmeventd unless --monitor is specified.
Do not use this if dmeventd is already monitoring a device. Do not use this if dmeventd is already monitoring a device.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreskippedcluster\fP \fB--ignoreskippedcluster\fP
.br .br
Use to avoid exiting with an non-zero status code if the command is run Use to avoid exiting with an non-zero status code if the command is run
without clustered locking and clustered VGs are skipped. without clustered locking and clustered VGs are skipped.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-lockopt\fP \fIString\fP \fB--lockopt\fP \fIString\fP
.br .br
Used to pass options for special cases to lvmlockd. Used to pass options for special cases to lvmlockd.
See lvmlockd(8) for more information. See lvmlockd(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-lockstart\fP \fB--lockstart\fP
.br .br
Start the lockspace of a shared VG in lvmlockd. Start the lockspace of a shared VG in lvmlockd.
lvmlockd locks becomes available for the VG, allowing LVM to use the VG. lvmlockd locks becomes available for the VG, allowing LVM to use the VG.
@ -698,7 +698,7 @@ See lvmlockd(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-lockstop\fP \fB--lockstop\fP
.br .br
Stop the lockspace of a shared VG in lvmlockd. Stop the lockspace of a shared VG in lvmlockd.
lvmlockd locks become unavailable for the VG, preventing LVM from using the VG. lvmlockd locks become unavailable for the VG, preventing LVM from using the VG.
@ -706,42 +706,42 @@ See lvmlockd(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP \fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP
.br .br
Change the VG lock type to or from a shared lock type used with lvmlockd. Change the VG lock type to or from a shared lock type used with lvmlockd.
See lvmlockd(8) for more information. See lvmlockd(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-logicalvolume\fP \fINumber\fP \fB-l\fP|\fB--logicalvolume\fP \fINumber\fP
.br .br
Sets the maximum number of LVs allowed in a VG. Sets the maximum number of LVs allowed in a VG.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP
.br .br
Sets the maximum number of PVs that can belong to the VG. Sets the maximum number of PVs that can belong to the VG.
The value 0 removes any limitation. The value 0 removes any limitation.
For large numbers of PVs, also see options \-\-pvmetadatacopies, For large numbers of PVs, also see options --pvmetadatacopies,
and \-\-vgmetadatacopies for improving performance. and --vgmetadatacopies for improving performance.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadataprofile\fP \fIString\fP \fB--metadataprofile\fP \fIString\fP
.br .br
The metadata profile to use for command configuration. The metadata profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-monitor\fP \fBy\fP|\fBn\fP \fB--monitor\fP \fBy\fP|\fBn\fP
.br .br
Start (yes) or stop (no) monitoring an LV with dmeventd. Start (yes) or stop (no) monitoring an LV with dmeventd.
dmeventd monitors kernel events for an LV, and performs dmeventd monitors kernel events for an LV, and performs
@ -750,7 +750,7 @@ See dmeventd(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.br .br
Disables udev synchronisation. The process will not wait for notification Disables udev synchronisation. The process will not wait for notification
from udev. It will continue irrespective of any possible udev processing from udev. It will continue irrespective of any possible udev processing
@ -759,7 +759,7 @@ ignore the devices LVM creates.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.br .br
When set, the tools will do their best to provide access to VGs When set, the tools will do their best to provide access to VGs
that are only partially available (one or more PVs belonging that are only partially available (one or more PVs belonging
@ -768,7 +768,7 @@ changed with this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT] \fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT]
.br .br
Sets the physical extent size of PVs in the VG. Sets the physical extent size of PVs in the VG.
The value must be either a power of 2 of at least 1 sector The value must be either a power of 2 of at least 1 sector
@ -782,26 +782,26 @@ contiguous range of extents used in a LV must start and end on an extent boundar
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-poll\fP \fBy\fP|\fBn\fP \fB--poll\fP \fBy\fP|\fBn\fP
.br .br
When yes, start the background transformation of an LV. When yes, start the background transformation of an LV.
An incomplete transformation, e.g. pvmove or lvconvert interrupted An incomplete transformation, e.g. pvmove or lvconvert interrupted
by reboot or crash, can be restarted from the last checkpoint with \-\-poll y. by reboot or crash, can be restarted from the last checkpoint with --poll y.
When no, background transformation of an LV will not occur, and the When no, background transformation of an LV will not occur, and the
transformation will not complete. It may not be appropriate to immediately transformation will not complete. It may not be appropriate to immediately
poll an LV after activation, in which case \-\-poll n can be used to defer poll an LV after activation, in which case --poll n can be used to defer
polling until a later \-\-poll y command. polling until a later --poll y command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP
.br .br
The number of metadata areas to set aside on a PV for storing VG metadata. The number of metadata areas to set aside on a PV for storing VG metadata.
When 2, one copy of the VG metadata is stored at the front of the PV When 2, one copy of the VG metadata is stored at the front of the PV
@ -814,14 +814,14 @@ on the ability to use vgsplit later.)
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-refresh\fP \fB--refresh\fP
.br .br
If the LV is active, reload its metadata. If the LV is active, reload its metadata.
This is not necessary in normal operation, but may be useful This is not necessary in normal operation, but may be useful
@ -830,7 +830,7 @@ sharing is being used.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -841,19 +841,19 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-x\fP|\fB\-\-resizeable\fP \fBy\fP|\fBn\fP \fB-x\fP|\fB--resizeable\fP \fBy\fP|\fBn\fP
.br .br
Enables or disables the addition or removal of PVs to/from a VG Enables or disables the addition or removal of PVs to/from a VG
(by vgextend/vgreduce). (by vgextend/vgreduce).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -861,20 +861,20 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-sysinit\fP \fB--sysinit\fP
.br .br
Indicates that vgchange/lvchange is being invoked from early system initialisation Indicates that vgchange/lvchange is being invoked from early system initialisation
scripts (e.g. rc.sysinit or an initrd), before writable filesystems are scripts (e.g. rc.sysinit or an initrd), before writable filesystems are
available. As such, some functionality needs to be disabled and this option available. As such, some functionality needs to be disabled and this option
acts as a shortcut which selects an appropriate set of options. Currently, acts as a shortcut which selects an appropriate set of options. Currently,
this is equivalent to using \-\-ignorelockingfailure, \-\-ignoremonitoring, this is equivalent to using --ignorelockingfailure, --ignoremonitoring,
\-\-poll n, and setting env var LVM_SUPPRESS_LOCKING_FAILURE_MESSAGES. --poll n, and setting env var LVM_SUPPRESS_LOCKING_FAILURE_MESSAGES.
When used in conjunction with lvmetad enabled and running, When used in conjunction with lvmetad enabled and running,
vgchange/lvchange skip autoactivation, and defer to pvscan autoactivation. vgchange/lvchange skip autoactivation, and defer to pvscan autoactivation.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-systemid\fP \fIString\fP \fB--systemid\fP \fIString\fP
.br .br
Changes the system ID of the VG. Using this option requires caution Changes the system ID of the VG. Using this option requires caution
because the VG may become foreign to the host running the command, because the VG may become foreign to the host running the command,
@ -883,7 +883,7 @@ See lvmsystemid(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -893,26 +893,26 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-u\fP|\fB\-\-uuid\fP \fB-u\fP|\fB--uuid\fP
.br .br
Generate new random UUID for specified VGs. Generate new random UUID for specified VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP
.br .br
Number of copies of the VG metadata that are kept. Number of copies of the VG metadata that are kept.
VG metadata is kept in VG metadata areas on PVs in the VG, VG metadata is kept in VG metadata areas on PVs in the VG,
@ -930,7 +930,7 @@ all PVs, and then to become unmanaged.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -950,7 +950,7 @@ in place of a VG, LV or PV.
\fISelect\fP \fISelect\fP
.br .br
Select indicates that a required positional parameter can Select indicates that a required positional parameter can
be omitted if the \fB\-\-select\fP option is used. be omitted if the \fB--select\fP option is used.
No arg appears in this position. No arg appears in this position.
.HP .HP
\fIString\fP \fIString\fP
@ -967,7 +967,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -979,11 +979,11 @@ snapshots should be removed.
.SH EXAMPLES .SH EXAMPLES
Activate all LVs in all VGs on all existing devices. Activate all LVs in all VGs on all existing devices.
.br .br
.B vgchange \-a y .B vgchange -a y
Change the maximum number of LVs for an inactive VG. Change the maximum number of LVs for an inactive VG.
.br .br
.B vgchange \-l 128 vg00 .B vgchange -l 128 vg00
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH VGCK 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGCK 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgck \- Check the consistency of volume group(s) vgck - Check the consistency of volume group(s)
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgck\fP \fBvgck\fP
@ -16,7 +16,7 @@ vgck checks LVM metadata for consistency.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -30,64 +30,64 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -96,47 +96,47 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -147,7 +147,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -157,20 +157,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -201,7 +201,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGCONVERT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGCONVERT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgconvert \- Change volume group metadata format vgconvert - Change volume group metadata format
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgconvert\fP \fIposition_args\fP \fBvgconvert\fP \fIposition_args\fP
@ -19,31 +19,31 @@ longer needed in general.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] [ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-labelsector\fP \fINumber\fP ] [ \fB--labelsector\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-bootloaderareasize\fP \fISize\fP[m|UNIT] ] [ \fB--bootloaderareasize\fP \fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] [ \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-metadatasize\fP \fISize\fP[m|UNIT] ] [ \fB--metadatasize\fP \fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -54,78 +54,78 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-bootloaderareasize\fP \fISize\fP[m|UNIT] \fB--bootloaderareasize\fP \fISize\fP[m|UNIT]
.br .br
Create a separate bootloader area of specified size besides PV's data Create a separate bootloader area of specified size besides PV's data
area. The bootloader area is an area of reserved space on the PV from area. The bootloader area is an area of reserved space on the PV from
which LVM will not allocate any extents and it's kept untouched. This is which LVM will not allocate any extents and it's kept untouched. This is
primarily aimed for use with bootloaders to embed their own data or metadata. primarily aimed for use with bootloaders to embed their own data or metadata.
The start of the bootloader area is always aligned, see also \-\-dataalignment The start of the bootloader area is always aligned, see also --dataalignment
and \-\-dataalignmentoffset. The bootloader area size may eventually and --dataalignmentoffset. The bootloader area size may eventually
end up increased due to the alignment, but it's never less than the end up increased due to the alignment, but it's never less than the
size that is requested. To see the bootloader area start and size of size that is requested. To see the bootloader area start and size of
an existing PV use pvs -o +pv_ba_start,pv_ba_size. an existing PV use pvs -o +pv_ba_start,pv_ba_size.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -134,34 +134,34 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-labelsector\fP \fINumber\fP \fB--labelsector\fP \fINumber\fP
.br .br
By default the PV is labelled with an LVM2 identifier in its second By default the PV is labelled with an LVM2 identifier in its second
sector (sector 1). This lets you use a different sector near the sector (sector 1). This lets you use a different sector near the
@ -170,20 +170,20 @@ in the source). Use with care.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadatasize\fP \fISize\fP[m|UNIT] \fB--metadatasize\fP \fISize\fP[m|UNIT]
.br .br
The approximate amount of space used for each VG metadata area. The approximate amount of space used for each VG metadata area.
The size may be rounded. The size may be rounded.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP
.br .br
Specifies the type of on-disk metadata to use. Specifies the type of on-disk metadata to use.
\fBlvm2\fP (or just \fB2\fP) is the current, standard format. \fBlvm2\fP (or just \fB2\fP) is the current, standard format.
@ -192,14 +192,14 @@ can be used for accessing old data.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP
.br .br
The number of metadata areas to set aside on a PV for storing VG metadata. The number of metadata areas to set aside on a PV for storing VG metadata.
When 2, one copy of the VG metadata is stored at the front of the PV When 2, one copy of the VG metadata is stored at the front of the PV
@ -212,14 +212,14 @@ on the ability to use vgsplit later.)
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -230,7 +230,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -240,20 +240,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -279,7 +279,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGCREATE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGCREATE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgcreate \- Create a volume group vgcreate - Create a volume group
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgcreate\fP \fIposition_args\fP \fBvgcreate\fP \fIposition_args\fP
@ -17,91 +17,91 @@ devices are also available with vgcreate.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP ] [ \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-l\fP|\fB\-\-maxlogicalvolumes\fP \fINumber\fP ] [ \fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP ] [ \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] [ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT] ] [ \fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] [ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-addtag\fP \fITag\fP ] [ \fB--addtag\fP \fITag\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] [ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-metadataprofile\fP \fIString\fP ] [ \fB--metadataprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-labelsector\fP \fINumber\fP ] [ \fB--labelsector\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-metadatasize\fP \fISize\fP[m|UNIT] ] [ \fB--metadatasize\fP \fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] [ \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP ] [ \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-dataalignment\fP \fISize\fP[k|UNIT] ] [ \fB--dataalignment\fP \fISize\fP[k|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] ] [ \fB--dataalignmentoffset\fP \fISize\fP[k|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-shared\fP ] [ \fB--shared\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-systemid\fP \fIString\fP ] [ \fB--systemid\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP ] [ \fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-lockopt\fP \fIString\fP ] [ \fB--lockopt\fP \fIString\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -112,64 +112,64 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-addtag\fP \fITag\fP \fB--addtag\fP \fITag\fP
.br .br
Adds a tag to a PV, VG or LV. This option can be repeated to add Adds a tag to a PV, VG or LV. This option can be repeated to add
multiple tags at once. See lvm(8) for information about tags. multiple tags at once. See lvm(8) for information about tags.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP
.br .br
Determines the allocation policy when a command needs to allocate Determines the allocation policy when a command needs to allocate
Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy
@ -190,14 +190,14 @@ See \fBlvm\fP(8) for more information about allocation.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP
.br .br
Create a clustered VG using clvmd if LVM is compiled with cluster support. Create a clustered VG using clvmd if LVM is compiled with cluster support.
This allows multiple hosts to share a VG on shared devices. This allows multiple hosts to share a VG on shared devices.
@ -207,14 +207,14 @@ See clvmd(8) for more information about clustered VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -223,50 +223,50 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-dataalignment\fP \fISize\fP[k|UNIT] \fB--dataalignment\fP \fISize\fP[k|UNIT]
.br .br
Align the start of the data to a multiple of this number. Align the start of the data to a multiple of this number.
Also specify an appropriate Physical Extent size when creating a VG. Also specify an appropriate Physical Extent size when creating a VG.
To see the location of the first Physical Extent of an existing PV, To see the location of the first Physical Extent of an existing PV,
use pvs -o +pe_start. In addition, it may be shifted by an alignment offset. use pvs -o +pe_start. In addition, it may be shifted by an alignment offset.
See lvm.conf/data_alignment_offset_detection and \-\-dataalignmentoffset. See lvm.conf/data_alignment_offset_detection and --dataalignmentoffset.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] \fB--dataalignmentoffset\fP \fISize\fP[k|UNIT]
.br .br
Shift the start of the data area by this additional offset. Shift the start of the data area by this additional offset.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-labelsector\fP \fINumber\fP \fB--labelsector\fP \fINumber\fP
.br .br
By default the PV is labelled with an LVM2 identifier in its second By default the PV is labelled with an LVM2 identifier in its second
sector (sector 1). This lets you use a different sector near the sector (sector 1). This lets you use a different sector near the
@ -275,56 +275,56 @@ in the source). Use with care.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-lockopt\fP \fIString\fP \fB--lockopt\fP \fIString\fP
.br .br
Used to pass options for special cases to lvmlockd. Used to pass options for special cases to lvmlockd.
See lvmlockd(8) for more information. See lvmlockd(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP \fB--locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP
.br .br
Specify the VG lock type directly in place of using \-\-shared. Specify the VG lock type directly in place of using --shared.
See lvmlockd(8) for more information. See lvmlockd(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-maxlogicalvolumes\fP \fINumber\fP \fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP
.br .br
Sets the maximum number of LVs allowed in a VG. Sets the maximum number of LVs allowed in a VG.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP
.br .br
Sets the maximum number of PVs that can belong to the VG. Sets the maximum number of PVs that can belong to the VG.
The value 0 removes any limitation. The value 0 removes any limitation.
For large numbers of PVs, also see options \-\-pvmetadatacopies, For large numbers of PVs, also see options --pvmetadatacopies,
and \-\-vgmetadatacopies for improving performance. and --vgmetadatacopies for improving performance.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadataprofile\fP \fIString\fP \fB--metadataprofile\fP \fIString\fP
.br .br
The metadata profile to use for command configuration. The metadata profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadatasize\fP \fISize\fP[m|UNIT] \fB--metadatasize\fP \fISize\fP[m|UNIT]
.br .br
The approximate amount of space used for each VG metadata area. The approximate amount of space used for each VG metadata area.
The size may be rounded. The size may be rounded.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP
.br .br
Specifies the type of on-disk metadata to use. Specifies the type of on-disk metadata to use.
\fBlvm2\fP (or just \fB2\fP) is the current, standard format. \fBlvm2\fP (or just \fB2\fP) is the current, standard format.
@ -333,7 +333,7 @@ can be used for accessing old data.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT] \fB-s\fP|\fB--physicalextentsize\fP \fISize\fP[m|UNIT]
.br .br
Sets the physical extent size of PVs in the VG. Sets the physical extent size of PVs in the VG.
The value must be either a power of 2 of at least 1 sector The value must be either a power of 2 of at least 1 sector
@ -344,14 +344,14 @@ without recreating the VG, unless no extents need moving.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP
.br .br
The number of metadata areas to set aside on a PV for storing VG metadata. The number of metadata areas to set aside on a PV for storing VG metadata.
When 2, one copy of the VG metadata is stored at the front of the PV When 2, one copy of the VG metadata is stored at the front of the PV
@ -364,14 +364,14 @@ on the ability to use vgsplit later.)
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -382,7 +382,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-shared\fP \fB--shared\fP
.br .br
Create a shared VG using lvmlockd if LVM is compiled with lockd support. Create a shared VG using lvmlockd if LVM is compiled with lockd support.
lvmlockd will select lock type sanlock or dlm depending on which lock lvmlockd will select lock type sanlock or dlm depending on which lock
@ -393,7 +393,7 @@ See lvmlockd(8) for more information about shared VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-systemid\fP \fIString\fP \fB--systemid\fP \fIString\fP
.br .br
Specifies the system ID that will be given to the new VG, overriding the Specifies the system ID that will be given to the new VG, overriding the
system ID of the host running the command. A VG is normally created system ID of the host running the command. A VG is normally created
@ -405,7 +405,7 @@ See lvmsystemid(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -415,20 +415,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP
.br .br
Number of copies of the VG metadata that are kept. Number of copies of the VG metadata that are kept.
VG metadata is kept in VG metadata areas on PVs in the VG, VG metadata is kept in VG metadata areas on PVs in the VG,
@ -446,7 +446,7 @@ all PVs, and then to become unmanaged.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -454,11 +454,11 @@ answer yes. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP
.br .br
Controls if the first 4 sectors (2048 bytes) of the device are wiped. Controls if the first 4 sectors (2048 bytes) of the device are wiped.
The default is to wipe these sectors unless either or both of The default is to wipe these sectors unless either or both of
\-\-restorefile or \-\-uuid are specified. --restorefile or --uuid are specified.
.ad b .ad b
.SH VARIABLES .SH VARIABLES
.HP .HP
@ -490,7 +490,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGDISPLAY 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGDISPLAY 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgdisplay \- Display volume group information vgdisplay - Display volume group information
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgdisplay\fP \fBvgdisplay\fP
@ -19,95 +19,95 @@ and more, using a more compact and configurable output format.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-activevolumegroups\fP ] [ \fB-A\fP|\fB--activevolumegroups\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-c\fP|\fB\-\-colon\fP ] [ \fB-c\fP|\fB--colon\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-C\fP|\fB\-\-columns\fP ] [ \fB-C\fP|\fB--columns\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] [ \fB-o\fP|\fB--options\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-P\fP|\fB\-\-partial\fP ] [ \fB-P\fP|\fB--partial\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-s\fP|\fB\-\-short\fP ] [ \fB-s\fP|\fB--short\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] [ \fB-O\fP|\fB--sort\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-aligned\fP ] [ \fB--aligned\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-binary\fP ] [ \fB--binary\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] [ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-foreign\fP ] [ \fB--foreign\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreskippedcluster\fP ] [ \fB--ignoreskippedcluster\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-logonly\fP ] [ \fB--logonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noheadings\fP ] [ \fB--noheadings\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nosuffix\fP ] [ \fB--nosuffix\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-readonly\fP ] [ \fB--readonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-shared\fP ] [ \fB--shared\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-separator\fP \fIString\fP ] [ \fB--separator\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unbuffered\fP ] [ \fB--unbuffered\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] [ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -121,70 +121,70 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-activevolumegroups\fP \fB-A\fP|\fB--activevolumegroups\fP
.br .br
Only select active VGs. The VG is considered active Only select active VGs. The VG is considered active
if at least one of its LVs is active. if at least one of its LVs is active.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-aligned\fP \fB--aligned\fP
.br .br
Use with \-\-separator to align the output columns Use with --separator to align the output columns
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-binary\fP \fB--binary\fP
.br .br
Use binary values "0" or "1" instead of descriptive literal values Use binary values "0" or "1" instead of descriptive literal values
for columns that have exactly two valid values to report (not counting for columns that have exactly two valid values to report (not counting
@ -192,28 +192,28 @@ the "unknown" value which denotes that the value could not be determined).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-c\fP|\fB\-\-colon\fP \fB-c\fP|\fB--colon\fP
.br .br
Generate colon separated output for easier parsing in scripts or programs. Generate colon separated output for easier parsing in scripts or programs.
Also see vgs(8) which provides considerably more control over the output. Also see vgs(8) which provides considerably more control over the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-C\fP|\fB\-\-columns\fP \fB-C\fP|\fB--columns\fP
.br .br
Display output in columns, the equivalent of vgs(8). Display output in columns, the equivalent of vgs(8).
Options listed are the same as options given in vgs(8). Options listed are the same as options given in vgs(8).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -222,80 +222,80 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP
.br .br
See lvmreport(7). See lvmreport(7).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-foreign\fP \fB--foreign\fP
.br .br
Report/display foreign VGs that would otherwise be skipped. Report/display foreign VGs that would otherwise be skipped.
See lvmsystemid(7) for more information about foreign VGs. See lvmsystemid(7) for more information about foreign VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreskippedcluster\fP \fB--ignoreskippedcluster\fP
.br .br
Use to avoid exiting with an non-zero status code if the command is run Use to avoid exiting with an non-zero status code if the command is run
without clustered locking and clustered VGs are skipped. without clustered locking and clustered VGs are skipped.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-logonly\fP \fB--logonly\fP
.br .br
Suppress command report and display only log report. Suppress command report and display only log report.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noheadings\fP \fB--noheadings\fP
.br .br
Suppress the headings line that is normally the first line of output. Suppress the headings line that is normally the first line of output.
Useful if grepping the output. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nosuffix\fP \fB--nosuffix\fP
.br .br
Suppress the suffix on output sizes. Use with \-\-units Suppress the suffix on output sizes. Use with --units
(except h and H) if processing the output. (except h and H) if processing the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-o\fP|\fB\-\-options\fP \fIString\fP \fB-o\fP|\fB--options\fP \fIString\fP
.br .br
Comma-separated, ordered list of fields to display in columns. Comma-separated, ordered list of fields to display in columns.
String arg syntax is: [+|-|#]Field1[,Field2 ...] String arg syntax is: [+|-|#]Field1[,Field2 ...]
@ -317,7 +317,7 @@ See lvmreport(7) for more information about reporting.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.br .br
When set, the tools will do their best to provide access to VGs When set, the tools will do their best to provide access to VGs
that are only partially available (one or more PVs belonging that are only partially available (one or more PVs belonging
@ -326,21 +326,21 @@ changed with this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-readonly\fP \fB--readonly\fP
.br .br
Run the command in a special read-only mode which will read on-disk Run the command in a special read-only mode which will read on-disk
metadata without needing to take any locks. This can be used to peek metadata without needing to take any locks. This can be used to peek
@ -354,7 +354,7 @@ actually in use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -365,12 +365,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -378,13 +378,13 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-separator\fP \fIString\fP \fB--separator\fP \fIString\fP
.br .br
String to use to separate each column. Useful if grepping the output. String to use to separate each column. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-shared\fP \fB--shared\fP
.br .br
Report/display shared VGs that would otherwise be skipped when Report/display shared VGs that would otherwise be skipped when
lvmlockd is not being used on the host. lvmlockd is not being used on the host.
@ -392,20 +392,20 @@ See lvmlockd(8) for more information about shared VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-s\fP|\fB\-\-short\fP \fB-s\fP|\fB--short\fP
.br .br
Give a short listing showing the existence of VGs. Give a short listing showing the existence of VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-O\fP|\fB\-\-sort\fP \fIString\fP \fB-O\fP|\fB--sort\fP \fIString\fP
.br .br
Comma-separated ordered list of columns to sort by. Replaces the default Comma-separated ordered list of columns to sort by. Replaces the default
selection. Precede any column with \fB-\fP for a reverse sort on that column. selection. Precede any column with \fB-\fP for a reverse sort on that column.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -415,37 +415,37 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unbuffered\fP \fB--unbuffered\fP
.br .br
Produce output immediately without sorting or aligning the columns properly. Produce output immediately without sorting or aligning the columns properly.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP
.br .br
All sizes are output in these units: All sizes are output in these units:
human-(r)eadable with '<' rounding indicator, human-(r)eadable with '<' rounding indicator,
(h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes,
(g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes.
Capitalise to use multiples of 1000 (S.I.) instead of 1024. Capitalise to use multiples of 1000 (S.I.) instead of 1024.
Custom units can be specified, e.g. \-\-units 3M. Custom units can be specified, e.g. --units 3M.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -476,7 +476,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGEXPORT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGEXPORT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgexport \- Unregister volume group(s) from the system vgexport - Unregister volume group(s) from the system
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgexport\fP \fIoption_args\fP \fIposition_args\fP \fBvgexport\fP \fIoption_args\fP \fIposition_args\fP
@ -24,7 +24,7 @@ Export specified VGs.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -34,7 +34,7 @@ Export specified VGs.
Export all VGs. Export all VGs.
.br .br
.P .P
\fBvgexport\fP \fB-a\fP|\fB\-\-all\fP \fBvgexport\fP \fB-a\fP|\fB--all\fP
.br .br
.RS 4 .RS 4
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -45,7 +45,7 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.RE .RE
@ -53,69 +53,69 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -124,47 +124,47 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -175,12 +175,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -188,7 +188,7 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -198,20 +198,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -231,7 +231,7 @@ in place of a VG, LV or PV.
\fISelect\fP \fISelect\fP
.br .br
Select indicates that a required positional parameter can Select indicates that a required positional parameter can
be omitted if the \fB\-\-select\fP option is used. be omitted if the \fB--select\fP option is used.
No arg appears in this position. No arg appears in this position.
.HP .HP
\fIString\fP \fIString\fP
@ -248,7 +248,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGEXTEND 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGEXTEND 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgextend \- Add physical volumes to a volume group vgextend - Add physical volumes to a volume group
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgextend\fP \fIposition_args\fP \fBvgextend\fP \fIposition_args\fP
@ -13,62 +13,62 @@ for LVs in the VG.
Also, PVs that have gone missing and then returned, e.g. due to a Also, PVs that have gone missing and then returned, e.g. due to a
transient device failure, can be added back to the VG without transient device failure, can be added back to the VG without
re-initializing them (see \-\-restoremissing). re-initializing them (see --restoremissing).
If the specified PVs have not yet been initialized with pvcreate, vgextend If the specified PVs have not yet been initialized with pvcreate, vgextend
will initialize them. In this case pvcreate options can be used, e.g. will initialize them. In this case pvcreate options can be used, e.g.
\-\-labelsector, \-\-metadatasize, \-\-metadataignore, --labelsector, --metadatasize, --metadataignore,
\-\-pvmetadatacopies, \-\-dataalignment, \-\-dataalignmentoffset. --pvmetadatacopies, --dataalignment, --dataalignmentoffset.
.SH USAGE .SH USAGE
\fBvgextend\fP \fIVG\fP \fIPV\fP ... \fBvgextend\fP \fIVG\fP \fIPV\fP ...
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP ] [ \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] [ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-labelsector\fP \fINumber\fP ] [ \fB--labelsector\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-metadatasize\fP \fISize\fP[m|UNIT] ] [ \fB--metadatasize\fP \fISize\fP[m|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ] [ \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-metadataignore\fP \fBy\fP|\fBn\fP ] [ \fB--metadataignore\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-dataalignment\fP \fISize\fP[k|UNIT] ] [ \fB--dataalignment\fP \fISize\fP[k|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] ] [ \fB--dataalignmentoffset\fP \fISize\fP[k|UNIT] ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-restoremissing\fP ] [ \fB--restoremissing\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -79,71 +79,71 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -152,50 +152,50 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-dataalignment\fP \fISize\fP[k|UNIT] \fB--dataalignment\fP \fISize\fP[k|UNIT]
.br .br
Align the start of the data to a multiple of this number. Align the start of the data to a multiple of this number.
Also specify an appropriate Physical Extent size when creating a VG. Also specify an appropriate Physical Extent size when creating a VG.
To see the location of the first Physical Extent of an existing PV, To see the location of the first Physical Extent of an existing PV,
use pvs -o +pe_start. In addition, it may be shifted by an alignment offset. use pvs -o +pe_start. In addition, it may be shifted by an alignment offset.
See lvm.conf/data_alignment_offset_detection and \-\-dataalignmentoffset. See lvm.conf/data_alignment_offset_detection and --dataalignmentoffset.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-dataalignmentoffset\fP \fISize\fP[k|UNIT] \fB--dataalignmentoffset\fP \fISize\fP[k|UNIT]
.br .br
Shift the start of the data area by this additional offset. Shift the start of the data area by this additional offset.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-labelsector\fP \fINumber\fP \fB--labelsector\fP \fINumber\fP
.br .br
By default the PV is labelled with an LVM2 identifier in its second By default the PV is labelled with an LVM2 identifier in its second
sector (sector 1). This lets you use a different sector near the sector (sector 1). This lets you use a different sector near the
@ -204,13 +204,13 @@ in the source). Use with care.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadataignore\fP \fBy\fP|\fBn\fP \fB--metadataignore\fP \fBy\fP|\fBn\fP
.br .br
Specifies the metadataignore property of a PV. Specifies the metadataignore property of a PV.
If yes, metadata areas on the PV are ignored, and lvm will If yes, metadata areas on the PV are ignored, and lvm will
@ -219,14 +219,14 @@ If no, lvm will store metadata on the PV.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-metadatasize\fP \fISize\fP[m|UNIT] \fB--metadatasize\fP \fISize\fP[m|UNIT]
.br .br
The approximate amount of space used for each VG metadata area. The approximate amount of space used for each VG metadata area.
The size may be rounded. The size may be rounded.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP
.br .br
Specifies the type of on-disk metadata to use. Specifies the type of on-disk metadata to use.
\fBlvm2\fP (or just \fB2\fP) is the current, standard format. \fBlvm2\fP (or just \fB2\fP) is the current, standard format.
@ -235,14 +235,14 @@ can be used for accessing old data.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP \fB--pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP
.br .br
The number of metadata areas to set aside on a PV for storing VG metadata. The number of metadata areas to set aside on a PV for storing VG metadata.
When 2, one copy of the VG metadata is stored at the front of the PV When 2, one copy of the VG metadata is stored at the front of the PV
@ -255,14 +255,14 @@ on the ability to use vgsplit later.)
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -273,14 +273,14 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-restoremissing\fP \fB--restoremissing\fP
.br .br
Add a PV back into a VG after the PV was missing and then returned, Add a PV back into a VG after the PV was missing and then returned,
e.g. due to a transient failure. The PV is not reinitialized. e.g. due to a transient failure. The PV is not reinitialized.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -290,20 +290,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -311,11 +311,11 @@ answer yes. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP \fB-Z\fP|\fB--zero\fP \fBy\fP|\fBn\fP
.br .br
Controls if the first 4 sectors (2048 bytes) of the device are wiped. Controls if the first 4 sectors (2048 bytes) of the device are wiped.
The default is to wipe these sectors unless either or both of The default is to wipe these sectors unless either or both of
\-\-restorefile or \-\-uuid are specified. --restorefile or --uuid are specified.
.ad b .ad b
.SH VARIABLES .SH VARIABLES
.HP .HP
@ -347,7 +347,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGIMPORT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGIMPORT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgimport \- Register exported volume group with system vgimport - Register exported volume group with system
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgimport\fP \fIoption_args\fP \fIposition_args\fP \fBvgimport\fP \fIoption_args\fP \fIposition_args\fP
@ -21,7 +21,7 @@ Import specified VGs.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -31,7 +31,7 @@ Import specified VGs.
Import all VGs. Import all VGs.
.br .br
.P .P
\fBvgimport\fP \fB-a\fP|\fB\-\-all\fP \fBvgimport\fP \fB-a\fP|\fB--all\fP
.br .br
.RS 4 .RS 4
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -42,11 +42,11 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.RE .RE
@ -54,69 +54,69 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -125,54 +125,54 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -183,12 +183,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -196,7 +196,7 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -206,20 +206,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -239,7 +239,7 @@ in place of a VG, LV or PV.
\fISelect\fP \fISelect\fP
.br .br
Select indicates that a required positional parameter can Select indicates that a required positional parameter can
be omitted if the \fB\-\-select\fP option is used. be omitted if the \fB--select\fP option is used.
No arg appears in this position. No arg appears in this position.
.HP .HP
\fIString\fP \fIString\fP
@ -256,7 +256,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGIMPORTCLONE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGIMPORTCLONE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgimportclone \- Import a VG from cloned PVs vgimportclone - Import a VG from cloned PVs
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgimportclone\fP \fIposition_args\fP \fBvgimportclone\fP \fIposition_args\fP
@ -19,11 +19,11 @@ changes the associated VG and PV UUIDs.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-n\fP|\fB\-\-basevgname\fP \fIVG\fP ] [ \fB-n\fP|\fB--basevgname\fP \fIVG\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-i\fP|\fB\-\-import\fP ] [ \fB-i\fP|\fB--import\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -34,57 +34,57 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-n\fP|\fB\-\-basevgname\fP \fIString\fP \fB-n\fP|\fB--basevgname\fP \fIString\fP
.br .br
By default the snapshot VG will be renamed to the original name plus a By default the snapshot VG will be renamed to the original name plus a
numeric suffix to avoid duplicate naming (e.g. 'test_vg' would be renamed numeric suffix to avoid duplicate naming (e.g. 'test_vg' would be renamed
@ -94,14 +94,14 @@ a numeric suffix will be added (like the previous example) to make it unique.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -110,54 +110,54 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-i\fP|\fB\-\-import\fP \fB-i\fP|\fB--import\fP
.br .br
Import exported VGs. Otherwise VGs that have been exported Import exported VGs. Otherwise VGs that have been exported
will not be changed (nor will their associated PVs). will not be changed (nor will their associated PVs).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -167,20 +167,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -212,7 +212,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -224,7 +224,7 @@ The corresponding PVs from a hardware snapshot are "/dev/sdc" and "/dev/sdd".
Rename the VG associated with "/dev/sdc" and "/dev/sdd" from "vg00" to "vg00_snap" Rename the VG associated with "/dev/sdc" and "/dev/sdd" from "vg00" to "vg00_snap"
(and change associated UUIDs). (and change associated UUIDs).
.br .br
.B vgimportclone \-\-basevgname vg00_snap /dev/sdc /dev/sdd .B vgimportclone --basevgname vg00_snap /dev/sdc /dev/sdd
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH VGMERGE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGMERGE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgmerge \- Merge volume groups vgmerge - Merge volume groups
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgmerge\fP \fIposition_args\fP \fBvgmerge\fP \fIposition_args\fP
@ -16,11 +16,11 @@ of both VGs fit into the destination VG's limits.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-l\fP|\fB\-\-list\fP ] [ \fB-l\fP|\fB--list\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -31,71 +31,71 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -104,53 +104,53 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-list\fP \fB-l\fP|\fB--list\fP
.br .br
Display merged destination VG like vgdisplay -v. Display merged destination VG like vgdisplay -v.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -160,20 +160,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -199,7 +199,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -209,7 +209,7 @@ For example, LVM_VG_NAME can generally be substituted for a required VG paramete
Merge an inactive VG named "vg00" into the active or inactive VG named Merge an inactive VG named "vg00" into the active or inactive VG named
"databases", giving verbose runtime information. "databases", giving verbose runtime information.
.br .br
.B vgmerge \-v databases vg00 .B vgmerge -v databases vg00
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH VGMKNODES 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGMKNODES 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgmknodes \- Create the special files for volume group devices in /dev vgmknodes - Create the special files for volume group devices in /dev
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgmknodes\fP \fBvgmknodes\fP
@ -20,15 +20,15 @@ interoperating correctly.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-refresh\fP ] [ \fB--refresh\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -42,64 +42,64 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -108,54 +108,54 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-refresh\fP \fB--refresh\fP
.br .br
If the LV is active, reload its metadata. If the LV is active, reload its metadata.
This is not necessary in normal operation, but may be useful This is not necessary in normal operation, but may be useful
@ -164,7 +164,7 @@ sharing is being used.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -175,7 +175,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -185,20 +185,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -234,7 +234,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGREDUCE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGREDUCE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgreduce \- Remove physical volume(s) from a volume group vgreduce - Remove physical volume(s) from a volume group
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgreduce\fP \fIoption_args\fP \fIposition_args\fP \fBvgreduce\fP \fIoption_args\fP \fIposition_args\fP
@ -9,75 +9,75 @@ vgreduce \- Remove physical volume(s) from a volume group
.br .br
.P .P
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP \fB-d\fP|\fB--debug\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP \fB-f\fP|\fB--force\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-mirrorsonly\fP \fB--mirrorsonly\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP \fB-q\fP|\fB--quiet\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-removemissing\fP \fB--removemissing\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP \fB-v\fP|\fB--verbose\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.ad b .ad b
.br .br
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.ad b .ad b
.SH DESCRIPTION .SH DESCRIPTION
vgreduce removes one or more unused PVs from a VG. vgreduce removes one or more unused PVs from a VG.
@ -96,7 +96,7 @@ Remove a PV from a VG.
Remove all unused PVs from a VG. Remove all unused PVs from a VG.
.br .br
.P .P
\fBvgreduce\fP \fB-a\fP|\fB\-\-all\fP \fIVG\fP \fBvgreduce\fP \fB-a\fP|\fB--all\fP \fIVG\fP
.br .br
.RS 4 .RS 4
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -107,11 +107,11 @@ Remove all unused PVs from a VG.
Remove all missing PVs from a VG. Remove all missing PVs from a VG.
.br .br
.P .P
\fBvgreduce\fP \fB\-\-removemissing\fP \fIVG\fP \fBvgreduce\fP \fB--removemissing\fP \fIVG\fP
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB\-\-mirrorsonly\fP ] [ \fB--mirrorsonly\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -123,15 +123,15 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.RE .RE
@ -139,77 +139,77 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
Removes all empty PVs if none are named on the command line. Removes all empty PVs if none are named on the command line.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -218,66 +218,66 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-mirrorsonly\fP \fB--mirrorsonly\fP
.br .br
Only remove missing PVs from mirror LVs. Only remove missing PVs from mirror LVs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-removemissing\fP \fB--removemissing\fP
.br .br
Removes all missing PVs from the VG, if there are no LVs allocated Removes all missing PVs from the VG, if there are no LVs allocated
on them. This resumes normal operation of the VG (new LVs may again on them. This resumes normal operation of the VG (new LVs may again
be created, changed and so on). be created, changed and so on).
If this is not possible because LVs are referencing the missing PVs, If this is not possible because LVs are referencing the missing PVs,
this option can be combined with \-\-force to have the command remove this option can be combined with --force to have the command remove
any partial LVs. In this case, any LVs and dependent snapshots that any partial LVs. In this case, any LVs and dependent snapshots that
were partly on the missing disks are removed completely, including were partly on the missing disks are removed completely, including
those parts on disks that are still present. those parts on disks that are still present.
@ -286,7 +286,7 @@ some data first may be possible by activating LVs in partial mode.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -297,7 +297,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -307,20 +307,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -356,7 +356,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGREMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGREMOVE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgremove \- Remove volume group(s) vgremove - Remove volume group(s)
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgremove\fP \fIposition_args\fP \fBvgremove\fP \fIposition_args\fP
@ -12,7 +12,7 @@ vgremove removes one or more VGs. If LVs exist in the VG, a prompt is used
to confirm LV removal. to confirm LV removal.
If one or more PVs in the VG are lost, consider If one or more PVs in the VG are lost, consider
\fBvgreduce \-\-removemissing\fP to make the VG \fBvgreduce --removemissing\fP to make the VG
metadata consistent again. metadata consistent again.
Repeat the force option (\fB-ff\fP) to forcibly remove LVs in the VG Repeat the force option (\fB-ff\fP) to forcibly remove LVs in the VG
@ -22,19 +22,19 @@ without confirmation.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noudevsync\fP ] [ \fB--noudevsync\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -45,64 +45,64 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -111,40 +111,40 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noudevsync\fP \fB--noudevsync\fP
.br .br
Disables udev synchronisation. The process will not wait for notification Disables udev synchronisation. The process will not wait for notification
from udev. It will continue irrespective of any possible udev processing from udev. It will continue irrespective of any possible udev processing
@ -153,21 +153,21 @@ ignore the devices LVM creates.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -178,12 +178,12 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -191,7 +191,7 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -201,20 +201,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -234,7 +234,7 @@ in place of a VG, LV or PV.
\fISelect\fP \fISelect\fP
.br .br
Select indicates that a required positional parameter can Select indicates that a required positional parameter can
be omitted if the \fB\-\-select\fP option is used. be omitted if the \fB--select\fP option is used.
No arg appears in this position. No arg appears in this position.
.HP .HP
\fIString\fP \fIString\fP
@ -251,7 +251,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGRENAME 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGRENAME 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgrename \- Rename a volume group vgrename - Rename a volume group
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgrename\fP \fIposition_args\fP \fBvgrename\fP \fIposition_args\fP
@ -42,15 +42,15 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-f\fP|\fB\-\-force\fP ] [ \fB-f\fP|\fB--force\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.RE .RE
@ -58,71 +58,71 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -131,54 +131,54 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-f\fP|\fB\-\-force\fP ... \fB-f\fP|\fB--force\fP ...
.br .br
Override various checks, confirmations and protections. Override various checks, confirmations and protections.
Use with extreme caution. Use with extreme caution.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -189,7 +189,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -199,20 +199,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -238,7 +238,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.
@ -251,7 +251,7 @@ Rename VG "vg02" to "myvg":
Rename the VG with the specified UUID to "myvg". Rename the VG with the specified UUID to "myvg".
.br .br
.B vgrename Zvlifi\-Ep3t\-e0Ng\-U42h\-o0ye\-KHu1\-nl7Ns4 myvg .B vgrename Zvlifi-Ep3t-e0Ng-U42h-o0ye-KHu1-nl7Ns4 myvg
.SH SEE ALSO .SH SEE ALSO
.BR lvm (8) .BR lvm (8)

View File

@ -1,6 +1,6 @@
.TH VGS 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGS 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgs \- Display information about volume groups vgs - Display information about volume groups
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgs\fP \fBvgs\fP
@ -16,103 +16,103 @@ vgs produces formatted output about VGs.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-a\fP|\fB\-\-all\fP ] [ \fB-a\fP|\fB--all\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-o\fP|\fB\-\-options\fP \fIString\fP ] [ \fB-o\fP|\fB--options\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-P\fP|\fB\-\-partial\fP ] [ \fB-P\fP|\fB--partial\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-S\fP|\fB\-\-select\fP \fIString\fP ] [ \fB-S\fP|\fB--select\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-O\fP|\fB\-\-sort\fP \fIString\fP ] [ \fB-O\fP|\fB--sort\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-aligned\fP ] [ \fB--aligned\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-binary\fP ] [ \fB--binary\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ] [ \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-foreign\fP ] [ \fB--foreign\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignoreskippedcluster\fP ] [ \fB--ignoreskippedcluster\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-logonly\fP ] [ \fB--logonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nameprefixes\fP ] [ \fB--nameprefixes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-noheadings\fP ] [ \fB--noheadings\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nolocking\fP ] [ \fB--nolocking\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-nosuffix\fP ] [ \fB--nosuffix\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-readonly\fP ] [ \fB--readonly\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-rows\fP ] [ \fB--rows\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-separator\fP \fIString\fP ] [ \fB--separator\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-shared\fP ] [ \fB--shared\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-trustcache\fP ] [ \fB--trustcache\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unbuffered\fP ] [ \fB--unbuffered\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ] [ \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-unquoted\fP ] [ \fB--unquoted\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -126,69 +126,69 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-aligned\fP \fB--aligned\fP
.br .br
Use with \-\-separator to align the output columns Use with --separator to align the output columns
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-a\fP|\fB\-\-all\fP \fB-a\fP|\fB--all\fP
.br .br
List all VGs. Equivalent to not specifying any VGs. List all VGs. Equivalent to not specifying any VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-binary\fP \fB--binary\fP
.br .br
Use binary values "0" or "1" instead of descriptive literal values Use binary values "0" or "1" instead of descriptive literal values
for columns that have exactly two valid values to report (not counting for columns that have exactly two valid values to report (not counting
@ -196,14 +196,14 @@ the "unknown" value which denotes that the value could not be determined).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -212,94 +212,94 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP \fB--configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP
.br .br
See lvmreport(7). See lvmreport(7).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-foreign\fP \fB--foreign\fP
.br .br
Report/display foreign VGs that would otherwise be skipped. Report/display foreign VGs that would otherwise be skipped.
See lvmsystemid(7) for more information about foreign VGs. See lvmsystemid(7) for more information about foreign VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignoreskippedcluster\fP \fB--ignoreskippedcluster\fP
.br .br
Use to avoid exiting with an non-zero status code if the command is run Use to avoid exiting with an non-zero status code if the command is run
without clustered locking and clustered VGs are skipped. without clustered locking and clustered VGs are skipped.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-logonly\fP \fB--logonly\fP
.br .br
Suppress command report and display only log report. Suppress command report and display only log report.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nameprefixes\fP \fB--nameprefixes\fP
.br .br
Add an "LVM2_" prefix plus the field name to the output. Useful Add an "LVM2_" prefix plus the field name to the output. Useful
with \-\-noheadings to produce a list of field=value pairs that can with --noheadings to produce a list of field=value pairs that can
be used to set environment variables (for example, in udev rules). be used to set environment variables (for example, in udev rules).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-noheadings\fP \fB--noheadings\fP
.br .br
Suppress the headings line that is normally the first line of output. Suppress the headings line that is normally the first line of output.
Useful if grepping the output. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nolocking\fP \fB--nolocking\fP
.br .br
Disable locking. Disable locking.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-nosuffix\fP \fB--nosuffix\fP
.br .br
Suppress the suffix on output sizes. Use with \-\-units Suppress the suffix on output sizes. Use with --units
(except h and H) if processing the output. (except h and H) if processing the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-o\fP|\fB\-\-options\fP \fIString\fP \fB-o\fP|\fB--options\fP \fIString\fP
.br .br
Comma-separated, ordered list of fields to display in columns. Comma-separated, ordered list of fields to display in columns.
String arg syntax is: [+|-|#]Field1[,Field2 ...] String arg syntax is: [+|-|#]Field1[,Field2 ...]
@ -321,7 +321,7 @@ See lvmreport(7) for more information about reporting.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.br .br
When set, the tools will do their best to provide access to VGs When set, the tools will do their best to provide access to VGs
that are only partially available (one or more PVs belonging that are only partially available (one or more PVs belonging
@ -330,21 +330,21 @@ changed with this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-readonly\fP \fB--readonly\fP
.br .br
Run the command in a special read-only mode which will read on-disk Run the command in a special read-only mode which will read on-disk
metadata without needing to take any locks. This can be used to peek metadata without needing to take any locks. This can be used to peek
@ -358,7 +358,7 @@ actually in use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -369,18 +369,18 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-rows\fP \fB--rows\fP
.br .br
Output columns as rows. Output columns as rows.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-S\fP|\fB\-\-select\fP \fIString\fP \fB-S\fP|\fB--select\fP \fIString\fP
.br .br
Select objects for processing and reporting based on specified criteria. Select objects for processing and reporting based on specified criteria.
The criteria syntax is described by \fB\-\-select help\fP and \fBlvmreport\fP(7). The criteria syntax is described by \fB--select help\fP and \fBlvmreport\fP(7).
For reporting commands, one row is displayed for each object matching the criteria. For reporting commands, one row is displayed for each object matching the criteria.
See \fB\-\-options help\fP for selectable object fields. See \fB--options help\fP for selectable object fields.
Rows can be displayed with an additional "selected" field (-o selected) Rows can be displayed with an additional "selected" field (-o selected)
showing 1 if the row matches the selection and 0 otherwise. showing 1 if the row matches the selection and 0 otherwise.
For non-reporting commands which process LVM entities, the selection is For non-reporting commands which process LVM entities, the selection is
@ -388,13 +388,13 @@ used to choose items to process.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-separator\fP \fIString\fP \fB--separator\fP \fIString\fP
.br .br
String to use to separate each column. Useful if grepping the output. String to use to separate each column. Useful if grepping the output.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-shared\fP \fB--shared\fP
.br .br
Report/display shared VGs that would otherwise be skipped when Report/display shared VGs that would otherwise be skipped when
lvmlockd is not being used on the host. lvmlockd is not being used on the host.
@ -402,14 +402,14 @@ See lvmlockd(8) for more information about shared VGs.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-O\fP|\fB\-\-sort\fP \fIString\fP \fB-O\fP|\fB--sort\fP \fIString\fP
.br .br
Comma-separated ordered list of columns to sort by. Replaces the default Comma-separated ordered list of columns to sort by. Replaces the default
selection. Precede any column with \fB-\fP for a reverse sort on that column. selection. Precede any column with \fB-\fP for a reverse sort on that column.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -419,50 +419,50 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-trustcache\fP \fB--trustcache\fP
.br .br
Avoids certain device scanning during command processing. Do not use. Avoids certain device scanning during command processing. Do not use.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unbuffered\fP \fB--unbuffered\fP
.br .br
Produce output immediately without sorting or aligning the columns properly. Produce output immediately without sorting or aligning the columns properly.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP \fB--units\fP \fBr\fP|\fBR\fP|\fBh\fP|\fBH\fP|\fBb\fP|\fBB\fP|\fBs\fP|\fBS\fP|\fBk\fP|\fBK\fP|\fBm\fP|\fBM\fP|\fBg\fP|\fBG\fP|\fBt\fP|\fBT\fP|\fBp\fP|\fBP\fP|\fBe\fP|\fBE\fP
.br .br
All sizes are output in these units: All sizes are output in these units:
human-(r)eadable with '<' rounding indicator, human-(r)eadable with '<' rounding indicator,
(h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes, (h)uman-readable, (b)ytes, (s)ectors, (k)ilobytes, (m)egabytes,
(g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes. (g)igabytes, (t)erabytes, (p)etabytes, (e)xabytes.
Capitalise to use multiples of 1000 (S.I.) instead of 1024. Capitalise to use multiples of 1000 (S.I.) instead of 1024.
Custom units can be specified, e.g. \-\-units 3M. Custom units can be specified, e.g. --units 3M.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-unquoted\fP \fB--unquoted\fP
.br .br
When used with \-\-nameprefixes, output values in the field=value When used with --nameprefixes, output values in the field=value
pairs are not quoted. pairs are not quoted.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -493,7 +493,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGSCAN 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgscan \- Search for all volume groups vgscan - Search for all volume groups
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgscan\fP \fBvgscan\fP
@ -14,27 +14,27 @@ vgscan scans all supported LVM block devices in the system for VGs.
.br .br
.RS 4 .RS 4
.ad l .ad l
[ \fB-P\fP|\fB\-\-partial\fP ] [ \fB-P\fP|\fB--partial\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-cache\fP ] [ \fB--cache\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-ignorelockingfailure\fP ] [ \fB--ignorelockingfailure\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-mknodes\fP ] [ \fB--mknodes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-notifydbus\fP ] [ \fB--notifydbus\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP ] [ \fB--reportformat\fP \fBbasic\fP|\fBjson\fP ]
.ad b .ad b
.br .br
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -45,70 +45,70 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-cache\fP \fB--cache\fP
.br .br
Scan all devices and send the metadata to lvmetad. Scan all devices and send the metadata to lvmetad.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -117,47 +117,47 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-ignorelockingfailure\fP \fB--ignorelockingfailure\fP
.br .br
Allows a command to continue with read-only metadata Allows a command to continue with read-only metadata
operations after locking failures. operations after locking failures.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-mknodes\fP \fB--mknodes\fP
.br .br
Also checks the LVM special files in /dev that are needed for active Also checks the LVM special files in /dev that are needed for active
LVs and creates any missing ones and removes unused ones. LVs and creates any missing ones and removes unused ones.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-notifydbus\fP \fB--notifydbus\fP
.br .br
Send a notification to D-Bus. The command will exit with an error Send a notification to D-Bus. The command will exit with an error
if LVM is not built with support for D-Bus notification, or if the if LVM is not built with support for D-Bus notification, or if the
@ -165,7 +165,7 @@ notify_dbus config setting is disabled.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-P\fP|\fB\-\-partial\fP \fB-P\fP|\fB--partial\fP
.br .br
When set, the tools will do their best to provide access to VGs When set, the tools will do their best to provide access to VGs
that are only partially available (one or more PVs belonging that are only partially available (one or more PVs belonging
@ -174,21 +174,21 @@ changed with this option.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP \fB--reportformat\fP \fBbasic\fP|\fBjson\fP
.br .br
Overrides current output format for reports which is defined globally by Overrides current output format for reports which is defined globally by
the report/output_format setting in lvm.conf. the report/output_format setting in lvm.conf.
@ -199,7 +199,7 @@ output in JSON format. See \fBlvmreport\fP(7) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -209,20 +209,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -244,7 +244,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.

View File

@ -1,6 +1,6 @@
.TH VGSPLIT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." .TH VGSPLIT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
.SH NAME .SH NAME
vgsplit \- Move physical volumes into a new or existing volume group vgsplit - Move physical volumes into a new or existing volume group
. .
.SH SYNOPSIS .SH SYNOPSIS
\fBvgsplit\fP \fIoption_args\fP \fIposition_args\fP \fBvgsplit\fP \fIoption_args\fP \fIposition_args\fP
@ -35,7 +35,7 @@ Split a VG by specified PVs.
Split a VG by PVs in a specified LV. Split a VG by PVs in a specified LV.
.br .br
.P .P
\fBvgsplit\fP \fB-n\fP|\fB\-\-name\fP \fILV\fP \fIVG\fP \fIVG\fP \fBvgsplit\fP \fB-n\fP|\fB--name\fP \fILV\fP \fIVG\fP \fIVG\fP
.br .br
.RS 4 .RS 4
[ COMMON_OPTIONS ] [ COMMON_OPTIONS ]
@ -46,31 +46,31 @@ Common options for command:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ] [ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP ] [ \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-l\fP|\fB\-\-maxlogicalvolumes\fP \fINumber\fP ] [ \fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP ] [ \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ] [ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ] [ \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP ] [ \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP ]
.ad b .ad b
.RE .RE
@ -78,57 +78,57 @@ Common options for lvm:
. .
.RS 4 .RS 4
.ad l .ad l
[ \fB-d\fP|\fB\-\-debug\fP ] [ \fB-d\fP|\fB--debug\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-h\fP|\fB\-\-help\fP ] [ \fB-h\fP|\fB--help\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-q\fP|\fB\-\-quiet\fP ] [ \fB-q\fP|\fB--quiet\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-t\fP|\fB\-\-test\fP ] [ \fB-t\fP|\fB--test\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-v\fP|\fB\-\-verbose\fP ] [ \fB-v\fP|\fB--verbose\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB-y\fP|\fB\-\-yes\fP ] [ \fB-y\fP|\fB--yes\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-commandprofile\fP \fIString\fP ] [ \fB--commandprofile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-config\fP \fIString\fP ] [ \fB--config\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ] [ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-longhelp\fP ] [ \fB--longhelp\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-profile\fP \fIString\fP ] [ \fB--profile\fP \fIString\fP ]
.ad b .ad b
.br .br
.ad l .ad l
[ \fB\-\-version\fP ] [ \fB--version\fP ]
.ad b .ad b
.RE .RE
.SH OPTIONS .SH OPTIONS
.HP .HP
.ad l .ad l
\fB\-\-alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP \fB--alloc\fP \fBcontiguous\fP|\fBcling\fP|\fBcling_by_tags\fP|\fBnormal\fP|\fBanywhere\fP|\fBinherit\fP
.br .br
Determines the allocation policy when a command needs to allocate Determines the allocation policy when a command needs to allocate
Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy
@ -149,27 +149,27 @@ See \fBlvm\fP(8) for more information about allocation.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
.br .br
Specifies if metadata should be backed up automatically after a change. Specifies if metadata should be backed up automatically after a change.
Enabling this is strongly advised! See vgcfgbackup(8) for more information. Enabling this is strongly advised! See vgcfgbackup(8) for more information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP \fB-c\fP|\fB--clustered\fP \fBy\fP|\fBn\fP
.br .br
Specifies the clustered property of the new VG. Specifies the clustered property of the new VG.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-commandprofile\fP \fIString\fP \fB--commandprofile\fP \fIString\fP
.br .br
The command profile to use for command configuration. The command profile to use for command configuration.
See \fBlvm.conf\fP(5) for more information about profiles. See \fBlvm.conf\fP(5) for more information about profiles.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-config\fP \fIString\fP \fB--config\fP \fIString\fP
.br .br
Config settings for the command. These override lvm.conf settings. Config settings for the command. These override lvm.conf settings.
The String arg uses the same format as lvm.conf, The String arg uses the same format as lvm.conf,
@ -178,48 +178,48 @@ See \fBlvm.conf\fP(5) for more information about config.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-d\fP|\fB\-\-debug\fP ... \fB-d\fP|\fB--debug\fP ...
.br .br
Set debug level. Repeat from 1 to 6 times to increase the detail of Set debug level. Repeat from 1 to 6 times to increase the detail of
messages sent to the log file and/or syslog (if configured). messages sent to the log file and/or syslog (if configured).
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP \fB--driverloaded\fP \fBy\fP|\fBn\fP
.br .br
If set to no, the command will not attempt to use device-mapper. If set to no, the command will not attempt to use device-mapper.
For testing and debugging. For testing and debugging.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-h\fP|\fB\-\-help\fP \fB-h\fP|\fB--help\fP
.br .br
Display help text. Display help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-longhelp\fP \fB--longhelp\fP
.br .br
Display long help text. Display long help text.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-l\fP|\fB\-\-maxlogicalvolumes\fP \fINumber\fP \fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP
.br .br
Sets the maximum number of LVs allowed in a VG. Sets the maximum number of LVs allowed in a VG.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP
.br .br
Sets the maximum number of PVs that can belong to the VG. Sets the maximum number of PVs that can belong to the VG.
The value 0 removes any limitation. The value 0 removes any limitation.
For large numbers of PVs, also see options \-\-pvmetadatacopies, For large numbers of PVs, also see options --pvmetadatacopies,
and \-\-vgmetadatacopies for improving performance. and --vgmetadatacopies for improving performance.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-M\fP|\fB\-\-metadatatype\fP \fBlvm2\fP|\fBlvm1\fP \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP|\fBlvm1\fP
.br .br
Specifies the type of on-disk metadata to use. Specifies the type of on-disk metadata to use.
\fBlvm2\fP (or just \fB2\fP) is the current, standard format. \fBlvm2\fP (or just \fB2\fP) is the current, standard format.
@ -228,27 +228,27 @@ can be used for accessing old data.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-n\fP|\fB\-\-name\fP \fIString\fP \fB-n\fP|\fB--name\fP \fIString\fP
.br .br
Move only PVs used by the named LV. Move only PVs used by the named LV.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-profile\fP \fIString\fP \fB--profile\fP \fIString\fP
.br .br
An alias for \-\-commandprofile or \-\-metadataprofile, depending An alias for --commandprofile or --metadataprofile, depending
on the command. on the command.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-q\fP|\fB\-\-quiet\fP ... \fB-q\fP|\fB--quiet\fP ...
.br .br
Suppress output and log messages. Overrides \-\-debug and \-\-verbose. Suppress output and log messages. Overrides --debug and --verbose.
Repeat once to also suppress any prompts with answer no. Repeat once to also suppress any prompts with answer no.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-t\fP|\fB\-\-test\fP \fB-t\fP|\fB--test\fP
.br .br
Run in test mode. Commands will not update metadata. Run in test mode. Commands will not update metadata.
This is implemented by disabling all metadata writing but nevertheless This is implemented by disabling all metadata writing but nevertheless
@ -258,20 +258,20 @@ back metadata it believes has changed but hasn't.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-v\fP|\fB\-\-verbose\fP ... \fB-v\fP|\fB--verbose\fP ...
.br .br
Set verbose level. Repeat from 1 to 4 times to increase the detail Set verbose level. Repeat from 1 to 4 times to increase the detail
of messages sent to stdout and stderr. of messages sent to stdout and stderr.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-version\fP \fB--version\fP
.br .br
Display version information. Display version information.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB\-\-[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP \fB--[vg]metadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP
.br .br
Number of copies of the VG metadata that are kept. Number of copies of the VG metadata that are kept.
VG metadata is kept in VG metadata areas on PVs in the VG, VG metadata is kept in VG metadata areas on PVs in the VG,
@ -289,7 +289,7 @@ all PVs, and then to become unmanaged.
.ad b .ad b
.HP .HP
.ad l .ad l
\fB-y\fP|\fB\-\-yes\fP \fB-y\fP|\fB--yes\fP
.br .br
Do not prompt for confirmation interactively but always assume the Do not prompt for confirmation interactively but always assume the
answer yes. Use with extreme caution. answer yes. Use with extreme caution.
@ -325,7 +325,7 @@ UNIT represents other possible input units: \fBbBsSkKmMgGtTpPeE\fP.
b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes, b|B is bytes, s|S is sectors of 512 bytes, k|K is kilobytes,
m|M is megabytes, g|G is gigabytes, t|T is terabytes, m|M is megabytes, g|G is gigabytes, t|T is terabytes,
p|P is petabytes, e|E is exabytes. p|P is petabytes, e|E is exabytes.
(This should not be confused with the output control \-\-units, where (This should not be confused with the output control --units, where
capital letters mean multiple of 1000.) capital letters mean multiple of 1000.)
.SH ENVIRONMENT VARIABLES .SH ENVIRONMENT VARIABLES
See \fBlvm\fP(8) for information about environment variables used by lvm. See \fBlvm\fP(8) for information about environment variables used by lvm.