.. SPDX-License-Identifier: GPL-2.0
.. _tw_stable_kernel_rules:
.. include:: ../disclaimer-zh_TW.rst
:Original: :ref:`Documentation/process/stable-kernel-rules.rst <stable_kernel_rules>`
如果想評論或更新本文的內容,請直接聯繫原文件的維護者。如果你使用英文
交流有困難的話,也可以向中文版維護者求助。如果本翻譯更新不及時或者翻
譯存在問題,請聯繫中文版維護者::
中文版維護者: 鍾宇 TripleX Chung <xxx.phy@gmail.com>
中文版翻譯者: 鍾宇 TripleX Chung <xxx.phy@gmail.com>
中文版校譯者:
- 李陽 Li Yang <leoyang.li@nxp.com>
- Kangkai Yin <e12051@motorola.com>
- 胡皓文 Hu Haowen <2023002089@link.tyut.edu.cn>
- 葉宸佑 Chen-Yu Yeh <chenyou910331@gmail.com>
所有你想知道的事情 - 關於Linux -stable 版本發布
===============================================
關於哪些類型的補丁會被接收進入 "-stable" 樹、哪些不會被接收的規則:
- 該補丁或一個等效的修復必須已經存在於Linux主線(上游)。
- 它必須是顯而易見正確的,並且經過測試的。
- 連同上下文,它不能大於100行。
- 它必須遵循
:ref:`Documentation/process/submitting-patches.rst <submittingpatches>`
裡的規則。
- 它必須要麼修復一個困擾人們的真實的缺陷,要麼只是添加一個裝置ID。
對於前者,詳細來說:
- 它修復的問題,像是oops、當機、資料損壞、真實的安全問題、硬體怪癖
(hardware quirk)、建置錯誤(但不包括標記為CONFIG_BROKEN的東西),
或者一些“喔,這可不好”之類的問題。
- 發行版核心的使用者所報告的嚴重問題,如果修復的是顯著的效能或互動性
問題,也可以被考慮。由於這些修復不那麼顯而易見,並且有較高的風險引入
不易察覺的迴歸,它們應該只由發行版核心的維護者提交,並附上補充說明,
給出指向bugzilla條目(如果存在)的連結,以及關於使用者可見影響的額外
資訊。
- 不接受“這可能是一個問題...”之類的東西,比如“理論上的競爭條件”,除非
同時提供了缺陷如何被利用的解釋。
- 不接受對使用者沒有好處的“瑣碎”修復(拼寫更改、空白清理等)。
向 -stable 樹提交補丁的流程
---------------------------
.. note::
安全補丁不應(只)由 -stable 審查流程處理,而應遵循
:ref:`Documentation/process/security-bugs.rst <securitybugs>`
的流程。
要向 -stable 樹提交更改,有三個選項:
1. 在你隨後提交到主線的補丁的描述中,加上一個“stable標籤”。
2. 請求穩定版團隊撿取一個已經合併到主線的補丁。
3. 向穩定版團隊提交一個與已合併到主線的更改等效的補丁。
以下小節更詳細地描述每個選項。
:ref:`tw_option_1` 是 **強烈** 推薦的做法,它最簡單也最常見。
:ref:`tw_option_2` 主要用於提交時沒有考慮向後移植的更改。 :ref:`tw_option_3`
是前兩個選項之外的替代方案,用於已合併到主線的補丁需要調整才能套用到較舊系列
的情況(例如由於API變化)。
使用選項2或3時,可以要求將你的更改包含到特定的穩定版系列中。這麼做時,要確保
該修復或等效修復適用於、已提交到、或已經存在於所有仍在維護的較新穩定版樹中。
這是為了防止使用者日後更新時可能遇到的迴歸,例如一個合併於5.19-rc1的修復被
向後移植到5.10.y,卻沒有移植到5.15.y。
.. _tw_option_1:
選項1
*****
要讓你提交到主線的補丁之後被自動撿取到穩定版樹,請在簽署(sign-off)區加上
這個標籤::
Cc: stable@vger.kernel.org
當修復未公開的漏洞時,請改用 ``Cc: stable@kernel.org``:它可以降低透過
'git send-email' 意外將修復公開的機會,因為發送到該地址的郵件不會被投遞到
任何地方。
補丁合併到主線後,它將被套用到穩定版樹,而無需作者或子系統維護者再做任何
事情。
要向穩定版團隊發送額外的指示,可使用shell風格的行內註解來傳遞任意的或預定義
的備註:
* 指明揀選(cherry pick)所需的額外補丁前置條件::
Cc: <stable@vger.kernel.org> # 3.3.x: a1f84a3: sched: Check for idle
Cc: <stable@vger.kernel.org> # 3.3.x: 1b9508f: sched: Rate-limit newidle
Cc: <stable@vger.kernel.org> # 3.3.x: fd21073: sched: Fix affinity logic
Cc: <stable@vger.kernel.org> # 3.3.x
Signed-off-by: Ingo Molnar <mingo@elte.hu>
上面標籤序列的含義為::
git cherry-pick a1f84a3
git cherry-pick 1b9508f
git cherry-pick fd21073
git cherry-pick <this commit>
注意,對於一個補丁系列,你不必把系列中已有的補丁列為前置條件。例如,如果
你有如下補丁系列::
patch1
patch2
其中patch2依賴patch1,如果你已經把patch1標記為穩定版收錄,就不必再把它列
為patch2的前置條件。
* 指出核心版本的前置條件::
Cc: <stable@vger.kernel.org> # 3.3.x
該標籤的含義為::
git cherry-pick <this commit>
對每個從指定版本開始的“-stable”樹執行。
注意,如果穩定版團隊可以從Fixes:標籤推導出適當的版本,則無需這樣標記。
* 延遲補丁的撿取::
Cc: <stable@vger.kernel.org> # after -rc3
* 指出已知的問題::
Cc: <stable@vger.kernel.org> # see patch description, needs adjustments for <= 6.3
此外,stable標籤還有一種變體,可以讓穩定版團隊的向後移植工具(例如AUTOSEL
或尋找含有'Fixes:'標籤的提交的腳本)忽略一個更改::
Cc: <stable+noautosel@kernel.org> # reason goes here, and must be present
.. _tw_option_2:
選項2
*****
如果補丁已經合併到主線,請發送一封電子郵件到stable@vger.kernel.org,內容
包含補丁的標題、提交ID、你認為它應該被套用的原因,以及你希望它被套用到哪些
核心版本。
.. _tw_option_3:
選項3
*****
在確認補丁符合上述規則後,將補丁發送到stable@vger.kernel.org,並註明你希望
它被套用到的核心版本。這麼做時,你必須在你所提交補丁的更改日誌中註明上游的
提交ID,並在提交說明文字上方以單獨一行標註,像這樣::
commit <sha1> upstream.
或者::
[ Upstream commit <sha1> ]
如果提交的補丁與原始的上游補丁有出入(例如因為需要為較舊的API調整),則必須
在補丁描述中非常清楚地記錄並說明理由。
提交之後
--------
當補丁被接受進入佇列後,發送者會收到一個ACK;如果補丁被拒絕,則會收到NAK。
這個回覆可能需要幾天時間,取決於穩定版團隊成員的日程安排。
如果被接受,補丁將被加入 -stable 佇列,供其他開發人員和相關子系統維護者
審查。
審查週期
--------
- 當 -stable 維護者決定進行審查週期時,補丁將被發送到審查委員會,以及補丁
影響領域的維護者(除非提交者就是該領域的維護者),並抄送到linux-kernel
郵件列表。
- 審查委員會有48小時的時間對補丁作出ACK或NAK。
- 如果補丁被委員會成員拒絕,或者linux-kernel列表上的成員反對這個補丁並提出
了維護者和委員會成員沒有意識到的問題,補丁將從佇列中移除。
- 通過ACK的補丁將作為釋出候選(-rc)版本的一部分再次發布,以供開發人員和
測試人員測試。
- 通常只會產生一個 -rc 版本,然而如果存在未解決的問題,某些補丁可能會被修改
或移除,或者有額外的補丁進入佇列。此後會發布更多的 -rc 版本並加以測試,
直到不再發現問題為止。
- 可以在郵件列表上發送帶有任何所需測試資訊的“Tested-by:”郵件來回覆 -rc
版本。“Tested-by:”標籤將被收集並加入到發布提交中。
- 在審查週期結束時,新的 -stable 版本將被發布,其中包含所有排隊的、經過測試
的補丁。
- 安全補丁將由核心安全團隊直接接受進入 -stable 樹,而不經過正常的審查週期。
關於這一流程的更多細節,請聯繫核心安全團隊。
樹
--
- 已完成版本和進行中版本的補丁佇列可以在以下位置找到:
https://git.kernel.org/pub/scm/linux/kernel/git/stable/stable-queue.git
- 所有穩定版核心的最終定版並打上標籤的版本,可以在以下位置的每個版本各自的
分支中找到:
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
- 所有穩定版核心版本的釋出候選版本可以在以下位置找到:
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable-rc.git/
.. warning::
-stable-rc 樹是stable-queue樹在某個時間點的快照,會頻繁變動,因此會經常
被rebase。它只應被用於測試目的(例如供CI系統使用)。
審查委員會
----------
- 審查委員會由一些自願承擔這項任務的核心開發人員組成,還有幾位不是自願的。