€•Í;      Œ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/arch/arm64/cpu-hotplug”Œ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/arch/arm64/cpu-hotplug”Œ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/arch/arm64/cpu-hotplug”Œ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/arch/arm64/cpu-hotplug”Œ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/arch/arm64/cpu-hotplug”Œ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/arch/arm64/cpu-hotplug”Œ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ŸŒD/var/lib/git/docbuild/linux/Documentation/arch/arm64/cpu-hotplug.rst”h KubhŒtarget”“”)”}”(hŒ.. _cpuhp_index:”h]”h}”(h]”h ]”h"]”h$]”h&]”Œrefid”Œcpuhp-index”uh1h´h KhhhžhhŸh³ubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒCPU Hotplug and ACPI”h]”hŒCPU Hotplug and ACPI”…””}”(hhÉhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhhÄhžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒåCPU hotplug in the arm64 world is commonly used to describe the kernel taking
CPUs online/offline using PSCI. This document is about ACPI firmware allowing
CPUs that were not available during boot to be added to the system later.”h]”hŒåCPU hotplug in the arm64 world is commonly used to describe the kernel taking
CPUs online/offline using PSCI. This document is about ACPI firmware allowing
CPUs that were not available during boot to be added to the system later.”…””}”(hhÙhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KhhÄhžhubhØ)”}”(hŒL``possible`` and ``present`` refer to the state of the CPU as seen by linux.”h]”(hŒliteral”“”)”}”(hŒ``possible``”h]”hŒpossible”…””}”(hhíhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhhçubhŒ and ”…””}”(hhçhžhhŸNh Nubhì)”}”(hŒ``present``”h]”hŒpresent”…””}”(hhÿhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhhçubhŒ0 refer to the state of the CPU as seen by linux.”…””}”(hhçhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KhhÄhžhubhÃ)”}”(hhh]”(hÈ)”}”(hŒ:CPU Hotplug on physical systems - CPUs not present at boot”h]”hŒ:CPU Hotplug on physical systems - CPUs not present at boot”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhj  hžhhŸh³h KubhØ)”}”(hŒâPhysical systems need to mark a CPU that is ``possible`` but not ``present`` as
being ``present``. An example would be a dual socket machine, where the package
in one of the sockets can be replaced while the system is running.”h]”(hŒ,Physical systems need to mark a CPU that is ”…””}”(hj(  hžhhŸNh Nubhì)”}”(hŒ``possible``”h]”hŒpossible”…””}”(hj0  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj(  ubhŒ	 but not ”…””}”(hj(  hžhhŸNh Nubhì)”}”(hŒ``present``”h]”hŒpresent”…””}”(hjB  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj(  ubhŒ
 as
being ”…””}”(hj(  hžhhŸNh Nubhì)”}”(hŒ``present``”h]”hŒpresent”…””}”(hjT  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj(  ubhŒ. An example would be a dual socket machine, where the package
in one of the sockets can be replaced while the system is running.”…””}”(hj(  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h Khj  hžhubhØ)”}”(hŒThis is not supported.”h]”hŒThis is not supported.”…””}”(hjl  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h Khj  hžhubhØ)”}”(hŒèIn the arm64 world CPUs are not a single device but a slice of the system.
There are no systems that support the physical addition (or removal) of CPUs
while the system is running, and ACPI is not able to sufficiently describe
them.”h]”hŒèIn the arm64 world CPUs are not a single device but a slice of the system.
There are no systems that support the physical addition (or removal) of CPUs
while the system is running, and ACPI is not able to sufficiently describe
them.”…””}”(hjz  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h Khj  hžhubhØ)”}”(hŒÊe.g. New CPUs come with new caches, but the platform's cache topology is
described in a static table, the PPTT. How caches are shared between CPUs is
not discoverable, and must be described by firmware.”h]”hŒÌe.g. New CPUs come with new caches, but the platformâ€™s cache topology is
described in a static table, the PPTT. How caches are shared between CPUs is
not discoverable, and must be described by firmware.”…””}”(hjˆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h Khj  hžhubhØ)”}”(hX8  e.g. The GIC redistributor for each CPU must be accessed by the driver during
boot to discover the system wide supported features. ACPI's MADT GICC
structures can describe a redistributor associated with a disabled CPU, but
can't describe whether the redistributor is accessible, only that it is not
'always on'.”h]”hX@  e.g. The GIC redistributor for each CPU must be accessed by the driver during
boot to discover the system wide supported features. ACPIâ€™s MADT GICC
structures can describe a redistributor associated with a disabled CPU, but
canâ€™t describe whether the redistributor is accessible, only that it is not
â€˜always onâ€™.”…””}”(hj–  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K!hj  hžhubhØ)”}”(hŒDarm64's ACPI tables assume that everything described is ``present``.”h]”(hŒ:arm64â€™s ACPI tables assume that everything described is ”…””}”(hj¤  hžhhŸNh Nubhì)”}”(hŒ``present``”h]”hŒpresent”…””}”(hj¬  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj¤  ubhŒ.”…””}”(hj¤  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K'hj  hžhubeh}”(h]”Œ8cpu-hotplug-on-physical-systems-cpus-not-present-at-boot”ah ]”h"]”Œ:cpu hotplug on physical systems - cpus not present at boot”ah$]”h&]”uh1hÂhhÄhžhhŸh³h KubhÃ)”}”(hhh]”(hÈ)”}”(hŒ9CPU Hotplug on virtual systems - CPUs not enabled at boot”h]”hŒ9CPU Hotplug on virtual systems - CPUs not enabled at boot”…””}”(hjÏ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhjÌ  hžhhŸh³h K+ubhØ)”}”(hŒµVirtual systems have the advantage that all the properties the system will
ever have can be described at boot. There are no power-domain considerations
as such devices are emulated.”h]”hŒµVirtual systems have the advantage that all the properties the system will
ever have can be described at boot. There are no power-domain considerations
as such devices are emulated.”…””}”(hjÝ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K-hjÌ  hžhubhØ)”}”(hX„  CPU Hotplug on virtual systems is supported. It is distinct from physical
CPU Hotplug as all resources are described as ``present``, but CPUs may be
marked as disabled by firmware. Only the CPU's online/offline behaviour is
influenced by firmware. An example is where a virtual machine boots with a
single CPU, and additional CPUs are added once a cloud orchestrator deploys
the workload.”h]”(hŒxCPU Hotplug on virtual systems is supported. It is distinct from physical
CPU Hotplug as all resources are described as ”…””}”(hjë  hžhhŸNh Nubhì)”}”(hŒ``present``”h]”hŒpresent”…””}”(hjó  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhjë  ubhX  , but CPUs may be
marked as disabled by firmware. Only the CPUâ€™s online/offline behaviour is
influenced by firmware. An example is where a virtual machine boots with a
single CPU, and additional CPUs are added once a cloud orchestrator deploys
the workload.”…””}”(hjë  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K1hjÌ  hžhubhØ)”}”(hŒFFor a virtual machine, the VMM (e.g. Qemu) plays the part of firmware.”h]”hŒFFor a virtual machine, the VMM (e.g. Qemu) plays the part of firmware.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K8hjÌ  hžhubhØ)”}”(hŒ©Virtual hotplug is implemented as a firmware policy affecting which CPUs can be
brought online. Firmware can enforce its policy via PSCI's return codes. e.g.
``DENIED``.”h]”(hŒ Virtual hotplug is implemented as a firmware policy affecting which CPUs can be
brought online. Firmware can enforce its policy via PSCIâ€™s return codes. e.g.
”…””}”(hj  hžhhŸNh Nubhì)”}”(hŒ
``DENIED``”h]”hŒDENIED”…””}”(hj!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj  ubhŒ.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K:hjÌ  hžhubhØ)”}”(hX  The ACPI tables must describe all the resources of the virtual machine. CPUs
that firmware wishes to disable either from boot (or later) should not be
``enabled`` in the MADT GICC structures, but should have the ``online capable``
bit set, to indicate they can be enabled later. The boot CPU must be marked as
``enabled``.  The 'always on' GICR structure must be used to describe the
redistributors.”h]”(hŒ—The ACPI tables must describe all the resources of the virtual machine. CPUs
that firmware wishes to disable either from boot (or later) should not be
”…””}”(hj9  hžhhŸNh Nubhì)”}”(hŒ``enabled``”h]”hŒenabled”…””}”(hjA  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj9  ubhŒ2 in the MADT GICC structures, but should have the ”…””}”(hj9  hžhhŸNh Nubhì)”}”(hŒ``online capable``”h]”hŒonline capable”…””}”(hjS  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj9  ubhŒP
bit set, to indicate they can be enabled later. The boot CPU must be marked as
”…””}”(hj9  hžhhŸNh Nubhì)”}”(hŒ``enabled``”h]”hŒenabled”…””}”(hje  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj9  ubhŒR.  The â€˜always onâ€™ GICR structure must be used to describe the
redistributors.”…””}”(hj9  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h K>hjÌ  hžhubhØ)”}”(hX&  CPUs described as ``online capable`` but not ``enabled`` can be set to enabled
by the DSDT's Processor object's _STA method. On virtual systems the _STA method
must always report the CPU as ``present``. Changes to the firmware policy can
be notified to the OS via device-check or eject-request.”h]”(hŒCPUs described as ”…””}”(hj}  hžhhŸNh Nubhì)”}”(hŒ``online capable``”h]”hŒonline capable”…””}”(hj…  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj}  ubhŒ	 but not ”…””}”(hj}  hžhhŸNh Nubhì)”}”(hŒ``enabled``”h]”hŒenabled”…””}”(hj—  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj}  ubhŒŠ can be set to enabled
by the DSDTâ€™s Processor objectâ€™s _STA method. On virtual systems the _STA method
must always report the CPU as ”…””}”(hj}  hžhhŸNh Nubhì)”}”(hŒ``present``”h]”hŒpresent”…””}”(hj©  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhj}  ubhŒ]. Changes to the firmware policy can
be notified to the OS via device-check or eject-request.”…””}”(hj}  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KEhjÌ  hžhubhØ)”}”(hX†  CPUs described as ``enabled`` in the static table, should not have their _STA
modified dynamically by firmware. Soft-restart features such as kexec will
re-read the static properties of the system from these static tables, and
may malfunction if these no longer describe the running system. Linux will
re-discover the dynamic properties of the system from the _STA method later
during boot.”h]”(hŒCPUs described as ”…””}”(hjÁ  hžhhŸNh Nubhì)”}”(hŒ``enabled``”h]”hŒenabled”…””}”(hjÉ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hëhjÁ  ubhXi   in the static table, should not have their _STA
modified dynamically by firmware. Soft-restart features such as kexec will
re-read the static properties of the system from these static tables, and
may malfunction if these no longer describe the running system. Linux will
re-discover the dynamic properties of the system from the _STA method later
during boot.”…””}”(hjÁ  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h×hŸh³h KJhjÌ  hžhubeh}”(h]”Œ7cpu-hotplug-on-virtual-systems-cpus-not-enabled-at-boot”ah ]”h"]”Œ9cpu hotplug on virtual systems - cpus not enabled at boot”ah$]”h&]”uh1hÂhhÄhžhhŸh³h K+ubeh}”(h]”(Œcpu-hotplug-and-acpi”hÁeh ]”h"]”(Œcpu hotplug and acpi”Œcpuhp_index”eh$]”h&]”uh1hÂhhhžhhŸh³h KŒexpect_referenced_by_name”}”jï  h¶sŒexpect_referenced_by_id”}”hÁh¶subeh}”(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ï  hÁjî  jë  jÉ  jÆ  jæ  jã  uŒ	nametypes”}”(jï  ˆjî  ‰jÉ  ‰jæ  ‰uh}”(hÁhÄ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”]”hŒsystem_message”“”)”}”(hhh]”hØ)”}”(hhh]”hŒ1Hyperlink target "cpuhp-index" is not referenced.”…””}”hjƒ  sbah}”(h]”h ]”h"]”h$]”h&]”uh1h×hj€  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”h³Œline”Kuh1j~  ubaŒtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.