]> www.infradead.org Git - users/hch/configfs.git/commitdiff
docs: admin-guide: add kdump documentation into it
authorMauro Carvalho Chehab <mchehab+samsung@kernel.org>
Thu, 13 Jun 2019 18:21:39 +0000 (15:21 -0300)
committerMauro Carvalho Chehab <mchehab+samsung@kernel.org>
Mon, 15 Jul 2019 14:03:01 +0000 (11:03 -0300)
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>
14 files changed:
Documentation/admin-guide/bug-hunting.rst
Documentation/admin-guide/index.rst
Documentation/admin-guide/kdump/gdbmacros.txt [moved from Documentation/kdump/gdbmacros.txt with 100% similarity]
Documentation/admin-guide/kdump/index.rst [moved from Documentation/kdump/index.rst with 97% similarity]
Documentation/admin-guide/kdump/kdump.rst [moved from Documentation/kdump/kdump.rst with 100% similarity]
Documentation/admin-guide/kdump/vmcoreinfo.rst [moved from Documentation/kdump/vmcoreinfo.rst with 100% similarity]
Documentation/admin-guide/kernel-parameters.txt
Documentation/powerpc/firmware-assisted-dump.txt
Documentation/translations/zh_CN/oops-tracing.txt
MAINTAINERS
arch/arm/Kconfig
arch/arm64/Kconfig
arch/sh/Kconfig
arch/x86/Kconfig

index b761aa2a51d2df038887605d24b644c11180c1f0..44b8a4edd3484a586998a992b7a301659ba7803e 100644 (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
     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
-    gdbmacro in Documentation/kdump/gdbmacros.txt.
+    gdbmacro in Documentation/admin-guide/kdump/gdbmacros.txt.
 
 Finding the bug's location
 --------------------------
index 6fcc83aaa9b6e5d429f4fa2d21b43046ccdf1715..5b63182ceb5f0d49ca8a2d71baedc1acead6fab9 100644 (file)
@@ -39,6 +39,7 @@ problems and bugs in particular.
    ramoops
    dynamic-debug-howto
    init
+   kdump/index
    perf/index
 
 This is the beginning of a section with information of interest to
similarity index 97%
rename from Documentation/kdump/index.rst
rename to Documentation/admin-guide/kdump/index.rst
index 2b17fcf6867a30a59c52e4f99aaf10a3314dbf76..8e2ebd0383cda66915940fde415853fc63289097 100644 (file)
@@ -1,4 +1,3 @@
-:orphan:
 
 ================================================================
 Documentation for Kdump - The kexec-based Crash Dumping Solution
index 4821175a3769285b8631f42a5ef46c926ea61bab..e645b3ab4b6f1de5881d4d26daa17fa143ed7860 100644 (file)
                        [KNL, x86_64] select a region under 4G first, and
                        fall back to reserve region above 4G when '@offset'
                        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]
                        [KNL] Same as above, but depends on the memory
                        in the running system. The syntax of range is
                        start-[end] where start and end are both
                        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
                        [KNL, x86_64] range could be above 4G. Allow kernel
                        Specifies physical address of start of kernel core
                        image elf header and optionally the size. Generally
                        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]
                        The kernel tries to adjust MTRR layout from continuous
index 0c41d6d463f3b59a68bb7561776eed587acb8cb0..10e7f4d16c140fd5e8a0137f9b87d696d7d8a320 100644 (file)
@@ -59,7 +59,7 @@ as follows:
          the default calculated size. Use this option if default
          boot memory size is not sufficient for second kernel to
          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
          as fadump uses a predefined offset to reserve memory
          for boot memory dump preservation in case of a crash.
index 368ddd05b304430cabcd5f7b99678c902816b1aa..c5f3bda7abcb6c89c2d0840b4c7240278b5540f3 100644 (file)
@@ -53,8 +53,8 @@ cat /proc/kmsg > file, 然而你必须介入中止传输, kmsg是一个“
 (2)用串口终端启动(请参看Documentation/admin-guide/serial-console.rst),运行一个null
 modem到另一台机器并用你喜欢的通讯工具获取输出。Minicom工作地很好。
 
-(3)使用Kdump(请参看Documentation/kdump/kdump.rst),
-使用在Documentation/kdump/gdbmacros.txt中定义的dmesg gdb宏,从旧的内存中提取内核
+(3)使用Kdump(请参看Documentation/admin-guide/kdump/kdump.rst),
+使用在Documentation/admin-guide/kdump/gdbmacros.txt中定义的dmesg gdb宏,从旧的内存中提取内核
 环形缓冲区。
 
 完整信息
index 288f84dbd48005e14d00145cf1daddb7e03506c9..b36028f431925422fbe96ef3d156ad6654afe93b 100644 (file)
@@ -8675,7 +8675,7 @@ R:        Vivek Goyal <vgoyal@redhat.com>
 L:     kexec@lists.infradead.org
 W:     http://lse.sourceforge.net/kdump/
 S:     Maintained
-F:     Documentation/kdump/
+F:     Documentation/admin-guide/kdump/
 
 KEENE FM RADIO TRANSMITTER DRIVER
 M:     Hans Verkuil <hverkuil@xs4all.nl>
index 6425871e99039e505a5520e3a1f5f041fc7fc285..20afd607746517fb02e5ef3d1441fe94115ade9a 100644 (file)
@@ -2036,7 +2036,7 @@ config CRASH_DUMP
          kdump/kexec. The crash dump kernel must be compiled to a
          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
        bool "Auto calculation of the decompressed kernel image address"
index a4b22bbf0590f6382afa55dfa3c9fc5eee6e851d..86f81b5afd95515ed99403c27ed78e0173d22953 100644 (file)
@@ -996,7 +996,7 @@ config CRASH_DUMP
          reserved region and then later executed after a crash by
          kdump/kexec.
 
-         For more details see Documentation/kdump/kdump.rst
+         For more details see Documentation/admin-guide/kdump/kdump.rst
 
 config XEN_DOM0
        def_bool y
index 31a7d12db705243a7f3a2d64db39a8d315eab285..c2858ac6a46a2c1afa1053ae85e2ce52bbca80a8 100644 (file)
@@ -626,7 +626,7 @@ config CRASH_DUMP
          to a memory address not used by the main kernel using
          PHYSICAL_START.
 
-         For more details see Documentation/kdump/kdump.rst
+         For more details see Documentation/admin-guide/kdump/kdump.rst
 
 config KEXEC_JUMP
        bool "kexec jump (EXPERIMENTAL)"
index d0bbca65e4a420c1046facee47a98b8a696f9c9b..9505066b7ba3dd41b71405998a6f0e5bf054d158 100644 (file)
@@ -2057,7 +2057,7 @@ config CRASH_DUMP
          to a memory address not used by the main kernel or BIOS using
          PHYSICAL_START, or it must be built as a relocatable image
          (CONFIG_RELOCATABLE=y).
-         For more details see Documentation/kdump/kdump.rst
+         For more details see Documentation/admin-guide/kdump/kdump.rst
 
 config 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 "X" value as specified in the "crashkernel=YM@XM"
          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.
 
          Usage of bzImage for capturing the crash dump is recommended as