make: generate

1 files changed, 114 insertions, 237 deletions

diff --git a/man/lvmdevices.8_pregen b/man/lvmdevices.8_pregen
index 6bdb5ff26..267ce965f 100644
--- a/man/lvmdevices.8_pregen
+++ b/man/lvmdevices.8_pregen
@@ -1,8 +1,11 @@
 .TH LVMDEVICES 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
+.
 .SH NAME
-lvmdevices - Manage the devices file
+.
+lvmdevices \(em Manage the devices file
 .
 .SH SYNOPSIS
+.
 \fBlvmdevices\fP \fIoption_args\fP
 .br
     [ \fIoption_args\fP ]
@@ -10,108 +13,68 @@ lvmdevices - Manage the devices file
 .P
 .ad l
     \fB--adddev\fP \fIPV\fP
-.ad b
 .br
-.ad l
     \fB--addpvid\fP \fIString\fP
-.ad b
 .br
-.ad l
     \fB--check\fP
-.ad b
 .br
-.ad l
     \fB--commandprofile\fP \fIString\fP
-.ad b
 .br
-.ad l
     \fB--config\fP \fIString\fP
-.ad b
 .br
-.ad l
  \fB-d\fP|\fB--debug\fP
-.ad b
 .br
-.ad l
     \fB--deldev\fP \fIPV\fP
-.ad b
 .br
-.ad l
     \fB--delpvid\fP \fIString\fP
-.ad b
 .br
-.ad l
     \fB--devices\fP \fIPV\fP
-.ad b
 .br
-.ad l
     \fB--devicesfile\fP \fIString\fP
-.ad b
 .br
-.ad l
     \fB--driverloaded\fP \fBy\fP|\fBn\fP
-.ad b
 .br
-.ad l
  \fB-h\fP|\fB--help\fP
-.ad b
 .br
-.ad l
     \fB--lockopt\fP \fIString\fP
-.ad b
 .br
-.ad l
     \fB--longhelp\fP
-.ad b
 .br
-.ad l
     \fB--nolocking\fP
-.ad b
 .br
-.ad l
     \fB--profile\fP \fIString\fP
-.ad b
 .br
-.ad l
  \fB-q\fP|\fB--quiet\fP
-.ad b
 .br
-.ad l
  \fB-t\fP|\fB--test\fP
-.ad b
 .br
-.ad l
     \fB--update\fP
-.ad b
 .br
-.ad l
  \fB-v\fP|\fB--verbose\fP
-.ad b
 .br
-.ad l
     \fB--version\fP
-.ad b
 .br
-.ad l
  \fB-y\fP|\fB--yes\fP
 .ad b
+.
 .SH DESCRIPTION
+.
 The LVM devices file lists devices that lvm can use.  The default file is
-/etc/lvm/devices/system.devices, and the lvmdevices(8) command is used to
+\fI#DEFAULT_SYS_DIR#/devices/system.devices\fP, and the \fBlvmdevices\fP(8) command is used to
 add or remove device entries.  If the file does not exist, or if lvm.conf
 includes use_devicesfile=0, then lvm will not use a devices file.
-
+.P
 To use a device with lvm, add it to the devices file with the command
 lvmdevices --adddev, and to prevent lvm from seeing or using a device,
 remove it from the devices file with lvmdevices --deldev.  The
 vgimportdevices(8) command adds all PVs from a VG to the devices file,
 and updates the VG metadata to include device IDs of the PVs.
-
+.P
 Commands adding new devices to the devices file necessarily look outside
 the existing devices file to find the devices to add.  pvcreate, vgcreate,
 and vgextend also look outside the devices file to create new PVs and add
 them to the devices file.
-
+.P
 LVM records devices in the devices file using hardware-specific IDs, such
 as the WWID, and attempts to use subsystem-specific IDs for virtual device
 types (which also aim to be as unique and stable as possible.)
@@ -119,436 +82,350 @@ These device IDs are also written in the VG metadata.  When no hardware or
 virtual ID is available, lvm falls back using the unstable device name as
 the device ID.  When devnames are used, lvm performs extra scanning to
 find devices if their devname changes, e.g. after reboot.
-
+.P
 When proper device IDs are used, an lvm command will not look at devices
 outside the devices file, but when devnames are used as a fallback, lvm
 will scan devices outside the devices file to locate PVs on renamed
 devices.  A config setting search_for_devnames can be used to control the
 scanning for renamed devname entries.
-
+.P
 Related to the devices file, the new command option --devices <devnames>
 allows a list of devices to be specified for the command to use,
 overriding the devices file.  The listed devices act as a sort of devices
 file in terms of limiting which devices lvm will see and use.  Devices
 that are not listed will appear to be missing to the lvm command.
-    
-Multiple devices files can be kept in /etc/lvm/devices, which allows lvm
+.P
+Multiple devices files can be kept in \fI#DEFAULT_SYS_DIR#/devices\fP, which allows lvm
 to be used with different sets of devices, e.g. system devices do not need
 to be exposed to a specific application, and the application can use lvm on
 its own devices that are not exposed to the system.  The option
 --devicesfile <filename> is used to select the devices file to use with the
 command.  Without the option set, the default system devices file is used.
-
+.P
 Setting --devicesfile "" causes lvm to not use a devices file.
-
+.P
 With no devices file, lvm will use any device on the system, and applies
 the filter to limit the full set of system devices.  With a devices file,
 the regex filter is not used, and the filter settings in lvm.conf or the
 command line are ignored.  The vgimportdevices command is one exception
 which does apply the regex filter when looking for a VG to import.
-
+.P
 If a devices file exists, lvm will use it, even if it's empty.  An empty
 devices file means lvm will see no devices.
-
+.P
 If the system devices file does not yet exist, the pvcreate or vgcreate
 commands will create it if they see no existing VGs on the system.
 lvmdevices --addev and vgimportdevices will always create a new devices file
 if it does not yet exist.
-
+.P
 It is recommended to use lvm commands to make changes to the devices file to
 ensure proper updates.
-
+.
 .SH USAGE
+.
 Print devices in the devices file.
 .br
 .P
 \fBlvmdevices\fP
 .br
 .RS 4
+.ad l
 [ COMMON_OPTIONS ]
+.ad b
 .RE
-.br
--
-
+.P
+\(em
+.P
 Check the devices file and report incorrect values.
 .br
 .P
 \fBlvmdevices\fP \fB--check\fP
 .br
 .RS 4
+.ad l
 [ COMMON_OPTIONS ]
+.ad b
 .RE
-.br
--
-
+.P
+\(em
+.P
 Update the devices file to fix incorrect values.
 .br
 .P
 \fBlvmdevices\fP \fB--update\fP
 .br
 .RS 4
+.ad l
 [ COMMON_OPTIONS ]
+.ad b
 .RE
-.br
--
-
+.P
+\(em
+.P
 Add a device to the devices file.
 .br
 .P
 \fBlvmdevices\fP \fB--adddev\fP \fIPV\fP
 .br
 .RS 4
+.ad l
 [ COMMON_OPTIONS ]
+.ad b
 .RE
-.br
--
-
+.P
+\(em
+.P
 Remove a device from the devices file.
 .br
 .P
 \fBlvmdevices\fP \fB--deldev\fP \fIPV\fP
 .br
 .RS 4
+.ad l
 [ COMMON_OPTIONS ]
+.ad b
 .RE
-.br
--
-
+.P
+\(em
+.P
 Find the device with the given PVID and add it to the devices file.
 .br
 .P
 \fBlvmdevices\fP \fB--addpvid\fP \fIString\fP
 .br
 .RS 4
+.ad l
 [ COMMON_OPTIONS ]
+.ad b
 .RE
-.br
--
-
+.P
+\(em
+.P
 Remove the devices file entry for the given PVID.
 .br
 .P
 \fBlvmdevices\fP \fB--delpvid\fP \fIString\fP
 .br
 .RS 4
+.ad l
 [ COMMON_OPTIONS ]
+.ad b
 .RE
-.br
--
-
+.P
+\(em
+.P
 Common options for command:
 .
 .RS 4
+.ad l
+.ad b
 .RE
-
+.P
 Common options for lvm:
 .
 .RS 4
 .ad l
 [ \fB-d\fP|\fB--debug\fP ]
-.ad b
 .br
-.ad l
 [ \fB-h\fP|\fB--help\fP ]
-.ad b
 .br
-.ad l
 [ \fB-q\fP|\fB--quiet\fP ]
-.ad b
 .br
-.ad l
 [ \fB-t\fP|\fB--test\fP ]
-.ad b
 .br
-.ad l
 [ \fB-v\fP|\fB--verbose\fP ]
-.ad b
 .br
-.ad l
 [ \fB-y\fP|\fB--yes\fP ]
-.ad b
 .br
-.ad l
 [    \fB--commandprofile\fP \fIString\fP ]
-.ad b
 .br
-.ad l
 [    \fB--config\fP \fIString\fP ]
-.ad b
 .br
-.ad l
 [    \fB--devices\fP \fIPV\fP ]
-.ad b
 .br
-.ad l
 [    \fB--devicesfile\fP \fIString\fP ]
-.ad b
 .br
-.ad l
 [    \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
-.ad b
 .br
-.ad l
 [    \fB--lockopt\fP \fIString\fP ]
-.ad b
 .br
-.ad l
 [    \fB--longhelp\fP ]
-.ad b
 .br
-.ad l
 [    \fB--nolocking\fP ]
-.ad b
 .br
-.ad l
 [    \fB--profile\fP \fIString\fP ]
-.ad b
 .br
-.ad l
 [    \fB--version\fP ]
 .ad b
 .RE
+.
 .SH OPTIONS
+.
+.
 .HP
-.ad l
 \fB--adddev\fP \fIPV\fP
 .br
-.ad b
 Add a device to the devices file.
+.
 .HP
-.ad l
 \fB--addpvid\fP \fIString\fP
 .br
-.ad b
 Find a device with the PVID and add the device to the devices file.
+.
 .HP
-.ad l
 \fB--check\fP
 .br
-.ad b
 Check the content of the devices file.
+.
 .HP
-.ad l
 \fB--commandprofile\fP \fIString\fP
 .br
-.ad b
 The command profile to use for command configuration.
 See \fBlvm.conf\fP(5) for more information about profiles.
+.
 .HP
-.ad l
 \fB--config\fP \fIString\fP
 .br
-.ad b
-Config settings for the command. These override lvm.conf settings.
-The String arg uses the same format as lvm.conf,
+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
-.ad l
 \fB-d\fP|\fB--debug\fP ...
 .br
-.ad b
 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
-.ad l
 \fB--deldev\fP \fIPV\fP
 .br
-.ad b
 Remove a device from the devices file.
+.
 .HP
-.ad l
 \fB--delpvid\fP \fIString\fP
 .br
-.ad b
 Remove a device with the PVID from the devices file.
+.
 .HP
-.ad l
 \fB--devices\fP \fIPV\fP
 .br
-.ad b
 Devices that the command can use. This option can be repeated
 or accepts a comma separated list of devices. This overrides
 the devices file.
+.
 .HP
-.ad l
 \fB--devicesfile\fP \fIString\fP
 .br
-.ad b
 A file listing devices that LVM should use.
-The file must exist in /etc/lvm/devices/ and is managed
-with the lvmdevices(8) command.
-This overrides the lvm.conf devices/devicesfile and
-devices/use_devicesfile settings.
+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
-.ad l
 \fB--driverloaded\fP \fBy\fP|\fBn\fP
 .br
-.ad b
 If set to no, the command will not attempt to use device-mapper.
 For testing and debugging.
+.
 .HP
-.ad l
 \fB-h\fP|\fB--help\fP
 .br
-.ad b
 Display help text.
+.
 .HP
-.ad l
 \fB--lockopt\fP \fIString\fP
 .br
-.ad b
 Used to pass options for special cases to lvmlockd.
 See \fBlvmlockd\fP(8) for more information.
+.
 .HP
-.ad l
 \fB--longhelp\fP
 .br
-.ad b
 Display long help text.
+.
 .HP
-.ad l
 \fB--nolocking\fP
 .br
-.ad b
 Disable locking.
+.
 .HP
-.ad l
 \fB--profile\fP \fIString\fP
 .br
-.ad b
 An alias for --commandprofile or --metadataprofile, depending
 on the command.
+.
 .HP
-.ad l
 \fB-q\fP|\fB--quiet\fP ...
 .br
-.ad b
 Suppress output and log messages. Overrides --debug and --verbose.
 Repeat once to also suppress any prompts with answer 'no'.
+.
 .HP
-.ad l
 \fB-t\fP|\fB--test\fP
 .br
-.ad b
 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
-.ad l
 \fB--update\fP
 .br
-.ad b
 Update the content of the devices file.
+.
 .HP
-.ad l
 \fB-v\fP|\fB--verbose\fP ...
 .br
-.ad b
 Set verbose level. Repeat from 1 to 4 times to increase the detail
 of messages sent to stdout and stderr.
+.
 .HP
-.ad l
 \fB--version\fP
 .br
-.ad b
 Display version information.
+.
 .HP
-.ad l
 \fB-y\fP|\fB--yes\fP
 .br
-.ad b
 Do not prompt for confirmation interactively but always assume the
 answer yes. Use with extreme caution.
 (For automatic no, see -qq.)
+.
 .SH VARIABLES
-.HP
-\fIString\fP
-.br
+.
+.TP
+.I String
 See the option description for information about the string content.
-.HP
-\fISize\fP[UNIT]
-.br
+.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: \fBbBsSkKmMgGtTpPeE\fP.
-b|B is bytes, s|S is sectors of 512 bytes, k|K is KiB,
-m|M is MiB, g|G is GiB, t|T is TiB, p|P is PiB, e|E is EiB.
+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.
-.SH SEE ALSO
-.nh
-.ad l
-.BR lvm (8),
-.BR lvm.conf (5),
-.BR lvmconfig (8),
-.BR lvmdevices (8),
-
-.BR pvchange (8),
-.BR pvck (8),
-.BR pvcreate (8),
-.BR pvdisplay (8),
-.BR pvmove (8),
-.BR pvremove (8),
-.BR pvresize (8),
-.BR pvs (8),
-.BR pvscan (8),
-
-.BR vgcfgbackup (8),
-.BR vgcfgrestore (8),
-.BR vgchange (8),
-.BR vgck (8),
-.BR vgcreate (8),
-.BR vgconvert (8),
-.BR vgdisplay (8),
-.BR vgexport (8),
-.BR vgextend (8),
-.BR vgimport (8),
-.BR vgimportclone (8),
-.BR vgimportdevices (8),
-.BR vgmerge (8),
-.BR vgmknodes (8),
-.BR vgreduce (8),
-.BR vgremove (8),
-.BR vgrename (8),
-.BR vgs (8),
-.BR vgscan (8),
-.BR vgsplit (8),
-
-.BR lvcreate (8),
-.BR lvchange (8),
-.BR lvconvert (8),
-.BR lvdisplay (8),
-.BR lvextend (8),
-.BR lvreduce (8),
-.BR lvremove (8),
-.BR lvrename (8),
-.BR lvresize (8),
-.BR lvs (8),
-.BR lvscan (8),
-
-.BR lvm-fullreport (8),
-.BR lvm-lvpoll (8),
-.BR lvm2-activation-generator (8),
-.BR blkdeactivate (8),
-.BR lvmdump (8),
-
-.BR dmeventd (8),
-.BR lvmpolld (8),
-.BR lvmlockd (8),
-.BR lvmlockctl (8),
-.BR cmirrord (8),
-.BR lvmdbusd (8),
-
-.BR lvmsystemid (7),
-.BR lvmreport (7),
-.BR lvmraid (7),
-.BR lvmthin (7),
-.BR lvmcache (7)