diff options
Diffstat (limited to 'Documentation/kdump/kdump.txt')
-rw-r--r-- | Documentation/kdump/kdump.txt | 63 |
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 | |||
13 | the system panics). The system kernel's memory image is preserved across | 13 | the system panics). The system kernel's memory image is preserved across |
14 | the reboot and is accessible to the dump-capture kernel. | 14 | the reboot and is accessible to the dump-capture kernel. |
15 | 15 | ||
16 | You can use common Linux commands, such as cp and scp, to copy the | 16 | You can use common commands, such as cp and scp, to copy the |
17 | memory image to a dump file on the local disk, or across the network to | 17 | memory image to a dump file on the local disk, or across the network to |
18 | a remote system. | 18 | a remote system. |
19 | 19 | ||
@@ -69,7 +69,7 @@ http://www.kernel.org/pub/linux/kernel/people/horms/kexec-tools/kexec-tools-test | |||
69 | 69 | ||
70 | This is a symlink to the latest version, which at the time of writing is | 70 | This is a symlink to the latest version, which at the time of writing is |
71 | 20061214, the only release of kexec-tools-testing so far. As other versions | 71 | 20061214, the only release of kexec-tools-testing so far. As other versions |
72 | are made released, the older onese will remain available at | 72 | are released, the older ones will remain available at |
73 | http://www.kernel.org/pub/linux/kernel/people/horms/kexec-tools/ | 73 | http://www.kernel.org/pub/linux/kernel/people/horms/kexec-tools/ |
74 | 74 | ||
75 | Note: Latest kexec-tools-testing git tree is available at | 75 | Note: 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 | ||
162 | Dump-capture kernel config options (Arch Dependent, i386) | 162 | Dump-capture kernel config options (Arch Dependent, i386 and x86_64) |
163 | -------------------------------------------------------- | 163 | -------------------------------------------------------------------- |
164 | 1) On x86, enable high memory support under "Processor type and | 164 | |
165 | 1) 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 | ||
171 | 2) On x86 and x86_64, disable symmetric multi-processing support | 172 | 2) 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) | |||
203 | 5) Make and install the kernel and its modules. DO NOT add this kernel | 204 | 5) 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 | ||
206 | Dump-capture kernel config options (Arch Dependent, x86_64) | ||
207 | ---------------------------------------------------------- | ||
208 | 1) 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 | |||
217 | 2) 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 | |||
225 | 3) Make and install the kernel and its modules. DO NOT add this kernel | ||
226 | to the boot loader configuration files. | ||
227 | |||
228 | Dump-capture kernel config options (Arch Dependent, ppc64) | 207 | Dump-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 | |||
282 | can choose to load the uncompressed vmlinux or compressed bzImage/vmlinuz | 261 | can choose to load the uncompressed vmlinux or compressed bzImage/vmlinuz |
283 | of dump-capture kernel. Following is the summary. | 262 | of dump-capture kernel. Following is the summary. |
284 | 263 | ||
285 | For i386: | 264 | For 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. |
288 | For x86_64: | ||
289 | - Use vmlinux | ||
290 | For ppc64: | 267 | For ppc64: |
291 | - Use vmlinux | 268 | - Use vmlinux |
292 | For ia64: | 269 | For ia64: |
@@ -315,20 +292,22 @@ Following are the arch specific command line options to be used while | |||
315 | loading dump-capture kernel. | 292 | loading dump-capture kernel. |
316 | 293 | ||
317 | For i386, x86_64 and ia64: | 294 | For i386, x86_64 and ia64: |
318 | "1 irqpoll maxcpus=1" | 295 | "1 irqpoll maxcpus=1 reset_devices" |
319 | 296 | ||
320 | For ppc64: | 297 | For ppc64: |
321 | "1 maxcpus=1 noirqdistrib" | 298 | "1 maxcpus=1 noirqdistrib reset_devices" |
322 | 299 | ||
323 | 300 | ||
324 | Notes on loading the dump-capture kernel: | 301 | Notes 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() | |||
360 | is called inside interrupt context or die() is called and panic_on_oops is set, | 339 | is called inside interrupt context or die() is called and panic_on_oops is set, |
361 | the system will boot into the dump-capture kernel. | 340 | the system will boot into the dump-capture kernel. |
362 | 341 | ||
363 | On powererpc systems when a soft-reset is generated, die() is called by all cpus | 342 | On powerpc systems when a soft-reset is generated, die() is called by all cpus |
364 | and the system will boot into the dump-capture kernel. | 343 | and the system will boot into the dump-capture kernel. |
365 | 344 | ||
366 | For testing purposes, you can trigger a crash by using "ALT-SysRq-c", | 345 | For testing purposes, you can trigger a crash by using "ALT-SysRq-c", |
@@ -426,9 +405,3 @@ Contact | |||
426 | Vivek Goyal (vgoyal@in.ibm.com) | 405 | Vivek Goyal (vgoyal@in.ibm.com) |
427 | Maneesh Soni (maneesh@in.ibm.com) | 406 | Maneesh Soni (maneesh@in.ibm.com) |
428 | 407 | ||
429 | |||
430 | Trademark | ||
431 | ========= | ||
432 | |||
433 | Linux is a trademark of Linus Torvalds in the United States, other | ||
434 | countries, or both. | ||