summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMauro Carvalho Chehab <mchehab+samsung@kernel.org>2019-06-13 14:21:39 -0400
committerMauro Carvalho Chehab <mchehab+samsung@kernel.org>2019-07-15 10:03:01 -0400
commit330d48105245abfb8c9ca491dc53ea500657217a (patch)
treeb6d50bd5a9b1dc479f4d3414a741fe51eaca4e39
parent9e1cbede267916e737c4a755059418da3ac4de95 (diff)
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>
-rw-r--r--Documentation/admin-guide/bug-hunting.rst4
-rw-r--r--Documentation/admin-guide/index.rst1
-rw-r--r--Documentation/admin-guide/kdump/gdbmacros.txt (renamed from Documentation/kdump/gdbmacros.txt)0
-rw-r--r--Documentation/admin-guide/kdump/index.rst (renamed from Documentation/kdump/index.rst)1
-rw-r--r--Documentation/admin-guide/kdump/kdump.rst (renamed from Documentation/kdump/kdump.rst)0
-rw-r--r--Documentation/admin-guide/kdump/vmcoreinfo.rst (renamed from Documentation/kdump/vmcoreinfo.rst)0
-rw-r--r--Documentation/admin-guide/kernel-parameters.txt6
-rw-r--r--Documentation/powerpc/firmware-assisted-dump.txt2
-rw-r--r--Documentation/translations/zh_CN/oops-tracing.txt4
-rw-r--r--MAINTAINERS2
-rw-r--r--arch/arm/Kconfig2
-rw-r--r--arch/arm64/Kconfig2
-rw-r--r--arch/sh/Kconfig2
-rw-r--r--arch/x86/Kconfig4
14 files changed, 15 insertions, 15 deletions
diff --git a/Documentation/admin-guide/bug-hunting.rst b/Documentation/admin-guide/bug-hunting.rst
index b761aa2a51d2..44b8a4edd348 100644
--- a/Documentation/admin-guide/bug-hunting.rst
+++ b/Documentation/admin-guide/bug-hunting.rst
@@ -90,9 +90,9 @@ the disk is not available then you have three options:
90 run a null modem to a second machine and capture the output there 90 run a null modem to a second machine and capture the output there
91 using your favourite communication program. Minicom works well. 91 using your favourite communication program. Minicom works well.
92 92
93(3) Use Kdump (see Documentation/kdump/kdump.rst), 93(3) Use Kdump (see Documentation/admin-guide/kdump/kdump.rst),
94 extract the kernel ring buffer from old memory with using dmesg 94 extract the kernel ring buffer from old memory with using dmesg
95 gdbmacro in Documentation/kdump/gdbmacros.txt. 95 gdbmacro in Documentation/admin-guide/kdump/gdbmacros.txt.
96 96
97Finding the bug's location 97Finding the bug's location
98-------------------------- 98--------------------------
diff --git a/Documentation/admin-guide/index.rst b/Documentation/admin-guide/index.rst
index 6fcc83aaa9b6..5b63182ceb5f 100644
--- a/Documentation/admin-guide/index.rst
+++ b/Documentation/admin-guide/index.rst
@@ -39,6 +39,7 @@ problems and bugs in particular.
39 ramoops 39 ramoops
40 dynamic-debug-howto 40 dynamic-debug-howto
41 init 41 init
42 kdump/index
42 perf/index 43 perf/index
43 44
44This is the beginning of a section with information of interest to 45This is the beginning of a section with information of interest to
diff --git a/Documentation/kdump/gdbmacros.txt b/Documentation/admin-guide/kdump/gdbmacros.txt
index 220d0a80ca2c..220d0a80ca2c 100644
--- a/Documentation/kdump/gdbmacros.txt
+++ b/Documentation/admin-guide/kdump/gdbmacros.txt
diff --git a/Documentation/kdump/index.rst b/Documentation/admin-guide/kdump/index.rst
index 2b17fcf6867a..8e2ebd0383cd 100644
--- a/Documentation/kdump/index.rst
+++ b/Documentation/admin-guide/kdump/index.rst
@@ -1,4 +1,3 @@
1:orphan:
2 1
3================================================================ 2================================================================
4Documentation for Kdump - The kexec-based Crash Dumping Solution 3Documentation for Kdump - The kexec-based Crash Dumping Solution
diff --git a/Documentation/kdump/kdump.rst b/Documentation/admin-guide/kdump/kdump.rst
index ac7e131d2935..ac7e131d2935 100644
--- a/Documentation/kdump/kdump.rst
+++ b/Documentation/admin-guide/kdump/kdump.rst
diff --git a/Documentation/kdump/vmcoreinfo.rst b/Documentation/admin-guide/kdump/vmcoreinfo.rst
index 007a6b86e0ee..007a6b86e0ee 100644
--- a/Documentation/kdump/vmcoreinfo.rst
+++ b/Documentation/admin-guide/kdump/vmcoreinfo.rst
diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt
index 4821175a3769..e645b3ab4b6f 100644
--- a/Documentation/admin-guide/kernel-parameters.txt
+++ b/Documentation/admin-guide/kernel-parameters.txt
@@ -708,14 +708,14 @@
708 [KNL, x86_64] select a region under 4G first, and 708 [KNL, x86_64] select a region under 4G first, and
709 fall back to reserve region above 4G when '@offset' 709 fall back to reserve region above 4G when '@offset'
710 hasn't been specified. 710 hasn't been specified.
711 See Documentation/kdump/kdump.rst for further details. 711 See Documentation/admin-guide/kdump/kdump.rst for further details.
712 712
713 crashkernel=range1:size1[,range2:size2,...][@offset] 713 crashkernel=range1:size1[,range2:size2,...][@offset]
714 [KNL] Same as above, but depends on the memory 714 [KNL] Same as above, but depends on the memory
715 in the running system. The syntax of range is 715 in the running system. The syntax of range is
716 start-[end] where start and end are both 716 start-[end] where start and end are both
717 a memory unit (amount[KMG]). See also 717 a memory unit (amount[KMG]). See also
718 Documentation/kdump/kdump.rst for an example. 718 Documentation/admin-guide/kdump/kdump.rst for an example.
719 719
720 crashkernel=size[KMG],high 720 crashkernel=size[KMG],high
721 [KNL, x86_64] range could be above 4G. Allow kernel 721 [KNL, x86_64] range could be above 4G. Allow kernel
@@ -1207,7 +1207,7 @@
1207 Specifies physical address of start of kernel core 1207 Specifies physical address of start of kernel core
1208 image elf header and optionally the size. Generally 1208 image elf header and optionally the size. Generally
1209 kexec loader will pass this option to capture kernel. 1209 kexec loader will pass this option to capture kernel.
1210 See Documentation/kdump/kdump.rst for details. 1210 See Documentation/admin-guide/kdump/kdump.rst for details.
1211 1211
1212 enable_mtrr_cleanup [X86] 1212 enable_mtrr_cleanup [X86]
1213 The kernel tries to adjust MTRR layout from continuous 1213 The kernel tries to adjust MTRR layout from continuous
diff --git a/Documentation/powerpc/firmware-assisted-dump.txt b/Documentation/powerpc/firmware-assisted-dump.txt
index 0c41d6d463f3..10e7f4d16c14 100644
--- a/Documentation/powerpc/firmware-assisted-dump.txt
+++ b/Documentation/powerpc/firmware-assisted-dump.txt
@@ -59,7 +59,7 @@ as follows:
59 the default calculated size. Use this option if default 59 the default calculated size. Use this option if default
60 boot memory size is not sufficient for second kernel to 60 boot memory size is not sufficient for second kernel to
61 boot successfully. For syntax of crashkernel= parameter, 61 boot successfully. For syntax of crashkernel= parameter,
62 refer to Documentation/kdump/kdump.rst. If any offset is 62 refer to Documentation/admin-guide/kdump/kdump.rst. If any offset is
63 provided in crashkernel= parameter, it will be ignored 63 provided in crashkernel= parameter, it will be ignored
64 as fadump uses a predefined offset to reserve memory 64 as fadump uses a predefined offset to reserve memory
65 for boot memory dump preservation in case of a crash. 65 for boot memory dump preservation in case of a crash.
diff --git a/Documentation/translations/zh_CN/oops-tracing.txt b/Documentation/translations/zh_CN/oops-tracing.txt
index 368ddd05b304..c5f3bda7abcb 100644
--- a/Documentation/translations/zh_CN/oops-tracing.txt
+++ b/Documentation/translations/zh_CN/oops-tracing.txt
@@ -53,8 +53,8 @@ cat /proc/kmsg > file, 然而你必须介入中止传输, kmsg是一个“
53(2)用串口终端启动(请参看Documentation/admin-guide/serial-console.rst),运行一个null 53(2)用串口终端启动(请参看Documentation/admin-guide/serial-console.rst),运行一个null
54modem到另一台机器并用你喜欢的通讯工具获取输出。Minicom工作地很好。 54modem到另一台机器并用你喜欢的通讯工具获取输出。Minicom工作地很好。
55 55
56(3)使用Kdump(请参看Documentation/kdump/kdump.rst), 56(3)使用Kdump(请参看Documentation/admin-guide/kdump/kdump.rst),
57使用在Documentation/kdump/gdbmacros.txt中定义的dmesg gdb宏,从旧的内存中提取内核 57使用在Documentation/admin-guide/kdump/gdbmacros.txt中定义的dmesg gdb宏,从旧的内存中提取内核
58环形缓冲区。 58环形缓冲区。
59 59
60完整信息 60完整信息
diff --git a/MAINTAINERS b/MAINTAINERS
index 288f84dbd480..b36028f43192 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -8675,7 +8675,7 @@ R: Vivek Goyal <vgoyal@redhat.com>
8675L: kexec@lists.infradead.org 8675L: kexec@lists.infradead.org
8676W: http://lse.sourceforge.net/kdump/ 8676W: http://lse.sourceforge.net/kdump/
8677S: Maintained 8677S: Maintained
8678F: Documentation/kdump/ 8678F: Documentation/admin-guide/kdump/
8679 8679
8680KEENE FM RADIO TRANSMITTER DRIVER 8680KEENE FM RADIO TRANSMITTER DRIVER
8681M: Hans Verkuil <hverkuil@xs4all.nl> 8681M: Hans Verkuil <hverkuil@xs4all.nl>
diff --git a/arch/arm/Kconfig b/arch/arm/Kconfig
index 6425871e9903..20afd6077465 100644
--- a/arch/arm/Kconfig
+++ b/arch/arm/Kconfig
@@ -2036,7 +2036,7 @@ config CRASH_DUMP
2036 kdump/kexec. The crash dump kernel must be compiled to a 2036 kdump/kexec. The crash dump kernel must be compiled to a
2037 memory address not used by the main kernel 2037 memory address not used by the main kernel
2038 2038
2039 For more details see Documentation/kdump/kdump.rst 2039 For more details see Documentation/admin-guide/kdump/kdump.rst
2040 2040
2041config AUTO_ZRELADDR 2041config AUTO_ZRELADDR
2042 bool "Auto calculation of the decompressed kernel image address" 2042 bool "Auto calculation of the decompressed kernel image address"
diff --git a/arch/arm64/Kconfig b/arch/arm64/Kconfig
index a4b22bbf0590..86f81b5afd95 100644
--- a/arch/arm64/Kconfig
+++ b/arch/arm64/Kconfig
@@ -996,7 +996,7 @@ config CRASH_DUMP
996 reserved region and then later executed after a crash by 996 reserved region and then later executed after a crash by
997 kdump/kexec. 997 kdump/kexec.
998 998
999 For more details see Documentation/kdump/kdump.rst 999 For more details see Documentation/admin-guide/kdump/kdump.rst
1000 1000
1001config XEN_DOM0 1001config XEN_DOM0
1002 def_bool y 1002 def_bool y
diff --git a/arch/sh/Kconfig b/arch/sh/Kconfig
index 31a7d12db705..c2858ac6a46a 100644
--- a/arch/sh/Kconfig
+++ b/arch/sh/Kconfig
@@ -626,7 +626,7 @@ config CRASH_DUMP
626 to a memory address not used by the main kernel using 626 to a memory address not used by the main kernel using
627 PHYSICAL_START. 627 PHYSICAL_START.
628 628
629 For more details see Documentation/kdump/kdump.rst 629 For more details see Documentation/admin-guide/kdump/kdump.rst
630 630
631config KEXEC_JUMP 631config KEXEC_JUMP
632 bool "kexec jump (EXPERIMENTAL)" 632 bool "kexec jump (EXPERIMENTAL)"
diff --git a/arch/x86/Kconfig b/arch/x86/Kconfig
index d0bbca65e4a4..9505066b7ba3 100644
--- a/arch/x86/Kconfig
+++ b/arch/x86/Kconfig
@@ -2057,7 +2057,7 @@ config CRASH_DUMP
2057 to a memory address not used by the main kernel or BIOS using 2057 to a memory address not used by the main kernel or BIOS using
2058 PHYSICAL_START, or it must be built as a relocatable image 2058 PHYSICAL_START, or it must be built as a relocatable image
2059 (CONFIG_RELOCATABLE=y). 2059 (CONFIG_RELOCATABLE=y).
2060 For more details see Documentation/kdump/kdump.rst 2060 For more details see Documentation/admin-guide/kdump/kdump.rst
2061 2061
2062config KEXEC_JUMP 2062config KEXEC_JUMP
2063 bool "kexec jump" 2063 bool "kexec jump"
@@ -2094,7 +2094,7 @@ config PHYSICAL_START
2094 the reserved region. In other words, it can be set based on 2094 the reserved region. In other words, it can be set based on
2095 the "X" value as specified in the "crashkernel=YM@XM" 2095 the "X" value as specified in the "crashkernel=YM@XM"
2096 command line boot parameter passed to the panic-ed 2096 command line boot parameter passed to the panic-ed
2097 kernel. Please take a look at Documentation/kdump/kdump.rst 2097 kernel. Please take a look at Documentation/admin-guide/kdump/kdump.rst
2098 for more details about crash dumps. 2098 for more details about crash dumps.
2099 2099
2100 Usage of bzImage for capturing the crash dump is recommended as 2100 Usage of bzImage for capturing the crash dump is recommended as