2021-06-05 12:15:01

by Hu Haowen

[permalink] [raw]
Subject: [PATCH v3] docs/zh_CN: create new translations for zh_CN/dev-tools/testing-overview

Create new translations for dev-tools/testing-overview.rst and link it
to dev-tools/index.rst with TODOList modifications.

Signed-off-by: Hu Haowen <[email protected]>
---
.../translations/zh_CN/dev-tools/index.rst | 5 +
.../zh_CN/dev-tools/testing-overview.rst | 110 ++++++++++++++++++
2 files changed, 115 insertions(+)
create mode 100644 Documentation/translations/zh_CN/dev-tools/testing-overview.rst

diff --git a/Documentation/translations/zh_CN/dev-tools/index.rst b/Documentation/translations/zh_CN/dev-tools/index.rst
index fd73c479917b..6424590ea382 100644
--- a/Documentation/translations/zh_CN/dev-tools/index.rst
+++ b/Documentation/translations/zh_CN/dev-tools/index.rst
@@ -11,6 +11,9 @@
目前这些文档已经整理在一起,不需要再花费额外的精力。
欢迎任何补丁。

+有关测试专用工具的简要概述,参见
+Documentation/dev-tools/translations/zh_CN/testing-overview.rst
+
.. class:: toc-title

目录
@@ -19,6 +22,7 @@
:maxdepth: 2

gcov
+ testing-overview

Todolist:

@@ -29,6 +33,7 @@ Todolist:
- ubsan
- kmemleak
- kcsan
+ - kfence
- gdb-kernel-debugging
- kgdb
- kselftest
diff --git a/Documentation/translations/zh_CN/dev-tools/testing-overview.rst b/Documentation/translations/zh_CN/dev-tools/testing-overview.rst
new file mode 100644
index 000000000000..a2746c81033b
--- /dev/null
+++ b/Documentation/translations/zh_CN/dev-tools/testing-overview.rst
@@ -0,0 +1,110 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/dev-tools/testing-overview.rst
+:Translator: 胡皓文 Hu Haowen <[email protected]>
+
+============
+内核测试指南
+============
+
+有许多不同的工具可以用于测试Linux内核,因此了解什么时候使用它们可能
+很困难。本文档粗略概述了它们之间的区别,并阐释了它们是怎样糅合在一起
+的。
+
+编写和运行测试
+==============
+
+大多数内核测试都是用kselftest或KUnit框架之一编写的。它们都让运行测试
+更加简化,并为编写新测试提供帮助。
+
+如果你想验证内核的行为——尤其是内核的特定部分——那你就要使用kUnit或
+kselftest。
+
+KUnit和kselftest的区别
+----------------------
+
+.. note::
+ 由于本文段中部分术语尚无较好的对应中文释义,可能导致与原文含义
+ 存在些许差异,因此建议读者结合原文
+ (Documentation/dev-tools/testing-overview.rst)辅助阅读。
+
+ 如对部分翻译有异议或有更好的翻译意见,欢迎联系译者进行修订。
+
+KUnit(Documentation/dev-tools/kunit/index.rst)是用于“白箱”测
+试的一个完整的内核内部系统:因为测试代码是内核的一部分,所以它能够访
+问用户空间不能访问到的内部结构和功能。
+
+因此,KUnit测试最好针对内核中较小的、自包含的部分,以便能够独立地测
+试。“单元”测试的概念亦是如此。
+
+比如,一个KUnit测试可能测试一个单独的内核功能(甚至通过一个函数测试
+一个单一的代码路径,例如一个错误处理案例),而不是整个地测试一个特性。
+
+这也使得KUnit测试构建和运行非常地快,从而能够作为开发流程的一部分被
+频繁地运行。
+
+有关更详细的介绍,请参阅KUnit测试代码风格指南
+Documentation/dev-tools/kunit/style.rst
+
+kselftest(Documentation/dev-tools/kselftest.rst),相对来说,大量用
+于用户空间,并且通常测试用户空间的脚本或程序。
+
+这使得编写复杂的测试,或者需要操作更多全局系统状态的测试更加容易(诸
+如生成进程之类)。然而,从kselftest直接调用内核函数是不行的。这也就
+意味着只有通过某种方式(如系统调用、驱动设备、文件系统等)导出到了用
+户空间的内核功能才能使用kselftest来测试。为此,有些测试包含了一个伴
+生的内核模块用于导出更多的信息和功能。不过,对于基本上或者完全在内核
+中运行的测试,KUnit可能是更佳工具。
+
+kselftest也因此非常适合于全部功能的测试,因为这些功能会将接口暴露到
+用户空间,从而能够被测试,而不是展现实现细节。“system”测试和
+“end-to-end”测试亦是如此。
+
+比如,一个新的系统调用应该伴随有新的kselftest测试。
+
+代码覆盖率工具
+==============
+
+支持两种不同代码之间的覆盖率测量工具。它们可以用来验证一项测试执行的
+确切函数或代码行。这有助于决定内核被测试了多少,或用来查找合适的测试
+中没有覆盖到的极端情况。
+
+:doc:`gcov` 是GCC的覆盖率测试工具,能用于获取内核的全局或每个模块的
+覆盖率。与KCOV不同的是,这个工具不记录每个任务的覆盖率。覆盖率数据可
+以通过debugfs读取,并通过常规的gcov工具进行解释。
+
+:doc:`kcov` 是能够构建在内核之中,用于在每个任务的层面捕捉覆盖率的一
+个功能。因此,它对于模糊测试和关于代码执行期间信息的其它情况非常有用,
+比如在一个单一系统调用里使用它就很有用。
+
+动态分析工具
+============
+
+内核也支持许多动态分析工具,用以检测正在运行的内核中出现的多种类型的
+问题。这些工具通常每个去寻找一类不同的缺陷,比如非法内存访问,数据竞
+争等并发问题,或整型溢出等其他未定义行为。
+
+如下所示:
+
+* kmemleak检测可能的内存泄漏。参阅
+ Documentation/dev-tools/kmemleak.rst
+* KASAN检测非法内存访问,如数组越界和释放后重用(UAF)。参阅
+ Documentation/dev-tools/kasan.rst
+* UBSAN检测C标准中未定义的行为,如整型溢出。参阅
+ Documentation/dev-tools/ubsan.rst
+* KCSAN检测数据竞争。参阅 Documentation/dev-tools/kcsan.rst
+* KFENCE是一个低开销的内存问题检测器,比KASAN更快且能被用于批量构建。
+ 参阅 Documentation/dev-tools/kfence.rst
+* lockdep是一个锁定正确性检测器。参阅
+ Documentation/locking/lockdep-design.rst
+* 除此以外,在内核中还有一些其它的调试工具,大多数能在
+ lib/Kconfig.debug 中找到。
+
+这些工具倾向于对内核进行整体测试,并且不像kselftest和KUnit一样“传递”。
+它们可以通过在启用这些工具时运行内核测试以与kselftest或KUnit结合起来:
+之后你就能确保这些错误在测试过程中都不会发生了。
+
+一些工具与KUnit和kselftest集成,并且在检测到问题时会自动打断测试。
+
--
2.25.1


2021-06-08 02:56:42

by Hu Haowen

[permalink] [raw]
Subject: Re: [PATCH v3] docs/zh_CN: create new translations for zh_CN/dev-tools/testing-overview


在 2021/6/8 上午10:44, Wu X.C. 写道:
> On Sat, Jun 05, 2021 at 08:05:04PM +0800, Hu Haowen wrote:
>> Create new translations for dev-tools/testing-overview.rst and link it
>> to dev-tools/index.rst with TODOList modifications.
>>
>> Signed-off-by: Hu Haowen <[email protected]>
>> ---
>> .../translations/zh_CN/dev-tools/index.rst | 5 +
>> .../zh_CN/dev-tools/testing-overview.rst | 110 ++++++++++++++++++
> [...]
>> +
>> +代码覆盖率工具
>> +==============
>> +
>> +支持两种不同代码之间的覆盖率测量工具。它们可以用来验证一项测试执行的
> Linux内核支持两种不同的代码覆盖率测试工具。


But you mentioned that this sentence should be
"支持两种不同代码之间的覆盖率测量工具" in
the previous email. Should I take this version or the previous version?


Thx,

Hu Haowen


>
>> +确切函数或代码行。这有助于决定内核被测试了多少,或用来查找合适的测试
>> +中没有覆盖到的极端情况。
>> +
> OK, good job!
>
> Just need to fix a small problem, after that
>
> Reviewed-by: Wu XiangCheng <[email protected]>
> Thanks,
> Wu X.C.

2021-06-08 02:57:28

by Wu XiangCheng

[permalink] [raw]
Subject: Re: [PATCH v3] docs/zh_CN: create new translations for zh_CN/dev-tools/testing-overview

On Sat, Jun 05, 2021 at 08:05:04PM +0800, Hu Haowen wrote:
> Create new translations for dev-tools/testing-overview.rst and link it
> to dev-tools/index.rst with TODOList modifications.
>
> Signed-off-by: Hu Haowen <[email protected]>
> ---
> .../translations/zh_CN/dev-tools/index.rst | 5 +
> .../zh_CN/dev-tools/testing-overview.rst | 110 ++++++++++++++++++
[...]
> +
> +代码覆盖率工具
> +==============
> +
> +支持两种不同代码之间的覆盖率测量工具。它们可以用来验证一项测试执行的

Linux内核支持两种不同的代码覆盖率测试工具。

> +确切函数或代码行。这有助于决定内核被测试了多少,或用来查找合适的测试
> +中没有覆盖到的极端情况。
> +

OK, good job!

Just need to fix a small problem, after that

Reviewed-by: Wu XiangCheng <[email protected]>

Thanks,
Wu X.C.


Attachments:
(No filename) (904.00 B)
signature.asc (673.00 B)
Download all attachments

2021-06-08 03:18:19

by Wu XiangCheng

[permalink] [raw]
Subject: Re: [PATCH v3] docs/zh_CN: create new translations for zh_CN/dev-tools/testing-overview

On Tue, Jun 08, 2021 at 10:53:20AM +0800, Hu Haowen wrote:
>
> 在 2021/6/8 上午10:44, Wu X.C. 写道:
> > On Sat, Jun 05, 2021 at 08:05:04PM +0800, Hu Haowen wrote:
> > > Create new translations for dev-tools/testing-overview.rst and link it
> > > to dev-tools/index.rst with TODOList modifications.
> > >
> > > Signed-off-by: Hu Haowen <[email protected]>
> > > ---
> > > .../translations/zh_CN/dev-tools/index.rst | 5 +
> > > .../zh_CN/dev-tools/testing-overview.rst | 110 ++++++++++++++++++
> > [...]
> > > +
> > > +代码覆盖率工具
> > > +==============
> > > +
> > > +支持两种不同代码之间的覆盖率测量工具。它们可以用来验证一项测试执行的
> > Linux内核支持两种不同的代码覆盖率测试工具。
>
>
> But you mentioned that this sentence should be
> "支持两种不同代码之间的覆盖率测量工具" in
> the previous email. Should I take this version or the previous version?
>

Actually was "支持两种不同的代码覆盖率测试工具。"
<https://lore.kernel.org/linux-doc/[email protected]/>

I forgot the head and you added something in the middle :)

Please use the new version.

Thanks,
Wu

>
> Thx,
>
> Hu Haowen
>
>
> >
> > > +确切函数或代码行。这有助于决定内核被测试了多少,或用来查找合适的测试
> > > +中没有覆盖到的极端情况。
> > > +
> > OK, good job!
> >
> > Just need to fix a small problem, after that
> >
> > Reviewed-by: Wu XiangCheng <[email protected]>
> > Thanks,
> > Wu X.C.


Attachments:
(No filename) (1.56 kB)
signature.asc (673.00 B)
Download all attachments

2021-06-08 03:29:12

by Hu Haowen

[permalink] [raw]
Subject: Re: [PATCH v3] docs/zh_CN: create new translations for zh_CN/dev-tools/testing-overview


在 2021/6/8 上午11:14, Wu X.C. 写道:
> On Tue, Jun 08, 2021 at 10:53:20AM +0800, Hu Haowen wrote:
>> 在 2021/6/8 上午10:44, Wu X.C. 写道:
>>> On Sat, Jun 05, 2021 at 08:05:04PM +0800, Hu Haowen wrote:
>>>> Create new translations for dev-tools/testing-overview.rst and link it
>>>> to dev-tools/index.rst with TODOList modifications.
>>>>
>>>> Signed-off-by: Hu Haowen <[email protected]>
>>>> ---
>>>> .../translations/zh_CN/dev-tools/index.rst | 5 +
>>>> .../zh_CN/dev-tools/testing-overview.rst | 110 ++++++++++++++++++
>>> [...]
>>>> +
>>>> +代码覆盖率工具
>>>> +==============
>>>> +
>>>> +支持两种不同代码之间的覆盖率测量工具。它们可以用来验证一项测试执行的
>>> Linux内核支持两种不同的代码覆盖率测试工具。
>>
>> But you mentioned that this sentence should be
>> "支持两种不同代码之间的覆盖率测量工具" in
>> the previous email. Should I take this version or the previous version?
>>
> Actually was "支持两种不同的代码覆盖率测试工具。"
> <https://lore.kernel.org/linux-doc/[email protected]/>
>
> I forgot the head and you added something in the middle :)
>
> Please use the new version.


So here is nothing to be fixed now. Is this patch applied?

Thx,
Hu Haowen


> Thanks,
> Wu
>
>> Thx,
>>
>> Hu Haowen
>>
>>
>>>> +确切函数或代码行。这有助于决定内核被测试了多少,或用来查找合适的测试
>>>> +中没有覆盖到的极端情况。
>>>> +
>>> OK, good job!
>>>
>>> Just need to fix a small problem, after that
>>>
>>> Reviewed-by: Wu XiangCheng <[email protected]>
>>> Thanks,
>>> Wu X.C.

2021-06-09 13:22:13

by Hu Haowen

[permalink] [raw]
Subject: Re: [PATCH v3] docs/zh_CN: create new translations for zh_CN/dev-tools/testing-overview


在 2021/6/9 上午11:22, teng sterling 写道:
> Hi Haowen
>
> Thank you for your translation!
>
> Hu Haowen <[email protected]> 于2021年6月5日周六 下午8:13写道:
>> Create new translations for dev-tools/testing-overview.rst and link it
>> to dev-tools/index.rst with TODOList modifications.
>>
>> Signed-off-by: Hu Haowen <[email protected]>
>> ---
>> .../translations/zh_CN/dev-tools/index.rst | 5 +
>> .../zh_CN/dev-tools/testing-overview.rst | 110 ++++++++++++++++++
>> 2 files changed, 115 insertions(+)
>> create mode 100644 Documentation/translations/zh_CN/dev-tools/testing-overview.rst
>>
>> diff --git a/Documentation/translations/zh_CN/dev-tools/index.rst b/Documentation/translations/zh_CN/dev-tools/index.rst
>> index fd73c479917b..6424590ea382 100644
>> --- a/Documentation/translations/zh_CN/dev-tools/index.rst
>> +++ b/Documentation/translations/zh_CN/dev-tools/index.rst
>> @@ -11,6 +11,9 @@
>> 目前这些文档已经整理在一起,不需要再花费额外的精力。
>> 欢迎任何补丁。
>>
>> +有关测试专用工具的简要概述,参见
>> +Documentation/dev-tools/translations/zh_CN/testing-overview.rst
>> +
>> .. class:: toc-title
>>
>> 目录
>> @@ -19,6 +22,7 @@
>> :maxdepth: 2
>>
>> gcov
>> + testing-overview
>>
>> Todolist:
>>
>> @@ -29,6 +33,7 @@ Todolist:
>> - ubsan
>> - kmemleak
>> - kcsan
>> + - kfence
>> - gdb-kernel-debugging
>> - kgdb
>> - kselftest
>> diff --git a/Documentation/translations/zh_CN/dev-tools/testing-overview.rst b/Documentation/translations/zh_CN/dev-tools/testing-overview.rst
>> new file mode 100644
>> index 000000000000..a2746c81033b
>> --- /dev/null
>> +++ b/Documentation/translations/zh_CN/dev-tools/testing-overview.rst
>> @@ -0,0 +1,110 @@
>> +.. SPDX-License-Identifier: GPL-2.0
>> +
>> +.. include:: ../disclaimer-zh_CN.rst
>> +
>> +:Original: Documentation/dev-tools/testing-overview.rst
>> +:Translator: 胡皓文 Hu Haowen <[email protected]>
>> +
>> +============
>> +内核测试指南
>> +============
>> +
>> +有许多不同的工具可以用于测试Linux内核,因此了解什么时候使用它们可能
> here origin doc: There are a number of different tools for testing the
> Linux kernel, so knowing when to use *each of them* can be a
> challenge.
>
> how about?
> 有许多不同的工具可以用于测试Linux内核,因此搞明白使用每一种工具的时机可能是一个挑战。


Nice advice. Thanks for pointing it out. I'll send patch v4.


Thx,

Hu Haowen


>
> Your translation is fine, so decide for yourself which one you want to use.
>
> Reviewed-by: Yanteng Si <[email protected]>
>
> Thanks,
> Yanteng
>
>> +很困难。本文档粗略概述了它们之间的区别,并阐释了它们是怎样糅合在一起
>> +的。
>> +
>> +编写和运行测试
>> +==============
>> +
>> +大多数内核测试都是用kselftest或KUnit框架之一编写的。它们都让运行测试
>> +更加简化,并为编写新测试提供帮助。
>> +
>> +如果你想验证内核的行为——尤其是内核的特定部分——那你就要使用kUnit或
>> +kselftest。
>> +
>> +KUnit和kselftest的区别
>> +----------------------
>> +
>> +.. note::
>> + 由于本文段中部分术语尚无较好的对应中文释义,可能导致与原文含义
>> + 存在些许差异,因此建议读者结合原文
>> + (Documentation/dev-tools/testing-overview.rst)辅助阅读。
>> +
>> + 如对部分翻译有异议或有更好的翻译意见,欢迎联系译者进行修订。
>> +
>> +KUnit(Documentation/dev-tools/kunit/index.rst)是用于“白箱”测
>> +试的一个完整的内核内部系统:因为测试代码是内核的一部分,所以它能够访
>> +问用户空间不能访问到的内部结构和功能。
>> +
>> +因此,KUnit测试最好针对内核中较小的、自包含的部分,以便能够独立地测
>> +试。“单元”测试的概念亦是如此。
>> +
>> +比如,一个KUnit测试可能测试一个单独的内核功能(甚至通过一个函数测试
>> +一个单一的代码路径,例如一个错误处理案例),而不是整个地测试一个特性。
>> +
>> +这也使得KUnit测试构建和运行非常地快,从而能够作为开发流程的一部分被
>> +频繁地运行。
>> +
>> +有关更详细的介绍,请参阅KUnit测试代码风格指南
>> +Documentation/dev-tools/kunit/style.rst
>> +
>> +kselftest(Documentation/dev-tools/kselftest.rst),相对来说,大量用
>> +于用户空间,并且通常测试用户空间的脚本或程序。
>> +
>> +这使得编写复杂的测试,或者需要操作更多全局系统状态的测试更加容易(诸
>> +如生成进程之类)。然而,从kselftest直接调用内核函数是不行的。这也就
>> +意味着只有通过某种方式(如系统调用、驱动设备、文件系统等)导出到了用
>> +户空间的内核功能才能使用kselftest来测试。为此,有些测试包含了一个伴
>> +生的内核模块用于导出更多的信息和功能。不过,对于基本上或者完全在内核
>> +中运行的测试,KUnit可能是更佳工具。
>> +
>> +kselftest也因此非常适合于全部功能的测试,因为这些功能会将接口暴露到
>> +用户空间,从而能够被测试,而不是展现实现细节。“system”测试和
>> +“end-to-end”测试亦是如此。
>> +
>> +比如,一个新的系统调用应该伴随有新的kselftest测试。
>> +
>> +代码覆盖率工具
>> +==============
>> +
>> +支持两种不同代码之间的覆盖率测量工具。它们可以用来验证一项测试执行的
>> +确切函数或代码行。这有助于决定内核被测试了多少,或用来查找合适的测试
>> +中没有覆盖到的极端情况。
>> +
>> +:doc:`gcov` 是GCC的覆盖率测试工具,能用于获取内核的全局或每个模块的
>> +覆盖率。与KCOV不同的是,这个工具不记录每个任务的覆盖率。覆盖率数据可
>> +以通过debugfs读取,并通过常规的gcov工具进行解释。
>> +
>> +:doc:`kcov` 是能够构建在内核之中,用于在每个任务的层面捕捉覆盖率的一
>> +个功能。因此,它对于模糊测试和关于代码执行期间信息的其它情况非常有用,
>> +比如在一个单一系统调用里使用它就很有用。
>> +
>> +动态分析工具
>> +============
>> +
>> +内核也支持许多动态分析工具,用以检测正在运行的内核中出现的多种类型的
>> +问题。这些工具通常每个去寻找一类不同的缺陷,比如非法内存访问,数据竞
>> +争等并发问题,或整型溢出等其他未定义行为。
>> +
>> +如下所示:
>> +
>> +* kmemleak检测可能的内存泄漏。参阅
>> + Documentation/dev-tools/kmemleak.rst
>> +* KASAN检测非法内存访问,如数组越界和释放后重用(UAF)。参阅
>> + Documentation/dev-tools/kasan.rst
>> +* UBSAN检测C标准中未定义的行为,如整型溢出。参阅
>> + Documentation/dev-tools/ubsan.rst
>> +* KCSAN检测数据竞争。参阅 Documentation/dev-tools/kcsan.rst
>> +* KFENCE是一个低开销的内存问题检测器,比KASAN更快且能被用于批量构建。
>> + 参阅 Documentation/dev-tools/kfence.rst
>> +* lockdep是一个锁定正确性检测器。参阅
>> + Documentation/locking/lockdep-design.rst
>> +* 除此以外,在内核中还有一些其它的调试工具,大多数能在
>> + lib/Kconfig.debug 中找到。
>> +
>> +这些工具倾向于对内核进行整体测试,并且不像kselftest和KUnit一样“传递”。
>> +它们可以通过在启用这些工具时运行内核测试以与kselftest或KUnit结合起来:
>> +之后你就能确保这些错误在测试过程中都不会发生了。
>> +
>> +一些工具与KUnit和kselftest集成,并且在检测到问题时会自动打断测试。
>> +
>> --
>> 2.25.1
>>

2021-06-09 17:06:50

by teng sterling

[permalink] [raw]
Subject: Re: [PATCH v3] docs/zh_CN: create new translations for zh_CN/dev-tools/testing-overview

Hi Haowen

Thank you for your translation!

Hu Haowen <[email protected]> 于2021年6月5日周六 下午8:13写道:
>
> Create new translations for dev-tools/testing-overview.rst and link it
> to dev-tools/index.rst with TODOList modifications.
>
> Signed-off-by: Hu Haowen <[email protected]>
> ---
> .../translations/zh_CN/dev-tools/index.rst | 5 +
> .../zh_CN/dev-tools/testing-overview.rst | 110 ++++++++++++++++++
> 2 files changed, 115 insertions(+)
> create mode 100644 Documentation/translations/zh_CN/dev-tools/testing-overview.rst
>
> diff --git a/Documentation/translations/zh_CN/dev-tools/index.rst b/Documentation/translations/zh_CN/dev-tools/index.rst
> index fd73c479917b..6424590ea382 100644
> --- a/Documentation/translations/zh_CN/dev-tools/index.rst
> +++ b/Documentation/translations/zh_CN/dev-tools/index.rst
> @@ -11,6 +11,9 @@
> 目前这些文档已经整理在一起,不需要再花费额外的精力。
> 欢迎任何补丁。
>
> +有关测试专用工具的简要概述,参见
> +Documentation/dev-tools/translations/zh_CN/testing-overview.rst
> +
> .. class:: toc-title
>
> 目录
> @@ -19,6 +22,7 @@
> :maxdepth: 2
>
> gcov
> + testing-overview
>
> Todolist:
>
> @@ -29,6 +33,7 @@ Todolist:
> - ubsan
> - kmemleak
> - kcsan
> + - kfence
> - gdb-kernel-debugging
> - kgdb
> - kselftest
> diff --git a/Documentation/translations/zh_CN/dev-tools/testing-overview.rst b/Documentation/translations/zh_CN/dev-tools/testing-overview.rst
> new file mode 100644
> index 000000000000..a2746c81033b
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/dev-tools/testing-overview.rst
> @@ -0,0 +1,110 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/dev-tools/testing-overview.rst
> +:Translator: 胡皓文 Hu Haowen <[email protected]>
> +
> +============
> +内核测试指南
> +============
> +
> +有许多不同的工具可以用于测试Linux内核,因此了解什么时候使用它们可能
here origin doc: There are a number of different tools for testing the
Linux kernel, so knowing when to use *each of them* can be a
challenge.

how about?
有许多不同的工具可以用于测试Linux内核,因此搞明白使用每一种工具的时机可能是一个挑战。

Your translation is fine, so decide for yourself which one you want to use.

Reviewed-by: Yanteng Si <[email protected]>

Thanks,
Yanteng

> +很困难。本文档粗略概述了它们之间的区别,并阐释了它们是怎样糅合在一起
> +的。
> +
> +编写和运行测试
> +==============
> +
> +大多数内核测试都是用kselftest或KUnit框架之一编写的。它们都让运行测试
> +更加简化,并为编写新测试提供帮助。
> +
> +如果你想验证内核的行为——尤其是内核的特定部分——那你就要使用kUnit或
> +kselftest。
> +
> +KUnit和kselftest的区别
> +----------------------
> +
> +.. note::
> + 由于本文段中部分术语尚无较好的对应中文释义,可能导致与原文含义
> + 存在些许差异,因此建议读者结合原文
> + (Documentation/dev-tools/testing-overview.rst)辅助阅读。
> +
> + 如对部分翻译有异议或有更好的翻译意见,欢迎联系译者进行修订。
> +
> +KUnit(Documentation/dev-tools/kunit/index.rst)是用于“白箱”测
> +试的一个完整的内核内部系统:因为测试代码是内核的一部分,所以它能够访
> +问用户空间不能访问到的内部结构和功能。
> +
> +因此,KUnit测试最好针对内核中较小的、自包含的部分,以便能够独立地测
> +试。“单元”测试的概念亦是如此。
> +
> +比如,一个KUnit测试可能测试一个单独的内核功能(甚至通过一个函数测试
> +一个单一的代码路径,例如一个错误处理案例),而不是整个地测试一个特性。
> +
> +这也使得KUnit测试构建和运行非常地快,从而能够作为开发流程的一部分被
> +频繁地运行。
> +
> +有关更详细的介绍,请参阅KUnit测试代码风格指南
> +Documentation/dev-tools/kunit/style.rst
> +
> +kselftest(Documentation/dev-tools/kselftest.rst),相对来说,大量用
> +于用户空间,并且通常测试用户空间的脚本或程序。
> +
> +这使得编写复杂的测试,或者需要操作更多全局系统状态的测试更加容易(诸
> +如生成进程之类)。然而,从kselftest直接调用内核函数是不行的。这也就
> +意味着只有通过某种方式(如系统调用、驱动设备、文件系统等)导出到了用
> +户空间的内核功能才能使用kselftest来测试。为此,有些测试包含了一个伴
> +生的内核模块用于导出更多的信息和功能。不过,对于基本上或者完全在内核
> +中运行的测试,KUnit可能是更佳工具。
> +
> +kselftest也因此非常适合于全部功能的测试,因为这些功能会将接口暴露到
> +用户空间,从而能够被测试,而不是展现实现细节。“system”测试和
> +“end-to-end”测试亦是如此。
> +
> +比如,一个新的系统调用应该伴随有新的kselftest测试。
> +
> +代码覆盖率工具
> +==============
> +
> +支持两种不同代码之间的覆盖率测量工具。它们可以用来验证一项测试执行的
> +确切函数或代码行。这有助于决定内核被测试了多少,或用来查找合适的测试
> +中没有覆盖到的极端情况。
> +
> +:doc:`gcov` 是GCC的覆盖率测试工具,能用于获取内核的全局或每个模块的
> +覆盖率。与KCOV不同的是,这个工具不记录每个任务的覆盖率。覆盖率数据可
> +以通过debugfs读取,并通过常规的gcov工具进行解释。
> +
> +:doc:`kcov` 是能够构建在内核之中,用于在每个任务的层面捕捉覆盖率的一
> +个功能。因此,它对于模糊测试和关于代码执行期间信息的其它情况非常有用,
> +比如在一个单一系统调用里使用它就很有用。
> +
> +动态分析工具
> +============
> +
> +内核也支持许多动态分析工具,用以检测正在运行的内核中出现的多种类型的
> +问题。这些工具通常每个去寻找一类不同的缺陷,比如非法内存访问,数据竞
> +争等并发问题,或整型溢出等其他未定义行为。
> +
> +如下所示:
> +
> +* kmemleak检测可能的内存泄漏。参阅
> + Documentation/dev-tools/kmemleak.rst
> +* KASAN检测非法内存访问,如数组越界和释放后重用(UAF)。参阅
> + Documentation/dev-tools/kasan.rst
> +* UBSAN检测C标准中未定义的行为,如整型溢出。参阅
> + Documentation/dev-tools/ubsan.rst
> +* KCSAN检测数据竞争。参阅 Documentation/dev-tools/kcsan.rst
> +* KFENCE是一个低开销的内存问题检测器,比KASAN更快且能被用于批量构建。
> + 参阅 Documentation/dev-tools/kfence.rst
> +* lockdep是一个锁定正确性检测器。参阅
> + Documentation/locking/lockdep-design.rst
> +* 除此以外,在内核中还有一些其它的调试工具,大多数能在
> + lib/Kconfig.debug 中找到。
> +
> +这些工具倾向于对内核进行整体测试,并且不像kselftest和KUnit一样“传递”。
> +它们可以通过在启用这些工具时运行内核测试以与kselftest或KUnit结合起来:
> +之后你就能确保这些错误在测试过程中都不会发生了。
> +
> +一些工具与KUnit和kselftest集成,并且在检测到问题时会自动打断测试。
> +
> --
> 2.25.1
>