man > LVMDUMP(8)

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 tar‐
       ball 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 in‐
              structed 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  con‐
              siderably.  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  uncol‐
              lected 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 direc‐
              tory and dump of current udev database content (the  output  of  'udevadm  info  --ex‐
              port-db' command).

ENVIRONMENT VARIABLES
       LVM_BINARY
              The  LVM2  binary to use.  Defaults to "lvm".  Sometimes you might need to set this to
              "/usr/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)

Red Hat, Inc.                     LVM TOOLS 2.03.16(2) (2022-05-18)                       LVMDUMP(8)