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: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
This commit is contained in:
Mauro Carvalho Chehab 2019-06-13 15:21:39 -03:00
parent 9e1cbede26
commit 330d481052
14 changed files with 15 additions and 15 deletions

View File

@ -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
-------------------------- --------------------------

View File

@ -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

View File

@ -1,4 +1,3 @@
:orphan:
================================================================ ================================================================
Documentation for Kdump - The kexec-based Crash Dumping Solution Documentation for Kdump - The kexec-based Crash Dumping Solution

View File

@ -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 @@
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

View File

@ -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.

View File

@ -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宏从旧的内存中提取内核
环形缓冲区。 环形缓冲区。
完整信息 完整信息

View File

@ -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>

View File

@ -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"

View File

@ -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

View File

@ -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)"

View File

@ -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
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