Reviewed-by: Alex Shi <alexs@xxxxxxxxxx> On Fri, Jul 23, 2021 at 10:45 AM Yanteng Si <siyanteng@xxxxxxxxxxx> wrote: > > Translate Documentation/virt/guest-halt-polling.rst into Chinese. > > Signed-off-by: Yanteng Si <siyanteng@xxxxxxxxxxx> > --- > .../zh_CN/virt/guest-halt-polling.rst | 87 +++++++++++++++++++ > .../translations/zh_CN/virt/index.rst | 2 +- > 2 files changed, 88 insertions(+), 1 deletion(-) > create mode 100644 Documentation/translations/zh_CN/virt/guest-halt-polling.rst > > diff --git a/Documentation/translations/zh_CN/virt/guest-halt-polling.rst b/Documentation/translations/zh_CN/virt/guest-halt-polling.rst > new file mode 100644 > index 000000000000..6d35aeb88ffc > --- /dev/null > +++ b/Documentation/translations/zh_CN/virt/guest-halt-polling.rst > @@ -0,0 +1,87 @@ > +.. include:: ../disclaimer-zh_CN.rst > + > +:Original: Documentation/virt/guest-halt-polling.rst > + > +:翻译: > + > + 司延腾 Yanteng Si <siyanteng@xxxxxxxxxxx> > + > +:校译: > + > + > + > +.. _cn_virt_guest-halt-polling: > + > +======================================== > +客户机停止轮询机制（Guest halt polling） > +======================================== > + > +cpuidle_haltpoll驱动，与haltpoll管理器一起，允许客户机vcpus在停止前轮询 > +一定的时间。 > + > +这为物理机侧的轮询提供了以下好处: > + > + 1) 在执行轮询时，POLL标志被设置，这允许远程vCPU在执行唤醒时避免发送 > + IPI（以及处理IPI的相关成本）。 > + > + 2) 可以避免虚拟机退出的成本。 > + > +客户机侧轮询的缺点是，即使在物理机中的其他可运行任务中也会进行轮询。 > + > +其基本逻辑如下。一个全局值，即guest_halt_poll_ns，是由用户配置的，表示允 > +许轮询的最大时间量。这个值是固定的。 > + > +每个vcpu都有一个可调整的guest_halt_poll_ns（"per-cpu guest_halt_poll_ns"）， > +它由算法响应事件进行调整（解释如下）。 > + > +模块参数 > +======== > + > +haltpoll管理器有5个可调整的模块参数: > + > +1) guest_halt_poll_ns: > + > +轮询停止前执行的最大时间，以纳秒为单位。 > + > +默认值: 200000 > + > +2) guest_halt_poll_shrink: > + > +当唤醒事件发生在全局的guest_halt_poll_ns之后，用于缩减每个CPU的guest_halt_poll_ns > +的划分系数。 > + > +默认值: 2 > + > +3) guest_halt_poll_grow: > + > +当事件发生在per-cpu guest_halt_poll_ns之后但在global guest_halt_poll_ns之前， > +用于增长per-cpu guest_halt_poll_ns的乘法系数。 > + > +默认值: 2 > + > +4) guest_halt_poll_grow_start: > + > +在系统空闲的情况下，每个cpu guest_halt_poll_ns最终达到零。这个值设置了增长时的 > +初始每cpu guest_halt_poll_ns。这个值可以从10000开始增加，以避免在最初的增长阶 > +段出现失误。: > + > +10k, 20k, 40k, ... (例如，假设guest_halt_poll_grow=2). > + > +默认值: 50000 > + > +5) guest_halt_poll_allow_shrink: > + > +允许缩减的Bool参数。设置为N以避免它（一旦达到全局的guest_halt_poll_ns值，每CPU的 > +guest_halt_poll_ns将保持高位）。 > + > +默认值: Y > + > +模块参数可以从Debugfs文件中设置，在:: > + > + /sys/module/haltpoll/parameters/ > + > +进一步说明 > +========== > + > +- 在设置guest_halt_poll_ns参数时应该小心，因为一个大的值有可能使机器上的cpu使用率 > + 达到100%，否则几乎是完全空闲的。 > diff --git a/Documentation/translations/zh_CN/virt/index.rst b/Documentation/translations/zh_CN/virt/index.rst > index 6adda3fba6e0..1c602b8638f5 100644 > --- a/Documentation/translations/zh_CN/virt/index.rst > +++ b/Documentation/translations/zh_CN/virt/index.rst > @@ -21,12 +21,12 @@ Linux虚拟化支持 > :maxdepth: 2 > > paravirt_ops > + guest-halt-polling > > TODOLIST: > > kvm/index > uml/user_mode_linux_howto_v2 > - guest-halt-polling > ne_overview > acrn/index > > -- > 2.27.0 >
