€•æ=      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ8/translations/zh_CN/userspace-api/sysfs-platform_profile”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ8/translations/zh_TW/userspace-api/sysfs-platform_profile”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ8/translations/it_IT/userspace-api/sysfs-platform_profile”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ8/translations/ja_JP/userspace-api/sysfs-platform_profile”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ8/translations/ko_KR/userspace-api/sysfs-platform_profile”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ8/translations/pt_BR/userspace-api/sysfs-platform_profile”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ8/translations/sp_SP/userspace-api/sysfs-platform_profile”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒEPlatform Profile Selection (e.g. /sys/firmware/acpi/platform_profile)”h]”hŒEPlatform Profile Selection (e.g. /sys/firmware/acpi/platform_profile)”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³ŒR/var/lib/git/docbuild/linux/Documentation/userspace-api/sysfs-platform_profile.rst”h´KubhŒ	paragraph”“”)”}”(hX+  On modern systems the platform performance, temperature, fan and other
hardware related characteristics are often dynamically configurable. The
platform configuration is often automatically adjusted to the current
conditions by some automatic mechanism (which may very well live outside
the kernel).”h]”hX+  On modern systems the platform performance, temperature, fan and other
hardware related characteristics are often dynamically configurable. The
platform configuration is often automatically adjusted to the current
conditions by some automatic mechanism (which may very well live outside
the kernel).”…””}”(hhÍh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒ¯These auto platform adjustment mechanisms often can be configured with
one of several platform profiles, with either a bias towards low power
operation or towards performance.”h]”hŒ¯These auto platform adjustment mechanisms often can be configured with
one of several platform profiles, with either a bias towards low power
operation or towards performance.”…””}”(hhÛh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒThe purpose of the platform_profile attribute is to offer a generic sysfs
API for selecting the platform profile of these automatic mechanisms.”h]”hŒThe purpose of the platform_profile attribute is to offer a generic sysfs
API for selecting the platform profile of these automatic mechanisms.”…””}”(hhéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒñNote that this API is only for selecting the platform profile, it is
NOT a goal of this API to allow monitoring the resulting performance
characteristics. Monitoring performance is best done with device/vendor
specific tools, e.g. turbostat.”h]”hŒñNote that this API is only for selecting the platform profile, it is
NOT a goal of this API to allow monitoring the resulting performance
characteristics. Monitoring performance is best done with device/vendor
specific tools, e.g. turbostat.”…””}”(hh÷h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hX†  Specifically, when selecting a high performance profile the actual achieved
performance may be limited by various factors such as: the heat generated
by other components, room temperature, free air flow at the bottom of a
laptop, etc. It is explicitly NOT a goal of this API to let userspace know
about any sub-optimal conditions which are impeding reaching the requested
performance level.”h]”hX†  Specifically, when selecting a high performance profile the actual achieved
performance may be limited by various factors such as: the heat generated
by other components, room temperature, free air flow at the bottom of a
laptop, etc. It is explicitly NOT a goal of this API to let userspace know
about any sub-optimal conditions which are impeding reaching the requested
performance level.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hX”  Since numbers on their own cannot represent the multiple variables that a
profile will adjust (power consumption, heat generation, etc) this API
uses strings to describe the various profiles. To make sure that userspace
gets a consistent experience the sysfs-platform_profile ABI document defines
a fixed set of profile names. Drivers *must* map their internal profile
representation onto this fixed set.”h]”(hXO  Since numbers on their own cannot represent the multiple variables that a
profile will adjust (power consumption, heat generation, etc) this API
uses strings to describe the various profiles. To make sure that userspace
gets a consistent experience the sysfs-platform_profile ABI document defines
a fixed set of profile names. Drivers ”…””}”(hj  h²hh³Nh´NubhŒemphasis”“”)”}”(hŒ*must*”h]”hŒmust”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubhŒ? map their internal profile
representation onto this fixed set.”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒ„If there is no good match when mapping then a new profile name may be
added. Drivers which wish to introduce new profile names must:”h]”hŒ„If there is no good match when mapping then a new profile name may be
added. Drivers which wish to introduce new profile names must:”…””}”(hj5  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K%hh·h²hubhŒblock_quote”“”)”}”(hŒÅ1. Explain why the existing profile names cannot be used.
2. Add the new profile name, along with a clear description of the
   expected behaviour, to the sysfs-platform_profile ABI documentation.
”h]”hŒenumerated_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ6Explain why the existing profile names cannot be used.”h]”hÌ)”}”(hjR  h]”hŒ6Explain why the existing profile names cannot be used.”…””}”(hjT  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K(hjP  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jN  hjK  ubjO  )”}”(hŒ…Add the new profile name, along with a clear description of the
expected behaviour, to the sysfs-platform_profile ABI documentation.
”h]”hÌ)”}”(hŒ„Add the new profile name, along with a clear description of the
expected behaviour, to the sysfs-platform_profile ABI documentation.”h]”hŒ„Add the new profile name, along with a clear description of the
expected behaviour, to the sysfs-platform_profile ABI documentation.”…””}”(hjk  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K)hjg  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jN  hjK  ubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1jI  hjE  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jC  h³hÊh´K(hh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒ"Custom" profile support”h]”hŒâ€œCustomâ€ profile support”…””}”(hj“  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj  h²hh³hÊh´K-ubhÌ)”}”(hŒðThe platform_profile class also supports profiles advertising a "custom"
profile. This is intended to be set by drivers when the settings in the
driver have been modified in a way that a standard profile doesn't represent
the current state.”h]”hŒöThe platform_profile class also supports profiles advertising a â€œcustomâ€
profile. This is intended to be set by drivers when the settings in the
driver have been modified in a way that a standard profile doesnâ€™t represent
the current state.”…””}”(hj¡  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K.hj  h²hubeh}”(h]”Œcustom-profile-support”ah ]”h"]”Œ"custom" profile support”ah$]”h&]”uh1hµhh·h²hh³hÊh´K-ubh¶)”}”(hhh]”(h»)”}”(hŒMultiple driver support”h]”hŒMultiple driver support”…””}”(hjº  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj·  h²hh³hÊh´K4ubhÌ)”}”(hŒØWhen multiple drivers on a system advertise a platform profile handler, the
platform profile handler core will only advertise the profiles that are
common between all drivers to the ``/sys/firmware/acpi`` interfaces.”h]”(hŒ¶When multiple drivers on a system advertise a platform profile handler, the
platform profile handler core will only advertise the profiles that are
common between all drivers to the ”…””}”(hjÈ  h²hh³Nh´NubhŒliteral”“”)”}”(hŒ``/sys/firmware/acpi``”h]”hŒ/sys/firmware/acpi”…””}”(hjÒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÐ  hjÈ  ubhŒ interfaces.”…””}”(hjÈ  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K5hj·  h²hubhÌ)”}”(hŒqThis is to ensure there is no ambiguity on what the profile names mean when
all handlers don't support a profile.”h]”hŒsThis is to ensure there is no ambiguity on what the profile names mean when
all handlers donâ€™t support a profile.”…””}”(hjê  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K9hj·  h²hubhÌ)”}”(hŒ—Individual drivers will register a 'platform_profile' class device that has
similar semantics as the ``/sys/firmware/acpi/platform_profile`` interface.”h]”(hŒiIndividual drivers will register a â€˜platform_profileâ€™ class device that has
similar semantics as the ”…””}”(hjø  h²hh³Nh´NubjÑ  )”}”(hŒ'``/sys/firmware/acpi/platform_profile``”h]”hŒ#/sys/firmware/acpi/platform_profile”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÐ  hjø  ubhŒ interface.”…””}”(hjø  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K<hj·  h²hubhÌ)”}”(hŒ„To discover which driver is associated with a platform profile handler the
user can read the ``name`` attribute of the class device.”h]”(hŒ]To discover which driver is associated with a platform profile handler the
user can read the ”…””}”(hj  h²hh³Nh´NubjÑ  )”}”(hŒ``name``”h]”hŒname”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÐ  hj  ubhŒ attribute of the class device.”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K?hj·  h²hubhÌ)”}”(hŒdTo discover available profiles from the class interface the user can read the
``choices`` attribute.”h]”(hŒNTo discover available profiles from the class interface the user can read the
”…””}”(hj8  h²hh³Nh´NubjÑ  )”}”(hŒ``choices``”h]”hŒchoices”…””}”(hj@  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÐ  hj8  ubhŒ attribute.”…””}”(hj8  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KBhj·  h²hubhÌ)”}”(hŒIf a user wants to select a profile for a specific driver, they can do so
by writing to the ``profile`` attribute of the driver's class device.”h]”(hŒ\If a user wants to select a profile for a specific driver, they can do so
by writing to the ”…””}”(hjX  h²hh³Nh´NubjÑ  )”}”(hŒ``profile``”h]”hŒprofile”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÐ  hjX  ubhŒ* attribute of the driverâ€™s class device.”…””}”(hjX  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KEhj·  h²hubhÌ)”}”(hX  This will allow users to set different profiles for different drivers on the
same system. If the selected profile by individual drivers differs the
platform profile handler core will display the profile 'custom' to indicate
that the profiles are not the same.”h]”hX  This will allow users to set different profiles for different drivers on the
same system. If the selected profile by individual drivers differs the
platform profile handler core will display the profile â€˜customâ€™ to indicate
that the profiles are not the same.”…””}”(hjx  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KHhj·  h²hubhÌ)”}”(hŒêWhile the ``platform_profile`` attribute has the value ``custom``, writing a
common profile from ``platform_profile_choices`` to the platform_profile
attribute of the platform profile handler core will set the profile for all
drivers.”h]”(hŒ
While the ”…””}”(hj†  h²hh³Nh´NubjÑ  )”}”(hŒ``platform_profile``”h]”hŒplatform_profile”…””}”(hjŽ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÐ  hj†  ubhŒ attribute has the value ”…””}”(hj†  h²hh³Nh´NubjÑ  )”}”(hŒ
``custom``”h]”hŒcustom”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÐ  hj†  ubhŒ , writing a
common profile from ”…””}”(hj†  h²hh³Nh´NubjÑ  )”}”(hŒ``platform_profile_choices``”h]”hŒplatform_profile_choices”…””}”(hj²  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÐ  hj†  ubhŒm to the platform_profile
attribute of the platform profile handler core will set the profile for all
drivers.”…””}”(hj†  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KMhj·  h²hubeh}”(h]”Œmultiple-driver-support”ah ]”h"]”Œmultiple driver support”ah$]”h&]”uh1hµhh·h²hh³hÊh´K4ubeh}”(h]”ŒAplatform-profile-selection-e-g-sys-firmware-acpi-platform-profile”ah ]”h"]”ŒEplatform profile selection (e.g. /sys/firmware/acpi/platform_profile)”ah$]”h&]”uh1hµhhh²hh³hÊh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÊuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hºNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jý  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÊŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j×  jÔ  j´  j±  jÏ  jÌ  uŒ	nametypes”}”(j×  ‰j´  ‰jÏ  ‰uh}”(jÔ  h·j±  j  jÌ  j·  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.