O/sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget%/userspace-api/sysfs-platform_profilemodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/zh_TW/userspace-api/sysfs-platform_profilemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/it_IT/userspace-api/sysfs-platform_profilemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/ja_JP/userspace-api/sysfs-platform_profilemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/ko_KR/userspace-api/sysfs-platform_profilemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/sp_SP/userspace-api/sysfs-platform_profilemodnameN 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:spacepreserveuh1hhhhhhe/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/userspace-api/sysfs-platform_profile.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)}(h7Documentation/userspace-api/sysfs-platform_profile.rst h]h)}(h6Documentation/userspace-api/sysfs-platform_profile.rsth]h6Documentation/userspace-api/sysfs-platform_profile.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李睿 Rui Li h]h)}(h李睿 Rui Li h](h李睿 Rui Li <}(hj hhhNhNubh reference)}(h me@lirui.orgh]h me@lirui.org}(hj*hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:me@lirui.orguh1j(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)}(hE平台配置文件选择（如 /sys/firmware/acpi/platform_profile）h]hE平台配置文件选择（如 /sys/firmware/acpi/platform_profile）}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j[hjXhhhhhK ubh)}(h现代系统中平台性能、温度、风扇和其他硬件相关的特性通常是可以动态配置的。平台 配置通常会根据当前的状态由一些自动机制（很可能存在于内核之外）来自动调整。h]h现代系统中平台性能、温度、风扇和其他硬件相关的特性通常是可以动态配置的。平台 配置通常会根据当前的状态由一些自动机制（很可能存在于内核之外）来自动调整。}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjXhhubh)}(h这些平台自动调整机制通常能够被配置成多个平台配置文件中的一个，要么偏向节能运 行，要么偏向性能运行。h]h这些平台自动调整机制通常能够被配置成多个平台配置文件中的一个，要么偏向节能运 行，要么偏向性能运行。}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjXhhubh)}(hzplatform_profile属性的目的是提供一个通用的sysfs API来选择这些平台自动配置 机制的配置文件。h]hzplatform_profile属性的目的是提供一个通用的sysfs API来选择这些平台自动配置 机制的配置文件。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjXhhubh)}(h需要注意的是，这个API只能用作选择平台配置文件，用来监测所产生的性能特征并不 是其目标。监测性能最好使用设备/供应商提供的工具，比如turbostat。h]h需要注意的是，这个API只能用作选择平台配置文件，用来监测所产生的性能特征并不 是其目标。监测性能最好使用设备/供应商提供的工具，比如turbostat。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjXhhubh)}(hX7具体来说，当选择高性能配置文件时，真实能达到的性能可能受制于多种因素，比如： 其他组件的发热，房间温度，笔记本底部的自由空气流动等。让用户空间知道任何阻碍 达到要求性能水平的局部最优条件，显然不是这个API的目标。h]hX7具体来说，当选择高性能配置文件时，真实能达到的性能可能受制于多种因素，比如： 其他组件的发热，房间温度，笔记本底部的自由空气流动等。让用户空间知道任何阻碍 达到要求性能水平的局部最优条件，显然不是这个API的目标。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjXhhubh)}(hX由于数字本身并不能代表一个配置文件会调整的多个变量（功耗，发热等），这个API 使用字符串来描述多种配置文件。为了保证用户空间能够获得一致的体验， sysfs-platform_profile ABI 文档定义了一个固定的配置文件名集合。驱动程序 *必须* 将它们内置的配置文件表示映射到这个固定的集合中。h](hX2由于数字本身并不能代表一个配置文件会调整的多个变量（功耗，发热等），这个API 使用字符串来描述多种配置文件。为了保证用户空间能够获得一致的体验， sysfs-platform_profile ABI 文档定义了一个固定的配置文件名集合。驱动程序 }(hjhhhNhNubhemphasis)}(h*必须*h]h必须}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhI 将它们内置的配置文件表示映射到这个固定的集合中。}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjXhhubh)}(h如果映射时没有很好的匹配，可以添加一个新的配置文件名称。驱动希望引入的新配置 文件名称时必须：h]h如果映射时没有很好的匹配，可以添加一个新的配置文件名称。驱动希望引入的新配置 文件名称时必须：}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK#hjXhhubh block_quote)}(h1. 解释为什么无法使用已有的配置文件名称。 2. 添加一个新的配置文件名称，以及预期行为的清晰描述，保存到 sysfs-platform_profile ABI文档中。h]henumerated_list)}(hhh](h list_item)}(h9解释为什么无法使用已有的配置文件名称。h]h)}(hjh]h9解释为什么无法使用已有的配置文件名称。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK&hjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h{添加一个新的配置文件名称，以及预期行为的清晰描述，保存到 sysfs-platform_profile ABI文档中。h]h)}(h{添加一个新的配置文件名称，以及预期行为的清晰描述，保存到 sysfs-platform_profile ABI文档中。h]h{添加一个新的配置文件名称，以及预期行为的清晰描述，保存到 sysfs-platform_profile ABI文档中。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix.uh1jhjubah}(h]h ]h"]h$]h&]uh1jhhhK&hjXhhubeh}(h]"sys-firmware-acpi-platform-profileah ]h"]E平台配置文件选择（如 /sys/firmware/acpi/platform_profile）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_handlerjYerror_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}nameids}j3j0s nametypes}j3sh}j0jXs footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages] transformerN include_log]IDocumentation/translations/zh_CN/userspace-api/sysfs-platform_profile.rst(NNNNta decorationNhhub.