diff options
author | Mauro Carvalho Chehab <mchehab+samsung@kernel.org> | 2019-06-13 14:21:39 -0400 |
---|---|---|
committer | Mauro Carvalho Chehab <mchehab+samsung@kernel.org> | 2019-07-15 10:03:01 -0400 |
commit | 330d48105245abfb8c9ca491dc53ea500657217a (patch) | |
tree | b6d50bd5a9b1dc479f4d3414a741fe51eaca4e39 | |
parent | 9e1cbede267916e737c4a755059418da3ac4de95 (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.rst | 4 | ||||
-rw-r--r-- | Documentation/admin-guide/index.rst | 1 | ||||
-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.txt | 6 | ||||
-rw-r--r-- | Documentation/powerpc/firmware-assisted-dump.txt | 2 | ||||
-rw-r--r-- | Documentation/translations/zh_CN/oops-tracing.txt | 4 | ||||
-rw-r--r-- | MAINTAINERS | 2 | ||||
-rw-r--r-- | arch/arm/Kconfig | 2 | ||||
-rw-r--r-- | arch/arm64/Kconfig | 2 | ||||
-rw-r--r-- | arch/sh/Kconfig | 2 | ||||
-rw-r--r-- | arch/x86/Kconfig | 4 |
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 | ||
97 | Finding the bug's location | 97 | Finding 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 | ||
44 | This is the beginning of a section with information of interest to | 45 | This 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 | ================================================================ |
4 | Documentation for Kdump - The kexec-based Crash Dumping Solution | 3 | Documentation 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 |
54 | modem到另一台机器并用你喜欢的通讯工具获取输出。Minicom工作地很好。 | 54 | modem到另一台机器并用你喜欢的通讯工具获取输出。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> | |||
8675 | L: kexec@lists.infradead.org | 8675 | L: kexec@lists.infradead.org |
8676 | W: http://lse.sourceforge.net/kdump/ | 8676 | W: http://lse.sourceforge.net/kdump/ |
8677 | S: Maintained | 8677 | S: Maintained |
8678 | F: Documentation/kdump/ | 8678 | F: Documentation/admin-guide/kdump/ |
8679 | 8679 | ||
8680 | KEENE FM RADIO TRANSMITTER DRIVER | 8680 | KEENE FM RADIO TRANSMITTER DRIVER |
8681 | M: Hans Verkuil <hverkuil@xs4all.nl> | 8681 | M: 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 | ||
2041 | config AUTO_ZRELADDR | 2041 | config 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 | ||
1001 | config XEN_DOM0 | 1001 | config 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 | ||
631 | config KEXEC_JUMP | 631 | config 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 | ||
2062 | config KEXEC_JUMP | 2062 | config 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 |