Merge branches 'pm-cpufreq', 'pm-sleep' and 'pm-em'
[linux-2.6-microblaze.git] / Documentation / translations / zh_CN / virt / guest-halt-polling.rst
1 .. include:: ../disclaimer-zh_CN.rst
2
3 :Original: Documentation/virt/guest-halt-polling.rst
4
5 :翻译:
6
7  司延腾 Yanteng Si <siyanteng@loongson.cn>
8
9 :校译:
10
11  时奎亮 Alex Shi <alexs@kernel.org>
12
13 .. _cn_virt_guest-halt-polling:
14
15 ========================================
16 客户机停机轮询机制(Guest halt polling)
17 ========================================
18
19 cpuidle_haltpoll驱动,与haltpoll管理器一起,允许客户机vcpus在停机前轮询
20 一定的时间。
21
22 这为物理机侧的轮询提供了以下好处:
23
24         1) 在执行轮询时,POLL标志被设置,这允许远程vCPU在执行唤醒时避免发送
25            IPI(以及处理IPI的相关成本)。
26
27         2) 可以避免虚拟机退出的成本。
28
29 客户机侧轮询的缺点是,即使在物理机中的其他可运行任务中也会进行轮询。
30
31 其基本逻辑如下。一个全局值,即guest_halt_poll_ns,是由用户配置的,表示允
32 许轮询的最大时间量。这个值是固定的。
33
34 每个vcpu都有一个可调整的guest_halt_poll_ns("per-cpu guest_halt_poll_ns"),
35 它由算法响应事件进行调整(解释如下)。
36
37 模块参数
38 ========
39
40 haltpoll管理器有5个可调整的模块参数:
41
42 1) guest_halt_poll_ns:
43
44 轮询停机前执行的最大时间,以纳秒为单位。
45
46 默认值: 200000
47
48 2) guest_halt_poll_shrink:
49
50 当唤醒事件发生在全局的guest_halt_poll_ns之后,用于缩减每个CPU的guest_halt_poll_ns
51 的划分系数。
52
53 默认值: 2
54
55 3) guest_halt_poll_grow:
56
57 当事件发生在per-cpu guest_halt_poll_ns之后但在global guest_halt_poll_ns之前,
58 用于增长per-cpu guest_halt_poll_ns的乘法系数。
59
60 默认值: 2
61
62 4) guest_halt_poll_grow_start:
63
64 在系统空闲的情况下,每个cpu guest_halt_poll_ns最终达到零。这个值设置了增长时的
65 初始每cpu guest_halt_poll_ns。这个值可以从10000开始增加,以避免在最初的增长阶
66 段出现失误。:
67
68 10k, 20k, 40k, ... (例如,假设guest_halt_poll_grow=2).
69
70 默认值: 50000
71
72 5) guest_halt_poll_allow_shrink:
73
74 允许缩减的Bool参数。设置为N以避免它(一旦达到全局的guest_halt_poll_ns值,每CPU的
75 guest_halt_poll_ns将保持高位)。
76
77 默认值: Y
78
79 模块参数可以从Debugfs文件中设置,在::
80
81         /sys/module/haltpoll/parameters/
82
83 进一步说明
84 ==========
85
86 - 在设置guest_halt_poll_ns参数时应该小心,因为一个大的值有可能使几乎是完全空闲机
87   器上的cpu使用率达到100%。