1 .. SPDX-License-Identifier: GPL-2.0-or-later
2
3 .. include:: ../disclaimer-zh_CN.rst
4
5 .. _cn_researcherguidelines:
6
7 :Original: Documentation/process/researcher-gu
8
9 :译者:
10 - 慕冬亮 Dongliang Mu <dzm91@hust.edu.cn>
11
12 研究人员指南
13 +++++++++++++++++++++
14
15 Linux 内核社区欢迎对 Linux 内核及其
16 进行透明的研究。Linux 从这种研究
17
18 社区非常感谢研究人员在公开研究
19 早期参与有助于提高研究质量并使
20 已发表研究的开放访问副本。
21
22 本文旨在澄清研究开展过程中 Linux
23 研究及相关活动应遵循标准的研究
24 研究的更多背景信息，请查阅：
25
26 * `研究伦理史 <https://www.unlv.edu/resea
27 * `IEEE 伦理 <https://www.ieee.org/about/eth
28 * `开发者和研究人员对开源项目实
29
30 Linux 内核社区期望与项目互动的每
31 对 Linux 内核社区产生的任何公开可
32 是受欢迎的，对开发者的研究如若
33
34 完全基于公开可用资源（包括公共
35 显然是允许的。不过，和任何研究
36
37 然而，针对开发者行为的主动研究
38 未经同意，不得与开发者互动或对
39
40 调查
41 =======
42
43 研究通常采用调查问卷的形式发送
44 甚少。内核开发过程之所以有效，
45 而回应调查则是对繁忙开发者的单
46 这种研究方法不被鼓励。
47
48 内核社区成员已经收到过多的电子
49 此类请求会剥夺社区宝贵的贡献者
50
51 作为替代，研究人员应考虑参加开
52 并直接与社区互动。该方式获得的
53 到您的见解。
54
55 补丁
56 =======
57
58 澄清：向开发者发送补丁**是**与他
59 有漏洞的补丁或在讨论中提供误导
60 （例如，消耗时间、精力和士气）
61 的信任而损害项目，削弱为贡献者
62
63 研究人员参与 Linux 本身的开发与其
64 做法，尤其是在开发或运行可产生
65
66 在与开发者社区互动时，发送补丁
67 漏洞 -- 更有帮助的是经过审核的修
68
69 * Documentation/process/development-process.rs
70 * Documentation/process/submitting-patches.rst
71 * Documentation/admin-guide/reporting-issues.r
72 * Documentation/process/security-bugs.rst
73
74 然后发送补丁（包括所有如下详细
75
76 当发送因研究而产生的补丁时，提
77 来理解贡献。回答：
78
79 * 找到了什么具体问题？
80 * 在运行系统上如何触发这个问题
81 * 遇到这个问题对系统会有什么影
82 * 如何发现这个问题？具体包括任
83 * 在哪个版本的 Linux 上发现了这个
84 * 进行了哪些更改来修复这个问题
85 * 如何进行构建测试和运行时测试
86 * 此更改修复了哪个先前的提交？
87 * 还有谁审查了这个补丁？这应该
88
89 例如::
90
91 From: Author <author@email>
92 Subject: [PATCH] drivers/foo_bar: Add missin
93
94 The error path in foo_bar driver does not co
95 struct foo_bar_info. This can happen if the
96 rejects the initialization packets sent duri
97 would result in a 64 byte slab memory leak o
98 wasting memory resources over time.
99
100 This flaw was found using an experimental st
101 developing, LeakMagic[1], which reported the
102 analyzing the v5.15 kernel release:
103
104 path/to/foo_bar.c:187: missing kfree() call
105
106 Add the missing kfree() to the error path. N
107 this memory exist outside the probe function
108 place it can be freed.
109
110 x86_64 and arm64 defconfig builds with CONFI
111 11.2 show no new warnings, and LeakMagic no
112 code path. As we don't have a FooBar device
113 testing was able to be performed.
114
115 [1] https://url/to/leakmagic/details
116
117 Reported-by: Researcher <researcher@email>
118 Fixes: aaaabbbbccccdddd ("Introduce support
119 Signed-off-by: Author <author@email>
120 Reviewed-by: Reviewer <reviewer@email>
121
122 如果您是第一次参与贡献，建议在
123 告诉您补丁需要更仔细的内部审查
124 "Reviewed-by" 标签。找到熟悉 Linux 贡
125 并在将补丁发送到公共邮件列表前
126 其他开发者的负担。
127
128 如果你找不到人内部审核补丁且需
129 有任何其他问题，请联系技术咨询<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.