u<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&]uh1hhhhKhjXhhubhtarget)}(h".. _rust_code_documentation_zh_cn:h]h}(h]h ]h"]h$]h&]refidrust-code-documentation-zh-cnuh1jyhKhjXhhhhubjW)}(hhh](j\)}(h 代码文档h]h 代码文档}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhKubh)}(hMRust内核代码使用其内置的文档生成器 ``rustdoc`` 进行记录。h](h2Rust内核代码使用其内置的文档生成器 }(hjhhhNhNubhliteral)}(h ``rustdoc``h]hrustdoc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh 进行记录。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h生成的HTML文档包括集成搜索、链接项（如类型、函数、常量）、源代码等。它们可以在以下地址阅读 （TODO：当在主线中时链接，与其他文档一起生成）：h]h生成的HTML文档包括集成搜索、链接项（如类型、函数、常量）、源代码等。它们可以在以下地址阅读 （TODO：当在主线中时链接，与其他文档一起生成）：}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh 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&]uh1jhhhKhjhhubh)}(hXg这些文档也可以很容易地在本地生成和阅读。这相当快（与编译代码本身的顺序相同），而且不需要特 殊的工具或环境。这有一个额外的好处，那就是它们将根据所使用的特定内核配置进行定制。要生成它 们，请使用 ``rustdoc`` 目标，并使用编译时使用的相同调用，例如::h](hX 这些文档也可以很容易地在本地生成和阅读。这相当快（与编译代码本身的顺序相同），而且不需要特 殊的工具或环境。这有一个额外的好处，那就是它们将根据所使用的特定内核配置进行定制。要生成它 们，请使用 }(hjhhhNhNubj)}(h ``rustdoc``h]hrustdoc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh; 目标，并使用编译时使用的相同调用，例如:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh literal_block)}(hmake LLVM=1 rustdoch]hmake LLVM=1 rustdoc}hjsbah}(h]h ]h"]h$]h&]hhuh1j hhhK hjhhubh)}(hD要在你的网络浏览器中本地阅读该文档，请运行如::h]hC要在你的网络浏览器中本地阅读该文档，请运行如:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK"hjhhubj )}(h要了解如何编写文档，请看 coding-guidelines.rst 。h]h>要了解如何编写文档，请看 coding-guidelines.rst 。}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK&hjhhubeh}(h](jid2eh ]h"]( 代码文档rust_code_documentation_zh_cneh$]h&]uh1jVhjXhhhhhKexpect_referenced_by_name}jLj{sexpect_referenced_by_id}jj{subjW)}(hhh](j\)}(h额外的lintsh]h额外的lints}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjShhhhhK*ubh)}(h虽然 ``rustc`` 是一个非常有用的编译器，但一些额外的lints和分析可以通过 ``clippy`` （一个Rust linter）来实现。要启用它，请将CLIPPY=1传递到用于编译的同一调用中，例如::h](h虽然 }(hjdhhhNhNubj)}(h ``rustc``h]hrustc}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubhR 是一个非常有用的编译器，但一些额外的lints和分析可以通过 }(hjdhhhNhNubj)}(h ``clippy``h]hclippy}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjdubhr （一个Rust linter）来实现。要启用它，请将CLIPPY=1传递到用于编译的同一调用中，例如:}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK,hjShhubj )}(hmake LLVM=1 CLIPPY=1h]hmake LLVM=1 CLIPPY=1}hjsbah}(h]h ]h"]h$]h&]hhuh1j hhhK/hjShhubh)}(hc请注意，Clippy可能会改变代码生成，因此在构建产品内核时不应该启用它。h]hc请注意，Clippy可能会改变代码生成，因此在构建产品内核时不应该启用它。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjShhubeh}(h]lintsah ]h"]额外的lintsah$]h&]uh1jVhjXhhhhhK*ubjW)}(hhh](j\)}(h抽象和绑定h]h抽象和绑定}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjhhhhhK4ubh)}(h8抽象是用Rust代码包装来自C端的内核功能。h]h8抽象是用Rust代码包装来自C端的内核功能。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjhhubh)}(h~为了使用来自C端的函数和类型，需要创建绑定。绑定是Rust对那些来自C端的函数和类型的声明。h]h~为了使用来自C端的函数和类型，需要创建绑定。绑定是Rust对那些来自C端的函数和类型的声明。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjhhubh)}(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&]uh1hhhhK:hjhhubh)}(hX抽象并不能用于所有的内核内部API和概念，但随着时间的推移，我们打算扩大覆盖范围。“Leaf” 模块（例如，驱动程序）不应该直接使用C语言的绑定。相反，子系统应该根据需要提供尽可能安 全的抽象。h]hX抽象并不能用于所有的内核内部API和概念，但随着时间的推移，我们打算扩大覆盖范围。“Leaf” 模块（例如，驱动程序）不应该直接使用C语言的绑定。相反，子系统应该根据需要提供尽可能安 全的抽象。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hjhhubeh}(h]id3ah ]h"]抽象和绑定ah$]h&]uh1jVhjXhhhhhK4ubjW)}(hhh](j\)}(h有条件的编译h]h有条件的编译}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j[hj/hhhhhKCubh)}(h;Rust代码可以访问基于内核配置的条件性编译:h]h;Rust代码可以访问基于内核配置的条件性编译:}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKEhj/hhubj )}(h#[cfg(CONFIG_X)] // Enabled (`y` or `m`) #[cfg(CONFIG_X="y")] // Enabled as a built-in (`y`) #[cfg(CONFIG_X="m")] // Enabled as a module (`m`) #[cfg(not(CONFIG_X))] // Disabledh]h#[cfg(CONFIG_X)] // Enabled (`y` or `m`) #[cfg(CONFIG_X="y")] // Enabled as a built-in (`y`) #[cfg(CONFIG_X="m")] // Enabled as a module (`m`) #[cfg(not(CONFIG_X))] // Disabled}hjNsbah}(h]h ]h"]h$]h&]hhforcelanguagerusthighlight_args}uh1j hhhKGhj/hhubeh}(h]id4ah ]h"]有条件的编译ah$]h&]uh1jVhjXhhhhhKCubeh}(h]id1ah ]h"] 基本信息ah$]h&]uh1jVhhhhhhhK ubeh}(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_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _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}j]j{asnameids}(jnjkjLjjKjHjjj,j)jfjcu nametypes}(jnjLjKjj,jfuh}(jkjXjjjHjjjSj)jjcj/u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}jKsRparse_messages]transform_messages]hsystem_message)}(hhh]h)}(hhh]hCHyperlink target "rust-code-documentation-zh-cn" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1juba transformerN include_log]=Documentation/translations/zh_CN/rust/general-information.rst(NNNNta decorationNhhub.