Skip to content

Commit 52b36a6

Browse files
skywxFangerhankur
authored andcommitted
Update CN translation for coredump
1 parent 617f5a7 commit 52b36a6

File tree

2 files changed

+19
-17
lines changed

2 files changed

+19
-17
lines changed

docs/en/api-guides/core_dump.rst

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -59,22 +59,24 @@ Setting this option to 0 bytes will cause the core dump routines to run from the
5959
If a separate stack is used, the recommended stack size should be larger than 1300 bytes to ensure that the core dump routines themselves do not cause a stack overflow.
6060

6161

62-
Core Dump Memory Regions
63-
^^^^^^^^^^^^^^^^^^^^^^^^
62+
.. only:: not esp32c5
6463

65-
By default, core dumps typically save CPU registers, tasks data and summary of the panic reason. When the :ref:`CONFIG_ESP_COREDUMP_CAPTURE_DRAM` option is selected, ``.bss`` and ``.data`` sections and ``heap`` data will also be part of the dump.
64+
Core Dump Memory Regions
65+
^^^^^^^^^^^^^^^^^^^^^^^^
6666

67-
For a better debugging experience, it is recommended to dump these sections. However, this will result in a larger coredump file. The required additional storage space may vary based on the amount of DRAM the application uses.
67+
By default, core dumps typically save CPU registers, tasks data and summary of the panic reason. When the :ref:`CONFIG_ESP_COREDUMP_CAPTURE_DRAM` option is selected, ``.bss`` and ``.data`` sections and ``heap`` data will also be part of the dump.
6868

69-
.. note::
69+
For a better debugging experience, it is recommended to dump these sections. However, this will result in a larger coredump file. The required additional storage space may vary based on the amount of DRAM the application uses.
7070

7171
.. only:: SOC_SPIRAM_SUPPORTED
7272

73-
Apart from the crashed task's TCB and stack, data located in the external RAM will not be stored in the core dump file, this include variables defined with ``EXT_RAM_BSS_ATTR`` or ``EXT_RAM_NOINIT_ATTR`` attributes, as well as any data stored in the ``extram_bss`` section.
73+
.. note::
7474

75-
.. note::
75+
Apart from the crashed task's TCB and stack, data located in the external RAM will not be stored in the core dump file, this include variables defined with ``EXT_RAM_BSS_ATTR`` or ``EXT_RAM_NOINIT_ATTR`` attributes, as well as any data stored in the ``extram_bss`` section.
76+
77+
.. note::
7678

77-
This feature is only enabled when using the ELF file format.
79+
This feature is only enabled when using the ELF file format.
7880

7981
Core Dump to Flash
8082
------------------

docs/zh_CN/api-guides/core_dump.rst

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -58,24 +58,24 @@ ELF 格式具备扩展特性,支持在发生崩溃时保存更多关于错误
5858

5959
如果使用了独立的栈,建议栈大小应大于 1300 字节,确保核心转储例程本身不会导致栈溢出。
6060

61+
.. only:: not esp32c5
6162

62-
Core Dump Memory Regions
63-
^^^^^^^^^^^^^^^^^^^^^^^^
63+
核心转储内存区域
64+
^^^^^^^^^^^^^^^^
6465

65-
By default, core dumps typically save CPU registers, tasks data and summary of the panic reason. When the :ref:`CONFIG_ESP_COREDUMP_CAPTURE_DRAM` option is selected, ``.bss`` and ``.data`` sections and ``heap`` data will also be part of the dump.
66+
核心转储默认保存 CPU 寄存器、任务数据和崩溃原因。选择 :ref:`CONFIG_ESP_COREDUMP_CAPTURE_DRAM` 选项后,``.bss`` 段和 ``.data`` 段以及 ``heap`` 数据也将保存到转储中。
6667

67-
For a better debugging experience, it is recommended to dump these sections. However, this will result in a larger coredump file. The required additional storage space may vary based on the amount of DRAM the application uses.
68-
69-
.. note::
68+
推荐将上面提到的几个数据段都保存到核心转储中,以方便调试。但这会导致核心转储文件变大,具体所需的额外存储空间取决于应用程序使用的 DRAM 大小。
7069

7170
.. only:: SOC_SPIRAM_SUPPORTED
7271

73-
Apart from the crashed task's TCB and stack, data located in the external RAM will not be stored in the core dump file, this include variables defined with ``EXT_RAM_BSS_ATTR`` or ``EXT_RAM_NOINIT_ATTR`` attributes, as well as any data stored in the ``extram_bss`` section.
72+
.. note::
7473

75-
.. note::
74+
除了崩溃任务的 TCB 和栈外,位于外部 RAM 中的数据不会保存到核心转储文件中,包括使用 ``EXT_RAM_BSS_ATTR`` 或 ``EXT_RAM_NOINIT_ATTR`` 属性定义的变量,以及存储在 ``extram_bss`` 段中的任何数据。
7675

77-
This feature is only enabled when using the ELF file format.
76+
.. note::
7877

78+
该功能仅在使用 ELF 文件格式时可用。
7979

8080
将核心转储保存到 flash
8181
-----------------------

0 commit comments

Comments
 (0)