Warning
此文件的目的是爲讓中文讀者更容易閱讀和理解，而不是作爲一個分支。因此， 如果您對此文件有任何意見或改動，請先嘗試更新原始英文文件。如果要更改或 修正某處翻譯文件，請將意見或補丁發送給維護者（聯繫方式見下）。
Note
如果您發現本文檔與原始文件有任何不同或者有翻譯問題，請聯繫該文件的譯者， 或者發送電子郵件給胡皓文以獲取幫助：<2023002089@link.tyut.edu.cn>。
如果想評論或更新本文的內容，請直接聯繫原文件的維護者。如果你使用英文 交流有困難的話，也可以向中文版維護者求助。如果本翻譯更新不及時或者翻 譯存在問題，請聯繫中文版維護者:
中文版維護者： 鍾宇 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行。
它必須遵循 Documentation/process/submitting-patches.rst 裡的規則。
它必須要麼修復一個困擾人們的真實的缺陷，要麼只是添加一個裝置ID。 對於前者，詳細來說：
它修復的問題，像是oops、當機、資料損壞、真實的安全問題、硬體怪癖 （hardware quirk）、建置錯誤（但不包括標記為CONFIG_BROKEN的東西）， 或者一些“喔，這可不好”之類的問題。
發行版核心的使用者所報告的嚴重問題，如果修復的是顯著的效能或互動性 問題，也可以被考慮。由於這些修復不那麼顯而易見，並且有較高的風險引入 不易察覺的迴歸，它們應該只由發行版核心的維護者提交，並附上補充說明， 給出指向bugzilla條目（如果存在）的連結，以及關於使用者可見影響的額外 資訊。
不接受“這可能是一個問題...”之類的東西，比如“理論上的競爭條件”，除非 同時提供了缺陷如何被利用的解釋。
不接受對使用者沒有好處的“瑣碎”修復（拼寫更改、空白清理等）。
向 -stable 樹提交補丁的流程¶
Note
安全補丁不應（只）由 -stable 審查流程處理，而應遵循 Documentation/process/security-bugs.rst 的流程。
要向 -stable 樹提交更改，有三個選項：
在你隨後提交到主線的補丁的描述中，加上一個“stable標籤”。
請求穩定版團隊撿取一個已經合併到主線的補丁。
向穩定版團隊提交一個與已合併到主線的更改等效的補丁。
以下小節更詳細地描述每個選項。
選項1 是 強烈 推薦的做法，它最簡單也最常見。 選項2 主要用於提交時沒有考慮向後移植的更改。 選項3 是前兩個選項之外的替代方案，用於已合併到主線的補丁需要調整才能套用到較舊系列 的情況（例如由於API變化）。
使用選項2或3時，可以要求將你的更改包含到特定的穩定版系列中。這麼做時，要確保 該修復或等效修復適用於、已提交到、或已經存在於所有仍在維護的較新穩定版樹中。 這是為了防止使用者日後更新時可能遇到的迴歸，例如一個合併於5.19-rc1的修復被 向後移植到5.10.y，卻沒有移植到5.15.y。
選項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
選項2¶
如果補丁已經合併到主線，請發送一封電子郵件到stable@vger.kernel.org，內容 包含補丁的標題、提交ID、你認為它應該被套用的原因，以及你希望它被套用到哪些 核心版本。
選項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 樹，而不經過正常的審查週期。 關於這一流程的更多細節，請聯繫核心安全團隊。
樹¶
已完成版本和進行中版本的補丁佇列可以在以下位置找到：
所有穩定版核心的最終定版並打上標籤的版本，可以在以下位置的每個版本各自的 分支中找到：
所有穩定版核心版本的釋出候選版本可以在以下位置找到：
Warning
-stable-rc 樹是stable-queue樹在某個時間點的快照，會頻繁變動，因此會經常 被rebase。它只應被用於測試目的（例如供CI系統使用）。
審查委員會¶
審查委員會由一些自願承擔這項任務的核心開發人員組成，還有幾位不是自願的。