aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/kdump/kdump.txt
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/kdump/kdump.txt')
-rw-r--r--Documentation/kdump/kdump.txt63
1 files changed, 18 insertions, 45 deletions
diff --git a/Documentation/kdump/kdump.txt b/Documentation/kdump/kdump.txt
index 2fedc081b4c8..1b37b28cc234 100644
--- a/Documentation/kdump/kdump.txt
+++ b/Documentation/kdump/kdump.txt
@@ -13,7 +13,7 @@ dump of the system kernel's memory needs to be taken (for example, when
13the system panics). The system kernel's memory image is preserved across 13the system panics). The system kernel's memory image is preserved across
14the reboot and is accessible to the dump-capture kernel. 14the reboot and is accessible to the dump-capture kernel.
15 15
16You can use common Linux commands, such as cp and scp, to copy the 16You can use common commands, such as cp and scp, to copy the
17memory image to a dump file on the local disk, or across the network to 17memory image to a dump file on the local disk, or across the network to
18a remote system. 18a remote system.
19 19
@@ -69,7 +69,7 @@ http://www.kernel.org/pub/linux/kernel/people/horms/kexec-tools/kexec-tools-test
69 69
70This is a symlink to the latest version, which at the time of writing is 70This is a symlink to the latest version, which at the time of writing is
7120061214, the only release of kexec-tools-testing so far. As other versions 7120061214, the only release of kexec-tools-testing so far. As other versions
72are made released, the older onese will remain available at 72are released, the older ones will remain available at
73http://www.kernel.org/pub/linux/kernel/people/horms/kexec-tools/ 73http://www.kernel.org/pub/linux/kernel/people/horms/kexec-tools/
74 74
75Note: Latest kexec-tools-testing git tree is available at 75Note: Latest kexec-tools-testing git tree is available at
@@ -159,16 +159,17 @@ Dump-capture kernel config options (Arch Independent)
159 CONFIG_PROC_VMCORE=y 159 CONFIG_PROC_VMCORE=y
160 (CONFIG_PROC_VMCORE is set by default when CONFIG_CRASH_DUMP is selected.) 160 (CONFIG_PROC_VMCORE is set by default when CONFIG_CRASH_DUMP is selected.)
161 161
162Dump-capture kernel config options (Arch Dependent, i386) 162Dump-capture kernel config options (Arch Dependent, i386 and x86_64)
163-------------------------------------------------------- 163--------------------------------------------------------------------
1641) On x86, enable high memory support under "Processor type and 164
1651) On i386, enable high memory support under "Processor type and
165 features": 166 features":
166 167
167 CONFIG_HIGHMEM64G=y 168 CONFIG_HIGHMEM64G=y
168 or 169 or
169 CONFIG_HIGHMEM4G 170 CONFIG_HIGHMEM4G
170 171
1712) On x86 and x86_64, disable symmetric multi-processing support 1722) On i386 and x86_64, disable symmetric multi-processing support
172 under "Processor type and features": 173 under "Processor type and features":
173 174
174 CONFIG_SMP=n 175 CONFIG_SMP=n
@@ -203,28 +204,6 @@ Dump-capture kernel config options (Arch Dependent, i386)
2035) Make and install the kernel and its modules. DO NOT add this kernel 2045) Make and install the kernel and its modules. DO NOT add this kernel
204 to the boot loader configuration files. 205 to the boot loader configuration files.
205 206
206Dump-capture kernel config options (Arch Dependent, x86_64)
207----------------------------------------------------------
2081) On x86 and x86_64, disable symmetric multi-processing support
209 under "Processor type and features":
210
211 CONFIG_SMP=n
212
213 (If CONFIG_SMP=y, then specify maxcpus=1 on the kernel command line
214 when loading the dump-capture kernel, see section "Load the Dump-capture
215 Kernel".)
216
2172) Use a suitable value for "Physical address where the kernel is
218 loaded" (under "Processor type and features"). This only appears when
219 "kernel crash dumps" is enabled. By default this value is 0x1000000
220 (16MB). It should be the same as X in the "crashkernel=Y@X" boot
221 parameter.
222
223 For x86_64, normally "CONFIG_PHYSICAL_START=0x1000000".
224
2253) Make and install the kernel and its modules. DO NOT add this kernel
226 to the boot loader configuration files.
227
228Dump-capture kernel config options (Arch Dependent, ppc64) 207Dump-capture kernel config options (Arch Dependent, ppc64)
229---------------------------------------------------------- 208----------------------------------------------------------
230 209
@@ -282,11 +261,9 @@ Based on the architecture and type of image (relocatable or not), one
282can choose to load the uncompressed vmlinux or compressed bzImage/vmlinuz 261can choose to load the uncompressed vmlinux or compressed bzImage/vmlinuz
283of dump-capture kernel. Following is the summary. 262of dump-capture kernel. Following is the summary.
284 263
285For i386: 264For i386 and x86_64:
286 - Use vmlinux if kernel is not relocatable. 265 - Use vmlinux if kernel is not relocatable.
287 - Use bzImage/vmlinuz if kernel is relocatable. 266 - Use bzImage/vmlinuz if kernel is relocatable.
288For x86_64:
289 - Use vmlinux
290For ppc64: 267For ppc64:
291 - Use vmlinux 268 - Use vmlinux
292For ia64: 269For ia64:
@@ -315,20 +292,22 @@ Following are the arch specific command line options to be used while
315loading dump-capture kernel. 292loading dump-capture kernel.
316 293
317For i386, x86_64 and ia64: 294For i386, x86_64 and ia64:
318 "1 irqpoll maxcpus=1" 295 "1 irqpoll maxcpus=1 reset_devices"
319 296
320For ppc64: 297For ppc64:
321 "1 maxcpus=1 noirqdistrib" 298 "1 maxcpus=1 noirqdistrib reset_devices"
322 299
323 300
324Notes on loading the dump-capture kernel: 301Notes on loading the dump-capture kernel:
325 302
326* By default, the ELF headers are stored in ELF64 format to support 303* By default, the ELF headers are stored in ELF64 format to support
327 systems with more than 4GB memory. The --elf32-core-headers option can 304 systems with more than 4GB memory. On i386, kexec automatically checks if
328 be used to force the generation of ELF32 headers. This is necessary 305 the physical RAM size exceeds the 4 GB limit and if not, uses ELF32.
329 because GDB currently cannot open vmcore files with ELF64 headers on 306 So, on non-PAE systems, ELF32 is always used.
330 32-bit systems. ELF32 headers can be used on non-PAE systems (that is, 307
331 less than 4GB of memory). 308 The --elf32-core-headers option can be used to force the generation of ELF32
309 headers. This is necessary because GDB currently cannot open vmcore files
310 with ELF64 headers on 32-bit systems.
332 311
333* The "irqpoll" boot parameter reduces driver initialization failures 312* The "irqpoll" boot parameter reduces driver initialization failures
334 due to shared interrupts in the dump-capture kernel. 313 due to shared interrupts in the dump-capture kernel.
@@ -360,7 +339,7 @@ If die() is called, and it happens to be a thread with pid 0 or 1, or die()
360is called inside interrupt context or die() is called and panic_on_oops is set, 339is called inside interrupt context or die() is called and panic_on_oops is set,
361the system will boot into the dump-capture kernel. 340the system will boot into the dump-capture kernel.
362 341
363On powererpc systems when a soft-reset is generated, die() is called by all cpus 342On powerpc systems when a soft-reset is generated, die() is called by all cpus
364and the system will boot into the dump-capture kernel. 343and the system will boot into the dump-capture kernel.
365 344
366For testing purposes, you can trigger a crash by using "ALT-SysRq-c", 345For testing purposes, you can trigger a crash by using "ALT-SysRq-c",
@@ -426,9 +405,3 @@ Contact
426Vivek Goyal (vgoyal@in.ibm.com) 405Vivek Goyal (vgoyal@in.ibm.com)
427Maneesh Soni (maneesh@in.ibm.com) 406Maneesh Soni (maneesh@in.ibm.com)
428 407
429
430Trademark
431=========
432
433Linux is a trademark of Linus Torvalds in the United States, other
434countries, or both.