mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
36cac41115
Commitsa29bb6a14b...5c199d99f4narrowed down on addressing the escaping of hyphens in the dynamic creation of manuals whilst avoiding them in creating help texts. This lead to a sequence of slipping through hyphens adrressed by additional patches in aforementioned commit series. On the other hand, postprocessing dynamically man-generator created and statically provided manuals catches all hyphens in need of escaping. Changes: - revert the above commits whilst keeping man-generator streamlining and the detection of any '\' when generating help texts in order to avoid escapes to slip in - Dynamically escape hyphens in manaual pages using sed(1) in the respective Makefile targets - remove any manually added escaping on hyphens from any static manual sources or headers
113 lines
3.4 KiB
Plaintext
113 lines
3.4 KiB
Plaintext
.TH LVMDUMP 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
|
|
.SH NAME
|
|
lvmdump \(em create lvm2 information dumps for diagnostic purposes
|
|
.SH SYNOPSIS
|
|
.B lvmdump
|
|
.RB [ -a ]
|
|
.RB [ -c ]
|
|
.RB [ -d
|
|
.IR directory ]
|
|
.RB [ -h ]
|
|
.RB [ -l ]
|
|
.RB [ -m ]
|
|
.RB [ -p ]
|
|
.RB [ -s ]
|
|
.RB [ -u ]
|
|
.SH DESCRIPTION
|
|
lvmdump is a tool to dump various information concerning LVM2.
|
|
By default, it creates a tarball suitable for submission along
|
|
with a problem report.
|
|
.PP
|
|
The content of the tarball is as follows:
|
|
.br
|
|
- dmsetup info
|
|
.br
|
|
- table of currently running processes
|
|
.br
|
|
- recent entries from /var/log/messages (containing system messages)
|
|
.br
|
|
- complete lvm configuration and cache (content of /etc/lvm)
|
|
.br
|
|
- list of device nodes present under /dev
|
|
.br
|
|
- list of files present /sys/block
|
|
.br
|
|
- list of files present /sys/devices/virtual/block
|
|
.br
|
|
- if enabled with -m, metadata dump will be also included
|
|
.br
|
|
- if enabled with -a, debug output of vgscan, pvscan and list of all available volume groups, physical volumes and logical volumes will be included
|
|
.br
|
|
- if enabled with -c, cluster status info
|
|
.br
|
|
- if enabled with -l, lvmetad state if running
|
|
.br
|
|
- if enabled with -p, lvmpolld state if running
|
|
.br
|
|
- if enabled with -s, system info and context
|
|
.br
|
|
- if enabled with -u, udev info and context
|
|
.SH OPTIONS
|
|
.TP
|
|
.B -a
|
|
Advanced collection.
|
|
\fBWARNING\fR: if lvm is already hung, then this script may hang as well
|
|
if \fB-a\fR is used.
|
|
.TP
|
|
.B -c
|
|
If clvmd is running, gather cluster data as well.
|
|
.TP
|
|
.B -d \fIdirectory
|
|
Dump into a directory instead of tarball
|
|
By default, lvmdump will produce a single compressed tarball containing
|
|
all the information. Using this option, it can be instructed to only
|
|
produce the raw dump tree, rooted in \fIdirectory\fP.
|
|
.TP
|
|
.B -h
|
|
Print help message
|
|
.TP
|
|
.B -l
|
|
Include \fBlvmetad\fP(8) daemon dump if it is running. The dump contains
|
|
cached information that is currently stored in lvmetad: VG metadata,
|
|
PV metadata and various mappings in between these metadata for quick
|
|
access.
|
|
.TP
|
|
.B -m
|
|
Gather LVM metadata from the PVs
|
|
This option generates a 1:1 dump of the metadata area from all PVs visible
|
|
to the system, which can cause the dump to increase in size considerably.
|
|
However, the metadata dump may represent a valuable diagnostic resource.
|
|
.TP
|
|
.B -p
|
|
Include \fBlvmpolld\fP(8) daemon dump if it is running. The dump contains
|
|
all in-progress operation currently monitored by the daemon and partial
|
|
history for all yet uncollected results of polling operations already finished
|
|
including reason.
|
|
.TP
|
|
.B -s
|
|
Gather system info and context. Currently, this encompasses info gathered
|
|
by calling lsblk command and various systemd info and context: overall state
|
|
of systemd units present in the system, more detailed status of units
|
|
controlling LVM functionality and the content of systemd journal for
|
|
current boot.
|
|
.TP
|
|
.B -u
|
|
Gather udev info and context: /etc/udev/udev.conf file, udev daemon version
|
|
(output of 'udevadm info --version' command), udev rules currently used in the system
|
|
(content of /lib/udev/rules.d and /etc/udev/rules.d directory),
|
|
list of files in /lib/udev directory and dump of current udev
|
|
database content (the output of 'udevadm info --export-db' command).
|
|
.SH ENVIRONMENT VARIABLES
|
|
.TP
|
|
\fBLVM_BINARY\fP
|
|
The LVM2 binary to use.
|
|
Defaults to "lvm".
|
|
Sometimes you might need to set this to "/sbin/lvm.static", for example.
|
|
.TP
|
|
\fBDMSETUP_BINARY\fP
|
|
The dmsetup binary to use.
|
|
Defaults to "dmsetup".
|
|
.PP
|
|
.SH SEE ALSO
|
|
.BR lvm (8)
|