# lvmdump

## 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 mes‐
             sages)
           • 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 vol‐
             umes 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, lvm‐
                  dump will produce a single compressed tarball containing
                  all the information. Using this option, it can be instruct‐
                  ed 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 uncollected re‐
                  sults of polling operations already finished including rea‐
                  son.
    
           **-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 cur‐
                  rent 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** ".
    


* * *