€•¦9      Œ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”Œ//translations/zh_CN/admin-guide/acpi/cppc_sysfs”Œ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”Œ//translations/zh_TW/admin-guide/acpi/cppc_sysfs”Œ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”Œ//translations/it_IT/admin-guide/acpi/cppc_sysfs”Œ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”Œ//translations/ja_JP/admin-guide/acpi/cppc_sysfs”Œ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”Œ//translations/ko_KR/admin-guide/acpi/cppc_sysfs”Œ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”Œ//translations/sp_SP/admin-guide/acpi/cppc_sysfs”Œ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Œcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒI/var/lib/git/docbuild/linux/Documentation/admin-guide/acpi/cppc_sysfs.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ2Collaborative Processor Performance Control (CPPC)”h]”hŒ2Collaborative Processor Performance Control (CPPC)”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒtarget”“”)”}”(hŒ.. _cppc_sysfs:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œ
cppc-sysfs”uh1hÉh Khh¶hžhhŸh³ubhµ)”}”(hhh]”(hº)”}”(hŒCPPC”h]”hŒCPPC”…””}”(hhÚhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh×hžhhŸh³h K
ubhŒ	paragraph”“”)”}”(hX3  CPPC defined in the ACPI spec describes a mechanism for the OS to manage the
performance of a logical processor on a contiguous and abstract performance
scale. CPPC exposes a set of registers to describe abstract performance scale,
to request performance levels and to measure per-cpu delivered performance.”h]”hX3  CPPC defined in the ACPI spec describes a mechanism for the OS to manage the
performance of a logical processor on a contiguous and abstract performance
scale. CPPC exposes a set of registers to describe abstract performance scale,
to request performance levels and to measure per-cpu delivered performance.”…””}”(hhêhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khh×hžhubhé)”}”(hŒCFor more details on CPPC please refer to the ACPI specification at:”h]”hŒCFor more details on CPPC please refer to the ACPI specification at:”…””}”(hhøhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khh×hžhubhé)”}”(hŒhttp://uefi.org/specifications”h]”hŒ	reference”“”)”}”(hj  h]”hŒhttp://uefi.org/specifications”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j  uh1j
  hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khh×hžhubhé)”}”(hŒ8Some of the CPPC registers are exposed via sysfs under::”h]”hŒ7Some of the CPPC registers are exposed via sysfs under:”…””}”(hj   hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khh×hžhubhŒliteral_block”“”)”}”(hŒ'/sys/devices/system/cpu/cpuX/acpi_cppc/”h]”hŒ'/sys/devices/system/cpu/cpuX/acpi_cppc/”…””}”hj0  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j.  hŸh³h Khh×hžhubhé)”}”(hŒfor each cpu X::”h]”hŒfor each cpu X:”…””}”(hj>  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h Khh×hžhubj/  )”}”(hX^  $ ls -lR  /sys/devices/system/cpu/cpu0/acpi_cppc/
/sys/devices/system/cpu/cpu0/acpi_cppc/:
total 0
-r--r--r-- 1 root root 65536 Mar  5 19:38 feedback_ctrs
-r--r--r-- 1 root root 65536 Mar  5 19:38 highest_perf
-r--r--r-- 1 root root 65536 Mar  5 19:38 lowest_freq
-r--r--r-- 1 root root 65536 Mar  5 19:38 lowest_nonlinear_perf
-r--r--r-- 1 root root 65536 Mar  5 19:38 lowest_perf
-r--r--r-- 1 root root 65536 Mar  5 19:38 nominal_freq
-r--r--r-- 1 root root 65536 Mar  5 19:38 nominal_perf
-r--r--r-- 1 root root 65536 Mar  5 19:38 reference_perf
-r--r--r-- 1 root root 65536 Mar  5 19:38 wraparound_time”h]”hX^  $ ls -lR  /sys/devices/system/cpu/cpu0/acpi_cppc/
/sys/devices/system/cpu/cpu0/acpi_cppc/:
total 0
-r--r--r-- 1 root root 65536 Mar  5 19:38 feedback_ctrs
-r--r--r-- 1 root root 65536 Mar  5 19:38 highest_perf
-r--r--r-- 1 root root 65536 Mar  5 19:38 lowest_freq
-r--r--r-- 1 root root 65536 Mar  5 19:38 lowest_nonlinear_perf
-r--r--r-- 1 root root 65536 Mar  5 19:38 lowest_perf
-r--r--r-- 1 root root 65536 Mar  5 19:38 nominal_freq
-r--r--r-- 1 root root 65536 Mar  5 19:38 nominal_perf
-r--r--r-- 1 root root 65536 Mar  5 19:38 reference_perf
-r--r--r-- 1 root root 65536 Mar  5 19:38 wraparound_time”…””}”hjL  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j.  hŸh³h Khh×hžhubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒFhighest_perf : Highest performance of this processor (abstract scale).”h]”hé)”}”(hjc  h]”hŒFhighest_perf : Highest performance of this processor (abstract scale).”…””}”(hje  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K(hja  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_  hj\  hžhhŸh³h Nubj`  )”}”(hŒPnominal_perf : Highest sustained performance of this processor
(abstract scale).”h]”hé)”}”(hŒPnominal_perf : Highest sustained performance of this processor
(abstract scale).”h]”hŒPnominal_perf : Highest sustained performance of this processor
(abstract scale).”…””}”(hj|  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K)hjx  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_  hj\  hžhhŸh³h Nubj`  )”}”(hŒklowest_nonlinear_perf : Lowest performance of this processor with nonlinear
power savings (abstract scale).”h]”hé)”}”(hŒklowest_nonlinear_perf : Lowest performance of this processor with nonlinear
power savings (abstract scale).”h]”hŒklowest_nonlinear_perf : Lowest performance of this processor with nonlinear
power savings (abstract scale).”…””}”(hj”  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K+hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_  hj\  hžhhŸh³h Nubj`  )”}”(hŒElowest_perf : Lowest performance of this processor (abstract scale).
”h]”hé)”}”(hŒDlowest_perf : Lowest performance of this processor (abstract scale).”h]”hŒDlowest_perf : Lowest performance of this processor (abstract scale).”…””}”(hj¬  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K-hj¨  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_  hj\  hžhhŸh³h Nubj`  )”}”(hŒBlowest_freq : CPU frequency corresponding to lowest_perf (in MHz).”h]”hé)”}”(hjÂ  h]”hŒBlowest_freq : CPU frequency corresponding to lowest_perf (in MHz).”…””}”(hjÄ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K/hjÀ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_  hj\  hžhhŸh³h Nubj`  )”}”(hŒõnominal_freq : CPU frequency corresponding to nominal_perf (in MHz).
The above frequencies should only be used to report processor performance in
frequency instead of abstract scale. These values should not be used for any
functional decisions.
”h]”hé)”}”(hŒônominal_freq : CPU frequency corresponding to nominal_perf (in MHz).
The above frequencies should only be used to report processor performance in
frequency instead of abstract scale. These values should not be used for any
functional decisions.”h]”hŒônominal_freq : CPU frequency corresponding to nominal_perf (in MHz).
The above frequencies should only be used to report processor performance in
frequency instead of abstract scale. These values should not be used for any
functional decisions.”…””}”(hjÛ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K0hj×  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_  hj\  hžhhŸh³h Nubj`  )”}”(hŒæfeedback_ctrs : Includes both Reference and delivered performance counter.
Reference counter ticks up proportional to processor's reference performance.
Delivered counter ticks up proportional to processor's delivered performance.”h]”hé)”}”(hŒæfeedback_ctrs : Includes both Reference and delivered performance counter.
Reference counter ticks up proportional to processor's reference performance.
Delivered counter ticks up proportional to processor's delivered performance.”h]”hŒêfeedback_ctrs : Includes both Reference and delivered performance counter.
Reference counter ticks up proportional to processorâ€™s reference performance.
Delivered counter ticks up proportional to processorâ€™s delivered performance.”…””}”(hjó  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K5hjï  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_  hj\  hžhhŸh³h Nubj`  )”}”(hŒPwraparound_time: Minimum time for the feedback counters to wraparound
(seconds).”h]”hé)”}”(hŒPwraparound_time: Minimum time for the feedback counters to wraparound
(seconds).”h]”hŒPwraparound_time: Minimum time for the feedback counters to wraparound
(seconds).”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K8hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_  hj\  hžhhŸh³h Nubj`  )”}”(hŒireference_perf : Performance level at which reference performance counter
accumulates (abstract scale).

”h]”hé)”}”(hŒgreference_perf : Performance level at which reference performance counter
accumulates (abstract scale).”h]”hŒgreference_perf : Performance level at which reference performance counter
accumulates (abstract scale).”…””}”(hj#  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h K:hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j_  hj\  hžhhŸh³h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ*”uh1jZ  hŸh³h K(hh×hžhubeh}”(h]”(Œcppc”hÖeh ]”h"]”(Œcppc”Œ
cppc_sysfs”eh$]”h&]”uh1h´hh¶hžhhŸh³h K
Œexpect_referenced_by_name”}”jE  hËsŒexpect_referenced_by_id”}”hÖhËsubhµ)”}”(hhh]”(hº)”}”(hŒ'Computing Average Delivered Performance”h]”hŒ'Computing Average Delivered Performance”…””}”(hjO  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjL  hžhhŸh³h K?ubhé)”}”(hŒBelow describes the steps to compute the average performance delivered by
taking two different snapshots of feedback counters at time T1 and T2.”h]”hŒBelow describes the steps to compute the average performance delivered by
taking two different snapshots of feedback counters at time T1 and T2.”…””}”(hj]  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KAhjL  hžhubhŒblock_quote”“”)”}”(hŒaT1: Read feedback_ctrs as fbc_t1
    Wait or run some workload

T2: Read feedback_ctrs as fbc_t2
”h]”(hŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hŒ;T1: Read feedback_ctrs as fbc_t1
Wait or run some workload
”h]”(hŒterm”“”)”}”(hŒ T1: Read feedback_ctrs as fbc_t1”h]”hŒ T1: Read feedback_ctrs as fbc_t1”…””}”(hj~  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j|  hŸh³h KEhjx  ubhŒ
definition”“”)”}”(hhh]”hé)”}”(hŒWait or run some workload”h]”hŒWait or run some workload”…””}”(hj‘  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KEhjŽ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jŒ  hjx  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jv  hŸh³h KEhjs  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jq  hjm  ubhé)”}”(hŒ T2: Read feedback_ctrs as fbc_t2”h]”hŒ T2: Read feedback_ctrs as fbc_t2”…””}”(hj±  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hèhŸh³h KGhjm  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jk  hŸh³h KDhjL  hžhubj/  )”}”(hŒ¾delivered_counter_delta = fbc_t2[del] - fbc_t1[del]
reference_counter_delta = fbc_t2[ref] - fbc_t1[ref]

delivered_perf = (reference_perf x delivered_counter_delta) / reference_counter_delta”h]”hŒ¾delivered_counter_delta = fbc_t2[del] - fbc_t1[del]
reference_counter_delta = fbc_t2[ref] - fbc_t1[ref]

delivered_perf = (reference_perf x delivered_counter_delta) / reference_counter_delta”…””}”hjÅ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j.  hŸh³h KKhjL  hžhubeh}”(h]”Œ'computing-average-delivered-performance”ah ]”h"]”Œ'computing average delivered performance”ah$]”h&]”uh1h´hh¶hžhhŸh³h K?ubeh}”(h]”Œ0collaborative-processor-performance-control-cppc”ah ]”h"]”Œ2collaborative processor performance control (cppc)”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(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”}”hÖ]”hËasŒnameids”}”(jà  jÝ  jE  hÖjD  jA  jØ  jÕ  uŒ	nametypes”}”(jà  ‰jE  ˆjD  ‰jØ  ‰uh}”(jÝ  h¶hÖh×jA  h×jÕ  jL  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”]”hŒsystem_message”“”)”}”(hhh]”hé)”}”(hhh]”hŒ0Hyperlink target "cppc-sysfs" is not referenced.”…””}”hjp  sbah}”(h]”h ]”h"]”h$]”h&]”uh1hèhjm  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1jk  ubaŒtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.