asphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/core-api/symbol-namespacesmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/zh_TW/core-api/symbol-namespacesmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/it_IT/core-api/symbol-namespacesmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/ja_JP/core-api/symbol-namespacesmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/ko_KR/core-api/symbol-namespacesmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget./translations/sp_SP/core-api/symbol-namespacesmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhnote)}(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&]uh1hhhh[/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/core-api/symbol-namespaces.rsthKubh field_body)}(h-Documentation/core-api/symbol-namespaces.rst h]h)}(h,Documentation/core-api/symbol-namespaces.rsth]h,Documentation/core-api/symbol-namespaces.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翻译}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh)}(h-司延腾 Yanteng Si h]h)}(h,司延腾 Yanteng Si h](h司延腾 Yanteng Si <}(hjhhhNhNubh reference)}(hsiyanteng@loongson.cnh]hsiyanteng@loongson.cn}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:siyanteng@loongson.cnuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhtarget)}(h.. _cn_symbol-namespaces.rst:h]h}(h]h ]h"]h$]h&]refidcn-symbol-namespaces-rstuh1jDhKhhhhhhubhsection)}(hhh](htitle)}(h)符号命名空间（Symbol Namespaces）h]h)符号命名空间（Symbol Namespaces）}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jWhjThhhhhK ubh)}(h~本文档描述了如何使用符号命名空间来构造通过EXPORT_SYMBOL()系列宏导出的内核内符号的导出面。h]h~本文档描述了如何使用符号命名空间来构造通过EXPORT_SYMBOL()系列宏导出的内核内符号的导出面。}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjThhubhcomment)}(hX目录 === 1 简介 === 2 如何定义符号命名空间 --- 2.1 使用EXPORT_SYMBOL宏 --- 2.2 使用DEFAULT_SYMBOL_NAMESPACE定义 === 3 如何使用命名空间中导出的符号 === 4 加载使用命名空间符号的模块 === 5 自动创建MODULE_IMPORT_NS声明h]hX目录 === 1 简介 === 2 如何定义符号命名空间 --- 2.1 使用EXPORT_SYMBOL宏 --- 2.2 使用DEFAULT_SYMBOL_NAMESPACE定义 === 3 如何使用命名空间中导出的符号 === 4 加载使用命名空间符号的模块 === 5 自动创建MODULE_IMPORT_NS声明}hjwsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1juhjThhhhhKubjS)}(hhh](jX)}(h 1. 简介h]h 1. 简介}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jWhjhhhhhKubh)}(hX符号命名空间已经被引入，作为构造内核内API的导出面的一种手段。它允许子系统维护者将 他们导出的符号划分进独立的命名空间。这对于文档的编写非常有用（想想SUBSYSTEM_DEBUG 命名空间），也可以限制一组符号在内核其他部分的使用。今后，使用导出到命名空间的符号 的模块必须导入命名空间。否则，内核将根据其配置，拒绝加载该模块或警告说缺少 导入。h]hX符号命名空间已经被引入，作为构造内核内API的导出面的一种手段。它允许子系统维护者将 他们导出的符号划分进独立的命名空间。这对于文档的编写非常有用（想想SUBSYSTEM_DEBUG 命名空间），也可以限制一组符号在内核其他部分的使用。今后，使用导出到命名空间的符号 的模块必须导入命名空间。否则，内核将根据其配置，拒绝加载该模块或警告说缺少 导入。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]id1ah ]h"] 1. 简介ah$]h&]uh1jRhjThhhhhKubjS)}(hhh](jX)}(h!2. 如何定义符号命名空间h]h!2. 如何定义符号命名空间}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jWhjhhhhhK%ubh)}(h符号可以用不同的方法导出到命名空间。所有这些都在改变 EXPORT_SYMBOL 和与之类似的那些宏 被检测到的方式，以创建 ksymtab 条目。h]h符号可以用不同的方法导出到命名空间。所有这些都在改变 EXPORT_SYMBOL 和与之类似的那些宏 被检测到的方式，以创建 ksymtab 条目。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjhhubeh}(h]id2ah ]h"]!2. 如何定义符号命名空间ah$]h&]uh1jRhjThhhhhK%ubjS)}(hhh](jX)}(h2.1 使用EXPORT_SYMBOL宏h]h2.1 使用EXPORT_SYMBOL宏}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jWhjhhhhhK+ubh)}(hX除了允许将内核符号导出到内核符号表的宏EXPORT_SYMBOL()和EXPORT_SYMBOL_GPL()之外， 这些宏的变体还可以将符号导出到某个命名空间：EXPORT_SYMBOL_NS() 和 EXPORT_SYMBOL_NS_GPL()。 它们需要一个额外的参数：命名空间（the namespace）。请注意，由于宏扩展，该参数需 要是一个预处理器符号。例如，要把符号 ``usb_stor_suspend`` 导出到命名空间 ``USB_STORAGE``， 请使用::h](hX除了允许将内核符号导出到内核符号表的宏EXPORT_SYMBOL()和EXPORT_SYMBOL_GPL()之外， 这些宏的变体还可以将符号导出到某个命名空间：EXPORT_SYMBOL_NS() 和 EXPORT_SYMBOL_NS_GPL()。 它们需要一个额外的参数：命名空间（the namespace）。请注意，由于宏扩展，该参数需 要是一个预处理器符号。例如，要把符号 }(hjhhhNhNubhliteral)}(h``usb_stor_suspend``h]husb_stor_suspend}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh 导出到命名空间 }(hjhhhNhNubj)}(h``USB_STORAGE``h]h USB_STORAGE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh， 请使用:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK-hjhhubh literal_block)}(h2EXPORT_SYMBOL_NS(usb_stor_suspend, "USB_STORAGE");h]h2EXPORT_SYMBOL_NS(usb_stor_suspend, "USB_STORAGE");}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhK3hjhhubh)}(hX/相应的 ksymtab 条目结构体 ``kernel_symbol`` 将有相应的成员 ``命名空间`` 集。 导出时未指明命名空间的符号将指向 ``NULL`` 。如果没有定义命名空间，则默认没有。 ``modpost`` 和kernel/module/main.c分别在构建时或模块加载时使用名称空间。h](h"相应的 ksymtab 条目结构体 }(hj*hhhNhNubj)}(h``kernel_symbol``h]h kernel_symbol}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubh 将有相应的成员 }(hj*hhhNhNubj)}(h``命名空间``h]h 命名空间}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubh9 集。 导出时未指明命名空间的符号将指向 }(hj*hhhNhNubj)}(h``NULL``h]hNULL}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubh8 。如果没有定义命名空间，则默认没有。 }(hj*hhhNhNubj)}(h ``modpost``h]hmodpost}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj*ubhQ 和kernel/module/main.c分别在构建时或模块加载时使用名称空间。}(hj*hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK5hjhhubeh}(h] export-symbolah ]h"]2.1 使用export_symbol宏ah$]h&]uh1jRhjThhhhhK+ubjS)}(hhh](jX)}(h(2.2 使用DEFAULT_SYMBOL_NAMESPACE定义h]h(2.2 使用DEFAULT_SYMBOL_NAMESPACE定义}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jWhjhhhhhK:ubh)}(hXG为一个子系统的所有符号定义命名空间可能会非常冗长，并可能变得难以维护。因此，我 们提供了一个默认定义（DEFAULT_SYMBOL_NAMESPACE），如果设置了这个定义， 它将成 为所有没有指定命名空间的 EXPORT_SYMBOL() 和 EXPORT_SYMBOL_GPL() 宏扩展的默认 定义。h]hXG为一个子系统的所有符号定义命名空间可能会非常冗长，并可能变得难以维护。因此，我 们提供了一个默认定义（DEFAULT_SYMBOL_NAMESPACE），如果设置了这个定义， 它将成 为所有没有指定命名空间的 EXPORT_SYMBOL() 和 EXPORT_SYMBOL_GPL() 宏扩展的默认 定义。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK M=$PWD nsdepsh]h,$ make -C M=$PWD nsdeps}hj2sbah}(h]h ]h"]h$]h&]jjuh1jhhhKhjhhubeh}(h]module-import-nsah ]h"]%5. 自动创建module_import_ns声明ah$]h&]uh1jRhjThhhhhKuubeh}(h](symbol-namespacesjQeh ]h"]()符号命名空间（symbol namespaces）cn_symbol-namespaces.rsteh$]h&]uh1jRhhhhhhhK expect_referenced_by_name}jNjFsexpect_referenced_by_id}jQjFsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(jWN 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_handlerjxerror_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}jQ]jFasnameids}(jNjQjMjJjjjjjjjjjjjjjEjBu nametypes}(jNjMjjjjjjjEuh}(jQjTjJjTjjjjjjjjjjjjjBju 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]h>Hyperlink target "cn-symbol-namespaces-rst" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourceh،lineKuh1juba transformerN include_log]?Documentation/translations/zh_CN/core-api/symbol-namespaces.rst(NNNNta decorationNhhub.