dwww Home | Manual pages | Find package

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 de-
       fault, it creates a tarball suitable for submission along with a  prob-
       lem 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 in-
              formation. Using this option, it can be instructed to only  pro-
              duce the raw dump tree, rooted in directory.

       -h     Print help message

       -l     Include  lvmetad(8)  daemon dump if it is running. The dump con-
              tains 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.  How-
              ever,  the metadata dump may represent a valuable diagnostic re-
              source.

       -p     Include lvmpolld(8) daemon dump if it is running. The dump  con-
              tains  all in-progress operation currently monitored by the dae-
              mon 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 "/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)

Generated by dwww version 1.16 on Tue Dec 16 14:36:24 CET 2025.