1.. SPDX-License-Identifier: GPL-2.0
2
3.. include:: ../disclaimer-zh_TW.rst
4
5:Original: :doc:`../../../admin-guide/bug-bisect`
6
7:譯者:
8
9 吳想成 Wu XiangCheng <bobwxc@email.cn>
10 胡皓文 Hu Haowen <src.res.211@gmail.com>
11
12二分（bisect）缺陷
13+++++++++++++++++++
14
15（英文版）最後更新：2016年10月28日
16
17引言
18=====
19
20始終嘗試由來自kernel.org的原始碼構建的最新內核。如果您沒有信心這樣做，請將
21錯誤報告給您的發行版供應商，而不是內核開發人員。
22
23找到缺陷（bug）並不總是那麼容易，不過仍然得去找。如果你找不到它，不要放棄。
24儘可能多的向相關維護人員報告您發現的信息。請參閱MAINTAINERS文件以了解您所
25關注的子系統的維護人員。
26
27在提交錯誤報告之前，請閱讀「Documentation/admin-guide/reporting-issues.rst」。
28
29設備未出現（Devices not appearing）
30====================================
31
32這通常是由udev/systemd引起的。在將其歸咎於內核之前先檢查一下。
33
34查找導致缺陷的補丁
35===================
36
37使用 ``git`` 提供的工具可以很容易地找到缺陷，只要缺陷是可復現的。
38
39操作步驟：
40
41- 從git原始碼構建內核
42- 以此開始二分 [#f1]_::
43
44	$ git bisect start
45
46- 標記損壞的變更集::
47
48	$ git bisect bad [commit]
49
50- 標記正常工作的變更集::
51
52	$ git bisect good [commit]
53
54- 重新構建內核並測試
55- 使用以下任一與git bisect進行交互::
56
57	$ git bisect good
58
59  或::
60
61	$ git bisect bad
62
63  這取決於您測試的變更集上是否有缺陷
64- 在一些交互之後，git bisect將給出可能導致缺陷的變更集。
65
66- 例如，如果您知道當前版本有問題，而4.8版本是正常的，則可以執行以下操作::
67
68	$ git bisect start
69	$ git bisect bad                 # Current version is bad
70	$ git bisect good v4.8
71
72
73.. [#f1] 您可以（可選地）在開始git bisect的時候提供good或bad參數
74         ``git bisect start [BAD] [GOOD]``
75
76如需進一步參考，請閱讀：
77
78- ``git-bisect`` 的手冊頁
79- `Fighting regressions with git bisect（用git bisect解決回歸）
80  <https://www.kernel.org/pub/software/scm/git/docs/git-bisect-lk2009.html>`_
81- `Fully automated bisecting with "git bisect run"（使用git bisect run
82  來全自動二分） <https://lwn.net/Articles/317154>`_
83- `Using Git bisect to figure out when brokenness was introduced
84  （使用Git二分來找出何時引入了錯誤） <http://webchick.net/node/99>`_
85
86