[PATCH v2] docs/zh_CN: Update the translation of dev-tools/ubsan to v6.14-rc1

WangYuli posted 1 patch 1 year ago
There is a newer version of this series
.../translations/zh_CN/dev-tools/ubsan.rst    | 35 +++++++++----------
1 file changed, 17 insertions(+), 18 deletions(-)
[PATCH v2] docs/zh_CN: Update the translation of dev-tools/ubsan to v6.14-rc1
Posted by WangYuli 1 year ago
Commit 918327e9b7ff ("ubsan: Remove CONFIG_UBSAN_SANITIZE_ALL")
removed the CONFIG_UBSAN_SANITIZE_ALL configuration option. Update
the Chinese documentation accordingly and revise the document format
by the way.

Link: https://lore.kernel.org/all/6F05157E5E157493+20250123043258.149643-1-wangyuli@uniontech.com/
Signed-off-by: WangYuli <wangyuli@uniontech.com>
---
Changelog:
 *v1->v2: Update commit title to v6.14-rc1 and add Dongliang Mu's Chinese name.
---
 .../translations/zh_CN/dev-tools/ubsan.rst    | 35 +++++++++----------
 1 file changed, 17 insertions(+), 18 deletions(-)

diff --git a/Documentation/translations/zh_CN/dev-tools/ubsan.rst b/Documentation/translations/zh_CN/dev-tools/ubsan.rst
index 2487696b3772..a4d4d4c6d157 100644
--- a/Documentation/translations/zh_CN/dev-tools/ubsan.rst
+++ b/Documentation/translations/zh_CN/dev-tools/ubsan.rst
@@ -3,7 +3,16 @@
 .. include:: ../disclaimer-zh_CN.rst
 
 :Original: Documentation/dev-tools/ubsan.rst
-:Translator: Dongliang Mu <dzm91@hust.edu.cn>
+
+:翻译:
+
+ 慕冬亮 Dongliang Mu <dzm91@hust.edu.cn>
+
+:校译:
+
+ 王昱力 WangYuli <wangyuli@uniontech.com>
+
+.. _cn_ubsan:
 
 未定义行为消毒剂 - UBSAN
 ====================================
@@ -55,30 +64,20 @@ GCC自4.9.x [1_] (详见 ``-fsanitize=undefined`` 选项及其子选项)版
 
 使用如下内核配置启用UBSAN::
 
-	CONFIG_UBSAN=y
-
-使用如下内核配置检查整个内核::
-
-        CONFIG_UBSAN_SANITIZE_ALL=y
+  CONFIG_UBSAN=y
 
-为了在特定文件或目录启动代码插桩,需要在相应的内核Makefile中添加一行类似内容:
-
-- 单文件(如main.o)::
-
-    UBSAN_SANITIZE_main.o := y
-
-- 一个目录中的所有文件::
-
-    UBSAN_SANITIZE := y
-
-即使设置了``CONFIG_UBSAN_SANITIZE_ALL=y``,为了避免文件被插桩,可使用::
+排除要被检测的文件::
 
   UBSAN_SANITIZE_main.o := n
 
-与::
+排除一个目录中的所有文件::
 
   UBSAN_SANITIZE := n
 
+当全部文件都被禁用,可通过如下方式为特定文件启用::
+
+  UBSAN_SANITIZE_main.o := y
+
 未对齐的内存访问检测可通过开启独立选项 - CONFIG_UBSAN_ALIGNMENT 检测。
 该选项在支持未对齐访问的架构上(CONFIG_HAVE_EFFICIENT_UNALIGNED_ACCESS=y)
 默认为关闭。该选项仍可通过内核配置启用,但它将产生大量的UBSAN报告。
-- 
2.47.2

Re: [PATCH v2] docs/zh_CN: Update the translation of dev-tools/ubsan to v6.14-rc1
Posted by Yanteng Si 1 year ago
在 2/7/25 11:18 AM, WangYuli 写道:
> Commit 918327e9b7ff ("ubsan: Remove CONFIG_UBSAN_SANITIZE_ALL")
> removed the CONFIG_UBSAN_SANITIZE_ALL configuration option. Update
> the Chinese documentation accordingly and revise the document format
> by the way.
>
> Link: https://lore.kernel.org/all/6F05157E5E157493+20250123043258.149643-1-wangyuli@uniontech.com/
> Signed-off-by: WangYuli <wangyuli@uniontech.com>
> ---
> Changelog:
>   *v1->v2: Update commit title to v6.14-rc1 and add Dongliang Mu's Chinese name.
> ---
>   .../translations/zh_CN/dev-tools/ubsan.rst    | 35 +++++++++----------
>   1 file changed, 17 insertions(+), 18 deletions(-)
>
> diff --git a/Documentation/translations/zh_CN/dev-tools/ubsan.rst b/Documentation/translations/zh_CN/dev-tools/ubsan.rst
> index 2487696b3772..a4d4d4c6d157 100644
> --- a/Documentation/translations/zh_CN/dev-tools/ubsan.rst
> +++ b/Documentation/translations/zh_CN/dev-tools/ubsan.rst
> @@ -3,7 +3,16 @@
>   .. include:: ../disclaimer-zh_CN.rst
>   
>   :Original: Documentation/dev-tools/ubsan.rst
> -:Translator: Dongliang Mu <dzm91@hust.edu.cn>
> +
> +:翻译:
> +
> + 慕冬亮 Dongliang Mu <dzm91@hust.edu.cn>
> +
> +:校译:
> +
> + 王昱力 WangYuli <wangyuli@uniontech.com>
> +

> +.. _cn_ubsan:
we don't need the tag.
>   
>   未定义行为消毒剂 - UBSAN
>   ====================================
> @@ -55,30 +64,20 @@ GCC自4.9.x [1_] (详见 ``-fsanitize=undefined`` 选项及其子选项)版
>   
>   使用如下内核配置启用UBSAN::
>   
> -	CONFIG_UBSAN=y
> -
> -使用如下内核配置检查整个内核::
> -

> -        CONFIG_UBSAN_SANITIZE_ALL=y
> +  CONFIG_UBSAN=y

Please keep the indentation length consistent with the original one.

Thanks,

Yanteng

Re: [PATCH v2] docs/zh_CN: Update the translation of dev-tools/ubsan to v6.14-rc1
Posted by WangYuli 1 year ago
On 2025/2/7 16:37, Yanteng Si wrote:

>
>> +.. _cn_ubsan:
> we don't need the tag.
OK, will send patch v3.
>>     未定义行为消毒剂 - UBSAN
>>   ====================================
>> @@ -55,30 +64,20 @@ GCC自4.9.x [1_] (详见 ``-fsanitize=undefined`` 
>> 选项及其子选项)版
>>     使用如下内核配置启用UBSAN::
>>   -    CONFIG_UBSAN=y
>> -
>> -使用如下内核配置检查整个内核::
>> -
>
>> -        CONFIG_UBSAN_SANITIZE_ALL=y
>> +  CONFIG_UBSAN=y
>
> Please keep the indentation length consistent with the original one.
>
>
It already does.

Please see commit 918327e9b7ffb45321cbb4b9b86b58ec555fe6b3 ("ubsan: Remove

CONFIG_UBSAN_SANITIZE_ALL")'s change of 
Documentation/dev-tools/ubsan.rst for

the details.


Thanks,

-- 
WangYuli