€•]:Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ+/translations/zh_CN/virt/guest-halt-polling”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ+/translations/zh_TW/virt/guest-halt-polling”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ+/translations/it_IT/virt/guest-halt-polling”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ+/translations/ja_JP/virt/guest-halt-polling”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ+/translations/ko_KR/virt/guest-halt-polling”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ+/translations/pt_BR/virt/guest-halt-polling”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ+/translations/sp_SP/virt/guest-halt-polling”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒGuest halt polling”h]”hŒGuest halt polling”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³ŒE/var/lib/git/docbuild/linux/Documentation/virt/guest-halt-polling.rst”h´KubhŒ paragraph”“”)”}”(hŒ†The cpuidle_haltpoll driver, with the haltpoll governor, allows the guest vcpus to poll for a specified amount of time before halting.”h]”hŒ†The cpuidle_haltpoll driver, with the haltpoll governor, allows the guest vcpus to poll for a specified amount of time before halting.”…””}”(hhÍh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒ:This provides the following benefits to host side polling:”h]”hŒ:This provides the following benefits to host side polling:”…””}”(hhÛh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K hh·h²hubhŒ block_quote”“”)”}”(hŒÚ1) The POLL flag is set while polling is performed, which allows a remote vCPU to avoid sending an IPI (and the associated cost of handling the IPI) when performing a wakeup. 2) The VM-exit cost can be avoided. ”h]”hŒenumerated_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒ¬The POLL flag is set while polling is performed, which allows a remote vCPU to avoid sending an IPI (and the associated cost of handling the IPI) when performing a wakeup. ”h]”hÌ)”}”(hŒ«The POLL flag is set while polling is performed, which allows a remote vCPU to avoid sending an IPI (and the associated cost of handling the IPI) when performing a wakeup.”h]”hŒ«The POLL flag is set while polling is performed, which allows a remote vCPU to avoid sending an IPI (and the associated cost of handling the IPI) when performing a wakeup.”…””}”(hhúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K hhöubah}”(h]”h ]”h"]”h$]”h&]”uh1hôhhñubhõ)”}”(hŒ!The VM-exit cost can be avoided. ”h]”hÌ)”}”(hŒ The VM-exit cost can be avoided.”h]”hŒ The VM-exit cost can be avoided.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khjubah}”(h]”h ]”h"]”h$]”h&]”uh1hôhhñubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ)”uh1hïhhëubah}”(h]”h ]”h"]”h$]”h&]”uh1héh³hÊh´K hh·h²hubhÌ)”}”(hŒkThe downside of guest side polling is that polling is performed even with other runnable tasks in the host.”h]”hŒkThe downside of guest side polling is that polling is performed even with other runnable tasks in the host.”…””}”(hj7h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒ©The basic logic as follows: A global value, guest_halt_poll_ns, is configured by the user, indicating the maximum amount of time polling is allowed. This value is fixed.”h]”hŒ©The basic logic as follows: A global value, guest_halt_poll_ns, is configured by the user, indicating the maximum amount of time polling is allowed. This value is fixed.”…””}”(hjEh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hŒšEach vcpu has an adjustable guest_halt_poll_ns ("per-cpu guest_halt_poll_ns"), which is adjusted by the algorithm in response to events (explained below).”h]”hŒžEach vcpu has an adjustable guest_halt_poll_ns (“per-cpu guest_halt_poll_nsâ€), which is adjusted by the algorithm in response to events (explained below).”…””}”(hjSh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒModule Parameters”h]”hŒModule Parameters”…””}”(hjdh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjah²hh³hÊh´KubhÌ)”}”(hŒ6The haltpoll governor has 5 tunable module parameters:”h]”hŒ6The haltpoll governor has 5 tunable module parameters:”…””}”(hjrh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khjah²hubhð)”}”(hhh]”hõ)”}”(hŒguest_halt_poll_ns: ”h]”hÌ)”}”(hŒguest_halt_poll_ns:”h]”hŒguest_halt_poll_ns:”…””}”(hj‡h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K!hjƒubah}”(h]”h ]”h"]”h$]”h&]”uh1hôhj€h²hh³hÊh´Nubah}”(h]”h ]”h"]”h$]”h&]”j,j-j.hj/j0uh1hïhjah²hh³hÊh´K!ubhÌ)”}”(hŒQMaximum amount of time, in nanoseconds, that polling is performed before halting.”h]”hŒQMaximum amount of time, in nanoseconds, that polling is performed before halting.”…””}”(hj¡h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K#hjah²hubhÌ)”}”(hŒDefault: 200000”h]”hŒDefault: 200000”…””}”(hj¯h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K&hjah²hubhð)”}”(hhh]”hõ)”}”(hŒguest_halt_poll_shrink: ”h]”hÌ)”}”(hŒguest_halt_poll_shrink:”h]”hŒguest_halt_poll_shrink:”…””}”(hjÄh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K(hjÀubah}”(h]”h ]”h"]”h$]”h&]”uh1hôhj½h²hh³hÊh´Nubah}”(h]”h ]”h"]”h$]”h&]”j,j-j.hj/j0Œstart”Kuh1hïhjah²hh³hÊh´K(ubhÌ)”}”(hŒwDivision factor used to shrink per-cpu guest_halt_poll_ns when wakeup event occurs after the global guest_halt_poll_ns.”h]”hŒwDivision factor used to shrink per-cpu guest_halt_poll_ns when wakeup event occurs after the global guest_halt_poll_ns.”…””}”(hjßh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K*hjah²hubhÌ)”}”(hŒ Default: 2”h]”hŒ Default: 2”…””}”(hjíh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K-hjah²hubhð)”}”(hhh]”hõ)”}”(hŒguest_halt_poll_grow: ”h]”hÌ)”}”(hŒguest_halt_poll_grow:”h]”hŒguest_halt_poll_grow:”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K/hjþubah}”(h]”h ]”h"]”h$]”h&]”uh1hôhjûh²hh³hÊh´Nubah}”(h]”h ]”h"]”h$]”h&]”j,j-j.hj/j0jÞKuh1hïhjah²hh³hÊh´K/ubhÌ)”}”(hŒ–Multiplication factor used to grow per-cpu guest_halt_poll_ns when event occurs after per-cpu guest_halt_poll_ns but before global guest_halt_poll_ns.”h]”hŒ–Multiplication factor used to grow per-cpu guest_halt_poll_ns when event occurs after per-cpu guest_halt_poll_ns but before global guest_halt_poll_ns.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K1hjah²hubhÌ)”}”(hŒ Default: 2”h]”hŒ Default: 2”…””}”(hj*h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K5hjah²hubhð)”}”(hhh]”hõ)”}”(hŒguest_halt_poll_grow_start: ”h]”hÌ)”}”(hŒguest_halt_poll_grow_start:”h]”hŒguest_halt_poll_grow_start:”…””}”(hj?h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K7hj;ubah}”(h]”h ]”h"]”h$]”h&]”uh1hôhj8h²hh³hÊh´Nubah}”(h]”h ]”h"]”h$]”h&]”j,j-j.hj/j0jÞKuh1hïhjah²hh³hÊh´K7ubhÌ)”}”(hŒéThe per-cpu guest_halt_poll_ns eventually reaches zero in case of an idle system. This value sets the initial per-cpu guest_halt_poll_ns when growing. This can be increased from 10000, to avoid misses during the initial growth stage:”h]”hŒéThe per-cpu guest_halt_poll_ns eventually reaches zero in case of an idle system. This value sets the initial per-cpu guest_halt_poll_ns when growing. This can be increased from 10000, to avoid misses during the initial growth stage:”…””}”(hjYh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K9hjah²hubhÌ)”}”(hŒ<10k, 20k, 40k, ... (example assumes guest_halt_poll_grow=2).”h]”hŒ<10k, 20k, 40k, ... (example assumes guest_halt_poll_grow=2).”…””}”(hjgh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K?hjah²hubhÌ)”}”(hŒDefault: 50000”h]”hŒDefault: 50000”…””}”(hjuh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KAhjah²hubhð)”}”(hhh]”hõ)”}”(hŒguest_halt_poll_allow_shrink: ”h]”hÌ)”}”(hŒguest_halt_poll_allow_shrink:”h]”hŒguest_halt_poll_allow_shrink:”…””}”(hjŠh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KChj†ubah}”(h]”h ]”h"]”h$]”h&]”uh1hôhjƒh²hh³hÊh´Nubah}”(h]”h ]”h"]”h$]”h&]”j,j-j.hj/j0jÞKuh1hïhjah²hh³hÊh´KCubhÌ)”}”(hŒ˜Bool parameter which allows shrinking. Set to N to avoid it (per-cpu guest_halt_poll_ns will remain high once achieves global guest_halt_poll_ns value).”h]”hŒ˜Bool parameter which allows shrinking. Set to N to avoid it (per-cpu guest_halt_poll_ns will remain high once achieves global guest_halt_poll_ns value).”…””}”(hj¤h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KEhjah²hubhÌ)”}”(hŒ Default: Y”h]”hŒ Default: Y”…””}”(hj²h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KIhjah²hubhÌ)”}”(hŒ:The module parameters can be set from the sysfs files in::”h]”hŒ9The module parameters can be set from the sysfs files in:”…””}”(hjÀh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KKhjah²hubhŒ literal_block”“”)”}”(hŒ /sys/module/haltpoll/parameters/”h]”hŒ /sys/module/haltpoll/parameters/”…””}”hjÐsbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1jÎh³hÊh´KMhjah²hubeh}”(h]”Œmodule-parameters”ah ]”h"]”Œmodule parameters”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒ Further Notes”h]”hŒ Further Notes”…””}”(hjëh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjèh²hh³hÊh´KPubhŒ bullet_list”“”)”}”(hhh]”hõ)”}”(hŒÀCare should be taken when setting the guest_halt_poll_ns parameter as a large value has the potential to drive the cpu usage to 100% on a machine which would be almost entirely idle otherwise.”h]”hÌ)”}”(hŒÀCare should be taken when setting the guest_halt_poll_ns parameter as a large value has the potential to drive the cpu usage to 100% on a machine which would be almost entirely idle otherwise.”h]”hŒÀCare should be taken when setting the guest_halt_poll_ns parameter as a large value has the potential to drive the cpu usage to 100% on a machine which would be almost entirely idle otherwise.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KRhjþubah}”(h]”h ]”h"]”h$]”h&]”uh1hôhjûh²hh³hÊh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jùh³hÊh´KRhjèh²hubeh}”(h]”Œ further-notes”ah ]”h"]”Œ further notes”ah$]”h&]”uh1hµhh·h²hh³hÊh´KPubeh}”(h]”Œguest-halt-polling”ah ]”h"]”Œguest halt polling”ah$]”h&]”uh1hµhhh²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”jQŒ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âjaj 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”]”(hŒsystem_message”“”)”}”(hhh]”hÌ)”}”(hŒ:Enumerated list start value not ordinal-1: "2" (ordinal 2)”h]”hŒ>Enumerated list start value not ordinal-1: “2†(ordinal 2)”…””}”(hj¸h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËhjµubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œsource”hÊŒline”Kuh1j³hjah²hh³hÊh´K(ubj´)”}”(hhh]”hÌ)”}”(hŒ:Enumerated list start value not ordinal-1: "3" (ordinal 3)”h]”hŒ>Enumerated list start value not ordinal-1: “3†(ordinal 3)”…””}”(hjÔh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËhjÑubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”jÎŒsource”hÊŒline”Kuh1j³hjah²hh³hÊh´K/ubj´)”}”(hhh]”hÌ)”}”(hŒ:Enumerated list start value not ordinal-1: "4" (ordinal 4)”h]”hŒ>Enumerated list start value not ordinal-1: “4†(ordinal 4)”…””}”(hjïh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËhjìubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”jÎŒsource”hÊŒline”Kuh1j³hjah²hh³hÊh´K7ubj´)”}”(hhh]”hÌ)”}”(hŒ:Enumerated list start value not ordinal-1: "5" (ordinal 5)”h]”hŒ>Enumerated list start value not ordinal-1: “5†(ordinal 5)”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËhjubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”jÎŒsource”hÊŒline”Kuh1j³hjah²hh³hÊh´KCubeŒtransform_messages”]”Œ transformer”NŒ include_log”]”Œ decoration”Nh²hub.