7:sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/rust/general-informationmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/zh_TW/rust/general-informationmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/it_IT/rust/general-informationmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/ja_JP/rust/general-informationmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/ko_KR/rust/general-informationmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget,/translations/sp_SP/rust/general-informationmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhY/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/rust/general-information.rsthKubhnote)}(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)}(h+Documentation/rust/general-information.rst h]h)}(h*Documentation/rust/general-information.rsth]h*Documentation/rust/general-information.rst}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h翻译h]h翻译}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhKubh)}(h.司延腾 Yanteng Si h]h)}(h,司延腾 Yanteng Si h](h司延腾 Yanteng Si <}(hj hhhNhNubh reference)}(hsiyanteng@loongson.cnh]hsiyanteng@loongson.cn}(hj*hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:siyanteng@loongson.cnuh1j(hj ubh>}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhj ubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhsection)}(hhh](htitle)}(h 基本信息h]h 基本信息}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjXhhhhhK ubh)}(hO本文档包含了在内核中使用Rust支持时需要了解的有用信息。h]hO本文档包含了在内核中使用Rust支持时需要了解的有用信息。}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjXhhubjW)}(hhh](j\)}(h 代码文档h]h 代码文档}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjyhhhhhKubh)}(hMRust内核代码使用其内置的文档生成器 ``rustdoc`` 进行记录。h](h2Rust内核代码使用其内置的文档生成器 }(hjhhhNhNubhliteral)}(h ``rustdoc``h]hrustdoc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh 进行记录。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjyhhubh)}(h生成的HTML文档包括集成搜索、链接项（如类型、函数、常量）、源代码等。它们可以在以下地址阅读 （TODO：当在主线中时链接，与其他文档一起生成）：h]h生成的HTML文档包括集成搜索、链接项（如类型、函数、常量）、源代码等。它们可以在以下地址阅读 （TODO：当在主线中时链接，与其他文档一起生成）：}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjyhhubh block_quote)}(hhttp://kernel.org/ h]h)}(hhttp://kernel.org/h]j))}(hjh]hhttp://kernel.org/}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1j(hjubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhhKhjyhhubh)}(hXg这些文档也可以很容易地在本地生成和阅读。这相当快（与编译代码本身的顺序相同），而且不需要特 殊的工具或环境。这有一个额外的好处，那就是它们将根据所使用的特定内核配置进行定制。要生成它 们，请使用 ``rustdoc`` 目标，并使用编译时使用的相同调用，例如::h](hX 这些文档也可以很容易地在本地生成和阅读。这相当快（与编译代码本身的顺序相同），而且不需要特 殊的工具或环境。这有一个额外的好处，那就是它们将根据所使用的特定内核配置进行定制。要生成它 们，请使用 }(hjhhhNhNubj)}(h ``rustdoc``h]hrustdoc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh; 目标，并使用编译时使用的相同调用，例如:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjyhhubh literal_block)}(hmake LLVM=1 rustdoch]hmake LLVM=1 rustdoc}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhKhjyhhubh)}(hD要在你的网络浏览器中本地阅读该文档，请运行如::h]hC要在你的网络浏览器中本地阅读该文档，请运行如:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK!hjyhhubj)}(h要了解如何编写文档，请看 coding-guidelines.rst 。h]h>要了解如何编写文档，请看 coding-guidelines.rst 。}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK%hjyhhubeh}(h]id2ah ]h"] 代码文档ah$]h&]uh1jVhjXhhhhhKubjW)}(hhh](j\)}(h额外的lintsh]h额外的lints}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j[hj@hhhhhK)ubh)}(h虽然 ``rustc`` 是一个非常有用的编译器，但一些额外的lints和分析可以通过 ``clippy`` （一个Rust linter）来实现。要启用它，请将CLIPPY=1传递到用于编译的同一调用中，例如::h](h虽然 }(hjQhhhNhNubj)}(h ``rustc``h]hrustc}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubhR 是一个非常有用的编译器，但一些额外的lints和分析可以通过 }(hjQhhhNhNubj)}(h ``clippy``h]hclippy}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjQubhr （一个Rust linter）来实现。要启用它，请将CLIPPY=1传递到用于编译的同一调用中，例如:}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK+hj@hhubj)}(hmake LLVM=1 CLIPPY=1h]hmake LLVM=1 CLIPPY=1}hjsbah}(h]h ]h"]h$]h&]hhuh1jhhhK.hj@hhubh)}(hc请注意，Clippy可能会改变代码生成，因此在构建产品内核时不应该启用它。h]hc请注意，Clippy可能会改变代码生成，因此在构建产品内核时不应该启用它。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hj@hhubeh}(h]lintsah ]h"]额外的lintsah$]h&]uh1jVhjXhhhhhK)ubjW)}(hhh](j\)}(h抽象和绑定h]h抽象和绑定}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhK3ubh)}(h8抽象是用Rust代码包装来自C端的内核功能。h]h8抽象是用Rust代码包装来自C端的内核功能。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hjhhubh)}(h~为了使用来自C端的函数和类型，需要创建绑定。绑定是Rust对那些来自C端的函数和类型的声明。h]h~为了使用来自C端的函数和类型，需要创建绑定。绑定是Rust对那些来自C端的函数和类型的声明。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hjhhubh)}(h例如，人们可以在Rust中写一个 ``Mutex`` 抽象，它从C端包装一个 ``Mutex结构体`` ，并 通过绑定调用其函数。h](h)例如，人们可以在Rust中写一个 }(hjhhhNhNubj)}(h ``Mutex``h]hMutex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh! 抽象，它从C端包装一个 }(hjhhhNhNubj)}(h``Mutex结构体``h]hMutex结构体}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh& ，并 通过绑定调用其函数。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK9hjhhubh)}(hX抽象并不能用于所有的内核内部API和概念，但随着时间的推移，我们打算扩大覆盖范围。“Leaf” 模块（例如，驱动程序）不应该直接使用C语言的绑定。相反，子系统应该根据需要提供尽可能安 全的抽象。h]hX抽象并不能用于所有的内核内部API和概念，但随着时间的推移，我们打算扩大覆盖范围。“Leaf” 模块（例如，驱动程序）不应该直接使用C语言的绑定。相反，子系统应该根据需要提供尽可能安 全的抽象。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK