docs/zh_CN: add some virt docs translation
Subsystems (2)
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
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
@@ -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
@@ -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
PATCH v3 2/8 docs/zh_CN: add virt paravirt_ops translation
In reply to Yanteng SiTranslate 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
@@ -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
Re: [PATCH v3 2/8] docs/zh_CN: add virt paravirt_ops translation
Quoted 43 lines · Yanteng Si
Translate
Documentation/virt/paravirt_ops.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>Reviewed-by Alex Shi <[email protected]>--- .../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.rstDocumentation/translations/zh_CN/virt/index.rst +2
-1@@ -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/indexDocumentation/translations/zh_CN/virt/paravirt_ops.rst new file +8
-0@@ -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
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.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>Reviewed-by Alex Shi <[email protected]>--- .../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.rstDocumentation/translations/zh_CN/virt/index.rst +2
-1@@ -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/indexDocumentation/translations/zh_CN/virt/paravirt_ops.rst new file +12
-0@@ -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_opsthis 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
PATCH v3 3/8 docs/zh_CN: add virt guest-halt-polling translation
In reply to Yanteng SiTranslate 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
@@ -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
@@ -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
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.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>Reviewed-by Alex Shi <[email protected]>--- .../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.rstDocumentation/translations/zh_CN/virt/guest-halt-polling.rst new file +6
-0@@ -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@@ -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
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.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>Reviewed-by Alex Shi <[email protected]>--- .../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.rstDocumentation/translations/zh_CN/virt/guest-halt-polling.rst new file +10
-0@@ -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
PATCH v3 4/8 docs/zh_CN: add virt ne_overview translation
In reply to Yanteng SiTranslate 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
@@ -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
PATCH v3 5/8 docs/zh_CN: add virt acrn index translation
In reply to Yanteng SiTranslate 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
@@ -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
@@ -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
Re: [PATCH v3 5/8] docs/zh_CN: add virt acrn index translation
Quoted 4 lines · Yanteng Si
Translate
Documentation/virt/acrn/index.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>
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.rstDocumentation/translations/zh_CN/virt/acrn/index.rst new file +27
-0@@ -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 + cpuidDocumentation/translations/zh_CN/virt/index.rst +1
-2@@ -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
PATCH v3 6/8 docs/zh_CN: add virt acrn introduction translation
In reply to Yanteng SiTranslate 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
@@ -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
Re: [PATCH v3 6/8] docs/zh_CN: add virt acrn introduction translation
Quoted 73 lines · Yanteng Si
Translate
Documentation/virt/acrn/introduction.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>--- .../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.rstDocumentation/translations/zh_CN/virt/acrn/index.rst +3
-1@@ -20,8 +20,10 @@ ACRN超级管理器 .. toctree:: :maxdepth: 1 + introduction + TODOLIST: - introduction + io-request cpuidDocumentation/translations/zh_CN/virt/acrn/introduction.rst new file +41
-0@@ -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
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.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>--- .../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.rstDocumentation/translations/zh_CN/virt/acrn/index.rst +3
-1@@ -20,8 +20,10 @@ ACRN超级管理器 .. toctree:: :maxdepth: 1 + introduction + TODOLIST: - introduction + io-request cpuidDocumentation/translations/zh_CN/virt/acrn/introduction.rst new file +41
-0@@ -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
Reviewed-by Alex Shi <[email protected]>
OK!
Thanks,
Yanteng
PATCH v3 7/8 docs/zh_CN: add virt acrn io-request translation
In reply to Yanteng SiTranslate 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
@@ -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
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.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>
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.rstDocumentation/translations/zh_CN/virt/acrn/index.rst +2
-1@@ -21,9 +21,10 @@ ACRN超级管理器 :maxdepth: 1 introduction + io-request TODOLIST: - io-request + cpuidDocumentation/translations/zh_CN/virt/acrn/io-request.rst new file +99
-1@@ -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
PATCH v3 8/8 docs/zh_CN: add virt acrn cpuid translation
In reply to Yanteng SiTranslate 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
@@ -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
@@ -22,9 +22,4 @@ ACRN超级管理器 introduction io-request - -TODOLIST: - - - cpuid
Signature · 1 line
2.27.0
Re: [PATCH v3 8/8] docs/zh_CN: add virt acrn cpuid translation
Quoted 4 lines · Yanteng Si
Translate
Documentation/virt/acrn/cpuid.rstinto Chinese.Signed-off-by Yanteng Si <[email protected]>
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.rstDocumentation/translations/zh_CN/virt/acrn/cpuid.rst new file +56
-0@@ -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@@ -22,9 +22,4 @@ ACRN超级管理器 introduction io-request - -TODOLIST: - - - cpuid --2.27.0