diff options
Diffstat (limited to 'man/vgsplit.8_pregen')
| -rw-r--r-- | man/vgsplit.8_pregen | 371 |
1 files changed, 371 insertions, 0 deletions
diff --git a/man/vgsplit.8_pregen b/man/vgsplit.8_pregen new file mode 100644 index 0000000..b128fb8 --- /dev/null +++ b/man/vgsplit.8_pregen @@ -0,0 +1,371 @@ +.TH VGSPLIT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." +. +.SH NAME +. +vgsplit \(em Move physical volumes into a new or existing volume group +. +.SH SYNOPSIS +. +\fBvgsplit\fP \fIoption_args\fP \fIposition_args\fP +.br + [ \fIoption_args\fP ] +.br +. +.SH DESCRIPTION +. +vgsplit moves one or more PVs from a source VG (the first VG arg) to a +destination VG (the second VG arg). The PV(s) to move are named after the +source and destination VGs, or an LV is named, in which case the PVs +underlying the LV are moved. +.P +If the destination VG does not exist, a new VG is created (command options +can be used to specify properties of the new VG, also see +\fBvgcreate\fP(8)). +.P +LVs cannot be split between VGs; each LV must be entirely on the PVs in +the source or destination VG. +.P +vgsplit can only move complete PVs. (See \fBpvmove\fP(8) for moving part +of a PV.) +. +.SH USAGE +. +Split a VG by specified PVs. +.br +.P +\fBvgsplit\fP \fIVG\fP \fIVG\fP \fIPV\fP ... +.br +.RS 4 +.ad l +[ COMMON_OPTIONS ] +.ad b +.RE +.P +Split a VG by PVs in a specified LV. +.br +.P +\fBvgsplit\fP \fB-n\fP|\fB--name\fP \fILV\fP \fIVG\fP \fIVG\fP +.br +.RS 4 +.ad l +[ COMMON_OPTIONS ] +.ad b +.RE +.P +Common options for command: +. +.RS 4 +.ad l +[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ] +.br +[ \fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP ] +.br +[ \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP ] +.br +[ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP ] +.br +[ \fB--alloc\fP \c +.nh +\%\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP +.hy +] +.br +[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ] +.br +[ \fB--\fP[\fBvg\fP]\fBmetadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP ] +.ad b +.RE +.P +Common options for lvm: +. +.RS 4 +.ad l +[ \fB-d\fP|\fB--debug\fP ] +.br +[ \fB-h\fP|\fB--help\fP ] +.br +[ \fB-q\fP|\fB--quiet\fP ] +.br +[ \fB-t\fP|\fB--test\fP ] +.br +[ \fB-v\fP|\fB--verbose\fP ] +.br +[ \fB-y\fP|\fB--yes\fP ] +.br +[ \fB--commandprofile\fP \fIString\fP ] +.br +[ \fB--config\fP \fIString\fP ] +.br +[ \fB--devices\fP \fIPV\fP ] +.br +[ \fB--devicesfile\fP \fIString\fP ] +.br +[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ] +.br +[ \fB--journal\fP \fIString\fP ] +.br +[ \fB--lockopt\fP \fIString\fP ] +.br +[ \fB--longhelp\fP ] +.br +[ \fB--nohints\fP ] +.br +[ \fB--nolocking\fP ] +.br +[ \fB--profile\fP \fIString\fP ] +.br +[ \fB--version\fP ] +.ad b +.RE +. +.SH OPTIONS +. +. +.HP +.ad l +\fB--alloc\fP \c +.nh +\%\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP +.hy +.ad b +.br +Determines the allocation policy when a command needs to allocate +Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy +which can be changed with vgchange/lvchange, or overridden on the +command line. +\fBnormal\fP applies common sense rules such as not placing parallel stripes +on the same PV. +\fBinherit\fP applies the VG policy to an LV. +\fBcontiguous\fP requires new PEs be placed adjacent to existing PEs. +\fBcling\fP places new PEs on the same PV as existing PEs in the same +stripe of the LV. +If there are sufficient PEs for an allocation, but normal does not +use them, \fBanywhere\fP will use them even if it reduces performance, +e.g. by placing two stripes on the same PV. +Optional positional PV args on the command line can also be used to limit +which PVs the command will use for allocation. +See \fBlvm\fP(8) for more information about allocation. +. +.HP +\fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP +.br +Specifies if metadata should be backed up automatically after a change. +Enabling this is strongly advised! See \fBvgcfgbackup\fP(8) for more information. +. +.HP +\fB--commandprofile\fP \fIString\fP +.br +The command profile to use for command configuration. +See \fBlvm.conf\fP(5) for more information about profiles. +. +.HP +\fB--config\fP \fIString\fP +.br +Config settings for the command. These override \fBlvm.conf\fP(5) settings. +The String arg uses the same format as \fBlvm.conf\fP(5), +or may use section/field syntax. +See \fBlvm.conf\fP(5) for more information about config. +. +.HP +\fB-d\fP|\fB--debug\fP ... +.br +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). +. +.HP +\fB--devices\fP \fIPV\fP +.br +Restricts the devices that are visible and accessible to the command. +Devices not listed will appear to be missing. This option can be +repeated, or accepts a comma separated list of devices. This overrides +the devices file. +. +.HP +\fB--devicesfile\fP \fIString\fP +.br +A file listing devices that LVM should use. +The file must exist in \fI#DEFAULT_SYS_DIR#/devices/\fP and is managed +with the \fBlvmdevices\fP(8) command. +This overrides the \fBlvm.conf\fP(5) \fBdevices/devicesfile\fP and +\fBdevices/use_devicesfile\fP settings. +. +.HP +\fB--driverloaded\fP \fBy\fP|\fBn\fP +.br +If set to no, the command will not attempt to use device-mapper. +For testing and debugging. +. +.HP +\fB-h\fP|\fB--help\fP +.br +Display help text. +. +.HP +\fB--journal\fP \fIString\fP +.br +Record information in the systemd journal. +This information is in addition to information +enabled by the lvm.conf log/journal setting. +command: record information about the command. +output: record the default command output. +debug: record full command debugging. +. +.HP +\fB--lockopt\fP \fIString\fP +.br +Used to pass options for special cases to lvmlockd. +See \fBlvmlockd\fP(8) for more information. +. +.HP +\fB--longhelp\fP +.br +Display long help text. +. +.HP +\fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP +.br +Sets the maximum number of LVs allowed in a VG. +. +.HP +\fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP +.br +Sets the maximum number of PVs that can belong to the VG. +The value 0 removes any limitation. +For large numbers of PVs, also see options --pvmetadatacopies, +and --vgmetadatacopies for improving performance. +. +.HP +\fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP +.br +Specifies the type of on-disk metadata to use. +\fBlvm2\fP (or just \fB2\fP) is the current, standard format. +\fBlvm1\fP (or just \fB1\fP) is no longer used. +. +.HP +\fB-n\fP|\fB--name\fP \fIString\fP +.br +Move only PVs used by the named LV. +. +.HP +\fB--nohints\fP +.br +Do not use the hints file to locate devices for PVs. A command may read +more devices to find PVs when hints are not used. The command will still +perform standard hint file invalidation where appropriate. +. +.HP +\fB--nolocking\fP +.br +Disable locking. Use with caution, concurrent commands may produce +incorrect results. +. +.HP +\fB--poolmetadataspare\fP \fBy\fP|\fBn\fP +.br +Enable or disable the automatic creation and management of a +spare pool metadata LV in the VG. A spare metadata LV is reserved +space that can be used when repairing a pool. +. +.HP +\fB--profile\fP \fIString\fP +.br +An alias for --commandprofile or --metadataprofile, depending +on the command. +. +.HP +\fB-q\fP|\fB--quiet\fP ... +.br +Suppress output and log messages. Overrides --debug and --verbose. +Repeat once to also suppress any prompts with answer 'no'. +. +.HP +\fB-t\fP|\fB--test\fP +.br +Run in test mode. Commands will not update metadata. +This is implemented by disabling all metadata writing but nevertheless +returning success to the calling function. This may lead to unusual +error messages in multi-stage operations if a tool relies on reading +back metadata it believes has changed but hasn't. +. +.HP +\fB-v\fP|\fB--verbose\fP ... +.br +Set verbose level. Repeat from 1 to 4 times to increase the detail +of messages sent to stdout and stderr. +. +.HP +\fB--version\fP +.br +Display version information. +. +.HP +\fB--\fP[\fBvg\fP]\fBmetadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP +.br +Number of copies of the VG metadata that are kept. +VG metadata is kept in VG metadata areas on PVs in the VG, +i.e. reserved space at the start and/or end of the PVs. +Keeping a copy of the VG metadata on every PV can reduce performance +in VGs containing a large number of PVs. +When this number is set to a non-zero value, LVM will automatically +choose PVs on which to store metadata, using the metadataignore flags +on PVs to achieve the specified number. +The number can also be replaced with special string values: +\fBunmanaged\fP causes LVM to not automatically manage the PV +metadataignore flags. +\fBall\fP causes LVM to first clear the metadataignore flags on +all PVs, and then to become unmanaged. +. +.HP +\fB-y\fP|\fB--yes\fP +.br +Do not prompt for confirmation interactively but always assume the +answer yes. Use with extreme caution. +(For automatic no, see -qq.) +. +.SH VARIABLES +. +.TP +.I VG +Volume Group name. See \fBlvm\fP(8) for valid names. +.TP +.I PV +Physical Volume name, a device path under /dev. +For commands managing physical extents, a PV positional arg +generally accepts a suffix indicating a range (or multiple ranges) +of physical extents (PEs). When the first PE is omitted, it defaults +to the start of the device, and when the last PE is omitted it defaults to end. +Start and end range (inclusive): \fIPV\fP[\fB:\fP\fIPE\fP\fB-\fP\fIPE\fP]... +Start and length range (counting from 0): \fIPV\fP[\fB:\fP\fIPE\fP\fB+\fP\fIPE\fP]... +.TP +.I String +See the option description for information about the string content. +.TP +.IR Size [UNIT] +Size is an input number that accepts an optional unit. +Input units are always treated as base two values, regardless of +capitalization, e.g. 'k' and 'K' both refer to 1024. +The default input unit is specified by letter, followed by |UNIT. +UNIT represents other possible input units: +.BR b | B +is bytes, +.BR s | S +is sectors of 512 bytes, +.BR k | K +is KiB, +.BR m | M +is MiB, +.BR g | G +is GiB, +.BR t | T +is TiB, +.BR p | P +is PiB, +.BR e | E +is EiB. +(This should not be confused with the output control --units, where +capital letters mean multiple of 1000.) +. +.SH ENVIRONMENT VARIABLES +. +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. |