Skip to contentSkip to conversation

docs/zh_CN: add some virt docs translation

PATCH Superseded Yanteng Si 3 participants 18 messages Aug 1, 2021 – Aug 4, 2021

Subsystems (2)

v3 of 4 Superseded Latest is v4 →

lore
Share & tools
lore

Yanteng Si

author
#0 lore raw

v3 cover docs/zh_CN: add some virt docs translation

v3:

* Modified some words under Alex's advices;
* add 校译者(proofreading) sign.If you don't want me to do this, please let me know
* pick Alex's Review-by tag for [patch 1-4/8]

v2:

patch 2/8:

* Modified some words under Feiyang's advices;
* add 校译者(proofreading) sign.If you don't want me to do this, please let me know.

Yanteng Si (8):
docs/zh_CN: add virt index translation docs/zh_CN: add virt paravirt_ops translation docs/zh_CN: add virt guest-halt-polling translation docs/zh_CN: add virt ne_overview translation docs/zh_CN: add virt acrn index translation docs/zh_CN: add virt acrn introduction translation docs/zh_CN: add virt acrn io-request translation docs/zh_CN: add virt acrn cpuid translation

 Documentation/translations/zh_CN/index.rst    |  2 +-
 .../translations/zh_CN/virt/acrn/cpuid.rst    | 56 +++++++++++
 .../translations/zh_CN/virt/acrn/index.rst    | 25 +++++
 .../zh_CN/virt/acrn/introduction.rst          | 52 ++++++++++
 .../zh_CN/virt/acrn/io-request.rst            | 99 +++++++++++++++++++
 .../zh_CN/virt/guest-halt-polling.rst         | 87 ++++++++++++++++
 .../translations/zh_CN/virt/index.rst         | 38 +++++++
 .../translations/zh_CN/virt/ne_overview.rst   | 88 +++++++++++++++++
 .../translations/zh_CN/virt/paravirt_ops.rst  | 41 ++++++++
 9 files changed, 487 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/cpuid.rst
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/index.rst
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/introduction.rst
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/io-request.rst
 create mode 100644 Documentation/translations/zh_CN/virt/guest-halt-polling.rst
 create mode 100644 Documentation/translations/zh_CN/virt/index.rst
 create mode 100644 Documentation/translations/zh_CN/virt/ne_overview.rst
 create mode 100644 Documentation/translations/zh_CN/virt/paravirt_ops.rst
Signature · 1 line
2.27.0
author
#1 lore raw

PATCH v3 1/8 docs/zh_CN: add virt index translation

Add virt to .../zh_CN/index and translate it into Chinese.

---
 Documentation/translations/zh_CN/index.rst    |  2 +-
 .../translations/zh_CN/virt/index.rst         | 37 +++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/index.rst
Documentation/translations/zh_CN/index.rst +1 -1
index e0d51a167032..c311c8741e6f 100644
@@ -102,6 +102,7 @@ TODOList:
    iio/index
    sound/index
    filesystems/index
+   virt/index
 
 TODOList:
 
@@ -127,7 +128,6 @@ TODOList:
 * spi/index
 * w1/index
 * watchdog/index
-* virt/index
 * input/index
 * hwmon/index
 * gpu/index
Documentation/translations/zh_CN/virt/index.rst new file +37 -0
new file mode 100644
index 000000000000..9e5df5b5de15
@@ -0,0 +1,37 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/index.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_index:
+
+===============
+Linux虚拟化支持
+===============
+
+.. toctree::
+   :maxdepth: 2
+
+TODOLIST:
+
+   kvm/index
+   uml/user_mode_linux_howto_v2
+   paravirt_ops
+   guest-halt-polling
+   ne_overview
+   acrn/index
+
+.. only:: html and subproject
+
+   Indices
+   =======
+
+   * :ref:`genindex`
Signature · 1 line
2.27.0
author
#2 lore raw

PATCH v3 2/8 docs/zh_CN: add virt paravirt_ops translation

In reply to Yanteng Si

Translate Documentation/virt/paravirt_ops.rst into Chinese.

---
 .../translations/zh_CN/virt/index.rst         |  3 +-
 .../translations/zh_CN/virt/paravirt_ops.rst  | 41 +++++++++++++++++++
 2 files changed, 43 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/paravirt_ops.rst
Documentation/translations/zh_CN/virt/index.rst +2 -1
index 9e5df5b5de15..b9b23bb88ffa 100644
@@ -20,11 +20,12 @@ Linux虚拟化支持
 .. toctree::
    :maxdepth: 2
 
+   paravirt_ops
+
 TODOLIST:
 
    kvm/index
    uml/user_mode_linux_howto_v2
-   paravirt_ops
    guest-halt-polling
    ne_overview
    acrn/index
Documentation/translations/zh_CN/virt/paravirt_ops.rst new file +41 -0

41 lines not on this page · raw message

Signature · 1 line
2.27.0
#3 lore raw

Re: [PATCH v3 2/8] docs/zh_CN: add virt paravirt_ops translation

Quoted 43 lines · Yanteng Si

Translate Documentation/virt/paravirt_ops.rst into Chinese.

---
 .../translations/zh_CN/virt/index.rst         |  3 +-
 .../translations/zh_CN/virt/paravirt_ops.rst  | 41 +++++++++++++++++++
 2 files changed, 43 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/paravirt_ops.rst
Documentation/translations/zh_CN/virt/index.rst +2 -1
index 9e5df5b5de15..b9b23bb88ffa 100644
@@ -20,11 +20,12 @@ Linux虚拟化支持
 .. toctree::
    :maxdepth: 2
 
+   paravirt_ops
+
 TODOLIST:
 
    kvm/index
    uml/user_mode_linux_howto_v2
-   paravirt_ops
    guest-halt-polling
    ne_overview
    acrn/index
Documentation/translations/zh_CN/virt/paravirt_ops.rst new file +8 -0
new file mode 100644
index 000000000000..e9e0708a1d63
@@ -0,0 +1,41 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/paravirt_ops.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>

Documentation/translations/zh_CN/virt/paravirt_ops.rst line 18

Quoted 10 lines
Documentation/translations/zh_CN/virt/paravirt_ops.rst new file +10 -0
+
+:校译:
+
+ 陈飞杨 Feiyang Chen <[email protected]>
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_paravirt_ops:
+
+============
+Paravirt_ops

this title could be translated as 半虚拟化操作?

Quoted 12 lines
Documentation/translations/zh_CN/virt/paravirt_ops.rst new file +12 -0
+============
+
+Linux提供了对不同管理程序虚拟化技术的支持。历史上,为了支持不同的虚拟机超级管理器
+(hypervisor,下文简称超级管理器),需要不同的二进制内核,这个限制已经被pv_ops移
+除了。Linux pv_ops是一个虚拟化API,它能够支持不同的管理程序。它允许每个管理程序
+优先于关键操作,并允许单一的内核二进制文件在所有支持的执行环境中运行,包括本机——没
+有任何管理程序。
+
+pv_ops提供了一组函数指针,代表了与低级关键指令和各领域高级功能相对应的操作。
+pv-ops允许在运行时进行优化,在启动时对低级关键操作进行二进制修补。
+
+pv_ops操作被分为三类:

Documentation/translations/zh_CN/virt/paravirt_ops.rst line 40

Quoted 10 lines
Documentation/translations/zh_CN/virt/paravirt_ops.rst new file +10 -0
+
+- 简单的间接调用
+   这些操作对应于高水平的函数,众所周知,间接调用的开销并不十分重要。
+
+- 间接调用,允许用二进制补丁进行优化
+   通常情况下,这些操作对应于低级别的关键指令。它们被频繁地调用,并且是对性能关
+   键。开销是非常重要的。
+
+- 一套用于手写汇编代码的宏程序
+   手写的汇编代码(.S文件)也需要准虚拟化,因为它们包括敏感指令或其中的一些代

paravirt usually is tranlated as 半虚拟化,

others looks good for me.

Thanks
Alex

Quoted 4 lines
Documentation/translations/zh_CN/virt/paravirt_ops.rst new file +1 -1
+   码路径对性能非常关键。
--

2.27.0

#4 lore raw

Re: [PATCH v3 2/8] docs/zh_CN: add virt paravirt_ops translation

Quoted 49 lines · Alex Shi <[email protected]> 于2021年8月4日周三 上午10:40写道:
Quoted 47 lines · Yanteng Si

Translate Documentation/virt/paravirt_ops.rst into Chinese.

---
 .../translations/zh_CN/virt/index.rst         |  3 +-
 .../translations/zh_CN/virt/paravirt_ops.rst  | 41 +++++++++++++++++++
 2 files changed, 43 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/paravirt_ops.rst
Documentation/translations/zh_CN/virt/index.rst +2 -1
index 9e5df5b5de15..b9b23bb88ffa 100644
@@ -20,11 +20,12 @@ Linux虚拟化支持
 .. toctree::
    :maxdepth: 2
 
+   paravirt_ops
+
 TODOLIST:
 
    kvm/index
    uml/user_mode_linux_howto_v2
-   paravirt_ops
    guest-halt-polling
    ne_overview
    acrn/index
Documentation/translations/zh_CN/virt/paravirt_ops.rst new file +12 -0
new file mode 100644
index 000000000000..e9e0708a1d63
@@ -0,0 +1,41 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/paravirt_ops.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 陈飞杨 Feiyang Chen <[email protected]>
Quoted 8 lines

Documentation/translations/zh_CN/virt/paravirt_ops.rst line 18

Quoted 6 lines
Documentation/translations/zh_CN/virt/paravirt_ops.rst new file +6 -0
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_paravirt_ops:
+
+============
+Paravirt_ops

this title could be translated as 半虚拟化操作?

OK!

Quoted 17 lines
Quoted 17 lines
Documentation/translations/zh_CN/virt/paravirt_ops.rst new file +16 -0
+============
+
+Linux提供了对不同管理程序虚拟化技术的支持。历史上,为了支持不同的虚拟机超级管理器
+(hypervisor,下文简称超级管理器),需要不同的二进制内核,这个限制已经被pv_ops移
+除了。Linux pv_ops是一个虚拟化API,它能够支持不同的管理程序。它允许每个管理程序
+优先于关键操作,并允许单一的内核二进制文件在所有支持的执行环境中运行,包括本机——没
+有任何管理程序。
+
+pv_ops提供了一组函数指针,代表了与低级关键指令和各领域高级功能相对应的操作。
+pv-ops允许在运行时进行优化,在启动时对低级关键操作进行二进制修补。
+
+pv_ops操作被分为三类:
+
+- 简单的间接调用
+   这些操作对应于高水平的函数,众所周知,间接调用的开销并不十分重要。
+
Quoted 8 lines

Documentation/translations/zh_CN/virt/paravirt_ops.rst line 40

Quoted 6 lines
Documentation/translations/zh_CN/virt/paravirt_ops.rst new file +6 -0
+- 间接调用,允许用二进制补丁进行优化
+   通常情况下,这些操作对应于低级别的关键指令。它们被频繁地调用,并且是对性能关
+   键。开销是非常重要的。
+
+- 一套用于手写汇编代码的宏程序
+   手写的汇编代码(.S文件)也需要准虚拟化,因为它们包括敏感指令或其中的一些代

paravirt usually is tranlated as 半虚拟化,

OK!

Quoted 3 lines

others looks good for me.

Thanks,

Yanteng

author
#5 lore raw

PATCH v3 3/8 docs/zh_CN: add virt guest-halt-polling translation

In reply to Yanteng Si

Translate Documentation/virt/guest-halt-polling.rst into Chinese.

---
 .../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
Documentation/translations/zh_CN/virt/guest-halt-polling.rst new file +87 -0
new file mode 100644
index 000000000000..f12712c506c3
@@ -0,0 +1,87 @@
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/guest-halt-polling.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _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%,否则几乎是完全空闲的。
Documentation/translations/zh_CN/virt/index.rst +1 -1
index b9b23bb88ffa..b94f6a3c2257 100644
@@ -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
 
Signature · 1 line
2.27.0
#6 lore raw

Re: [PATCH v3 3/8] docs/zh_CN: add virt guest-halt-polling translation

Quoted 23 lines · Yanteng Si

Translate Documentation/virt/guest-halt-polling.rst into Chinese.

---
 .../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
Documentation/translations/zh_CN/virt/guest-halt-polling.rst new file +6 -0
new file mode 100644
index 000000000000..f12712c506c3
@@ -0,0 +1,87 @@
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/guest-halt-polling.rst
+
+:翻译:
+

Documentation/translations/zh_CN/virt/guest-halt-polling.rst line 16

Quoted 10 lines
Documentation/translations/zh_CN/virt/guest-halt-polling.rst new file +10 -0
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_guest-halt-polling:
+
+========================================
+客户机停止轮询机制(Guest halt polling)

I still feel the halt is better to be tranlated as 停机, is this right?

Quoted 61 lines
Documentation/translations/zh_CN/virt/guest-halt-polling.rst new file +61 -0
+========================================
+
+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

Documentation/translations/zh_CN/virt/guest-halt-polling.rst line 87

Quoted 10 lines
Documentation/translations/zh_CN/virt/guest-halt-polling.rst new file +10 -0
+
+模块参数可以从Debugfs文件中设置,在::
+
+       /sys/module/haltpoll/parameters/
+
+进一步说明
+==========
+
+- 在设置guest_halt_poll_ns参数时应该小心,因为一个大的值有可能使机器上的cpu使用率
+  达到100%,否则几乎是完全空闲的。

is the following better?
因为一个大的值有可能使几乎是完全空闲机器上的cpu使用率达到100%

Thanks
Alex

Quoted 21 lines
Documentation/translations/zh_CN/virt/index.rst +1 -2
index b9b23bb88ffa..b94f6a3c2257 100644
@@ -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

#7 lore raw

Re: [PATCH v3 3/8] docs/zh_CN: add virt guest-halt-polling translation

Quoted 29 lines · Alex Shi <[email protected]> 于2021年8月4日周三 上午10:59写道:
Quoted 27 lines · Yanteng Si

Translate Documentation/virt/guest-halt-polling.rst into Chinese.

---
 .../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
Documentation/translations/zh_CN/virt/guest-halt-polling.rst new file +10 -0
new file mode 100644
index 000000000000..f12712c506c3
@@ -0,0 +1,87 @@
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/guest-halt-polling.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
Quoted 8 lines

Documentation/translations/zh_CN/virt/guest-halt-polling.rst line 16

Quoted 6 lines
Documentation/translations/zh_CN/virt/guest-halt-polling.rst new file +6 -0
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_guest-halt-polling:
+
+========================================
+客户机停止轮询机制(Guest halt polling)

I still feel the halt is better to be tranlated as 停机, is this right?

yeah!

Quoted 67 lines
Quoted 67 lines
Documentation/translations/zh_CN/virt/guest-halt-polling.rst new file +66 -0
+========================================
+
+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/
+
Quoted 8 lines

Documentation/translations/zh_CN/virt/guest-halt-polling.rst line 87

Quoted 5 lines
Documentation/translations/zh_CN/virt/guest-halt-polling.rst new file +5 -0
+进一步说明
+==========
+
+- 在设置guest_halt_poll_ns参数时应该小心,因为一个大的值有可能使机器上的cpu使用率
+  达到100%,否则几乎是完全空闲的。

is the following better?
因为一个大的值有可能使几乎是完全空闲机器上的cpu使用率达到100%

great!

Thanks,

Yanteng

author
#8 lore raw

PATCH v3 4/8 docs/zh_CN: add virt ne_overview translation

In reply to Yanteng Si

Translate Documentation/virt/ne_overview.rst into Chinese.

---
 .../translations/zh_CN/virt/index.rst         |  2 +-
 .../translations/zh_CN/virt/ne_overview.rst   | 88 +++++++++++++++++++
 2 files changed, 89 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/ne_overview.rst
Documentation/translations/zh_CN/virt/index.rst +1 -1
index b94f6a3c2257..8e7713163962 100644
@@ -22,12 +22,12 @@ Linux虚拟化支持
 
    paravirt_ops
    guest-halt-polling
+   ne_overview
 
 TODOLIST:
 
    kvm/index
    uml/user_mode_linux_howto_v2
-   ne_overview
    acrn/index
 
 .. only:: html and subproject
Documentation/translations/zh_CN/virt/ne_overview.rst new file +88 -0

88 lines not on this page · raw message

Signature · 1 line
2.27.0
author
#9 lore raw

PATCH v3 5/8 docs/zh_CN: add virt acrn index translation

In reply to Yanteng Si

Translate Documentation/virt/acrn/index.rst into Chinese.

---
 .../translations/zh_CN/virt/acrn/index.rst    | 27 +++++++++++++++++++
 .../translations/zh_CN/virt/index.rst         |  2 +-
 2 files changed, 28 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/index.rst
Documentation/translations/zh_CN/virt/acrn/index.rst new file +27 -0
new file mode 100644
index 000000000000..6061e790ee83
@@ -0,0 +1,27 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/acrn/index.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_acrn_index:
+
+==============
+ACRN超级管理器
+==============
+
+.. toctree::
+   :maxdepth: 1
+
+TODOLIST:
+
+   introduction
+   io-request
+   cpuid
Documentation/translations/zh_CN/virt/index.rst +1 -1
index 8e7713163962..f8dd13681341 100644
@@ -23,12 +23,12 @@ Linux虚拟化支持
    paravirt_ops
    guest-halt-polling
    ne_overview
+   acrn/index
 
 TODOLIST:
 
    kvm/index
    uml/user_mode_linux_howto_v2
-   acrn/index
 
 .. only:: html and subproject
 
Signature · 1 line
2.27.0
Reviewed-by on v3 5/8
#10 lore raw

Re: [PATCH v3 5/8] docs/zh_CN: add virt acrn index translation

Quoted 4 lines · Yanteng Si

Translate Documentation/virt/acrn/index.rst into Chinese.

Quoted 60 lines
---
 .../translations/zh_CN/virt/acrn/index.rst    | 27 +++++++++++++++++++
 .../translations/zh_CN/virt/index.rst         |  2 +-
 2 files changed, 28 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/index.rst
Documentation/translations/zh_CN/virt/acrn/index.rst new file +27 -0
new file mode 100644
index 000000000000..6061e790ee83
@@ -0,0 +1,27 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/acrn/index.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_acrn_index:
+
+==============
+ACRN超级管理器
+==============
+
+.. toctree::
+   :maxdepth: 1
+
+TODOLIST:
+
+   introduction
+   io-request
+   cpuid
Documentation/translations/zh_CN/virt/index.rst +1 -2
index 8e7713163962..f8dd13681341 100644
@@ -23,12 +23,12 @@ Linux虚拟化支持
    paravirt_ops
    guest-halt-polling
    ne_overview
+   acrn/index
 
 TODOLIST:
 
    kvm/index
    uml/user_mode_linux_howto_v2
-   acrn/index
 
 .. only:: html and subproject
 
--

2.27.0

author
#11 lore raw

PATCH v3 6/8 docs/zh_CN: add virt acrn introduction translation

In reply to Yanteng Si

Translate Documentation/virt/acrn/introduction.rst into Chinese.

---
 .../translations/zh_CN/virt/acrn/index.rst    |  4 +-
 .../zh_CN/virt/acrn/introduction.rst          | 52 +++++++++++++++++++
 2 files changed, 55 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/introduction.rst
Documentation/translations/zh_CN/virt/acrn/index.rst +3 -1
index 6061e790ee83..b8f502033455 100644
@@ -20,8 +20,10 @@ ACRN超级管理器
 .. toctree::
    :maxdepth: 1
 
+   introduction
+
 TODOLIST:
 
-   introduction
+
    io-request
    cpuid
Documentation/translations/zh_CN/virt/acrn/introduction.rst new file +52 -0

52 lines not on this page · raw message

Signature · 1 line
2.27.0
Reviewed-by on v3 6/8
#12 lore raw

Re: [PATCH v3 6/8] docs/zh_CN: add virt acrn introduction translation

Quoted 73 lines · Yanteng Si

Translate Documentation/virt/acrn/introduction.rst into Chinese.

---
 .../translations/zh_CN/virt/acrn/index.rst    |  4 +-
 .../zh_CN/virt/acrn/introduction.rst          | 52 +++++++++++++++++++
 2 files changed, 55 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/introduction.rst
Documentation/translations/zh_CN/virt/acrn/index.rst +3 -1
index 6061e790ee83..b8f502033455 100644
@@ -20,8 +20,10 @@ ACRN超级管理器
 .. toctree::
    :maxdepth: 1
 
+   introduction
+
 TODOLIST:
 
-   introduction
+
    io-request
    cpuid
Documentation/translations/zh_CN/virt/acrn/introduction.rst new file +41 -0
new file mode 100644
index 000000000000..b31034bcfa4e
@@ -0,0 +1,52 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/acrn/introduction.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_acrn_introduction:
+
+ACRN超级管理器介绍
+==================
+
+ACRN超级管理器是一个第一类超级管理器,直接在裸机硬件上运行。它有一个特权管理虚拟机,称为服
+务虚拟机,用于管理用户虚拟机和进行I/O仿真。
+
+ACRN用户空间是一个运行在服务虚拟机中的应用程序,它根据命令行配置为用户虚拟机仿真设备。
+ACRN管理程序服务模块(HSM)是服务虚拟机中的一个内核模块,为ACRN用户空间提供管理程序服
+务。
+
+下图展示了该架构。
+
+::
+
+                服务端VM                      用户端VM
+      +----------------------------+  |  +------------------+
+      |        +--------------+    |  |  |                  |
+      |        |ACRN用户空间  |    |  |  |                  |
+      |        +--------------+    |  |  |                  |
+      |-----------------ioctl------|  |  |                  |   ...
+      |内核空间       +----------+ |  |  |                  |
+      |               |   HSM    | |  |  | 驱动             |
+      |               +----------+ |  |  |                  |
+      +--------------------|-------+  |  +------------------+
+  +---------------------hypercall----------------------------------------+
+  |                         ACRN超级管理器                               |

Documentation/translations/zh_CN/virt/acrn/introduction.rst line 51

Quoted 10 lines
Documentation/translations/zh_CN/virt/acrn/introduction.rst new file +10 -0
+  +----------------------------------------------------------------------+
+  |                          硬件                                        |
+  +----------------------------------------------------------------------+
+
+ACRN用户空间为用户虚拟机分配内存,配置和初始化用户虚拟机使用的设备,加载虚拟引导程序,
+初始化虚拟CPU状态,处理来自用户虚拟机的I/O请求访问。它使用ioctls来与HSM通信。HSM通过
+与ACRN超级管理器的hypercalls进行交互来实现管理服务。HSM向用户空间输出一个char设备接口
+(/dev/acrn_hsm)。
+
+ACRN超级管理器是开源的,任何人都可以贡献。源码库可在

remove '可‘ ? with this

Thanks

Quoted 4 lines
Documentation/translations/zh_CN/virt/acrn/introduction.rst new file +1 -1
+https://github.com/projectacrn/acrn-hypervisor。
--

2.27.0

#13 lore raw

Re: [PATCH v3 6/8] docs/zh_CN: add virt acrn introduction translation

Quoted 88 lines · Alex Shi <[email protected]> 于2021年8月4日周三 上午11:02写道:
Quoted 73 lines · Yanteng Si

Translate Documentation/virt/acrn/introduction.rst into Chinese.

---
 .../translations/zh_CN/virt/acrn/index.rst    |  4 +-
 .../zh_CN/virt/acrn/introduction.rst          | 52 +++++++++++++++++++
 2 files changed, 55 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/introduction.rst
Documentation/translations/zh_CN/virt/acrn/index.rst +3 -1
index 6061e790ee83..b8f502033455 100644
@@ -20,8 +20,10 @@ ACRN超级管理器
 .. toctree::
    :maxdepth: 1
 
+   introduction
+
 TODOLIST:
 
-   introduction
+
    io-request
    cpuid
Documentation/translations/zh_CN/virt/acrn/introduction.rst new file +41 -0
new file mode 100644
index 000000000000..b31034bcfa4e
@@ -0,0 +1,52 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/acrn/introduction.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_acrn_introduction:
+
+ACRN超级管理器介绍
+==================
+
+ACRN超级管理器是一个第一类超级管理器,直接在裸机硬件上运行。它有一个特权管理虚拟机,称为服
+务虚拟机,用于管理用户虚拟机和进行I/O仿真。
+
+ACRN用户空间是一个运行在服务虚拟机中的应用程序,它根据命令行配置为用户虚拟机仿真设备。
+ACRN管理程序服务模块(HSM)是服务虚拟机中的一个内核模块,为ACRN用户空间提供管理程序服
+务。
+
+下图展示了该架构。
+
+::
+
+                服务端VM                      用户端VM
+      +----------------------------+  |  +------------------+
+      |        +--------------+    |  |  |                  |
+      |        |ACRN用户空间  |    |  |  |                  |
+      |        +--------------+    |  |  |                  |
+      |-----------------ioctl------|  |  |                  |   ...
+      |内核空间       +----------+ |  |  |                  |
+      |               |   HSM    | |  |  | 驱动             |
+      |               +----------+ |  |  |                  |
+      +--------------------|-------+  |  +------------------+
+  +---------------------hypercall----------------------------------------+
+  |                         ACRN超级管理器                               |

Documentation/translations/zh_CN/virt/acrn/introduction.rst line 51

Quoted 10 lines
Documentation/translations/zh_CN/virt/acrn/introduction.rst new file +10 -0
+  +----------------------------------------------------------------------+
+  |                          硬件                                        |
+  +----------------------------------------------------------------------+
+
+ACRN用户空间为用户虚拟机分配内存,配置和初始化用户虚拟机使用的设备,加载虚拟引导程序,
+初始化虚拟CPU状态,处理来自用户虚拟机的I/O请求访问。它使用ioctls来与HSM通信。HSM通过
+与ACRN超级管理器的hypercalls进行交互来实现管理服务。HSM向用户空间输出一个char设备接口
+(/dev/acrn_hsm)。
+
+ACRN超级管理器是开源的,任何人都可以贡献。源码库可在

remove '可‘ ? with this

Quoted 2 lines

OK!

Thanks,

Yanteng

author
#14 lore raw

PATCH v3 7/8 docs/zh_CN: add virt acrn io-request translation

In reply to Yanteng Si

Translate Documentation/virt/acrn/io-request.rst into Chinese.

---
 .../translations/zh_CN/virt/acrn/index.rst    |  3 +-
 .../zh_CN/virt/acrn/io-request.rst            | 99 +++++++++++++++++++
 2 files changed, 101 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/io-request.rst
Documentation/translations/zh_CN/virt/acrn/index.rst +2 -1
index b8f502033455..b53976e20a34 100644
@@ -21,9 +21,10 @@ ACRN超级管理器
    :maxdepth: 1
 
    introduction
+   io-request
 
 TODOLIST:
 
 
-   io-request
+
    cpuid
Documentation/translations/zh_CN/virt/acrn/io-request.rst new file +99 -0

99 lines not on this page · raw message

Signature · 1 line
2.27.0
Reviewed-by on v3 7/8
#15 lore raw

Re: [PATCH v3 7/8] docs/zh_CN: add virt acrn io-request translation

Quoted 4 lines · Yanteng Si

Translate Documentation/virt/acrn/io-request.rst into Chinese.

Quoted 130 lines
---
 .../translations/zh_CN/virt/acrn/index.rst    |  3 +-
 .../zh_CN/virt/acrn/io-request.rst            | 99 +++++++++++++++++++
 2 files changed, 101 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/io-request.rst
Documentation/translations/zh_CN/virt/acrn/index.rst +2 -1
index b8f502033455..b53976e20a34 100644
@@ -21,9 +21,10 @@ ACRN超级管理器
    :maxdepth: 1
 
    introduction
+   io-request
 
 TODOLIST:
 
 
-   io-request
+
    cpuid
Documentation/translations/zh_CN/virt/acrn/io-request.rst new file +99 -1
new file mode 100644
index 000000000000..1a25ea15ae07
@@ -0,0 +1,99 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/acrn/io-request.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_acrn_io-request:
+
+I/O请求处理
+===========
+
+客户虚拟机的I/O请求由超级管理器构建,由ACRN超级管理器服务模块分发到与I/O请求的地址范
+围相对应的I/O客户端。I/O请求处理的细节将在以下章节描述。
+
+1. I/O请求
+----------
+
+对于每个客户虚拟机,有一个共享的4KB字节的内存区域,用于超级管理器和服务虚拟机之间的
+I/O请求通信。一个I/O请求是一个256字节的结构体缓冲区,它是 "acrn_io_request" 结构
+体,当客户虚拟机中发生被困的I/O访问时,由超级管理器的I/O处理器填充。服务虚拟机中的
+ACRN用户空间首先分配一个4KB字节的页面,并将缓冲区的GPA(客户物理地址)传递给管理平
+台。缓冲区被用作16个I/O请求槽的数组,每个I/O请求槽为256字节。这个数组是按vCPU ID
+索引的。
+
+2. I/O客户端
+------------
+
+一个I/O客户端负责处理客户虚拟机的I/O请求,其访问的GPA在一定范围内。每个客户虚拟机
+可以关联多个I/O客户端。每个客户虚拟机都有一个特殊的客户端,称为默认客户端,负责处理
+所有不在其他客户端范围内的I/O请求。ACRN用户空间充当每个客户虚拟机的默认客户端。
+
+下面的图示显示了I/O请求共享缓冲区、I/O请求和I/O客户端之间的关系。
+
+::
+
+     +------------------------------------------------------+
+     |                                       服务VM         |
+     |+--------------------------------------------------+  |
+     ||      +----------------------------------------+  |  |
+     ||      | 共享页                 ACRN用户空间    |  |  |
+     ||      |    +-----------------+  +------------+ |  |  |
+     ||   +----+->| acrn_io_request |<-+  默认      | |  |  |
+     ||   |  | |  +-----------------+  | I/O客户端  | |  |  |
+     ||   |  | |  |       ...       |  +------------+ |  |  |
+     ||   |  | |  +-----------------+                 |  |  |
+     ||   |  +-|--------------------------------------+  |  |
+     ||---|----|-----------------------------------------|  |
+     ||   |    |                             内核        |  |
+     ||   |    |            +----------------------+     |  |
+     ||   |    |            | +-------------+  HSM |     |  |
+     ||   |    +--------------+             |      |     |  |
+     ||   |                 | | I/O客户端   |      |     |  |
+     ||   |                 | |             |      |     |  |
+     ||   |                 | +-------------+      |     |  |
+     ||   |                 +----------------------+     |  |
+     |+---|----------------------------------------------+  |
+     +----|-------------------------------------------------+
+          |
+     +----|-------------------------------------------------+
+     |  +-+-----------+                                     |
+     |  | I/O处理     |              ACRN超级管理器         |
+     |  +-------------+                                     |
+     +------------------------------------------------------+
+
+3. I/O请求状态转换
+------------------
+
+一个ACRN I/O请求的状态转换如下。
+
+::
+
+   FREE -> PENDING -> PROCESSING -> COMPLETE -> FREE -> ...
+
+- FREE: 这个I/O请求槽是空的
+- PENDING: 在这个槽位上有一个有效的I/O请求正在等待
+- PROCESSING: 正在处理I/O请求
+- COMPLETE: 该I/O请求已被处理
+
+处于COMPLETE或FREE状态的I/O请求是由超级管理器拥有的。HSM和ACRN用户空间负责处理其
+他的。
+
+4. I/O请求的处理流程
+--------------------
+
+a. 当客户虚拟机中发生被陷入的I/O访问时,超级管理器的I/O处理程序将把I/O请求填充为
+   PENDING状态。
+b. 超级管理器向服务虚拟机发出一个向上调用,这是一个通知中断。
+c. upcall处理程序会安排一个工作者来调度I/O请求。
+d. 工作者寻找PENDING I/O请求,根据I/O访问的地址将其分配给不同的注册客户,将其
+   状态更新为PROCESSING,并通知相应的客户进行处理。
+e. 被通知的客户端处理指定的I/O请求。
+f. HSM将I/O请求状态更新为COMPLETE,并通过hypercalls通知超级管理器完成。
--

2.27.0

author
#16 lore raw

PATCH v3 8/8 docs/zh_CN: add virt acrn cpuid translation

In reply to Yanteng Si

Translate Documentation/virt/acrn/cpuid.rst into Chinese.

---
 .../translations/zh_CN/virt/acrn/cpuid.rst    | 56 +++++++++++++++++++
 .../translations/zh_CN/virt/acrn/index.rst    |  5 --
 2 files changed, 56 insertions(+), 5 deletions(-)
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/cpuid.rst
Documentation/translations/zh_CN/virt/acrn/cpuid.rst new file +56 -0
new file mode 100644
index 000000000000..252aa10ad52e
@@ -0,0 +1,56 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/acrn/cpuid.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_acrn_cpuid:
+
+==============
+ACRN CPUID位域
+==============
+
+在ACRN超级管理器上运行的客户虚拟机可以使用CPUID检查其一些功能。
+
+ACRN的cpuid函数是:
+
+函数: 0x40000000
+
+返回::
+
+   eax = 0x40000010
+   ebx = 0x4e524341
+   ecx = 0x4e524341
+   edx = 0x4e524341
+
+注意,ebx,ecx和edx中的这个值对应于字符串“ACRNACRNACRN”。eax中的值对应于这个叶子
+中存在的最大cpuid函数,如果将来有更多的函数加入,将被更新。
+
+函数: define ACRN_CPUID_FEATURES (0x40000001)
+
+返回::
+
+          ebx, ecx, edx
+          eax = an OR'ed group of (1 << flag)
+
+其中 ``flag`` 的定义如下:
+
+================================= =========== ================================
+标志                              值          描述
+================================= =========== ================================
+ACRN_FEATURE_PRIVILEGED_VM        0           客户虚拟机是一个有特权的虚拟机
+================================= =========== ================================
+
+函数: 0x40000010
+
+返回::
+
+          ebx, ecx, edx
+          eax = (Virtual) TSC frequency in kHz.
Documentation/translations/zh_CN/virt/acrn/index.rst +0 -5
index b53976e20a34..34605d87f103 100644
@@ -22,9 +22,4 @@ ACRN超级管理器
 
    introduction
    io-request
-
-TODOLIST:
-
-
-
    cpuid
Signature · 1 line
2.27.0
Reviewed-by on v3 8/8
#17 lore raw

Re: [PATCH v3 8/8] docs/zh_CN: add virt acrn cpuid translation

Quoted 4 lines · Yanteng Si

Translate Documentation/virt/acrn/cpuid.rst into Chinese.

Quoted 85 lines
---
 .../translations/zh_CN/virt/acrn/cpuid.rst    | 56 +++++++++++++++++++
 .../translations/zh_CN/virt/acrn/index.rst    |  5 --
 2 files changed, 56 insertions(+), 5 deletions(-)
 create mode 100644 Documentation/translations/zh_CN/virt/acrn/cpuid.rst
Documentation/translations/zh_CN/virt/acrn/cpuid.rst new file +56 -0
new file mode 100644
index 000000000000..252aa10ad52e
@@ -0,0 +1,56 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. include:: ../../disclaimer-zh_CN.rst
+
+:Original: Documentation/virt/acrn/cpuid.rst
+
+:翻译:
+
+ 司延腾 Yanteng Si <[email protected]>
+
+:校译:
+
+ 时奎亮 Alex Shi <[email protected]>
+
+.. _cn_virt_acrn_cpuid:
+
+==============
+ACRN CPUID位域
+==============
+
+在ACRN超级管理器上运行的客户虚拟机可以使用CPUID检查其一些功能。
+
+ACRN的cpuid函数是:
+
+函数: 0x40000000
+
+返回::
+
+   eax = 0x40000010
+   ebx = 0x4e524341
+   ecx = 0x4e524341
+   edx = 0x4e524341
+
+注意,ebx,ecx和edx中的这个值对应于字符串“ACRNACRNACRN”。eax中的值对应于这个叶子
+中存在的最大cpuid函数,如果将来有更多的函数加入,将被更新。
+
+函数: define ACRN_CPUID_FEATURES (0x40000001)
+
+返回::
+
+          ebx, ecx, edx
+          eax = an OR'ed group of (1 << flag)
+
+其中 ``flag`` 的定义如下:
+
+================================= =========== ================================
+标志                              值          描述
+================================= =========== ================================
+ACRN_FEATURE_PRIVILEGED_VM        0           客户虚拟机是一个有特权的虚拟机
+================================= =========== ================================
+
+函数: 0x40000010
+
+返回::
+
+          ebx, ecx, edx
+          eax = (Virtual) TSC frequency in kHz.
Documentation/translations/zh_CN/virt/acrn/index.rst +0 -6
index b53976e20a34..34605d87f103 100644
@@ -22,9 +22,4 @@ ACRN超级管理器
 
    introduction
    io-request
-
-TODOLIST:
-
-
-
    cpuid
--

2.27.0