lvmdump(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT VARIABLES | SEE ALSO | COLOPHON

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

NAME         top

       lvmdump — create lvm2 information dumps for diagnostic purposes

SYNOPSIS         top

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

DESCRIPTION         top

       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         top

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

       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         top

       lvm(8), lvmpolld(8),

       udev(8), udevadm(8)

COLOPHON         top

       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 2025-02-02.  (At that time,
       the date of the most recent commit that was found in the
       repository was 2025-01-31.)  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.31(2)-git (2025-01-14)        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)