← Back to branch summary

~ubuntu-branches/ubuntu/precise/makedumpfile/precise

« back to all changes in this revision

Viewing changes to makedumpfile.8

  • Committer: Bazaar Package Importer
  • Author(s): John Wright
  • Date: 2010-03-03 17:17:35 UTC
  • mfrom: (1.1.3 upstream) (7.1.2 sid)
  • Revision ID: james.westby@ubuntu.com-20100303171735-vxw4zqii21mcj0a0
Tags: 1.3.5-1
http://bugs.debian.org/569685
* New upstream version
* Preserve upstream's original makedumpfile.8 in clean target
* kdump-config: Fix a typo
* Switch to the "3.0 (quilt)" source format
  - Remove unneeded Build-Depends on quilt
* Update kdump-tools.README.Debian to reflect that recent kernels
  don't need a crash kernel start address
* Apply patch from Petter Reinholdtsen to fix incorrect dependencies
  in kdump-tools.init (Closes: #569685)
* Indicate support for Linux 2.6.32
  - Although upstream hasn't updated its LATEST_VERSION macro, this
    version works without modification on Linux 2.6.32.  Squelch a
    warning that a 2.6.32 kernel is not supported.
* Backport upstream commit 4a16bd39866093f4949f8e9dc183fa2321bda22d
  - Fix buffer overflow when writing dh->signature

Show diffs side-by-side

added added

removed removed

Lines of Context:
makedumpfile.8
1
 
.TH MAKEDUMPFILE 8 "April 2009" "makedumpfile v1.3.3" "Linux System Administrator's Manual"
 
1
.TH MAKEDUMPFILE 8 "11 November 2009" "makedumpfile v1.3.5" "Linux System Administrator's Manual"
2
2
.SH NAME
3
3
makedumpfile \- make a small dumpfile of kdump
4
4
.SH SYNOPSIS
31
31
"capture kernel") is running. This document represents /proc/vmcore as
32
32
\fIVMCORE\fR. makedumpfile makes a small \fIDUMPFILE\fR by compressing dump
33
33
data or by excluding unnecessary pages for analysis, or both. makedumpfile
34
 
needs the first kernel's \fIVMLINUX\fR with debug information, so that it can
35
 
distinguish unnecessary pages by analyzing how the first kernel uses the memory.
 
34
needs the first kernel's debug information, so that it can distinguish
 
35
unnecessary pages by analyzing how the first kernel uses the memory.
 
36
The information can be taken from \fIVMLINUX\fR or \fIVMCOREINFO\fR.
36
37
.PP
37
38
makedumpfile can exclude the following types of pages while copying
38
39
\fIVMCORE\fR to \fIDUMPFILE\fR, and a user can choose which type of pages will
64
65
initrd cannot include a large file like \fIVMLINUX\fR. To solve the problem,
65
66
makedumpfile makes \fIVMCOREINFO\fR beforehand, and it refers to
66
67
\fIVMCOREINFO\fR instead of \fIVMLINUX\fR while the second kernel is running.
 
68
.br
 
69
\fIVMCORE\fR has contained \fIVMCOREINFO\fR since linux-2.6.24, and a user does
 
70
not need to specify neither -x nor -i option.
67
71
.PP
68
72
If the second kernel is running on its initrd without mounting any file system,
69
73
a user needs to transport the dump data to a remote host. To transport the dump
73
77
cannot read the flattened format directly, so on a remote host the received
74
78
data in the flattened format needs to be rearranged to a readable
75
79
\fIDUMPFILE\fR format by makedumpfile (or makedumpfile\-R.pl).
76
 
 
 
80
.PP
 
81
makedumpfile can read a \fIDUMPFILE\fR in the kdump-compressed format instead
 
82
of \fIVMCORE\fR and re-filter it. This feature is useful in situation that
 
83
users need to reduce the file size of \fIDUMPFILE\fR for sending it somewhere
 
84
by ftp/scp/etc. (If all of the page types, which are specified by a new dump_level,
 
85
are excluded from an original \fIDUMPFILE\fR already, a new \fIDUMPFILE\fR is the
 
86
same as an original \fIDUMPFILE\fR.)
 
87
.br
 
88
For example, makedumpfile can create a \fIDUMPFILE\fR of dump_level 31 from the
 
89
one of dump_level 3 like the following:
 
90
.br
 
91
.B Example:
 
92
.br
 
93
# makedumpfile \-c \-d 3 /proc/vmcore dumpfile.1
 
94
.br
 
95
# makedumpfile \-c \-d 31 dumpfile.1 dumpfile.2
77
96
 
78
97
.PP
79
98
.SH OPTIONS
96
115
Pages of the specified type are not copied to \fIDUMPFILE\fR. The page type
97
116
marked in the following table is excluded. A user can specify multiple page
98
117
types by setting the sum of each page type for dump_level. The maximum of
99
 
dump_level is 31. Note that dump_level for Xen dump filtering is 0 or 1.
 
118
dump_level is 31. Note that a dump_level for Xen dump filtering is 0 or 1 on
 
119
a machine other than x86_64 (On an x86_64 machine, it is possible to specify
 
120
2 or bigger as a dump_level).
100
121
.br
101
122
If specifying multiple dump_levels with the delimiter ',', makedumpfile retries
102
123
to create a \fIDUMPFILE\fR by other dump_level when "No space on device" error
173
194
Specify the first kernel's \fIVMLINUX\fR with debug information to analyze the
174
195
first kernel's memory usage.
175
196
.br
 
197
This option is necessary if \fIVMCORE\fR does not contain \fIVMCOREINFO\fR,
 
198
[\-i \fIVMCOREINFO\fR] is not specified, and dump_level is 2 or more.
 
199
.br
176
200
The page size of the first kernel and the second kernel should match.
177
201
.br
178
202
.B Example:
184
208
Specify \fIVMCOREINFO\fR instead of \fIVMLINUX\fR for analyzing the first kernel's memory usage.
185
209
.br
186
210
\fIVMCOREINFO\fR should be made beforehand by makedumpfile with \-g option, and
187
 
it contains the first kernel's information. If dump_level is 2 or more and
188
 
[\-x \fIVMLINUX\fR] is not specified, this option is necessary.
 
211
it contains the first kernel's information.
 
212
.br
 
213
This option is necessary if \fIVMCORE\fR does not contain \fIVMCOREINFO\fR,
 
214
[\-x \fIVMLINUX\fR] is not specified, and dump_level is 2 or more.
189
215
.br
190
216
.B Example:
191
217
.br
325
351
This option is only for x86_64.
326
352
Specify the \fIxen_phys_start_address\fR, if the xen code/data is relocatable
327
353
and \fIVMCORE\fR does not contain \fIxen_phys_start_address\fR in the CRASHINFO.
328
 
\fIxen_phys_start_address\fR can be token from the line of "Hypervisor code
 
354
\fIxen_phys_start_address\fR can be taken from the line of "Hypervisor code
329
355
and data" in /proc/iomem. For example, specify 0xcee00000 as \fIxen_phys_start_address\fR
330
356
if /proc/iomem is the following:
331
357
  -------------------------------------------------------