contrib/lvm2/dist/man/lvmdump.8

   1 .\"    $NetBSD: lvmdump.8,v 1.2 2009/02/18 12:16:13 haad Exp $
   2 .\"
   3 .TH LVMDUMP 8 "LVM TOOLS 2.02.44-cvs (02-17-09)" "Red Hat, Inc."
   4 .SH NAME
   5 lvmdump - create lvm2 information dumps for diagnostic purposes
   6 .SH SYNOPSIS
   7 \fBlvmdump\fP [options] [-d directory]
   8 .SH DESCRIPTION
   9 \fBlvmdump\fP is a tool to dump various information concerning LVM2. By default, it creates a tarball suitable for submission along with a problem report.
  10 .PP
  11 The content of the tarball is as follows:
  12 .br
  13 - dmsetup info
  14 .br
  15 - table of currently running processes
  16 .br
  17 - recent entries from /var/log/messages (containing system messages)
  18 .br
  19 - complete lvm configuration and cache
  20 .br
  21 - list of device nodes present under /dev
  22 .br
  23 - if enabled with -m, metadata dump will be also included
  24 .br
  25 - if enabled with -a, debug output of vgscan, pvscan and list of all available volume groups, physical volumes and logical volumes will be included
  26 .br
  27 - if enabled with -c, cluster status info
  28 .SH OPTIONS
  29 .TP
  30 \fB\-h\fR \(em print help message
  31 .TP
  32 \fB\-a\fR \(em advanced collection
  33 \fBWARNING\fR: if lvm is already hung, then this script may hang as well if \fB\-a\fR is used
  34 .TP
  35 \fB\-m\fR \(em gather LVM metadata from the PVs
  36 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.
  37 .TP
  38 \fB\-d\fR directory \(em dump into a directory instead of tarball
  39 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 \fBdirectory\fP.
  40 .TP
  41 \fB\-c\fR \(em if clvmd is running, gather cluster data as well
  42 .SH ENVIRONMENT VARIABLES
  43 .TP
  44 \fBLVM_BINARY\fP
  45 The LVM2 binary to use.
  46 Defaults to "lvm".
  47 Sometimes you might need to set this to "/sbin/lvm.static", for example.
  48 .TP
  49 \fBDMSETUP_BINARY\fP
  50 The dmsetup binary to use.
  51 Defaults to "dmsetup".
  52 .PP