Ksphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget"/admin-guide/reporting-regressionsmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/zh_TW/admin-guide/reporting-regressionsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/it_IT/admin-guide/reporting-regressionsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/ja_JP/admin-guide/reporting-regressionsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/ko_KR/admin-guide/reporting-regressionsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/pt_BR/admin-guide/reporting-regressionsmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget5/translations/sp_SP/admin-guide/reporting-regressionsmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhcomment)}(h0SPDX-License-Identifier: (GPL-2.0+ OR CC-BY-4.0)h]h0SPDX-License-Identifier: (GPL-2.0+ OR CC-BY-4.0)}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhb/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/admin-guide/reporting-regressions.rsthKubh)}(h*【重分发信息参见本文件结尾】h]h*【重分发信息参见本文件结尾】}hhsbah}(h]h ]h"]h$]h&]hhuh1hhhhhhhhKubhnote)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]h paragraph)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hh5Documentation/translations/zh_CN/disclaimer-zh_CN.rsthKhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh field_list)}(hhh](hfield)}(hhh](h field_name)}(hOriginalh]hOriginal}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(h4Documentation/admin-guide/reporting-regressions.rst h]h)}(h3Documentation/admin-guide/reporting-regressions.rsth]h3Documentation/admin-guide/reporting-regressions.rst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j hhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h译者h]h译者}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hhhKubj)}(h+吴想成 Wu XiangCheng h]h)}(h)吴想成 Wu XiangCheng h](h吴想成 Wu XiangCheng <}(hjBhhhNhNubh reference)}(hbobwxc@email.cnh]hbobwxc@email.cn}(hjLhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:bobwxc@email.cnuh1jJhjBubh>}(hjBhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK hj>ubah}(h]h ]h"]h$]h&]uh1j hj-ubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhsection)}(hhh](htitle)}(h报告回归问题h]h报告回归问题}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjzhhhhhKubh)}(h“*我们拒绝出现回归*”是Linux内核开发的首要规则；Linux的发起者和领军开发者Linus Torvalds立下了此规则并确保它被落实。h](h“}(hjhhhNhNubhemphasis)}(h*我们拒绝出现回归*h]h我们拒绝出现回归}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh”是Linux内核开发的首要规则；Linux的发起者和领军开发者Linus Torvalds立下了此规则并确保它被落实。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjzhhubh)}(h本文档描述了这条规则对用户的意义，以及Linux内核开发模型如何确保解决所有被报告 的回归；关于内核开发者如何处理的方面参见 Documentation/process/handling-regressions.rst 。h]h本文档描述了这条规则对用户的意义，以及Linux内核开发模型如何确保解决所有被报告 的回归；关于内核开发者如何处理的方面参见 Documentation/process/handling-regressions.rst 。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjzhhubjy)}(hhh](j~)}(h*本文重点（亦即“太长不看”）h]h*本文重点（亦即“太长不看”）}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKubhenumerated_list)}(hhh](h list_item)}(h如果某程序在原先的Linux内核上运行良好，但在较新版本上效果更差、或者根本不 能用，那么你就碰见回归问题了。注意，新内核需要使用类似配置编译；更多相关细 节参见下方。 h]h)}(h如果某程序在原先的Linux内核上运行良好，但在较新版本上效果更差、或者根本不 能用，那么你就碰见回归问题了。注意，新内核需要使用类似配置编译；更多相关细 节参见下方。h]h如果某程序在原先的Linux内核上运行良好，但在较新版本上效果更差、或者根本不 能用，那么你就碰见回归问题了。注意，新内核需要使用类似配置编译；更多相关细 节参见下方。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hX按照 Documentation/translations/zh_CN/admin-guide/reporting-issues.rst 中 所说的报告你的问题，该文档已经包含了所有关于回归的重要方面，为了方便起见也 复制到了下面。两个重点：在报告主题中使用“[REGRESSION]”开头并抄送或转发到 `回归邮件列表 `_ （regressions@lists.linux.dev）。 h]h)}(hX按照 Documentation/translations/zh_CN/admin-guide/reporting-issues.rst 中 所说的报告你的问题，该文档已经包含了所有关于回归的重要方面，为了方便起见也 复制到了下面。两个重点：在报告主题中使用“[REGRESSION]”开头并抄送或转发到 `回归邮件列表 `_ （regressions@lists.linux.dev）。h](hX'按照 Documentation/translations/zh_CN/admin-guide/reporting-issues.rst 中 所说的报告你的问题，该文档已经包含了所有关于回归的重要方面，为了方便起见也 复制到了下面。两个重点：在报告主题中使用“[REGRESSION]”开头并抄送或转发到 }(hjhhhNhNubjK)}(h<`回归邮件列表 `_h]h回归邮件列表}(hjhhhNhNubah}(h]h ]h"]h$]h&]name回归邮件列表refuri$https://lore.kernel.org/regressions/uh1jJhjubhtarget)}(h' h]h}(h]id3ah ]h"]回归邮件列表ah$]h&]refurij uh1j  referencedKhjubh （}(hjhhhNhNubjK)}(hregressions@lists.linux.devh]hregressions@lists.linux.dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]refuri"mailto:regressions@lists.linux.devuh1jJhjubh）。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(h可选但是建议：在发送或转发报告时，指明该回归发生的起点，以便Linux内核回归 追踪机器人“regzbot”可以追踪此问题:: #regzbot introduced v5.13..v5.14-rc1 h](h)}(h可选但是建议：在发送或转发报告时，指明该回归发生的起点，以便Linux内核回归 追踪机器人“regzbot”可以追踪此问题::h]h可选但是建议：在发送或转发报告时，指明该回归发生的起点，以便Linux内核回归 追踪机器人“regzbot”可以追踪此问题:}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK%hj?ubh literal_block)}(h$#regzbot introduced v5.13..v5.14-rc1h]h$#regzbot introduced v5.13..v5.14-rc1}hjSsbah}(h]h ]h"]h$]h&]hhuh1jQhhhK(hj?ubeh}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1jhjhhhhhKubeh}(h]id2ah ]h"]*本文重点（亦即“太长不看”）ah$]h&]uh1jxhjzhhhhhKubjy)}(hhh](j~)}(h/与用户相关的所有Linux内核回归细节h]h/与用户相关的所有Linux内核回归细节}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjzhhhhhK,ubjy)}(hhh](j~)}(h 基本重点h]h 基本重点}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhK0ubjy)}(hhh](j~)}(h<什么是“回归”以及什么是“无回归规则”？h]h<什么是“回归”以及什么是“无回归规则”？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhK4ubh)}(hX如果某程序/实例在原先的Linux内核上运行良好，但在较新版本上效果更差、或者根本 不能用，那么你就碰见回归问题了。“无回归规则”不允许出现这种情况。如果偶然发 生了，导致问题的开发者应当迅速修复问题。h]hX如果某程序/实例在原先的Linux内核上运行良好，但在较新版本上效果更差、或者根本 不能用，那么你就碰见回归问题了。“无回归规则”不允许出现这种情况。如果偶然发 生了，导致问题的开发者应当迅速修复问题。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjhhubh)}(hX也就是说，若Linux 5.13中的WiFi驱动程序运行良好，但是在5.14版本上却不能用、速 度明显变慢或出现错误，那就出现了回归。如果某正常工作的应用程序突然在新内核上 出现不稳定，这也是回归；这些问题可能是由于procfs、sysfs或Linux提供给用户空间 软件的许多其他接口之一的变化。但请记住，前述例子中的5.14需要使用类似于5.13的 配置构建。这可以用 ``make olddefconfig`` 实现，详细解释见下。h](hX也就是说，若Linux 5.13中的WiFi驱动程序运行良好，但是在5.14版本上却不能用、速 度明显变慢或出现错误，那就出现了回归。如果某正常工作的应用程序突然在新内核上 出现不稳定，这也是回归；这些问题可能是由于procfs、sysfs或Linux提供给用户空间 软件的许多其他接口之一的变化。但请记住，前述例子中的5.14需要使用类似于5.13的 配置构建。这可以用 }(hjhhhNhNubhliteral)}(h``make olddefconfig``h]hmake olddefconfig}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh 实现，详细解释见下。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK:hjhhubh)}(h注意本节第一句话中的“实例”：即使开发者需要遵循“无回归”规则，但仍可自由地改 变内核的任何方面，甚至是导出到用户空间的API或ABI，只要别破坏现有的应用程序或 用例。h]h注意本节第一句话中的“实例”：即使开发者需要遵循“无回归”规则，但仍可自由地改 变内核的任何方面，甚至是导出到用户空间的API或ABI，只要别破坏现有的应用程序或 用例。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjhhubh)}(h还需注意，“无回归”规则只限制内核提供给用户空间的接口。它不适用于内核内部接 口，比如一些外部开发的驱动程序用来插入钩子到内核的模块API。h]h还需注意，“无回归”规则只限制内核提供给用户空间的接口。它不适用于内核内部接 口，比如一些外部开发的驱动程序用来插入钩子到内核的模块API。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjhhubeh}(h]id5ah ]h"]<什么是“回归”以及什么是“无回归规则”？ah$]h&]uh1jxhjhhhhhK4ubjy)}(hhh](j~)}(h如何报告回归？h]h如何报告回归？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKHubh)}(h只需按照 Documentation/translations/zh_CN/admin-guide/reporting-issues.rst 中 所说的报告你的问题，该文档已经包含了要点。下面几点概述了一下只在回归中重要的 方面：h]h只需按照 Documentation/translations/zh_CN/admin-guide/reporting-issues.rst 中 所说的报告你的问题，该文档已经包含了要点。下面几点概述了一下只在回归中重要的 方面：}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhjhhubh block_quote)}(hXK* 在检查可加入讨论的现有报告时，别忘了搜索 `Linux回归邮件列表 `_ 和 `regzbot网页界面 `_ 。 * 在报告主题的开头加上“[REGRESSION]”。 * 在你的报告中明确最后一个正常工作的内核版本和首个出问题的版本。如若可能， 用二分法尝试找出导致回归的变更，更多细节见下。 * 记得把报告发到Linux回归邮件列表（regressions@lists.linux.dev）。 * 如果通过邮件报告回归，请抄送回归列表。 * 如果你使用某些缺陷追踪器报告回归，请通过邮件转发已提交的报告到回归列表， 并抄送维护者以及出问题的相关子系统的邮件列表。 如果是稳定版或长期支持版系列（如v5.15.3…v5.15.5）的回归，请记得抄送 `Linux稳定版邮件列表 `_ （stable@vger.kernel.org）。 如果你成功地执行了二分，请抄送肇事提交的信息中所有签了“Signed-off-by:”的人。 h](h bullet_list)}(hhh](j)}(h在检查可加入讨论的现有报告时，别忘了搜索 `Linux回归邮件列表 `_ 和 `regzbot网页界面 `_ 。 h]h)}(h在检查可加入讨论的现有报告时，别忘了搜索 `Linux回归邮件列表 `_ 和 `regzbot网页界面 `_ 。h](h=在检查可加入讨论的现有报告时，别忘了搜索 }(hj/hhhNhNubjK)}(hA`Linux回归邮件列表 `_h]hLinux回归邮件列表}(hj7hhhNhNubah}(h]h ]h"]h$]h&]nameLinux回归邮件列表j $https://lore.kernel.org/regressions/uh1jJhj/ubj )}(h' h]h}(h]id7ah ]h"]linux回归邮件列表ah$]h&]refurijGuh1j jKhj/ubh 和 }(hj/hhhNhNubjK)}(hI`regzbot网页界面 `_h]hregzbot网页界面}(hjYhhhNhNubah}(h]h ]h"]h$]h&]nameregzbot网页界面j 0https://linux-regtracking.leemhuis.info/regzbot/uh1jJhj/ubj )}(h3 h]h}(h]regzbotah ]h"]regzbot网页界面ah$]h&]refurijiuh1j jKhj/ubh 。}(hj/hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKNhj+ubah}(h]h ]h"]h$]h&]uh1jhj(ubj)}(h4在报告主题的开头加上“[REGRESSION]”。 h]h)}(h3在报告主题的开头加上“[REGRESSION]”。h]h3在报告主题的开头加上“[REGRESSION]”。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjubah}(h]h ]h"]h$]h&]uh1jhj(ubj)}(h在你的报告中明确最后一个正常工作的内核版本和首个出问题的版本。如若可能， 用二分法尝试找出导致回归的变更，更多细节见下。 h]h)}(h在你的报告中明确最后一个正常工作的内核版本和首个出问题的版本。如若可能， 用二分法尝试找出导致回归的变更，更多细节见下。h]h在你的报告中明确最后一个正常工作的内核版本和首个出问题的版本。如若可能， 用二分法尝试找出导致回归的变更，更多细节见下。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThjubah}(h]h ]h"]h$]h&]uh1jhj(ubj)}(hX记得把报告发到Linux回归邮件列表（regressions@lists.linux.dev）。 * 如果通过邮件报告回归，请抄送回归列表。 * 如果你使用某些缺陷追踪器报告回归，请通过邮件转发已提交的报告到回归列表， 并抄送维护者以及出问题的相关子系统的邮件列表。 如果是稳定版或长期支持版系列（如v5.15.3…v5.15.5）的回归，请记得抄送 `Linux稳定版邮件列表 `_ （stable@vger.kernel.org）。 h](h)}(hP记得把报告发到Linux回归邮件列表（regressions@lists.linux.dev）。h](h/记得把报告发到Linux回归邮件列表（}(hjhhhNhNubjK)}(hregressions@lists.linux.devh]hregressions@lists.linux.dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]refuri"mailto:regressions@lists.linux.devuh1jJhjubh）。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKWhjubj')}(hhh](j)}(h:如果通过邮件报告回归，请抄送回归列表。 h]h)}(h9如果通过邮件报告回归，请抄送回归列表。h]h9如果通过邮件报告回归，请抄送回归列表。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKYhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h如果你使用某些缺陷追踪器报告回归，请通过邮件转发已提交的报告到回归列表， 并抄送维护者以及出问题的相关子系统的邮件列表。 h]h)}(h如果你使用某些缺陷追踪器报告回归，请通过邮件转发已提交的报告到回归列表， 并抄送维护者以及出问题的相关子系统的邮件列表。h]h如果你使用某些缺陷追踪器报告回归，请通过邮件转发已提交的报告到回归列表， 并抄送维护者以及出问题的相关子系统的邮件列表。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK[hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]bullet*uh1j&hhhKYhjubh)}(h如果是稳定版或长期支持版系列（如v5.15.3…v5.15.5）的回归，请记得抄送 `Linux稳定版邮件列表 `_ （stable@vger.kernel.org）。h](h`如果是稳定版或长期支持版系列（如v5.15.3…v5.15.5）的回归，请记得抄送 }(hjhhhNhNubjK)}(h?`Linux稳定版邮件列表 `_h]hLinux稳定版邮件列表}(hj hhhNhNubah}(h]h ]h"]h$]h&]nameLinux稳定版邮件列表j https://lore.kernel.org/stable/uh1jJhjubj )}(h" h]h}(h]id8ah ]h"]linux稳定版邮件列表ah$]h&]refurij0uh1j jKhjubh （}(hjhhhNhNubjK)}(hstable@vger.kernel.orgh]hstable@vger.kernel.org}(hjBhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:stable@vger.kernel.orguh1jJhjubh）。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK^hjubeh}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]jjuh1j&hhhKNhj"ubj!)}(ho如果你成功地执行了二分，请抄送肇事提交的信息中所有签了“Signed-off-by:”的人。 h]h)}(hn如果你成功地执行了二分，请抄送肇事提交的信息中所有签了“Signed-off-by:”的人。h]hn如果你成功地执行了二分，请抄送肇事提交的信息中所有签了“Signed-off-by:”的人。}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKahjhubah}(h]h ]h"]h$]h&]uh1j hhhKahj"ubeh}(h]h ]h"]h$]h&]uh1j hhhKNhjhhubh)}(h在抄送你的报告到列表时，也请记得通知前述的Linux内核回归追踪机器人。只需在邮件 中包含如下片段::h]h在抄送你的报告到列表时，也请记得通知前述的Linux内核回归追踪机器人。只需在邮件 中包含如下片段:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchjhhubjR)}(h%#regzbot introduced: v5.13..v5.14-rc1h]h%#regzbot introduced: v5.13..v5.14-rc1}hjsbah}(h]h ]h"]h$]h&]hhuh1jQhhhKfhjhhubh)}(hX Regzbot会就将你的邮件视为在某个特定版本区间的回归报告。上例中即linux v5.13仍 然正常，而Linux 5.14-rc1是首个您遇到问题的版本。如果你执行了二分以查找导致回 归的提交，请使用指定肇事提交的id代替::h]hX Regzbot会就将你的邮件视为在某个特定版本区间的回归报告。上例中即linux v5.13仍 然正常，而Linux 5.14-rc1是首个您遇到问题的版本。如果你执行了二分以查找导致回 归的提交，请使用指定肇事提交的id代替:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhjhhubjR)}(h#regzbot introduced: 1f2e3d4c5dh]h#regzbot introduced: 1f2e3d4c5d}hjsbah}(h]h ]h"]h$]h&]hhuh1jQhhhKlhjhhubh)}(hX添加这样的“regzbot命令”对你是有好处的，它会确保报告不会被忽略。如果你省略了 它，Linux内核的回归跟踪者会把你的回归告诉regzbot，只要你发送了一个副本到回归 邮件列表。但是回归跟踪者只有一个人，有时不得不休息或甚至偶尔享受可以远离电脑 的时光（听起来很疯狂）。因此，依赖此人手动将回归添加到 `已追踪且尚未解决的 Linux内核回归列表 `_ 和 regzbot发送的每周回归报告，可能会出现延迟。 这样的延误会导致Linus Torvalds 在决定“继续开发还是发布新版本？”时忽略严重的回归。h](hX添加这样的“regzbot命令”对你是有好处的，它会确保报告不会被忽略。如果你省略了 它，Linux内核的回归跟踪者会把你的回归告诉regzbot，只要你发送了一个副本到回归 邮件列表。但是回归跟踪者只有一个人，有时不得不休息或甚至偶尔享受可以远离电脑 的时光（听起来很疯狂）。因此，依赖此人手动将回归添加到 }(hjhhhNhNubjK)}(hi`已追踪且尚未解决的 Linux内核回归列表 `_h]h3已追踪且尚未解决的 Linux内核回归列表}(hjhhhNhNubah}(h]h ]h"]h$]h&]name3已追踪且尚未解决的 Linux内核回归列表j 0https://linux-regtracking.leemhuis.info/regzbot/uh1jJhjubj )}(h3 h]h}(h]id9ah ]h"]3已追踪且尚未解决的 linux内核回归列表ah$]h&]refurijuh1j jKhjubh 和 regzbot发送的每周回归报告，可能会出现延迟。 这样的延误会导致Linus Torvalds 在决定“继续开发还是发布新版本？”时忽略严重的回归。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKnhjhhubeh}(h]id6ah ]h"]如何报告回归？ah$]h&]uh1jxhjhhhhhKHubjy)}(hhh](j~)}(h$真的修复了所有的回归吗？h]h$真的修复了所有的回归吗？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKwubh)}(h几乎所有都是，只要引起问题的变更（肇事提交）被可靠定位。也有些回归可以不用这 样，但通常是必须的。h]h几乎所有都是，只要引起问题的变更（肇事提交）被可靠定位。也有些回归可以不用这 样，但通常是必须的。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKyhjhhubeh}(h]id10ah ]h"]$真的修复了所有的回归吗？ah$]h&]uh1jxhjhhhhhKwubjy)}(hhh](j~)}(h'谁需要找出回归的根本原因？h]h'谁需要找出回归的根本原因？}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhK}ubh)}(hX受影响代码区域的开发者应该自行尝试定位问题所在。但仅靠他们的努力往往是不可 能做到的，很多问题只发生在开发者的无法接触的其他特定外部环境中——例如特定的 硬件平台、固件、Linux发行版、系统的配置或应用程序。这就是为什么最终往往是报 告者定位肇事提交；有时用户甚至需要再运行额外测试以查明确切的根本原因。开发 者应该提供建议和可能的帮助，以使普通用户更容易完成该流程。h]hX受影响代码区域的开发者应该自行尝试定位问题所在。但仅靠他们的努力往往是不可 能做到的，很多问题只发生在开发者的无法接触的其他特定外部环境中——例如特定的 硬件平台、固件、Linux发行版、系统的配置或应用程序。这就是为什么最终往往是报 告者定位肇事提交；有时用户甚至需要再运行额外测试以查明确切的根本原因。开发 者应该提供建议和可能的帮助，以使普通用户更容易完成该流程。}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id11ah ]h"]'谁需要找出回归的根本原因？ah$]h&]uh1jxhjhhhhhK}ubjy)}(hhh](j~)}(h如何找到罪魁祸首？h]h如何找到罪魁祸首？}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjDhhhhhKubh)}(hX如 Documentation/translations/zh_CN/admin-guide/reporting-issues.rst （简要） 和 Documentation/translations/zh_CN/admin-guide/bug-bisect.rst （详细）中所 述，执行二分。听起来工作量很大，但大部分情况下很快就能找到罪魁祸首。如果这很 困难或可靠地重现问题很耗时，请考虑与其他受影响的用户合作，一起缩小搜索范围。h]hX如 Documentation/translations/zh_CN/admin-guide/reporting-issues.rst （简要） 和 Documentation/translations/zh_CN/admin-guide/bug-bisect.rst （详细）中所 述，执行二分。听起来工作量很大，但大部分情况下很快就能找到罪魁祸首。如果这很 困难或可靠地重现问题很耗时，请考虑与其他受影响的用户合作，一起缩小搜索范围。}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjDhhubeh}(h]id12ah ]h"]如何找到罪魁祸首？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(h0当出现回归时我可以向谁寻求建议？h]h0当出现回归时我可以向谁寻求建议？}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjkhhhhhKubh)}(h发送邮件到回归邮件列表（regressions@lists.linux.dev）同时抄送Linux内核的回归 跟踪者（regressions@leemhuis.info）;如果问题需要保密处理，可以省略列表。h](h$发送邮件到回归邮件列表（}(hj|hhhNhNubjK)}(hregressions@lists.linux.devh]hregressions@lists.linux.dev}(hjhhhNhNubah}(h]h ]h"]h$]h&]refuri"mailto:regressions@lists.linux.devuh1jJhj|ubh0）同时抄送Linux内核的回归 跟踪者（}(hj|hhhNhNubjK)}(hregressions@leemhuis.infoh]hregressions@leemhuis.info}(hjhhhNhNubah}(h]h ]h"]h$]h&]refuri mailto:regressions@leemhuis.infouh1jJhj|ubh:）;如果问题需要保密处理，可以省略列表。}(hj|hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjkhhubeh}(h]id13ah ]h"]0当出现回归时我可以向谁寻求建议？ah$]h&]uh1jxhjhhhhhKubeh}(h]id4ah ]h"] 基本重点ah$]h&]uh1jxhjzhhhhhK0ubjy)}(hhh](j~)}(h关于回归的更多细节h]h关于回归的更多细节}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKubjy)}(hhh](j~)}(h*“无回归规则”的目标是什么？h]h*“无回归规则”的目标是什么？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKubh)}(hX用户应该放心升级内核版本，而不必担心有程序可能崩溃。这符合内核开发者的利益， 可以使更新有吸引力：他们不希望用户停留在停止维护或超过一年半的稳定/长期Linux 版本系列上。这也符合所有人的利益，因为 `那些系列可能含有已知的缺陷、安全问题 或其他后续版本已经修复的问题 `_ 。 此外，内核开发者希望使用户测试最新的预发行版或常规发行版变得简单而有吸引力。 这同样符合所有人的利益，如果新版本出来后很快就有相关报告，会使追踪和修复问题 更容易。h](hX用户应该放心升级内核版本，而不必担心有程序可能崩溃。这符合内核开发者的利益， 可以使更新有吸引力：他们不希望用户停留在停止维护或超过一年半的稳定/长期Linux 版本系列上。这也符合所有人的利益，因为 }(hjhhhNhNubjK)}(h`那些系列可能含有已知的缺陷、安全问题 或其他后续版本已经修复的问题 `_h]ha那些系列可能含有已知的缺陷、安全问题 或其他后续版本已经修复的问题}(hjhhhNhNubah}(h]h ]h"]h$]h&]namea那些系列可能含有已知的缺陷、安全问题 或其他后续版本已经修复的问题j Ihttp://www.kroah.com/log/blog/2018/08/24/what-stable-kernel-should-i-use/uh1jJhjubj )}(hL h]h}(h]id16ah ]h"]a那些系列可能含有已知的缺陷、安全问题 或其他后续版本已经修复的问题ah$]h&]refurijuh1j jKhjubh 。 此外，内核开发者希望使用户测试最新的预发行版或常规发行版变得简单而有吸引力。 这同样符合所有人的利益，如果新版本出来后很快就有相关报告，会使追踪和修复问题 更容易。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id15ah ]h"]*“无回归规则”的目标是什么？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(h0实际中“无回归”规则真的可行吗？h]h0实际中“无回归”规则真的可行吗？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKubh)}(h这不是句玩笑话，请见Linux创建者和主要开发人员Linus Torvalds在邮件列表中的许 多发言，其中一些在 Documentation/process/handling-regressions.rst 中被引用。h]h这不是句玩笑话，请见Linux创建者和主要开发人员Linus Torvalds在邮件列表中的许 多发言，其中一些在 Documentation/process/handling-regressions.rst 中被引用。}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h此规则的例外情况极为罕见；之前当开发者认为某个特定的情况有必要援引例外时， 基本都被证明错了。h]h此规则的例外情况极为罕见；之前当开发者认为某个特定的情况有必要援引例外时， 基本都被证明错了。}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id17ah ]h"]0实际中“无回归”规则真的可行吗？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(h'谁来确保“无回归”被落实？h]h'谁来确保“无回归”被落实？}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjQhhhhhKubh)}(h照看和支撑树的子系统维护者应该关心这一点——例如，Linus Torvalds之于主线， Greg Kroah-Hartman等人之于各种稳定/长期系列。h]h照看和支撑树的子系统维护者应该关心这一点——例如，Linus Torvalds之于主线， Greg Kroah-Hartman等人之于各种稳定/长期系列。}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjQhhubh)}(hX他们都得到了别人的帮助，以确保回归报告不会被遗漏。其中之一是Thorsten Leemhuis，他目前担任Linux内核的“回归跟踪者”；为了做好这项工作，他使用了 regzbot——Linux内核回归跟踪机器人。所以这就是为什么要抄送或转发你的报告到 回归邮件列表来通知这些人，已经最好在你的邮件中包含“regzbot命令”来立即追踪它。h]hX他们都得到了别人的帮助，以确保回归报告不会被遗漏。其中之一是Thorsten Leemhuis，他目前担任Linux内核的“回归跟踪者”；为了做好这项工作，他使用了 regzbot——Linux内核回归跟踪机器人。所以这就是为什么要抄送或转发你的报告到 回归邮件列表来通知这些人，已经最好在你的邮件中包含“regzbot命令”来立即追踪它。}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjQhhubeh}(h]id18ah ]h"]'谁来确保“无回归”被落实？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(h回归通常多久能修复？h]h回归通常多久能修复？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKubh)}(h开发者应该尽快修复任何被报告的回归，以提供及时为受影响的用户提供解决方案，并 防止更多用户遇到问题；然而，开发人员需要花足够的时间和注意力确保回归修复不会 造成额外的损害。h]h开发者应该尽快修复任何被报告的回归，以提供及时为受影响的用户提供解决方案，并 防止更多用户遇到问题；然而，开发人员需要花足够的时间和注意力确保回归修复不会 造成额外的损害。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h因此，答案取决于各种因素，如回归的影响、存在时长或出现于哪个Linux版本系列。 但最终，大多数的回归应该在两周内修复。h]h因此，答案取决于各种因素，如回归的影响、存在时长或出现于哪个Linux版本系列。 但最终，大多数的回归应该在两周内修复。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id19ah ]h"]回归通常多久能修复？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(hB当问题可以通过升级某些软件解决时，是回归吗？h]hB当问题可以通过升级某些软件解决时，是回归吗？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKubh)}(hZ基本都是。如果开发人员告诉您其他情况，请咨询上述回归跟踪者。h]hZ基本都是。如果开发人员告诉您其他情况，请咨询上述回归跟踪者。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id20ah ]h"]B当问题可以通过升级某些软件解决时，是回归吗？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(h3当新内核变慢或能耗增加，是回归吗？h]h3当新内核变慢或能耗增加，是回归吗？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKubh)}(h是的，但有一些差别。在微型基准测试中变慢5%不太可能被视为回归，除非它也会对 广泛基准测试的结果产生超过1%的影响。如果有疑问，请寻求建议。h]h是的，但有一些差别。在微型基准测试中变慢5%不太可能被视为回归，除非它也会对 广泛基准测试的结果产生超过1%的影响。如果有疑问，请寻求建议。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id21ah ]h"]3当新内核变慢或能耗增加，是回归吗？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(h>当更新Linux时外部内核模块崩溃了，是回归吗？h]h>当更新Linux时外部内核模块崩溃了，是回归吗？}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j}hj hhhhhKubh)}(h不，因为“无回归”规则仅限于Linux内核提供给用户空间的接口和服务。因此，它不包括 构建或运行外部开发的内核模块，因为它们在内核空间中运行与挂进内核使用的内部接 口偶尔会变化。h]h不，因为“无回归”规则仅限于Linux内核提供给用户空间的接口和服务。因此，它不包括 构建或运行外部开发的内核模块，因为它们在内核空间中运行与挂进内核使用的内部接 口偶尔会变化。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubeh}(h]id22ah ]h"]>当更新linux时外部内核模块崩溃了，是回归吗？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(h*如何处理安全修复引起的回归？h]h*如何处理安全修复引起的回归？}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1j}hj0hhhhhKubh)}(hXQ在极为罕见的情况下，安全问题无法在不引起回归的情况下修复；这些修复都被放弃了， 因为它们终究会引起问题。幸运的是这种两难境地基本都可以避免，受影响区域的主要 开发者以及Linus Torvalds本人通常都会努力在不引入回归的情况下解决安全问题。h]hXQ在极为罕见的情况下，安全问题无法在不引起回归的情况下修复；这些修复都被放弃了， 因为它们终究会引起问题。幸运的是这种两难境地基本都可以避免，受影响区域的主要 开发者以及Linus Torvalds本人通常都会努力在不引入回归的情况下解决安全问题。}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj0hhubh)}(h如果你仍然面临此种情况，请查看邮件列表档案是否有人尽力避免过回归。如果没有， 请报告它；如有疑问，请如上所述寻求建议。h]h如果你仍然面临此种情况，请查看邮件列表档案是否有人尽力避免过回归。如果没有， 请报告它；如有疑问，请如上所述寻求建议。}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj0hhubeh}(h]id23ah ]h"]*如何处理安全修复引起的回归？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(hB当修复回归时不可避免会引入另一个，如何处理？h]hB当修复回归时不可避免会引入另一个，如何处理？}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjehhhhhKubh)}(hXe很遗憾这种事确实会出现，但幸运的是并不经常出现；如果发生了，受影响代码区的资 深开发者应当调查该问题以找到避免回归的解决方法，至少避免它们的影响。如果你遇 到这样的情况，如上所述：检查之前的讨论是否有人已经尽了最大努力，如有疑问请寻 求建议。h]hXe很遗憾这种事确实会出现，但幸运的是并不经常出现；如果发生了，受影响代码区的资 深开发者应当调查该问题以找到避免回归的解决方法，至少避免它们的影响。如果你遇 到这样的情况，如上所述：检查之前的讨论是否有人已经尽了最大努力，如有疑问请寻 求建议。}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjehhubh)}(hX小提示：如果人们在每个开发周期中定期给出主线预发布（即v5.15-rc1或-rc3）以供 测试，则可以避免这种情况。为了更好地解释，可以设想一个在Linux v5.14和v5.15-rc1 之间集成的更改，该更改导致了回归，但同时是应用于5.15-rc1的其他改进的强依赖。 如果有人在5.15发布之前就发现并报告了这个问题，那么所有更改都可以直接撤销，从 而解决回归问题。而就在几天或几周后，此解决方案变成了不可能，因为一些软件可能 已经开始依赖于后续更改之一：撤销所有更改将导致上述用户软件出现回归，这是不可 接受的。h]hX小提示：如果人们在每个开发周期中定期给出主线预发布（即v5.15-rc1或-rc3）以供 测试，则可以避免这种情况。为了更好地解释，可以设想一个在Linux v5.14和v5.15-rc1 之间集成的更改，该更改导致了回归，但同时是应用于5.15-rc1的其他改进的强依赖。 如果有人在5.15发布之前就发现并报告了这个问题，那么所有更改都可以直接撤销，从 而解决回归问题。而就在几天或几周后，此解决方案变成了不可能，因为一些软件可能 已经开始依赖于后续更改之一：撤销所有更改将导致上述用户软件出现回归，这是不可 接受的。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjehhubeh}(h]id24ah ]h"]B当修复回归时不可避免会引入另一个，如何处理？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(hB若我所依赖的功能在数月前被移除了，是回归吗？h]hB若我所依赖的功能在数月前被移除了，是回归吗？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKubh)}(h是的，但如前节所述，通常很难修复此类回归。因此需要逐案处理。这也是定期测试主 线预发布对所有人有好处的另一个原因。h]h是的，但如前节所述，通常很难修复此类回归。因此需要逐案处理。这也是定期测试主 线预发布对所有人有好处的另一个原因。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id25ah ]h"]B若我所依赖的功能在数月前被移除了，是回归吗？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(hQ如果我似乎是唯一受影响的人，是否仍适用“无回归”规则？h]hQ如果我似乎是唯一受影响的人，是否仍适用“无回归”规则？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhKubh)}(h适用，但仅限于实际使用：Linux开发人员希望能够自由地取消那些只能在阁楼和博物 馆中找到的硬件的支持。h]h适用，但仅限于实际使用：Linux开发人员希望能够自由地取消那些只能在阁楼和博物 馆中找到的硬件的支持。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXp请注意，有时为了取得进展，不得不出现回归——后者也是防止Linux停滞不前所必需 的。因此如果回归所影响的用户很少，那么为了他们和其他人更大的利益，还是让事情 过去吧。尤其是存在某种规避回归的简单方法，例如更新一些软件或者使用专门为此目 的创建的内核参数。h]hXp请注意，有时为了取得进展，不得不出现回归——后者也是防止Linux停滞不前所必需 的。因此如果回归所影响的用户很少，那么为了他们和其他人更大的利益，还是让事情 过去吧。尤其是存在某种规避回归的简单方法，例如更新一些软件或者使用专门为此目 的创建的内核参数。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id26ah ]h"]Q如果我似乎是唯一受影响的人，是否仍适用“无回归”规则？ah$]h&]uh1jxhjhhhhhKubjy)}(hhh](j~)}(h7回归规则是否也适用于staging树中的代码？h]h7回归规则是否也适用于staging树中的代码？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhMubh)}(h不，参见 `适用于所有staging代码配置选项的帮助文本 `_ ， 其早已声明::h](h 不，参见 }(hjhhhNhNubjK)}(h`适用于所有staging代码配置选项的帮助文本 `_h]h7适用于所有staging代码配置选项的帮助文本}(hjhhhNhNubah}(h]h ]h"]h$]h&]name7适用于所有staging代码配置选项的帮助文本j _https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/drivers/staging/Kconfiguh1jJhjubj )}(hb h]h}(h]id27ah ]h"]7适用于所有staging代码配置选项的帮助文本ah$]h&]refurijuh1j jKhjubh ， 其早已声明:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubjR)}(h请注意：这些驱动正在积极开发中，可能无法正常工作，并可能包含会在不久的 将来发生变化的用户接口。h]h请注意：这些驱动正在积极开发中，可能无法正常工作，并可能包含会在不久的 将来发生变化的用户接口。}hj7sbah}(h]h ]h"]h$]h&]hhuh1jQhhhMhjhhubh)}(h虽然staging开发人员通常坚持“无回归”的原则，但有时为了取得进展也会违背它。这就 是为什么当staging树的WiFi驱动被基本推倒重来时，有些用户不得不处理回归（通常可 以忽略）。h]h虽然staging开发人员通常坚持“无回归”的原则，但有时为了取得进展也会违背它。这就 是为什么当staging树的WiFi驱动被基本推倒重来时，有些用户不得不处理回归（通常可 以忽略）。}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjhhubeh}(h]stagingah ]h"]7回归规则是否也适用于staging树中的代码？ah$]h&]uh1jxhjhhhhhMubjy)}(hhh](j~)}(h<为什么较新版本必须“使用相似配置编译”？h]h<为什么较新版本必须“使用相似配置编译”？}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1j}hj[hhhhhMubh)}(h因为Linux内核开发人员有时会集成已知的会导致回归的变更，但使它们成为可选的，并 在内核的默认配置下禁用它们。这一技巧允许进步，否则“无回归”规则将导致停滞。h]h因为Linux内核开发人员有时会集成已知的会导致回归的变更，但使它们成为可选的，并 在内核的默认配置下禁用它们。这一技巧允许进步，否则“无回归”规则将导致停滞。}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj[hhubh)}(hX4例如，试想一个新的可以阻止恶意软件滥用某个内核的接口的安全特性，同时又需要满足 另一个很罕见的应用程序。上述的方法可使两方都满意：使用这些应用程序的人可以关闭 新的安全功能，而其他不会遇到麻烦的人可以启用它。h]hX4例如，试想一个新的可以阻止恶意软件滥用某个内核的接口的安全特性，同时又需要满足 另一个很罕见的应用程序。上述的方法可使两方都满意：使用这些应用程序的人可以关闭 新的安全功能，而其他不会遇到麻烦的人可以启用它。}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj[hhubeh}(h]id28ah ]h"]<为什么较新版本必须“使用相似配置编译”？ah$]h&]uh1jxhjhhhhhMubjy)}(hhh](j~)}(h*如何创建与旧内核相似的配置？h]h*如何创建与旧内核相似的配置？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhMubh)}(hXX用一个已知良好的内核启动机器，并用 ``make olddefconfig`` 配置新版的Linux。这 会让内核的构建脚本从正在运行的内核中摘录配置文件（“.config”文件），作为即将编 译的新版本的基础配置；同时将所有新的配置选项设为默认值，以禁用可能导致回归的 新功能。h](h4用一个已知良好的内核启动机器，并用 }(hjhhhNhNubj)}(h``make olddefconfig``h]hmake olddefconfig}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhX 配置新版的Linux。这 会让内核的构建脚本从正在运行的内核中摘录配置文件（“.config”文件），作为即将编 译的新版本的基础配置；同时将所有新的配置选项设为默认值，以禁用可能导致回归的 新功能。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubeh}(h]id29ah ]h"]*如何创建与旧内核相似的配置？ah$]h&]uh1jxhjhhhhhMubjy)}(hhh](j~)}(h<如何报告在预编译的普通内核中发现的回归？h]h<如何报告在预编译的普通内核中发现的回归？}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhM ubh)}(h您需要确保新的内核是用与旧版相似的配置编译（见上文），因为那些构建它们的人可 能启用了一些已知的与新内核不兼容的特性。如有疑问，请向内核的提供者报告问题并 寻求建议。h]h您需要确保新的内核是用与旧版相似的配置编译（见上文），因为那些构建它们的人可 能启用了一些已知的与新内核不兼容的特性。如有疑问，请向内核的提供者报告问题并 寻求建议。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM"hjhhubeh}(h]id30ah ]h"]<如何报告在预编译的普通内核中发现的回归？ah$]h&]uh1jxhjhhhhhM ubeh}(h]id14ah ]h"]关于回归的更多细节ah$]h&]uh1jxhjzhhhhhKubjy)}(hhh](j~)}(h+用“regzbot”追踪回归的更多信息h]h+用“regzbot”追踪回归的更多信息}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j}hjhhhhhM(ubjy)}(hhh](j~)}(h3什么是回归追踪？为啥我需要关心它？h]h3什么是回归追踪？为啥我需要关心它？}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j}hj hhhhhM+ubh)}(hX像“无回归”这样的规则需要有人来确保它们被遵守，否则会被有意/无意打破。历史证 明了这一点对于Linux内核开发也适用。这就是为什么Linux内核的回归跟踪者Thorsten Leemhuis，，和另一些人尽力关注所有的回归直到他们解决。他们从未为此获得报酬， 因此这项工作是在尽最大努力的基础上完成的。h]hX像“无回归”这样的规则需要有人来确保它们被遵守，否则会被有意/无意打破。历史证 明了这一点对于Linux内核开发也适用。这就是为什么Linux内核的回归跟踪者Thorsten Leemhuis，，和另一些人尽力关注所有的回归直到他们解决。他们从未为此获得报酬， 因此这项工作是在尽最大努力的基础上完成的。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM-hj hhubeh}(h]id32ah ]h"]3什么是回归追踪？为啥我需要关心它？ah$]h&]uh1jxhjhhhhhM+ubjy)}(hhh](j~)}(h9为什么/如何使用机器人追踪Linux内核回归？h]h9为什么/如何使用机器人追踪Linux内核回归？}(hj3 hhhNhNubah}(h]h ]h"]h$]h&]uh1j}hj0 hhhhhM3ubh)}(hX 由于Linux内核开发过程的分布式和松散结构，完全手动跟踪回归已经被证明是相当困难 的。因此Linux内核的回归跟踪者开发了regzbot来促进这项工作，其长期目标是尽可能为 所有相关人员自动化回归跟踪。h]hX 由于Linux内核开发过程的分布式和松散结构，完全手动跟踪回归已经被证明是相当困难 的。因此Linux内核的回归跟踪者开发了regzbot来促进这项工作，其长期目标是尽可能为 所有相关人员自动化回归跟踪。}(hjA hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM5hj0 hhubh)}(hRegzbot通过监视跟踪的回归报告的回复来工作。此外，它还查找用“Link:”标签引用这 些报告的补丁；对这些补丁的回复也会被跟踪。结合这些数据，可以很好地了解当前修 复过程的状态。h]hRegzbot通过监视跟踪的回归报告的回复来工作。此外，它还查找用“Link:”标签引用这 些报告的补丁；对这些补丁的回复也会被跟踪。结合这些数据，可以很好地了解当前修 复过程的状态。}(hjO hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM9hj0 hhubeh}(h]id33ah ]h"]9为什么/如何使用机器人追踪linux内核回归？ah$]h&]uh1jxhjhhhhhM3ubjy)}(hhh](j~)}(h+如何查看regzbot当前追踪的回归？h]h+如何查看regzbot当前追踪的回归？}(hjh hhhNhNubah}(h]h ]h"]h$]h&]uh1j}hje hhhhhM>ubh)}(hN参见 `regzbot在线 `_ 。h](h参见 }(hjv hhhNhNubjK)}(hC`regzbot在线 `_h]h regzbot在线}(hj~ hhhNhNubah}(h]h ]h"]h$]h&]name regzbot在线j 0https://linux-regtracking.leemhuis.info/regzbot/uh1jJhjv ubj )}(h3 h]h}(h]id35ah ]h"] regzbot在线ah$]h&]refurij uh1j jKhjv ubh 。}(hjv hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhM@hje hhubeh}(h]id34ah ]h"]+如何查看regzbot当前追踪的回归？ah$]h&]uh1jxhjhhhhhM>ubjy)}(hhh](j~)}(h%何种问题可以由regzbot追踪？h]h%何种问题可以由regzbot追踪？}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j}hj hhhhhMCubh)}(hX该机器人只为了跟踪回归，因此请不要让regzbot涉及常规问题。但是对于Linux内核的 回归跟踪者来说，让regzbot跟踪严重问题也可以，如有关挂起、损坏数据或内部错误 （Panic、Oops、BUG（）、warning…）的报告。h]hX该机器人只为了跟踪回归，因此请不要让regzbot涉及常规问题。但是对于Linux内核的 回归跟踪者来说，让regzbot跟踪严重问题也可以，如有关挂起、损坏数据或内部错误 （Panic、Oops、BUG（）、warning…）的报告。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMEhj hhubeh}(h]id36ah ]h"]%何种问题可以由regzbot追踪？ah$]h&]uh1jxhjhhhhhMCubjy)}(hhh](j~)}(h-如何修改被追踪回归的相关信息？h]h-如何修改被追踪回归的相关信息？}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j}hj hhhhhMJubh)}(hX在直接或间接回复报告邮件时使用“regzbot命令”即可。最简单的方法是：在“已发送”文 件夹或邮件列表存档中找到报告，然后使用邮件客户端的“全部回复”功能对其进行回复。 在该邮件中的独立段落中可使用以下命令之一（即使用空行将这些命令中的一个或多个与 其余邮件文本分隔开）。h]hX在直接或间接回复报告邮件时使用“regzbot命令”即可。最简单的方法是：在“已发送”文 件夹或邮件列表存档中找到报告，然后使用邮件客户端的“全部回复”功能对其进行回复。 在该邮件中的独立段落中可使用以下命令之一（即使用空行将这些命令中的一个或多个与 其余邮件文本分隔开）。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMLhj hhubj!)}(hX* 更新回归引入起点，例如在执行二分之后:: #regzbot introduced: 1f2e3d4c5d * 设置或更新标题:: #regzbot title: foo * 监视讨论或bugzilla.kernel.org上有关讨论或修复的工单:: #regzbot monitor: https://lore.kernel.org/r/30th.anniversary.repost@klaava.Helsinki.FI/ #regzbot monitor: https://bugzilla.kernel.org/show_bug.cgi?id=123456789 * 标记一个有更多相关细节的地方，例如有关但主题不同的邮件列表帖子或缺陷追踪器中的工单:: #regzbot link: https://bugzilla.kernel.org/show_bug.cgi?id=123456789 * 标记回归已失效:: #regzbot invalid: wasn't a regression, problem has always existed h]j')}(hhh](j)}(h^更新回归引入起点，例如在执行二分之后:: #regzbot introduced: 1f2e3d4c5d h](h)}(h8更新回归引入起点，例如在执行二分之后::h]h7更新回归引入起点，例如在执行二分之后:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMQhj ubjR)}(h#regzbot introduced: 1f2e3d4c5dh]h#regzbot introduced: 1f2e3d4c5d}hj sbah}(h]h ]h"]h$]h&]hhuh1jQhhhMShj ubeh}(h]h ]h"]h$]h&]uh1jhj ubj)}(h1设置或更新标题:: #regzbot title: foo h](h)}(h设置或更新标题::h]h设置或更新标题:}(hj% hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMUhj! ubjR)}(h#regzbot title: fooh]h#regzbot title: foo}hj3 sbah}(h]h ]h"]h$]h&]hhuh1jQhhhMWhj! ubeh}(h]h ]h"]h$]h&]uh1jhj ubj)}(h监视讨论或bugzilla.kernel.org上有关讨论或修复的工单:: #regzbot monitor: https://lore.kernel.org/r/30th.anniversary.repost@klaava.Helsinki.FI/ #regzbot monitor: https://bugzilla.kernel.org/show_bug.cgi?id=123456789 h](h)}(hE监视讨论或bugzilla.kernel.org上有关讨论或修复的工单::h]hD监视讨论或bugzilla.kernel.org上有关讨论或修复的工单:}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMYhjG ubjR)}(h#regzbot monitor: https://lore.kernel.org/r/30th.anniversary.repost@klaava.Helsinki.FI/ #regzbot monitor: https://bugzilla.kernel.org/show_bug.cgi?id=123456789h]h#regzbot monitor: https://lore.kernel.org/r/30th.anniversary.repost@klaava.Helsinki.FI/ #regzbot monitor: https://bugzilla.kernel.org/show_bug.cgi?id=123456789}hjY sbah}(h]h ]h"]h$]h&]hhuh1jQhhhM[hjG ubeh}(h]h ]h"]h$]h&]uh1jhj ubj)}(h标记一个有更多相关细节的地方，例如有关但主题不同的邮件列表帖子或缺陷追踪器中的工单:: #regzbot link: https://bugzilla.kernel.org/show_bug.cgi?id=123456789 h](h)}(h}标记一个有更多相关细节的地方，例如有关但主题不同的邮件列表帖子或缺陷追踪器中的工单::h]h|标记一个有更多相关细节的地方，例如有关但主题不同的邮件列表帖子或缺陷追踪器中的工单:}(hjq hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM^hjm ubjR)}(hD#regzbot link: https://bugzilla.kernel.org/show_bug.cgi?id=123456789h]hD#regzbot link: https://bugzilla.kernel.org/show_bug.cgi?id=123456789}hj sbah}(h]h ]h"]h$]h&]hhuh1jQhhhM`hjm ubeh}(h]h ]h"]h$]h&]uh1jhj ubj)}(h_标记回归已失效:: #regzbot invalid: wasn't a regression, problem has always existed h](h)}(h标记回归已失效::h]h标记回归已失效:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMbhj ubjR)}(hA#regzbot invalid: wasn't a regression, problem has always existedh]hA#regzbot invalid: wasn't a regression, problem has always existed}hj sbah}(h]h ]h"]h$]h&]hhuh1jQhhhMdhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]jjuh1j&hhhMQhj ubah}(h]h ]h"]h$]h&]uh1j hhhMQhj hhubh)}(hX+Regzbot还支持其他一些主要由开发人员或回归追踪人员使用的命令。命令的更多细节请 参考 `入门指南 `_ 和 `参考手册 `_ 。h](hxRegzbot还支持其他一些主要由开发人员或回归追踪人员使用的命令。命令的更多细节请 参考 }(hj hhhNhNubjK)}(hX`入门指南 `_h]h 入门指南}(hj hhhNhNubah}(h]h ]h"]h$]h&]name 入门指南j Fhttps://gitlab.com/knurd42/regzbot/-/blob/main/docs/getting_started.mduh1jJhj ubj )}(hI h]h}(h]id38ah ]h"] 入门指南ah$]h&]refurij uh1j jKhj ubh 和 }(hj hhhNhNubjK)}(hR`参考手册 `_h]h 参考手册}(hj hhhNhNubah}(h]h ]h"]h$]h&]name 参考手册j @https://gitlab.com/knurd42/regzbot/-/blob/main/docs/reference.mduh1jJhj ubj )}(hC h]h}(h]id39ah ]h"] 参考手册ah$]h&]refurij uh1j jKhj ubh 。}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMfhj hhubh)}(h 正文结束h]h 正文结束}hj sbah}(h]h ]h"]h$]h&]hhuh1hhj hhhhhMkubh)}(hX[如本文件开头所述，本文以GPL-2.0+或CC-BY-4.0许可发行。如您想仅在CC-BY-4.0许 可下重分发本文，请用“Linux内核开发者”作为作者，并用如下链接作为来源： https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/Documentation/translations/zh_CN/admin-guide/reporting-regressions.rsth]hX[如本文件开头所述，本文以GPL-2.0+或CC-BY-4.0许可发行。如您想仅在CC-BY-4.0许 可下重分发本文，请用“Linux内核开发者”作为作者，并用如下链接作为来源： https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/plain/Documentation/translations/zh_CN/admin-guide/reporting-regressions.rst=}hj% sbah}(h]h ]h"]h$]h&]hhuh1hhj hhhhhMoubh)}(h注意：本RST文件内容只有在来自Linux内核源代码时是使用CC-BY-4.0许可的，因为经 过处理的版本（如经内核的构建系统）可能包含来自使用更严格许可证的文件的内容。h]h注意：本RST文件内容只有在来自Linux内核源代码时是使用CC-BY-4.0许可的，因为经 过处理的版本（如经内核的构建系统）可能包含来自使用更严格许可证的文件的内容。}hj3 sbah}(h]h ]h"]h$]h&]hhuh1hhj hhhhhMrubeh}(h]id37ah ]h"]-如何修改被追踪回归的相关信息？ah$]h&]uh1jxhjhhhhhMJubeh}(h]id31ah ]h"]+用“regzbot”追踪回归的更多信息ah$]h&]uh1jxhjzhhhhhM(ubeh}(h]linuxah ]h"]/与用户相关的所有linux内核回归细节ah$]h&]uh1jxhjzhhhhhK,ubeh}(h]id1ah ]h"]报告回归问题ah$]h&]uh1jxhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(j}N generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j^ j[ jwjtjjjV jS jjjjjjjQjNjsjpj:j7jjjjjAj>jhjejjjjjjjjjNjKjjjjjjjjj-j*jbj_jjjjjjjXjUj)j&jjjjjjjN jK j- j* jb j_ j j j j j j jF jC j j j j u nametypes}(j^ jwjjV jjjjQjsj:jjjAjhjjjjjNjjjjj-jbjjjjXj)jjjjN j- jb j j j jF j j uh}(j[ jzjtjjj jS jzjjjjjjjNjHjpjjj7j1jjjjj>jjejDjjkjjjjjjjKjjjQjjjjjjj*j j_j0jjejjjjjUjj&j jj[jjjjjK jj* j j_ j0 j je j j j j jC j j j j j u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}j K'sRparse_messages]transform_messages] transformerN include_log]FDocumentation/translations/zh_CN/admin-guide/reporting-regressions.rst(NNNNta decorationNhhub.