1 .. SPDX-License-Identifier: GPL-2.0 1 .. SPDX-License-Identifier: GPL-2.0
2 2
3 .. _tw_process_howto: 3 .. _tw_process_howto:
4 4
5 .. include:: ../disclaimer-zh_TW.rst 5 .. include:: ../disclaimer-zh_TW.rst
6 6
7 :Original: :ref:`Documentation/process/howto.r 7 :Original: :ref:`Documentation/process/howto.rst <process_howto>`
8 8
9 譯者:: 9 譯者::
10 10
11 英文版維護者： Greg Kroah-Hartman <g 11 英文版維護者： Greg Kroah-Hartman <greg@kroah.com>
12 中文版維護者： 李陽 Li Yang <leoy 12 中文版維護者： 李陽 Li Yang <leoyang.li@nxp.com>
13 中文版翻譯者： 李陽 Li Yang <leoy 13 中文版翻譯者： 李陽 Li Yang <leoyang.li@nxp.com>
14 時奎亮 Alex Shi <alex.shi 14 時奎亮 Alex Shi <alex.shi@linux.alibaba.com>
15 中文版校譯者: 15 中文版校譯者:
16 鍾宇 TripleX Chung <xxx.p 16 鍾宇 TripleX Chung <xxx.phy@gmail.com>
17 陳琦 Maggie Chen <chenqi@ 17 陳琦 Maggie Chen <chenqi@beyondsoft.com>
18 王聰 Wang Cong <xiyou.wan 18 王聰 Wang Cong <xiyou.wangcong@gmail.com>
19 胡皓文 Hu Haowen <2023002 19 胡皓文 Hu Haowen <2023002089@link.tyut.edu.cn>
20 20
21 如何參與Linux內核開發 21 如何參與Linux內核開發
22 ===================== 22 =====================
23 23
24 這是一篇將如何參與Linux內核開發 24 這是一篇將如何參與Linux內核開發的相關問題一網打盡的終極祕笈。它將指導你
25 成爲一名Linux內核開發者，並且學 25 成爲一名Linux內核開發者，並且學會如何同Linux內核開發社區合作。它儘可能不
26 包括任何關於內核編程的技術細節 26 包括任何關於內核編程的技術細節，但會給你指引一條獲得這些知識的正確途徑。
27 27
28 如果這篇文章中的任何內容不再適 28 如果這篇文章中的任何內容不再適用，請給文末列出的文件維護者發送補丁。
29 29
30 30
31 入門 31 入門
32 ---- 32 ----
33 33
34 你想了解如何成爲一名Linux內核開 34 你想了解如何成爲一名Linux內核開發者？或者老闆吩咐你「給這個設備寫個Linux
35 驅動程序」？這篇文章的目的就是 35 驅動程序」？這篇文章的目的就是教會你達成這些目標的全部訣竅，它將描述你需
36 要經過的流程以及給出如何同內核 36 要經過的流程以及給出如何同內核社區合作的一些提示。它還將試圖解釋內核社區
37 爲何這樣運作。 37 爲何這樣運作。
38 38
39 Linux內核大部分是由C語言寫成的， 39 Linux內核大部分是由C語言寫成的，一些體系結構相關的代碼用到了彙編語言。要
40 參與內核開發，你必須精通C語言。 40 參與內核開發，你必須精通C語言。除非你想爲某個架構開發底層代碼，否則你並
41 不需要了解（任何體系結構的）彙 41 不需要了解（任何體系結構的）彙編語言。下面列舉的書籍雖然不能替代紮實的C
42 語言教育和多年的開發經驗，但如 42 語言教育和多年的開發經驗，但如果需要的話，做爲參考還是不錯的：
43 43
44 - "The C Programming Language" by Kernighan a 44 - "The C Programming Language" by Kernighan and Ritchie [Prentice Hall]
45 《C程序設計語言（第2版·新版） 45 《C程序設計語言（第2版·新版）》（徐寶文 李志 譯）[機械工業出版社]
46 - "Practical C Programming" by Steve Oualline 46 - "Practical C Programming" by Steve Oualline [O'Reilly]
47 《實用C語言編程（第三版）》（ 47 《實用C語言編程（第三版）》（郭大海 譯）[中國電力出版社]
48 - "C: A Reference Manual" by Harbison and St 48 - "C: A Reference Manual" by Harbison and Steele [Prentice Hall]
49 《C語言參考手冊（原書第5版） 49 《C語言參考手冊（原書第5版）》（邱仲潘 等譯）[機械工業出版社]
50 50
51 Linux內核使用GNU C和GNU工具鏈開發。 51 Linux內核使用GNU C和GNU工具鏈開發。雖然它遵循ISO C11標準，但也用到了一些
52 標準中沒有定義的擴展。內核是自 52 標準中沒有定義的擴展。內核是自給自足的C環境，不依賴於標準C庫的支持，所以
53 並不支持C標準中的部分定義。比如 53 並不支持C標準中的部分定義。比如long long類型的大數除法和浮點運算就不允許
54 使用。有時候確實很難弄清楚內核 54 使用。有時候確實很難弄清楚內核對工具鏈的要求和它所使用的擴展，不幸的是目
55 前還沒有明確的參考資料可以解釋 55 前還沒有明確的參考資料可以解釋它們。請查閱gcc信息頁（使用「info gcc」命令
56 顯示）獲得一些這方面信息。 56 顯示）獲得一些這方面信息。
57 57
58 請記住你是在學習怎麼和已經存在 58 請記住你是在學習怎麼和已經存在的開發社區打交道。它由一羣形形色色的人組成，
59 他們對代碼、風格和過程有著很高 59 他們對代碼、風格和過程有著很高的標準。這些標準是在長期實踐中總結出來的，
60 適應於地理上分散的大型開發團隊 60 適應於地理上分散的大型開發團隊。它們已經被很好得整理成檔，建議你在開發
61 之前儘可能多的學習這些標準，而 61 之前儘可能多的學習這些標準，而不要期望別人來適應你或者你公司的行爲方式。
62 62
63 63
64 法律問題 64 法律問題
65 -------- 65 --------
66 66
67 Linux內核原始碼都是在GPL（通用公 67 Linux內核原始碼都是在GPL（通用公共許可證）的保護下發布的。要了解這種許可
68 的細節請查看原始碼主目錄下的COPY 68 的細節請查看原始碼主目錄下的COPYING文件。Linux內核許可準則和如何使用
69 `SPDX <https://spdx.org/>` 標誌符說明在 69 `SPDX <https://spdx.org/>` 標誌符說明在這個文件中
70 :ref:`Documentation/translations/zh_TW/process 70 :ref:`Documentation/translations/zh_TW/process/license-rules.rst <tw_kernel_licensing>`
71 如果你對它還有更深入問題請聯繫 71 如果你對它還有更深入問題請聯繫律師，而不要在Linux內核郵件組上提問。因爲
72 郵件組裡的人並不是律師，不要期 72 郵件組裡的人並不是律師，不要期望他們的話有法律效力。
73 73
74 對於GPL的常見問題和解答，請訪問 74 對於GPL的常見問題和解答，請訪問以下連結：
75 https://www.gnu.org/licenses/gpl-faq.h 75 https://www.gnu.org/licenses/gpl-faq.html
76 76
77 77
78 文檔 78 文檔
79 ---- 79 ----
80 80
81 Linux內核代碼中包含有大量的文檔 81 Linux內核代碼中包含有大量的文檔。這些文檔對於學習如何與內核社區互動有著
82 不可估量的價值。當一個新的功能 82 不可估量的價值。當一個新的功能被加入內核，最好把解釋如何使用這個功能的文
83 檔也放進內核。當內核的改動導致 83 檔也放進內核。當內核的改動導致面向用戶空間的接口發生變化時，最好將相關信
84 息或手冊頁(manpages)的補丁發到mtk.ma 84 息或手冊頁(manpages)的補丁發到mtk.manpages@gmail.com，以向手冊頁(manpages)
85 的維護者解釋這些變化。 85 的維護者解釋這些變化。
86 86
87 以下是內核代碼中需要閱讀的文檔 87 以下是內核代碼中需要閱讀的文檔：
88 :ref:`Documentation/admin-guide/README.rst < 88 :ref:`Documentation/admin-guide/README.rst <readme>`
89 文件簡要介紹了Linux內核的背景 89 文件簡要介紹了Linux內核的背景，並且描述了如何配置和編譯內核。內核的
90 新用戶應該從這裡開始。 90 新用戶應該從這裡開始。
91 91
92 92
93 :ref:`Documentation/process/changes.rst <cha 93 :ref:`Documentation/process/changes.rst <changes>`
94 文件給出了用來編譯和使用內核 94 文件給出了用來編譯和使用內核所需要的最小軟體包列表。
95 95
96 :ref:`Documentation/translations/zh_TW/proce 96 :ref:`Documentation/translations/zh_TW/process/coding-style.rst <tw_codingstyle>`
97 描述Linux內核的代碼風格和理由 97 描述Linux內核的代碼風格和理由。所有新代碼需要遵守這篇文檔中定義的規
98 范。大多數維護者只會接收符合 98 范。大多數維護者只會接收符合規定的補丁，很多人也只會幫忙檢查符合風格
99 的代碼。 99 的代碼。
100 100
101 :ref:`Documentation/translations/zh_TW/proce 101 :ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>`
102 102
103 這兩份文檔明確描述如何創建和 103 這兩份文檔明確描述如何創建和發送補丁，其中包括（但不僅限於)：
104 - 郵件內容 104 - 郵件內容
105 - 郵件格式 105 - 郵件格式
106 - 選擇收件人 106 - 選擇收件人
107 107
108 遵守這些規定並不能保證提交成 108 遵守這些規定並不能保證提交成功（因爲所有補丁需要通過嚴格的內容和風格
109 審查），但是忽視他們幾乎就意 109 審查），但是忽視他們幾乎就意味著失敗。
110 110
111 其他關於如何正確地生成補丁的 111 其他關於如何正確地生成補丁的優秀文檔包括：
112 "The Perfect Patch" 112 "The Perfect Patch"
113 113
114 https://www.ozlabs.org/~akpm/stuff/tpp 114 https://www.ozlabs.org/~akpm/stuff/tpp.txt
115 115
116 "Linux kernel patch submission format" 116 "Linux kernel patch submission format"
117 117
118 https://web.archive.org/web/2018082911 118 https://web.archive.org/web/20180829112450/http://linux.yyz.us/patch-format.html
119 119
120 :ref:`Documentation/translations/zh_TW/proce 120 :ref:`Documentation/translations/zh_TW/process/stable-api-nonsense.rst <tw_stable_api_nonsense>`
121 論證內核爲什麼特意不包括穩定 121 論證內核爲什麼特意不包括穩定的內核內部API，也就是說不包括像這樣的特
122 性： 122 性：
123 123
124 - 子系統中間層（爲了兼容性 124 - 子系統中間層（爲了兼容性？）
125 - 在不同作業系統間易於移植 125 - 在不同作業系統間易於移植的驅動程序
126 - 減緩（甚至阻止）內核代碼 126 - 減緩（甚至阻止）內核代碼的快速變化
127 127
128 這篇文檔對於理解Linux的開發哲 128 這篇文檔對於理解Linux的開發哲學至關重要。對於將開發平台從其他操作系
129 統轉移到Linux的人來說也很重要 129 統轉移到Linux的人來說也很重要。
130 130
131 :ref:`Documentation/process/security-bugs.rs 131 :ref:`Documentation/process/security-bugs.rst <securitybugs>`
132 如果你認爲自己發現了Linux內核 132 如果你認爲自己發現了Linux內核的安全性問題，請根據這篇文檔中的步驟來
133 提醒其他內核開發者並幫助解決 133 提醒其他內核開發者並幫助解決這個問題。
134 134
135 :ref:`Documentation/translations/zh_TW/proce 135 :ref:`Documentation/translations/zh_TW/process/management-style.rst <tw_managementstyle>`
136 136
137 描述內核維護者的工作方法及其 137 描述內核維護者的工作方法及其共有特點。這對於剛剛接觸內核開發（或者對
138 它感到好奇）的人來說很重要， 138 它感到好奇）的人來說很重要，因爲它解釋了很多對於內核維護者獨特行爲的
139 普遍誤解與迷惑。 139 普遍誤解與迷惑。
140 140
141 :ref:`Documentation/process/stable-kernel-ru 141 :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>`
142 解釋了穩定版內核發布的規則， 142 解釋了穩定版內核發布的規則，以及如何將改動放入這些版本的步驟。
143 143
144 :ref:`Documentation/process/kernel-docs.rst 144 :ref:`Documentation/process/kernel-docs.rst <kernel_docs>`
145 有助於內核開發的外部文檔列表 145 有助於內核開發的外部文檔列表。如果你在內核自帶的文檔中沒有找到你想找
146 的內容，可以查看這些文檔。 146 的內容，可以查看這些文檔。
147 147
148 :ref:`Documentation/process/applying-patches 148 :ref:`Documentation/process/applying-patches.rst <applying_patches>`
149 關於補丁是什麼以及如何將它打 149 關於補丁是什麼以及如何將它打在不同內核開發分支上的好介紹
150 150
151 內核還擁有大量從代碼自動生成或 151 內核還擁有大量從代碼自動生成或者從 ReStructuredText(ReST) 標記生成的文檔，
152 比如這個文檔，它包含內核內部API 152 比如這個文檔，它包含內核內部API的全面介紹以及如何妥善處理加鎖的規則。所有
153 這些文檔都可以通過運行以下命令 153 這些文檔都可以通過運行以下命令從內核代碼中生成爲PDF或HTML文檔::
154 154
155 make pdfdocs 155 make pdfdocs
156 make htmldocs 156 make htmldocs
157 157
158 ReST格式的文檔會生成在 Documentation/ 158 ReST格式的文檔會生成在 Documentation/output. 目錄中。
159 它們也可以用下列命令生成 LaTeX 和 159 它們也可以用下列命令生成 LaTeX 和 ePub 格式文檔::
160 160
161 make latexdocs 161 make latexdocs
162 make epubdocs 162 make epubdocs
163 163
164 如何成爲內核開發者 164 如何成爲內核開發者
165 ------------------ 165 ------------------
166 如果你對Linux內核開發一無所知， 166 如果你對Linux內核開發一無所知，你應該訪問「Linux內核新手」計劃：
167 167
168 https://kernelnewbies.org 168 https://kernelnewbies.org
169 169
170 它擁有一個可以問各種最基本的內 170 它擁有一個可以問各種最基本的內核開發問題的郵件列表（在提問之前一定要記得
171 查找已往的郵件，確認是否有人已 171 查找已往的郵件，確認是否有人已經回答過相同的問題）。它還擁有一個可以獲得
172 實時反饋的IRC聊天頻道，以及大量 172 實時反饋的IRC聊天頻道，以及大量對於學習Linux內核開發相當有幫助的文檔。
173 173
174 網站簡要介紹了原始碼組織結構、 174 網站簡要介紹了原始碼組織結構、子系統劃分以及目前正在進行的項目（包括內核
175 中的和單獨維護的）。它還提供了 175 中的和單獨維護的）。它還提供了一些基本的幫助信息，比如如何編譯內核和打補
176 丁。 176 丁。
177 177
178 如果你想加入內核開發社區並協助 178 如果你想加入內核開發社區並協助完成一些任務，卻找不到從哪裡開始，可以訪問
179 「Linux內核房管員」計劃： 179 「Linux內核房管員」計劃：
180 180
181 https://kernelnewbies.org/KernelJanito 181 https://kernelnewbies.org/KernelJanitors
182 182
183 這是極佳的起點。它提供一個相對 183 這是極佳的起點。它提供一個相對簡單的任務列表，列出內核代碼中需要被重新
184 整理或者改正的地方。通過和負責 184 整理或者改正的地方。通過和負責這個計劃的開發者們一同工作，你會學到將補丁
185 集成進內核的基本原理。如果還沒 185 集成進內核的基本原理。如果還沒有決定下一步要做什麼的話，你還可能會得到方
186 向性的指點。 186 向性的指點。
187 187
188 在真正動手修改內核代碼之前，理 188 在真正動手修改內核代碼之前，理解要修改的代碼如何運作是必需的。要達到這個
189 目的，沒什麼辦法比直接讀代碼更 189 目的，沒什麼辦法比直接讀代碼更有效了（大多數花招都會有相應的注釋），而且
190 一些特製的工具還可以提供幫助。 190 一些特製的工具還可以提供幫助。例如，「Linux代碼交叉引用」項目就是一個值得
191 特別推薦的幫助工具，它將原始碼 191 特別推薦的幫助工具，它將原始碼顯示在有編目和索引的網頁上。其中一個更新及
192 時的內核源碼庫，可以通過以下地 192 時的內核源碼庫，可以通過以下地址訪問：
193 193
194 https://elixir.bootlin.com/ 194 https://elixir.bootlin.com/
195 195
196 196
197 開發流程 197 開發流程
198 -------- 198 --------
199 199
200 目前Linux內核開發流程包括幾個「 200 目前Linux內核開發流程包括幾個「主內核分支」和很多子系統相關的內核分支。這
201 些分支包括： 201 些分支包括：
202 202
203 - Linus 的內核源碼樹 203 - Linus 的內核源碼樹
204 - 多個主要版本的穩定版內核樹 204 - 多個主要版本的穩定版內核樹
205 - 子系統相關的內核樹 205 - 子系統相關的內核樹
206 - linux-next 集成測試樹 206 - linux-next 集成測試樹
207 207
208 208
209 主線樹 209 主線樹
210 ------ 210 ------
211 主線樹是由Linus Torvalds 維護的。你 211 主線樹是由Linus Torvalds 維護的。你可以在https://kernel.org 網站或者代碼
212 庫中下找到它。它的開發遵循以下 212 庫中下找到它。它的開發遵循以下步驟：
213 213
214 - 每當一個新版本的內核被發布， 214 - 每當一個新版本的內核被發布，爲期兩周的集成窗口將被打開。在這段時間裡
215 維護者可以向Linus提交大段的修 215 維護者可以向Linus提交大段的修改，通常這些修改已經被放到-mm內核中幾個
216 星期了。提交大量修改的首選方 216 星期了。提交大量修改的首選方式是使用git工具（內核的代碼版本管理工具
217 ，更多的信息可以在 https://git-sc 217 ，更多的信息可以在 https://git-scm.com/ 獲取），不過使用普通補丁也是
218 可以的。 218 可以的。
219 - 兩個星期以後-rc1版本內核發布 219 - 兩個星期以後-rc1版本內核發布。之後只有不包含可能影響整個內核穩定性的
220 新功能的補丁才可能被接受。請 220 新功能的補丁才可能被接受。請注意一個全新的驅動程序（或者文件系統）有
221 可能在-rc1後被接受是因爲這樣 221 可能在-rc1後被接受是因爲這樣的修改完全獨立，不會影響其他的代碼，所以
222 沒有造成內核退步的風險。在-rc 222 沒有造成內核退步的風險。在-rc1以後也可以用git向Linus提交補丁，不過所
223 有的補丁需要同時被發送到相應 223 有的補丁需要同時被發送到相應的公衆郵件列表以徵詢意見。
224 - 當Linus認爲當前的git源碼樹已經 224 - 當Linus認爲當前的git源碼樹已經達到一個合理健全的狀態足以發布供人測試
225 時，一個新的-rc版本就會被發布 225 時，一個新的-rc版本就會被發布。計劃是每周都發布新的-rc版本。
226 - 這個過程一直持續下去直到內核 226 - 這個過程一直持續下去直到內核被認爲達到足夠穩定的狀態，持續時間大概是
227 6個星期。 227 6個星期。
228 228
229 關於內核發布，值得一提的是Andrew 229 關於內核發布，值得一提的是Andrew Morton在linux-kernel郵件列表中如是說：
230 「沒有人知道新內核何時會 230 「沒有人知道新內核何時會被發布，因爲發布是根據已知bug的情況來決定
231 的，而不是根據一個事先制 231 的，而不是根據一個事先制定好的時間表。」
232 232
233 子系統特定樹 233 子系統特定樹
234 ------------ 234 ------------
235 235
236 各種內核子系統的維護者——以及 236 各種內核子系統的維護者——以及許多內核子系統開發人員——在原始碼庫中公開了他們
237 當前的開發狀態。這樣，其他人就 237 當前的開發狀態。這樣，其他人就可以看到內核的不同區域發生了什麼。在開發速度
238 很快的領域，可能會要求開發人員 238 很快的領域，可能會要求開發人員將提交的內容建立在這樣的子系統內核樹上，這樣
239 就避免了提交與其他已經進行的工 239 就避免了提交與其他已經進行的工作之間的衝突。
240 240
241 這些存儲庫中的大多數都是Git樹， 241 這些存儲庫中的大多數都是Git樹，但是也有其他的scm在使用，或者補丁隊列被發布
242 爲Quilt系列。這些子系統存儲庫的 242 爲Quilt系列。這些子系統存儲庫的地址列在MAINTAINERS文件中。其中許多可以在
243 https://git.kernel.org/上瀏覽。 243 https://git.kernel.org/上瀏覽。
244 244
245 在將一個建議的補丁提交到這樣的 245 在將一個建議的補丁提交到這樣的子系統樹之前，需要對它進行審查，審查主要發生
246 在郵件列表上（請參見下面相應的 246 在郵件列表上（請參見下面相應的部分）。對於幾個內核子系統，這個審查過程是通
247 過工具補丁跟蹤的。Patchwork提供了 247 過工具補丁跟蹤的。Patchwork提供了一個Web界面，顯示補丁發布、對補丁的任何評
248 論或修訂，維護人員可以將補丁標 248 論或修訂，維護人員可以將補丁標記爲正在審查、接受或拒絕。大多數補丁網站都列
249 在 https://patchwork.kernel.org/ 249 在 https://patchwork.kernel.org/
250 250
251 Linux-next 集成測試樹 251 Linux-next 集成測試樹
252 --------------------- 252 ---------------------
253 253
254 在將子系統樹的更新合併到主線樹 254 在將子系統樹的更新合併到主線樹之前，需要對它們進行集成測試。爲此，存在一個
255 特殊的測試存儲庫，其中幾乎每天 255 特殊的測試存儲庫，其中幾乎每天都會提取所有子系統樹：
256 256
257 https://git.kernel.org/？p=linux/kern 257 https://git.kernel.org/？p=linux/kernel/git/next/linux-next.git
258 258
259 通過這種方式，Linux-next 對下一個 259 通過這種方式，Linux-next 對下一個合併階段將進入主線內核的內容給出了一個概要
260 展望。非常歡冒險的測試者運行測 260 展望。非常歡冒險的測試者運行測試Linux-next。
261 261
262 多個主要版本的穩定版內核樹 262 多個主要版本的穩定版內核樹
263 ----------------------------------- 263 -----------------------------------
264 由3個數字組成的內核版本號說明此 264 由3個數字組成的內核版本號說明此內核是-stable版本。它們包含內核的相對較小且
265 至關重要的修補，這些修補針對安 265 至關重要的修補，這些修補針對安全性問題或者嚴重的內核退步。
266 266
267 這種版本的內核適用於那些期望獲 267 這種版本的內核適用於那些期望獲得最新的穩定版內核並且不想參與測試開發版或
268 者實驗版的用戶。 268 者實驗版的用戶。
269 269
270 穩定版內核樹版本由「穩定版」小< 270 穩定版內核樹版本由「穩定版」小組（郵件地址<stable@vger.kernel.org>）維護，一般
271 隔周發布新版本。 271 隔周發布新版本。
272 272
273 內核源碼中的 :ref:`Documentation/process 273 內核源碼中的 :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>`
274 文件具體描述了可被穩定版內核接 274 文件具體描述了可被穩定版內核接受的修改類型以及發布的流程。
275 275
276 276
277 報告bug 277 報告bug
278 ------- 278 -------
279 279
280 bugzilla.kernel.org是Linux內核開發者們 280 bugzilla.kernel.org是Linux內核開發者們用來跟蹤內核Bug的網站。我們鼓勵用
281 戶在這個工具中報告找到的所有bug 281 戶在這個工具中報告找到的所有bug。如何使用內核bugzilla的細節請訪問：
282 282
283 http://test.kernel.org/bugzilla/faq.ht 283 http://test.kernel.org/bugzilla/faq.html
284 284
285 內核源碼主目錄中的:ref:`admin-guide/r 285 內核源碼主目錄中的:ref:`admin-guide/reporting-bugs.rst <reportingbugs>`
286 文件里有一個很好的模板。它指導 286 文件里有一個很好的模板。它指導用戶如何報告可能的內核bug以及需要提供哪些信息
287 來幫助內核開發者們找到問題的根 287 來幫助內核開發者們找到問題的根源。
288 288
289 289
290 利用bug報告 290 利用bug報告
291 ----------- 291 -----------
292 292
293 練習內核開發技能的最好辦法就是 293 練習內核開發技能的最好辦法就是修改其他人報告的bug。你不光可以幫助內核變
294 得更加穩定，還可以學會如何解決 294 得更加穩定，還可以學會如何解決實際問題從而提高自己的技能，並且讓其他開發
295 者感受到你的存在。修改bug是贏得 295 者感受到你的存在。修改bug是贏得其他開發者讚譽的最好辦法，因爲並不是很多
296 人都喜歡浪費時間去修改別人報告 296 人都喜歡浪費時間去修改別人報告的bug。
297 297
298 要嘗試修改已知的bug，請訪問 http:/ 298 要嘗試修改已知的bug，請訪問 http://bugzilla.kernel.org 網址。
299 299
300 300
301 郵件列表 301 郵件列表
302 -------- 302 --------
303 303
304 正如上面的文檔所描述，大多數的 304 正如上面的文檔所描述，大多數的骨幹內核開發者都加入了Linux Kernel郵件列
305 表。如何訂閱和退訂列表的細節可 305 表。如何訂閱和退訂列表的細節可以在這裡找到：
306 306
307 http://vger.kernel.org/vger-lists.html 307 http://vger.kernel.org/vger-lists.html#linux-kernel
308 308
309 網上很多地方都有這個郵件列表的 309 網上很多地方都有這個郵件列表的存檔(archive)。可以使用搜尋引擎來找到這些
310 存檔。比如： 310 存檔。比如：
311 311
312 https://lore.kernel.org/lkml/ 312 https://lore.kernel.org/lkml/
313 313
314 在發信之前，我們強烈建議你先在 314 在發信之前，我們強烈建議你先在存檔中搜索你想要討論的問題。很多已經被詳細
315 討論過的問題只在郵件列表的存檔 315 討論過的問題只在郵件列表的存檔中可以找到。
316 316
317 大多數內核子系統也有自己獨立的 317 大多數內核子系統也有自己獨立的郵件列表來協調各自的開發工作。從
318 MAINTAINERS文件中可以找到不同話題 318 MAINTAINERS文件中可以找到不同話題對應的郵件列表。
319 319
320 很多郵件列表架設在kernel.org伺服器 320 很多郵件列表架設在kernel.org伺服器上。這些列表的信息可以在這裡找到：
321 321
322 http://vger.kernel.org/vger-lists.html 322 http://vger.kernel.org/vger-lists.html
323 323
324 在使用這些郵件列表時，請記住保 324 在使用這些郵件列表時，請記住保持良好的行爲習慣。下面的連結提供了與這些列
325 表（或任何其它郵件列表）交流的 325 表（或任何其它郵件列表）交流的一些簡單規則，雖然內容有點濫竽充數。
326 326
327 http://www.albion.com/netiquette/ 327 http://www.albion.com/netiquette/
328 328
329 當有很多人回覆你的郵件時，郵件 329 當有很多人回覆你的郵件時，郵件的抄送列表會變得很長。請不要將任何人從抄送
330 列表中刪除，除非你有足夠的理由 330 列表中刪除，除非你有足夠的理由這麼做。也不要只回復到郵件列表。請習慣於同
331 一封郵件接收兩次（一封來自發送 331 一封郵件接收兩次（一封來自發送者一封來自郵件列表），而不要試圖通過添加一
332 些奇特的郵件頭來解決這個問題， 332 些奇特的郵件頭來解決這個問題，人們不會喜歡的。
333 333
334 記住保留你所回復內容的上下文和 334 記住保留你所回復內容的上下文和源頭。在你回覆郵件的頂部保留「某某某說到……」
335 這幾行。將你的評論加在被引用的 335 這幾行。將你的評論加在被引用的段落之間而不要放在郵件的頂部。
336 336
337 如果你在郵件中附帶補丁，請確認 337 如果你在郵件中附帶補丁，請確認它們是可以直接閱讀的純文本（如
338 :ref:`Documentation/translations/zh_TW/process 338 :ref:`Documentation/translations/zh_TW/process/submitting-patches.rst <tw_submittingpatches>`
339 文檔中所述）。內核開發者們不希 339 文檔中所述）。內核開發者們不希望遇到附件或者被壓縮了的補丁。只有這樣才能
340 保證他們可以直接評論你的每行代 340 保證他們可以直接評論你的每行代碼。請確保你使用的郵件發送程序不會修改空格
341 和制表符。一個防範性的測試方法 341 和制表符。一個防範性的測試方法是先將郵件發送給自己，然後自己嘗試是否可以
342 順利地打上收到的補丁。如果測試 342 順利地打上收到的補丁。如果測試不成功，請調整或者更換你的郵件發送程序直到
343 它正確工作爲止。 343 它正確工作爲止。
344 344
345 總而言之，請尊重其他的郵件列表 345 總而言之，請尊重其他的郵件列表訂閱者。
346 346
347 347
348 同內核社區合作 348 同內核社區合作
349 ---------------- 349 ----------------
350 350
351 內核社區的目標就是提供盡善盡美 351 內核社區的目標就是提供盡善盡美的內核。所以當你提交補丁期望被接受進內核的
352 時候，它的技術價值以及其他方面 352 時候，它的技術價值以及其他方面都將被評審。那麼你可能會得到什麼呢？
353 353
354 - 批評 354 - 批評
355 - 評論 355 - 評論
356 - 要求修改 356 - 要求修改
357 - 要求證明修改的必要性 357 - 要求證明修改的必要性
358 - 沉默 358 - 沉默
359 359
360 要記住，這些是把補丁放進內核的 360 要記住，這些是把補丁放進內核的正常情況。你必須學會聽取對補丁的批評和評論，
361 從技術層面評估它們，然後要麼重 361 從技術層面評估它們，然後要麼重寫你的補丁要麼簡明扼要地論證修改是不必要
362 的。如果你發的郵件沒有得到任何 362 的。如果你發的郵件沒有得到任何回應，請過幾天後再試一次，因爲有時信件會湮
363 沒在茫茫信海中。 363 沒在茫茫信海中。
364 364
365 你不應該做的事情： 365 你不應該做的事情：
366 366
367 - 期望自己的補丁不受任何質疑就 367 - 期望自己的補丁不受任何質疑就直接被接受
368 - 翻臉 368 - 翻臉
369 - 忽略別人的評論 369 - 忽略別人的評論
370 - 沒有按照別人的要求做任何修改 370 - 沒有按照別人的要求做任何修改就重新提交
371 371
372 在一個努力追尋最好技術方案的社 372 在一個努力追尋最好技術方案的社區里，對於一個補丁有多少好處總會有不同的見
373 解。你必須要抱著合作的態度，願 373 解。你必須要抱著合作的態度，願意改變自己的觀點來適應內核的風格。或者至少
374 願意去證明你的想法是有價值的。 374 願意去證明你的想法是有價值的。記住，犯錯誤是允許的，只要你願意朝著正確的
375 方案去努力。 375 方案去努力。
376 376
377 如果你的第一個補丁換來的是一堆 377 如果你的第一個補丁換來的是一堆修改建議，這是很正常的。這並不代表你的補丁
378 不會被接受，也不意味著有人和你 378 不會被接受，也不意味著有人和你作對。你只需要改正所有提出的問題然後重新發
379 送你的補丁。 379 送你的補丁。
380 380
381 內核社區和公司文化的差異 381 內核社區和公司文化的差異
382 ------------------------ 382 ------------------------
383 383
384 內核社區的工作模式同大多數傳統 384 內核社區的工作模式同大多數傳統公司開發隊伍的工作模式並不相同。下面這些例
385 子，可以幫助你避免某些可能發生 385 子，可以幫助你避免某些可能發生問題：
386 用這些話介紹你的修改提案會有好 386 用這些話介紹你的修改提案會有好處：
387 387
388 - 它同時解決了多個問題 388 - 它同時解決了多個問題
389 - 它刪除了2000行代碼 389 - 它刪除了2000行代碼
390 - 這是補丁，它已經解釋了我想 390 - 這是補丁，它已經解釋了我想要說明的
391 - 我在5種不同的體系結構上測試 391 - 我在5種不同的體系結構上測試過它……
392 - 這是一系列小補丁用來…… 392 - 這是一系列小補丁用來……
393 - 這個修改提高了普通機器的性 393 - 這個修改提高了普通機器的性能……
394 394
395 應該避免如下的說法： 395 應該避免如下的說法：
396 396
397 - 我們在AIX/ptx/Solaris就是這麼做 397 - 我們在AIX/ptx/Solaris就是這麼做的，所以這麼做肯定是好的……
398 - 我做這行已經20年了，所以… 398 - 我做這行已經20年了，所以……
399 - 爲了我們公司賺錢考慮必須這 399 - 爲了我們公司賺錢考慮必須這麼做
400 - 這是我們的企業產品線所需要 400 - 這是我們的企業產品線所需要的
401 - 這裡是描述我觀點的1000頁設計 401 - 這裡是描述我觀點的1000頁設計文檔
402 - 這是一個5000行的補丁用來…… 402 - 這是一個5000行的補丁用來……
403 - 我重寫了現在亂七八糟的代碼 403 - 我重寫了現在亂七八糟的代碼，這就是……
404 - 我被規定了最後期限，所以這 404 - 我被規定了最後期限，所以這個補丁需要立刻被接受
405 405
406 另外一個內核社區與大部分傳統公 406 另外一個內核社區與大部分傳統公司的軟體開發隊伍不同的地方是無法面對面地交
407 流。使用電子郵件和IRC聊天工具做 407 流。使用電子郵件和IRC聊天工具做爲主要溝通工具的一個好處是性別和種族歧視
408 將會更少。Linux內核的工作環境更 408 將會更少。Linux內核的工作環境更能接受婦女和少數族羣，因爲每個人在別人眼
409 里只是一個郵件地址。國際化也幫 409 里只是一個郵件地址。國際化也幫助了公平的實現，因爲你無法通過姓名來判斷人
410 的性別。男人有可能叫李麗，女人 410 的性別。男人有可能叫李麗，女人也有可能叫王剛。大多數在Linux內核上工作過
411 並表達過看法的女性對在linux上工 411 並表達過看法的女性對在linux上工作的經歷都給出了正面的評價。
412 412
413 對於一些不習慣使用英語的人來說 413 對於一些不習慣使用英語的人來說，語言可能是一個引起問題的障礙。在郵件列表
414 中要正確地表達想法必需良好地掌 414 中要正確地表達想法必需良好地掌握語言，所以建議你在發送郵件之前最好檢查一
415 下英文寫得是否正確。 415 下英文寫得是否正確。
416 416
417 417
418 拆分修改 418 拆分修改
419 -------- 419 --------
420 420
421 Linux內核社區並不喜歡一下接收大 421 Linux內核社區並不喜歡一下接收大段的代碼。修改需要被恰當地介紹、討論並且
422 拆分成獨立的小段。這幾乎完全和 422 拆分成獨立的小段。這幾乎完全和公司中的習慣背道而馳。你的想法應該在開發最
423 開始的階段就讓大家知道，這樣你 423 開始的階段就讓大家知道，這樣你就可以及時獲得對你正在進行的開發的反饋。這
424 樣也會讓社區覺得你是在和他們協 424 樣也會讓社區覺得你是在和他們協作，而不是僅僅把他們當作傾銷新功能的對象。
425 無論如何，你不要一次性地向郵件 425 無論如何，你不要一次性地向郵件列表發送50封信，你的補丁序列應該永遠用不到
426 這麼多。 426 這麼多。
427 427
428 將補丁拆開的原因如下： 428 將補丁拆開的原因如下：
429 429
430 1) 小的補丁更有可能被接受，因爲 430 1) 小的補丁更有可能被接受，因爲它們不需要太多的時間和精力去驗證其正確性。
431 一個5行的補丁，可能在維護者看 431 一個5行的補丁，可能在維護者看了一眼以後就會被接受。而500行的補丁則
432 需要數個小時來審查其正確性（ 432 需要數個小時來審查其正確性（所需時間隨補丁大小增加大約呈指數級增長）。
433 433
434 當出了問題的時候，小的補丁也 434 當出了問題的時候，小的補丁也會讓調試變得非常容易。一個一個補丁地回溯
435 將會比仔細剖析一個被打上的大 435 將會比仔細剖析一個被打上的大補丁（這個補丁破壞了其他東西）容易得多。
436 436
437 2）不光發送小的補丁很重要，在提 437 2）不光發送小的補丁很重要，在提交之前重新編排、化簡（或者僅僅重新排列）
438 補丁也是很重要的。 438 補丁也是很重要的。
439 439
440 這裡有內核開發者Al Viro打的一個比 440 這裡有內核開發者Al Viro打的一個比方：
441 「想像一個老師正在給學生 441 「想像一個老師正在給學生批改數學作業。老師並不希望看到學生爲了得
442 到正確解法所進行的嘗試和 442 到正確解法所進行的嘗試和產生的錯誤。他希望看到的是最乾淨最優雅的
443 解答。好學生了解這點，絕 443 解答。好學生了解這點，絕不會把最終解決之前的中間方案提交上去。」
444 444
445 內核開發也是這樣。維護者 445 內核開發也是這樣。維護者和評審者不希望看到一個人在解決問題時的思
446 考過程。他們只希望看到簡 446 考過程。他們只希望看到簡單和優雅的解決方案。
447 447
448 直接給出一流的解決方案，和社區 448 直接給出一流的解決方案，和社區一起協作討論尚未完成的工作，這兩者之間似乎
449 很難找到一個平衡點。所以最好儘 449 很難找到一個平衡點。所以最好儘早開始收集有利於你進行改進的反饋；同時也要
450 保證修改分成很多小塊，這樣在整 450 保證修改分成很多小塊，這樣在整個項目都準備好被包含進內核之前，其中的一部
451 分可能會先被接收。 451 分可能會先被接收。
452 452
453 必須了解這樣做是不可接受的：試 453 必須了解這樣做是不可接受的：試圖將未完成的工作提交進內核，然後再找時間修
454 復。 454 復。
455 455
456 456
457 證明修改的必要性 457 證明修改的必要性
458 ---------------- 458 ----------------
459 除了將補丁拆成小塊，很重要的一 459 除了將補丁拆成小塊，很重要的一點是讓Linux社區了解他們爲什麼需要這樣修改。
460 你必須證明新功能是有人需要的並 460 你必須證明新功能是有人需要的並且是有用的。
461 461
462 462
463 記錄修改 463 記錄修改
464 -------- 464 --------
465 465
466 當你發送補丁的時候，需要特別留 466 當你發送補丁的時候，需要特別留意郵件正文的內容。因爲這裡的信息將會做爲補
467 丁的修改記錄(ChangeLog)，會被一直 467 丁的修改記錄(ChangeLog)，會被一直保留以備大家查閱。它需要完全地描述補丁，
468 包括： 468 包括：
469 469
470 - 爲什麼需要這個修改 470 - 爲什麼需要這個修改
471 - 補丁的總體設計 471 - 補丁的總體設計
472 - 實現細節 472 - 實現細節
473 - 測試結果 473 - 測試結果
474 474
475 想了解它具體應該看起來像什麼， 475 想了解它具體應該看起來像什麼，請查閱以下文檔中的「ChangeLog」章節：
476 「The Perfect Patch」 476 「The Perfect Patch」
477 https://www.ozlabs.org/~akpm/stuff/tp 477 https://www.ozlabs.org/~akpm/stuff/tpp.txt
478 478
479 479
480 這些事情有時候做起來很難。要在 480 這些事情有時候做起來很難。要在任何方面都做到完美可能需要好幾年時間。這是
481 一個持續提高的過程，它需要大量 481 一個持續提高的過程，它需要大量的耐心和決心。只要不放棄，你一定可以做到。
482 很多人已經做到了，而他們都曾經 482 很多人已經做到了，而他們都曾經和現在的你站在同樣的起點上。
483 483
484 484
485 感謝 485 感謝
486 ---- 486 ----
487 感謝Paolo Ciarrocchi允許「開發流程」 487 感謝Paolo Ciarrocchi允許「開發流程」部分基於他所寫的文章
488 (http://www.kerneltravel.net/newbie/2.6-develo 488 (http://www.kerneltravel.net/newbie/2.6-development_process)，感謝Randy
489 Dunlap和Gerrit Huizenga完善了應該說和 489 Dunlap和Gerrit Huizenga完善了應該說和不該說的列表。感謝Pat Mochel, Hanna
490 Linder, Randy Dunlap, Kay Sievers, Vojtech Pav 490 Linder, Randy Dunlap, Kay Sievers, Vojtech Pavlik, Jan Kara, Josh Boyer,
491 Kees Cook, Andrew Morton, Andi Kleen, Vadim Lo 491 Kees Cook, Andrew Morton, Andi Kleen, Vadim Lobanov, Jesper Juhl, Adrian
492 Bunk, Keri Harris, Frans Pop, David A. Wheeler 492 Bunk, Keri Harris, Frans Pop, David A. Wheeler, Junio Hamano, Michael
493 Kerrisk和Alex Shepard的評審、建議和貢 493 Kerrisk和Alex Shepard的評審、建議和貢獻。沒有他們的幫助，這篇文檔是不可
494 能完成的。 494 能完成的。
495 495
496 496
497 497
498 英文版維護者： Greg Kroah-Hartman <greg@ 498 英文版維護者： Greg Kroah-Hartman <greg@kroah.com>
499 499
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.