lvmdump(8) — Linux manual page

LVMDUMP(8)               System Manager's Manual              LVMDUMP(8)

NAME

       lvmdump — create lvm2 information dumps for diagnostic purposes

SYNOPSIS

       lvmdump [-a] [-c] [-d directory] [-h] [-l] [-m] [-p] [-s] [-u]

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.

       The content of the tarball is as follows:
       • dmsetup info
       • table of currently running processes
       • recent entries from /var/log/messages (containing system
         messages)
       • complete lvm configuration and cache (content of /etc/lvm)
       • list of device nodes present under /dev
       • list of files present /sys/block
       • list of files present /sys/devices/virtual/block
       • if enabled with -m, metadata dump will be also included
       • if enabled with -a, debug output of vgscan, pvscan and list of
         all available volume groups, physical volumes and logical
         volumes will be included
       • if enabled with -l, lvmetad state if running
       • if enabled with -p, lvmpolld state if running
       • if enabled with -s, system info and context
       • if enabled with -u, udev info and context

OPTIONS

       -a     Advanced collection.  WARNING: if lvm is already hung,
              then this script may hang as well if -a is used.

       -d directory
              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
              directory.

       -h     Print help message

       -l     Include lvmetad(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.

       -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.

       -p     Include lvmpolld(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.

       -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.

       -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).

ENVIRONMENT VARIABLES

       LVM_BINARY
              The LVM2 binary to use.  Defaults to "lvm".  Sometimes you
              might need to set this to "/bin/lvm.static", for example.

       DMSETUP_BINARY
              The dmsetup binary to use.  Defaults to "dmsetup".

SEE ALSO

       lvm(8), lvmpolld(8),

       udev(8), udevadm(8)

COLOPHON

       This page is part of the lvm2 (Logical Volume Manager 2) project.
       Information about the project can be found at 
       ⟨http://www.sourceware.org/lvm2/⟩.  If you have a bug report for
       this manual page, see ⟨https://github.com/lvmteam/lvm2/issues⟩.
       This page was obtained from the project's upstream Git repository
       ⟨git://sourceware.org/git/lvm2.git⟩ on 2024-06-14.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2024-06-11.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

Red Hat, Inc.     LVM TOOLS 2.03.25(2)-git (2024-05-16)       LVMDUMP(8)

Pages that refer to this page: lvchange(8), lvconvert(8), lvcreate(8), lvdisplay(8), lvextend(8), lvm(8), lvmconfig(8), lvmdevices(8), lvmdiskscan(8), lvm-fullreport(8), lvm-lvpoll(8), lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8), pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8), pvremove(8), pvresize(8), pvs(8), pvscan(8), vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgconvert(8), vgcreate(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8), vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8), vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8)

---