Commit 330d4810 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

docs: admin-guide: add kdump documentation into it

The Kdump documentation describes procedures with admins use
in order to solve issues on their systems.
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+samsung@kernel.org>
parent 9e1cbede
...@@ -90,9 +90,9 @@ the disk is not available then you have three options: ...@@ -90,9 +90,9 @@ the disk is not available then you have three options:
run a null modem to a second machine and capture the output there run a null modem to a second machine and capture the output there
using your favourite communication program. Minicom works well. using your favourite communication program. Minicom works well.
(3) Use Kdump (see Documentation/kdump/kdump.rst), (3) Use Kdump (see Documentation/admin-guide/kdump/kdump.rst),
extract the kernel ring buffer from old memory with using dmesg extract the kernel ring buffer from old memory with using dmesg
gdbmacro in Documentation/kdump/gdbmacros.txt. gdbmacro in Documentation/admin-guide/kdump/gdbmacros.txt.
Finding the bug's location Finding the bug's location
-------------------------- --------------------------
......
...@@ -39,6 +39,7 @@ problems and bugs in particular. ...@@ -39,6 +39,7 @@ problems and bugs in particular.
ramoops ramoops
dynamic-debug-howto dynamic-debug-howto
init init
kdump/index
perf/index perf/index
This is the beginning of a section with information of interest to This is the beginning of a section with information of interest to
......
:orphan:
================================================================ ================================================================
Documentation for Kdump - The kexec-based Crash Dumping Solution Documentation for Kdump - The kexec-based Crash Dumping Solution
......
...@@ -708,14 +708,14 @@ ...@@ -708,14 +708,14 @@
[KNL, x86_64] select a region under 4G first, and [KNL, x86_64] select a region under 4G first, and
fall back to reserve region above 4G when '@offset' fall back to reserve region above 4G when '@offset'
hasn't been specified. hasn't been specified.
See Documentation/kdump/kdump.rst for further details. See Documentation/admin-guide/kdump/kdump.rst for further details.
crashkernel=range1:size1[,range2:size2,...][@offset] crashkernel=range1:size1[,range2:size2,...][@offset]
[KNL] Same as above, but depends on the memory [KNL] Same as above, but depends on the memory
in the running system. The syntax of range is in the running system. The syntax of range is
start-[end] where start and end are both start-[end] where start and end are both
a memory unit (amount[KMG]). See also a memory unit (amount[KMG]). See also
Documentation/kdump/kdump.rst for an example. Documentation/admin-guide/kdump/kdump.rst for an example.
crashkernel=size[KMG],high crashkernel=size[KMG],high
[KNL, x86_64] range could be above 4G. Allow kernel [KNL, x86_64] range could be above 4G. Allow kernel
...@@ -1207,7 +1207,7 @@ ...@@ -1207,7 +1207,7 @@
Specifies physical address of start of kernel core Specifies physical address of start of kernel core
image elf header and optionally the size. Generally image elf header and optionally the size. Generally
kexec loader will pass this option to capture kernel. kexec loader will pass this option to capture kernel.
See Documentation/kdump/kdump.rst for details. See Documentation/admin-guide/kdump/kdump.rst for details.
enable_mtrr_cleanup [X86] enable_mtrr_cleanup [X86]
The kernel tries to adjust MTRR layout from continuous The kernel tries to adjust MTRR layout from continuous
......
...@@ -59,7 +59,7 @@ as follows: ...@@ -59,7 +59,7 @@ as follows:
the default calculated size. Use this option if default the default calculated size. Use this option if default
boot memory size is not sufficient for second kernel to boot memory size is not sufficient for second kernel to
boot successfully. For syntax of crashkernel= parameter, boot successfully. For syntax of crashkernel= parameter,
refer to Documentation/kdump/kdump.rst. If any offset is refer to Documentation/admin-guide/kdump/kdump.rst. If any offset is
provided in crashkernel= parameter, it will be ignored provided in crashkernel= parameter, it will be ignored
as fadump uses a predefined offset to reserve memory as fadump uses a predefined offset to reserve memory
for boot memory dump preservation in case of a crash. for boot memory dump preservation in case of a crash.
......
...@@ -53,8 +53,8 @@ cat /proc/kmsg > file, 然而你必须介入中止传输, kmsg是一个“ ...@@ -53,8 +53,8 @@ cat /proc/kmsg > file, 然而你必须介入中止传输, kmsg是一个“
(2)用串口终端启动(请参看Documentation/admin-guide/serial-console.rst),运行一个null (2)用串口终端启动(请参看Documentation/admin-guide/serial-console.rst),运行一个null
modem到另一台机器并用你喜欢的通讯工具获取输出。Minicom工作地很好。 modem到另一台机器并用你喜欢的通讯工具获取输出。Minicom工作地很好。
(3)使用Kdump(请参看Documentation/kdump/kdump.rst), (3)使用Kdump(请参看Documentation/admin-guide/kdump/kdump.rst),
使用在Documentation/kdump/gdbmacros.txt中定义的dmesg gdb宏,从旧的内存中提取内核 使用在Documentation/admin-guide/kdump/gdbmacros.txt中定义的dmesg gdb宏,从旧的内存中提取内核
环形缓冲区。 环形缓冲区。
完整信息 完整信息
......
...@@ -8675,7 +8675,7 @@ R: Vivek Goyal <vgoyal@redhat.com> ...@@ -8675,7 +8675,7 @@ R: Vivek Goyal <vgoyal@redhat.com>
L: kexec@lists.infradead.org L: kexec@lists.infradead.org
W: http://lse.sourceforge.net/kdump/ W: http://lse.sourceforge.net/kdump/
S: Maintained S: Maintained
F: Documentation/kdump/ F: Documentation/admin-guide/kdump/
KEENE FM RADIO TRANSMITTER DRIVER KEENE FM RADIO TRANSMITTER DRIVER
M: Hans Verkuil <hverkuil@xs4all.nl> M: Hans Verkuil <hverkuil@xs4all.nl>
......
...@@ -2036,7 +2036,7 @@ config CRASH_DUMP ...@@ -2036,7 +2036,7 @@ config CRASH_DUMP
kdump/kexec. The crash dump kernel must be compiled to a kdump/kexec. The crash dump kernel must be compiled to a
memory address not used by the main kernel memory address not used by the main kernel
For more details see Documentation/kdump/kdump.rst For more details see Documentation/admin-guide/kdump/kdump.rst
config AUTO_ZRELADDR config AUTO_ZRELADDR
bool "Auto calculation of the decompressed kernel image address" bool "Auto calculation of the decompressed kernel image address"
......
...@@ -996,7 +996,7 @@ config CRASH_DUMP ...@@ -996,7 +996,7 @@ config CRASH_DUMP
reserved region and then later executed after a crash by reserved region and then later executed after a crash by
kdump/kexec. kdump/kexec.
For more details see Documentation/kdump/kdump.rst For more details see Documentation/admin-guide/kdump/kdump.rst
config XEN_DOM0 config XEN_DOM0
def_bool y def_bool y
......
...@@ -626,7 +626,7 @@ config CRASH_DUMP ...@@ -626,7 +626,7 @@ config CRASH_DUMP
to a memory address not used by the main kernel using to a memory address not used by the main kernel using
PHYSICAL_START. PHYSICAL_START.
For more details see Documentation/kdump/kdump.rst For more details see Documentation/admin-guide/kdump/kdump.rst
config KEXEC_JUMP config KEXEC_JUMP
bool "kexec jump (EXPERIMENTAL)" bool "kexec jump (EXPERIMENTAL)"
......
...@@ -2057,7 +2057,7 @@ config CRASH_DUMP ...@@ -2057,7 +2057,7 @@ config CRASH_DUMP
to a memory address not used by the main kernel or BIOS using to a memory address not used by the main kernel or BIOS using
PHYSICAL_START, or it must be built as a relocatable image PHYSICAL_START, or it must be built as a relocatable image
(CONFIG_RELOCATABLE=y). (CONFIG_RELOCATABLE=y).
For more details see Documentation/kdump/kdump.rst For more details see Documentation/admin-guide/kdump/kdump.rst
config KEXEC_JUMP config KEXEC_JUMP
bool "kexec jump" bool "kexec jump"
...@@ -2094,7 +2094,7 @@ config PHYSICAL_START ...@@ -2094,7 +2094,7 @@ config PHYSICAL_START
the reserved region. In other words, it can be set based on the reserved region. In other words, it can be set based on
the "X" value as specified in the "crashkernel=YM@XM" the "X" value as specified in the "crashkernel=YM@XM"
command line boot parameter passed to the panic-ed command line boot parameter passed to the panic-ed
kernel. Please take a look at Documentation/kdump/kdump.rst kernel. Please take a look at Documentation/admin-guide/kdump/kdump.rst
for more details about crash dumps. for more details about crash dumps.
Usage of bzImage for capturing the crash dump is recommended as Usage of bzImage for capturing the crash dump is recommended as
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment