This patch series set up the basic facility for the translation work
of the docs residing on filesystems into Chinese, indexing the filesystems
directory and adding one indexed translation into it. The virtiofs.rst
added is not only a translation itself but also an simple example that
future developers would take.
The detailed diff info also shows the basic essential markups of
the toctree and reStructuredText, at least for the most simple occasions.
More translations of filesystems are on their way, and futher,
of more subsystems.
---
Wang Wenhu (2):
doc: zh_CN: index files in filesystems subdirectory
doc: zh_CN: add translation for virtiofs
Documentation/filesystems/index.rst | 2 +
Documentation/filesystems/virtiofs.rst | 2 +
.../translations/zh_CN/filesystems/index.rst | 29 +++++++++
.../zh_CN/filesystems/virtiofs.rst | 62 +++++++++++++++++++
Documentation/translations/zh_CN/index.rst | 1 +
5 files changed, 96 insertions(+)
create mode 100644 Documentation/translations/zh_CN/filesystems/index.rst
create mode 100644 Documentation/translations/zh_CN/filesystems/virtiofs.rst
--
2.17.1
Translate virtiofs.rst in Documentation/filesystems/ into Chinese.
Signed-off-by: Wang Wenhu <[email protected]>
---
Documentation/filesystems/virtiofs.rst | 2 +
.../translations/zh_CN/filesystems/index.rst | 2 +
.../zh_CN/filesystems/virtiofs.rst | 62 +++++++++++++++++++
3 files changed, 66 insertions(+)
create mode 100644 Documentation/translations/zh_CN/filesystems/virtiofs.rst
diff --git a/Documentation/filesystems/virtiofs.rst b/Documentation/filesystems/virtiofs.rst
index 4f338e3cb3f7..7c4301d962f8 100644
--- a/Documentation/filesystems/virtiofs.rst
+++ b/Documentation/filesystems/virtiofs.rst
@@ -1,3 +1,5 @@
+.. _virtiofs_index:
+
.. SPDX-License-Identifier: GPL-2.0
===================================================
diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
index a47dd86d6196..205680ec790d 100644
--- a/Documentation/translations/zh_CN/filesystems/index.rst
+++ b/Documentation/translations/zh_CN/filesystems/index.rst
@@ -25,3 +25,5 @@ Linux Kernel中的文件系统
.. toctree::
:maxdepth: 2
+
+ virtiofs
diff --git a/Documentation/translations/zh_CN/filesystems/virtiofs.rst b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
new file mode 100644
index 000000000000..2a36cd417f8b
--- /dev/null
+++ b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
@@ -0,0 +1,62 @@
+.. raw:: latex
+
+ \renewcommand\thesection*
+ \renewcommand\thesubsection*
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/filesystems/virtiofs.rst <virtiofs_index>`
+
+译者
+::
+
+ 中文版维护者： 王文虎 Wang Wenhu <[email protected]>
+ 中文版翻译者： 王文虎 Wang Wenhu <[email protected]>
+ 中文版校译者: 王文虎 Wang Wenhu <[email protected]>
+
+.. SPDX-License-Identifier: GPL-2.0
+
+===========================================
+virtiofs: virtio-fs 主机<->客机共享文件系统
+===========================================
+
+- Copyright (C) 2019 Red Hat, Inc. （译者注：英文版版权信息）
+
+介绍
+====
+Linux的virtiofs文件系统实现了一个半虚拟化VIRTIO类型“virtio-fs”设备的驱动，通过该\
+类型设备实现客机<->主机文件系统共享。它允许客机挂载一个已经导出到主机的目录。
+
+客机通常需要访问主机或者远程系统上的文件。使用场景包括：在新客机安装时让文件对其\
+可见；从主机上的根文件系统启动；对无状态或临时客机提供持久存储和在客机之间共享目录。
+
+尽管在某些任务可能通过使用已有的网络文件系统完成，但是却需要非常难以自动化的配置\
+步骤，且将存储网络暴露给客机。而virtio-fs设备通过提供不经过网络的文件系统访问文件\
+的设计方式解决了这些问题。
+
+另外，virto-fs设备发挥了主客机共存的优点提高了性能，并且提供了网络文件系统所不具备
+的一些语义功能。
+
+用法
+====
+以``myfs``标签将文件系统挂载到``/mnt``:
+
+.. code-block:: sh
+
+ guest# mount -t virtiofs myfs /mnt
+
+请查阅 https://virtio-fs.gitlab.io/ 了解配置QEMU和virtiofsd守护程序的详细信息。
+
+内幕
+====
+由于virtio-fs设备将FUSE协议用于文件系统请求，因此Linux的virtiofs文件系统与FUSE文\
+件系统客户端紧密集成在一起。客机充当FUSE客户端而主机充当FUSE服务器，内核与用户空\
+间之间的/dev/fuse接口由virtio-fs设备接口代替。
+
+FUSE请求被置于虚拟队列中由主机处理。主机填充缓冲区中的响应部分，而客机处理请求的完成部分。
+
+将/dev/fuse映射到虚拟队列需要解决/dev/fuse和虚拟队列之间语义上的差异。每次读取\
+/dev/fuse设备时，FUSE客户端都可以选择要传输的请求，从而可以使某些请求优先于其他\
+请求。虚拟队列有其队列语义，无法更改已入队请求的顺序。在虚拟队列已满的情况下尤
+其关键，因为此时不可能加入高优先级的请求。为了解决此差异，virtio-fs设备采用“hiprio”\
+（高优先级）虚拟队列，专门用于有别于普通请求的高优先级请求。
--
2.17.1
On Sun, Mar 15, 2020 at 02:27:58AM -0700, Wang Wenhu wrote:
> This patch series set up the basic facility for the translation work
> of the docs residing on filesystems into Chinese, indexing the filesystems
> directory and adding one indexed translation into it. The virtiofs.rst
> added is not only a translation itself but also an simple example that
> future developers would take.
>
> The detailed diff info also shows the basic essential markups of
> the toctree and reStructuredText, at least for the most simple occasions.
> More translations of filesystems are on their way, and futher,
> of more subsystems.
>
> ---
> Wang Wenhu (2):
> doc: zh_CN: index files in filesystems subdirectory
> doc: zh_CN: add translation for virtiofs
>
> Documentation/filesystems/index.rst | 2 +
> Documentation/filesystems/virtiofs.rst | 2 +
> .../translations/zh_CN/filesystems/index.rst | 29 +++++++++
> .../zh_CN/filesystems/virtiofs.rst | 62 +++++++++++++++++++
> Documentation/translations/zh_CN/index.rst | 1 +
> 5 files changed, 96 insertions(+)
> create mode 100644 Documentation/translations/zh_CN/filesystems/index.rst
> create mode 100644 Documentation/translations/zh_CN/filesystems/virtiofs.rst
>
> --
> 2.17.1
>
I am not a Chinese speaker but thank you for translation the
documentation!
Acked-by: Stefan Hajnoczi <[email protected]>
Translate virtiofs.rst in Documentation/filesystems/ into Chinese.
Acked-by: Stefan Hajnoczi <[email protected]>
Signed-off-by: Wang Wenhu <[email protected]>
---
v2:
- add a blank line in the end of index.rst to index virtiofs.rst
- Asked-by Stefan Hajnoczi
- Link:https://lore.kernel.org/linux-doc/[email protected]/1-a.txt
---
Documentation/filesystems/virtiofs.rst | 2 +
.../translations/zh_CN/filesystems/index.rst | 3 +
.../zh_CN/filesystems/virtiofs.rst | 62 +++++++++++++++++++
3 files changed, 67 insertions(+)
create mode 100644 Documentation/translations/zh_CN/filesystems/virtiofs.rst
diff --git a/Documentation/filesystems/virtiofs.rst b/Documentation/filesystems/virtiofs.rst
index 4f338e3cb3f7..7c4301d962f8 100644
--- a/Documentation/filesystems/virtiofs.rst
+++ b/Documentation/filesystems/virtiofs.rst
@@ -1,3 +1,5 @@
+.. _virtiofs_index:
+
.. SPDX-License-Identifier: GPL-2.0
===================================================
diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
index a47dd86d6196..69f38df8c4bd 100644
--- a/Documentation/translations/zh_CN/filesystems/index.rst
+++ b/Documentation/translations/zh_CN/filesystems/index.rst
@@ -25,3 +25,6 @@ Linux Kernel中的文件系统
.. toctree::
:maxdepth: 2
+
+ virtiofs
+
diff --git a/Documentation/translations/zh_CN/filesystems/virtiofs.rst b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
new file mode 100644
index 000000000000..2a36cd417f8b
--- /dev/null
+++ b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
@@ -0,0 +1,62 @@
+.. raw:: latex
+
+ \renewcommand\thesection*
+ \renewcommand\thesubsection*
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/filesystems/virtiofs.rst <virtiofs_index>`
+
+译者
+::
+
+ 中文版维护者： 王文虎 Wang Wenhu <[email protected]>
+ 中文版翻译者： 王文虎 Wang Wenhu <[email protected]>
+ 中文版校译者: 王文虎 Wang Wenhu <[email protected]>
+
+.. SPDX-License-Identifier: GPL-2.0
+
+===========================================
+virtiofs: virtio-fs 主机<->客机共享文件系统
+===========================================
+
+- Copyright (C) 2019 Red Hat, Inc. （译者注：英文版版权信息）
+
+介绍
+====
+Linux的virtiofs文件系统实现了一个半虚拟化VIRTIO类型“virtio-fs”设备的驱动，通过该\
+类型设备实现客机<->主机文件系统共享。它允许客机挂载一个已经导出到主机的目录。
+
+客机通常需要访问主机或者远程系统上的文件。使用场景包括：在新客机安装时让文件对其\
+可见；从主机上的根文件系统启动；对无状态或临时客机提供持久存储和在客机之间共享目录。
+
+尽管在某些任务可能通过使用已有的网络文件系统完成，但是却需要非常难以自动化的配置\
+步骤，且将存储网络暴露给客机。而virtio-fs设备通过提供不经过网络的文件系统访问文件\
+的设计方式解决了这些问题。
+
+另外，virto-fs设备发挥了主客机共存的优点提高了性能，并且提供了网络文件系统所不具备
+的一些语义功能。
+
+用法
+====
+以``myfs``标签将文件系统挂载到``/mnt``:
+
+.. code-block:: sh
+
+ guest# mount -t virtiofs myfs /mnt
+
+请查阅 https://virtio-fs.gitlab.io/ 了解配置QEMU和virtiofsd守护程序的详细信息。
+
+内幕
+====
+由于virtio-fs设备将FUSE协议用于文件系统请求，因此Linux的virtiofs文件系统与FUSE文\
+件系统客户端紧密集成在一起。客机充当FUSE客户端而主机充当FUSE服务器，内核与用户空\
+间之间的/dev/fuse接口由virtio-fs设备接口代替。
+
+FUSE请求被置于虚拟队列中由主机处理。主机填充缓冲区中的响应部分，而客机处理请求的完成部分。
+
+将/dev/fuse映射到虚拟队列需要解决/dev/fuse和虚拟队列之间语义上的差异。每次读取\
+/dev/fuse设备时，FUSE客户端都可以选择要传输的请求，从而可以使某些请求优先于其他\
+请求。虚拟队列有其队列语义，无法更改已入队请求的顺序。在虚拟队列已满的情况下尤
+其关键，因为此时不可能加入高优先级的请求。为了解决此差异，virtio-fs设备采用“hiprio”\
+（高优先级）虚拟队列，专门用于有别于普通请求的高优先级请求。
--
2.17.1
Em Sun, 15 Mar 2020 02:28:00 -0700
Wang Wenhu <[email protected]> escreveu:
> Translate virtiofs.rst in Documentation/filesystems/ into Chinese.
>
> Signed-off-by: Wang Wenhu <[email protected]>
> ---
> Documentation/filesystems/virtiofs.rst | 2 +
> .../translations/zh_CN/filesystems/index.rst | 2 +
> .../zh_CN/filesystems/virtiofs.rst | 62 +++++++++++++++++++
> 3 files changed, 66 insertions(+)
> create mode 100644 Documentation/translations/zh_CN/filesystems/virtiofs.rst
>
> diff --git a/Documentation/filesystems/virtiofs.rst b/Documentation/filesystems/virtiofs.rst
> index 4f338e3cb3f7..7c4301d962f8 100644
> --- a/Documentation/filesystems/virtiofs.rst
> +++ b/Documentation/filesystems/virtiofs.rst
> @@ -1,3 +1,5 @@
> +.. _virtiofs_index:
> +
> .. SPDX-License-Identifier: GPL-2.0
Please place the SPDX header at the top of the document.
Regards,
Mauro
>
> ===================================================
> diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
> index a47dd86d6196..205680ec790d 100644
> --- a/Documentation/translations/zh_CN/filesystems/index.rst
> +++ b/Documentation/translations/zh_CN/filesystems/index.rst
> @@ -25,3 +25,5 @@ Linux Kernel中的文件系统
>
> .. toctree::
> :maxdepth: 2
> +
> + virtiofs
> diff --git a/Documentation/translations/zh_CN/filesystems/virtiofs.rst b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
> new file mode 100644
> index 000000000000..2a36cd417f8b
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
> @@ -0,0 +1,62 @@
> +.. raw:: latex
> +
> + \renewcommand\thesection*
> + \renewcommand\thesubsection*
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :ref:`Documentation/filesystems/virtiofs.rst <virtiofs_index>`
> +
> +译者
> +::
> +
> + 中文版维护者： 王文虎 Wang Wenhu <[email protected]>
> + 中文版翻译者： 王文虎 Wang Wenhu <[email protected]>
> + 中文版校译者: 王文虎 Wang Wenhu <[email protected]>
> +
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +===========================================
> +virtiofs: virtio-fs 主机<->客机共享文件系统
> +===========================================
> +
> +- Copyright (C) 2019 Red Hat, Inc. （译者注：英文版版权信息）
> +
> +介绍
> +====
> +Linux的virtiofs文件系统实现了一个半虚拟化VIRTIO类型“virtio-fs”设备的驱动，通过该\
> +类型设备实现客机<->主机文件系统共享。它允许客机挂载一个已经导出到主机的目录。
> +
> +客机通常需要访问主机或者远程系统上的文件。使用场景包括：在新客机安装时让文件对其\
> +可见；从主机上的根文件系统启动；对无状态或临时客机提供持久存储和在客机之间共享目录。
> +
> +尽管在某些任务可能通过使用已有的网络文件系统完成，但是却需要非常难以自动化的配置\
> +步骤，且将存储网络暴露给客机。而virtio-fs设备通过提供不经过网络的文件系统访问文件\
> +的设计方式解决了这些问题。
> +
> +另外，virto-fs设备发挥了主客机共存的优点提高了性能，并且提供了网络文件系统所不具备
> +的一些语义功能。
> +
> +用法
> +====
> +以``myfs``标签将文件系统挂载到``/mnt``:
> +
> +.. code-block:: sh
> +
> + guest# mount -t virtiofs myfs /mnt
> +
> +请查阅 https://virtio-fs.gitlab.io/ 了解配置QEMU和virtiofsd守护程序的详细信息。
> +
> +内幕
> +====
> +由于virtio-fs设备将FUSE协议用于文件系统请求，因此Linux的virtiofs文件系统与FUSE文\
> +件系统客户端紧密集成在一起。客机充当FUSE客户端而主机充当FUSE服务器，内核与用户空\
> +间之间的/dev/fuse接口由virtio-fs设备接口代替。
> +
> +FUSE请求被置于虚拟队列中由主机处理。主机填充缓冲区中的响应部分，而客机处理请求的完成部分。
> +
> +将/dev/fuse映射到虚拟队列需要解决/dev/fuse和虚拟队列之间语义上的差异。每次读取\
> +/dev/fuse设备时，FUSE客户端都可以选择要传输的请求，从而可以使某些请求优先于其他\
> +请求。虚拟队列有其队列语义，无法更改已入队请求的顺序。在虚拟队列已满的情况下尤
> +其关键，因为此时不可能加入高优先级的请求。为了解决此差异，virtio-fs设备采用“hiprio”\
> +（高优先级）虚拟队列，专门用于有别于普通请求的高优先级请求。
Thanks,
Mauro
Add filesystems subdirectory into the table of Contents for zh_CN,
all translations residing on it would be indexed conveniently.
Signed-off-by: Wang Wenhu <[email protected]>
---
Changelog:
- v2 added SPDX header
---
Documentation/filesystems/index.rst | 2 ++
.../translations/zh_CN/filesystems/index.rst | 29 +++++++++++++++++++
Documentation/translations/zh_CN/index.rst | 1 +
3 files changed, 32 insertions(+)
create mode 100644 Documentation/translations/zh_CN/filesystems/index.rst
diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst
index 386eaad008b2..ab47d5b1f092 100644
--- a/Documentation/filesystems/index.rst
+++ b/Documentation/filesystems/index.rst
@@ -1,3 +1,5 @@
+.. _filesystems_index:
+
===============================
Filesystems in the Linux kernel
===============================
diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
new file mode 100644
index 000000000000..0a2cabfeaf7b
--- /dev/null
+++ b/Documentation/translations/zh_CN/filesystems/index.rst
@@ -0,0 +1,29 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. raw:: latex
+
+ \renewcommand\thesection*
+ \renewcommand\thesubsection*
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/filesystems/index.rst <filesystems_index>`
+:Translator: Wang Wenhu <[email protected]>
+
+.. _cn_filesystems_index:
+
+========================
+Linux Kernel中的文件系统
+========================
+
+这份正在开发的手册或许在未来某个辉煌的日子里以易懂的形式将Linux虚拟\
+文件系统（VFS）层以及基于其上的各种文件系统如何工作呈现给大家。当前\
+可以看到下面的内容。
+
+文件系统
+========
+
+文件系统实现文档。
+
+.. toctree::
+ :maxdepth: 2
+
diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
index d3165535ec9e..76850a5dd982 100644
--- a/Documentation/translations/zh_CN/index.rst
+++ b/Documentation/translations/zh_CN/index.rst
@@ -14,6 +14,7 @@
:maxdepth: 2
process/index
+ filesystems/index
目录和表格
----------
--
2.17.1
Translate virtiofs.rst in Documentation/filesystems/ into Chinese.
Acked-by: Stefan Hajnoczi <[email protected]>
Signed-off-by: Wang Wenhu <[email protected]>
---
Changelog v2:
- add a blank line in the end of index.rst to index virtiofs.rst
- Asked-by Stefan Hajnoczi
- added SPDX header and Copyright info
---
Documentation/filesystems/virtiofs.rst | 2 +
.../translations/zh_CN/filesystems/index.rst | 2 +
.../zh_CN/filesystems/virtiofs.rst | 61 +++++++++++++++++++
3 files changed, 65 insertions(+)
create mode 100644 Documentation/translations/zh_CN/filesystems/virtiofs.rst
diff --git a/Documentation/filesystems/virtiofs.rst b/Documentation/filesystems/virtiofs.rst
index 4f338e3cb3f7..7c4301d962f8 100644
--- a/Documentation/filesystems/virtiofs.rst
+++ b/Documentation/filesystems/virtiofs.rst
@@ -1,3 +1,5 @@
+.. _virtiofs_index:
+
.. SPDX-License-Identifier: GPL-2.0
===================================================
diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
index 0a2cabfeaf7b..fd3700a4db6d 100644
--- a/Documentation/translations/zh_CN/filesystems/index.rst
+++ b/Documentation/translations/zh_CN/filesystems/index.rst
@@ -27,3 +27,5 @@ Linux Kernel中的文件系统
.. toctree::
:maxdepth: 2
+ virtiofs
+
diff --git a/Documentation/translations/zh_CN/filesystems/virtiofs.rst b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
new file mode 100644
index 000000000000..cd836a9b2ac4
--- /dev/null
+++ b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
@@ -0,0 +1,61 @@
+.. SPDX-License-Identifier: GPL-2.0
+.. raw:: latex
+
+ \renewcommand\thesection*
+ \renewcommand\thesubsection*
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/filesystems/virtiofs.rst <virtiofs_index>`
+
+译者
+::
+
+ 中文版维护者： 王文虎 Wang Wenhu <[email protected]>
+ 中文版翻译者： 王文虎 Wang Wenhu <[email protected]>
+ 中文版校译者: 王文虎 Wang Wenhu <[email protected]>
+
+===========================================
+virtiofs: virtio-fs 主机<->客机共享文件系统
+===========================================
+
+- Copyright (C) 2020 Vivo Communication Technology Co. Ltd.
+
+介绍
+====
+Linux的virtiofs文件系统实现了一个半虚拟化VIRTIO类型“virtio-fs”设备的驱动，通过该\
+类型设备实现客机<->主机文件系统共享。它允许客机挂载一个已经导出到主机的目录。
+
+客机通常需要访问主机或者远程系统上的文件。使用场景包括：在新客机安装时让文件对其\
+可见；从主机上的根文件系统启动；对无状态或临时客机提供持久存储和在客机之间共享目录。
+
+尽管在某些任务可能通过使用已有的网络文件系统完成，但是却需要非常难以自动化的配置\
+步骤，且将存储网络暴露给客机。而virtio-fs设备通过提供不经过网络的文件系统访问文件\
+的设计方式解决了这些问题。
+
+另外，virto-fs设备发挥了主客机共存的优点提高了性能，并且提供了网络文件系统所不具备
+的一些语义功能。
+
+用法
+====
+以``myfs``标签将文件系统挂载到``/mnt``:
+
+.. code-block:: sh
+
+ guest# mount -t virtiofs myfs /mnt
+
+请查阅 https://virtio-fs.gitlab.io/ 了解配置QEMU和virtiofsd守护程序的详细信息。
+
+内幕
+====
+由于virtio-fs设备将FUSE协议用于文件系统请求，因此Linux的virtiofs文件系统与FUSE文\
+件系统客户端紧密集成在一起。客机充当FUSE客户端而主机充当FUSE服务器，内核与用户空\
+间之间的/dev/fuse接口由virtio-fs设备接口代替。
+
+FUSE请求被置于虚拟队列中由主机处理。主机填充缓冲区中的响应部分，而客机处理请求的完成部分。
+
+将/dev/fuse映射到虚拟队列需要解决/dev/fuse和虚拟队列之间语义上的差异。每次读取\
+/dev/fuse设备时，FUSE客户端都可以选择要传输的请求，从而可以使某些请求优先于其他\
+请求。虚拟队列有其队列语义，无法更改已入队请求的顺序。在虚拟队列已满的情况下尤
+其关键，因为此时不可能加入高优先级的请求。为了解决此差异，virtio-fs设备采用“hiprio”\
+（高优先级）虚拟队列，专门用于有别于普通请求的高优先级请求。
--
2.17.1
Em Sun, 15 Mar 2020 08:52:38 -0700
Wang Wenhu <[email protected]> escreveu:
> Add filesystems subdirectory into the table of Contents for zh_CN,
> all translations residing on it would be indexed conveniently.
>
> Signed-off-by: Wang Wenhu <[email protected]>
> ---
> Changelog:
> - v2 added SPDX header
> ---
> Documentation/filesystems/index.rst | 2 ++
> .../translations/zh_CN/filesystems/index.rst | 29 +++++++++++++++++++
> Documentation/translations/zh_CN/index.rst | 1 +
> 3 files changed, 32 insertions(+)
> create mode 100644 Documentation/translations/zh_CN/filesystems/index.rst
>
> diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst
> index 386eaad008b2..ab47d5b1f092 100644
> --- a/Documentation/filesystems/index.rst
> +++ b/Documentation/filesystems/index.rst
> @@ -1,3 +1,5 @@
> +.. _filesystems_index:
> +
> ===============================
> Filesystems in the Linux kernel
> ===============================
> diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
> new file mode 100644
> index 000000000000..0a2cabfeaf7b
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/filesystems/index.rst
> @@ -0,0 +1,29 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +.. raw:: latex
> +
> + \renewcommand\thesection*
> + \renewcommand\thesubsection*
Out of curiosity: why do you add those?
My experience with raw latex is that adding things like that tend to
break with different Sphinx versions. So, if this is really needed, I
suggest you to test with at least Sphinx 1.7.9 and with the latest
version, to be sure that it won't cause troubles.
Except for that, patch looks ok to me.
Reviewed-by: Mauro Carvalho Chehab <[email protected]>
Regards,
Mauro
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :ref:`Documentation/filesystems/index.rst <filesystems_index>`
> +:Translator: Wang Wenhu <[email protected]>
> +
> +.. _cn_filesystems_index:
> +
> +========================
> +Linux Kernel中的文件系统
> +========================
> +
> +这份正在开发的手册或许在未来某个辉煌的日子里以易懂的形式将Linux虚拟\
> +文件系统（VFS）层以及基于其上的各种文件系统如何工作呈现给大家。当前\
> +可以看到下面的内容。
> +
> +文件系统
> +========
> +
> +文件系统实现文档。
> +
> +.. toctree::
> + :maxdepth: 2
> +
> diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
> index d3165535ec9e..76850a5dd982 100644
> --- a/Documentation/translations/zh_CN/index.rst
> +++ b/Documentation/translations/zh_CN/index.rst
> @@ -14,6 +14,7 @@
> :maxdepth: 2
>
> process/index
> + filesystems/index
>
> 目录和表格
> ----------
Thanks,
Mauro
Em Sun, 15 Mar 2020 08:52:39 -0700
Wang Wenhu <[email protected]> escreveu:
> Translate virtiofs.rst in Documentation/filesystems/ into Chinese.
>
> Acked-by: Stefan Hajnoczi <[email protected]>
> Signed-off-by: Wang Wenhu <[email protected]>
> ---
> Changelog v2:
> - add a blank line in the end of index.rst to index virtiofs.rst
> - Asked-by Stefan Hajnoczi
> - added SPDX header and Copyright info
> ---
> Documentation/filesystems/virtiofs.rst | 2 +
> .../translations/zh_CN/filesystems/index.rst | 2 +
> .../zh_CN/filesystems/virtiofs.rst | 61 +++++++++++++++++++
> 3 files changed, 65 insertions(+)
> create mode 100644 Documentation/translations/zh_CN/filesystems/virtiofs.rst
>
> diff --git a/Documentation/filesystems/virtiofs.rst b/Documentation/filesystems/virtiofs.rst
> index 4f338e3cb3f7..7c4301d962f8 100644
> --- a/Documentation/filesystems/virtiofs.rst
> +++ b/Documentation/filesystems/virtiofs.rst
> @@ -1,3 +1,5 @@
> +.. _virtiofs_index:
> +
> .. SPDX-License-Identifier: GPL-2.0
Please place the SPDX as the first line, e. g.:
.. SPDX-License-Identifier: GPL-2.0
+
+.. _virtiofs_index:
After doing such change:
Reviewed-by: Mauro Carvalho Chehab <[email protected]>
(In time: I'm not reviewing the translation - as I don't speak Mandarin)
>
> ===================================================
> diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
> index 0a2cabfeaf7b..fd3700a4db6d 100644
> --- a/Documentation/translations/zh_CN/filesystems/index.rst
> +++ b/Documentation/translations/zh_CN/filesystems/index.rst
> @@ -27,3 +27,5 @@ Linux Kernel中的文件系统
> .. toctree::
> :maxdepth: 2
>
> + virtiofs
> +
> diff --git a/Documentation/translations/zh_CN/filesystems/virtiofs.rst b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
> new file mode 100644
> index 000000000000..cd836a9b2ac4
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
> @@ -0,0 +1,61 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +.. raw:: latex
> +
> + \renewcommand\thesection*
> + \renewcommand\thesubsection*
Same note as on the previous patch: please check if this works with
1.7.9 and latest Sphinx versions
Regards,
Mauro
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :ref:`Documentation/filesystems/virtiofs.rst <virtiofs_index>`
> +
> +译者
> +::
> +
> + 中文版维护者： 王文虎 Wang Wenhu <[email protected]>
> + 中文版翻译者： 王文虎 Wang Wenhu <[email protected]>
> + 中文版校译者: 王文虎 Wang Wenhu <[email protected]>
> +
> +===========================================
> +virtiofs: virtio-fs 主机<->客机共享文件系统
> +===========================================
> +
> +- Copyright (C) 2020 Vivo Communication Technology Co. Ltd.
> +
> +介绍
> +====
> +Linux的virtiofs文件系统实现了一个半虚拟化VIRTIO类型“virtio-fs”设备的驱动，通过该\
> +类型设备实现客机<->主机文件系统共享。它允许客机挂载一个已经导出到主机的目录。
> +
> +客机通常需要访问主机或者远程系统上的文件。使用场景包括：在新客机安装时让文件对其\
> +可见；从主机上的根文件系统启动；对无状态或临时客机提供持久存储和在客机之间共享目录。
> +
> +尽管在某些任务可能通过使用已有的网络文件系统完成，但是却需要非常难以自动化的配置\
> +步骤，且将存储网络暴露给客机。而virtio-fs设备通过提供不经过网络的文件系统访问文件\
> +的设计方式解决了这些问题。
> +
> +另外，virto-fs设备发挥了主客机共存的优点提高了性能，并且提供了网络文件系统所不具备
> +的一些语义功能。
> +
> +用法
> +====
> +以``myfs``标签将文件系统挂载到``/mnt``:
> +
> +.. code-block:: sh
> +
> + guest# mount -t virtiofs myfs /mnt
> +
> +请查阅 https://virtio-fs.gitlab.io/ 了解配置QEMU和virtiofsd守护程序的详细信息。
> +
> +内幕
> +====
> +由于virtio-fs设备将FUSE协议用于文件系统请求，因此Linux的virtiofs文件系统与FUSE文\
> +件系统客户端紧密集成在一起。客机充当FUSE客户端而主机充当FUSE服务器，内核与用户空\
> +间之间的/dev/fuse接口由virtio-fs设备接口代替。
> +
> +FUSE请求被置于虚拟队列中由主机处理。主机填充缓冲区中的响应部分，而客机处理请求的完成部分。
> +
> +将/dev/fuse映射到虚拟队列需要解决/dev/fuse和虚拟队列之间语义上的差异。每次读取\
> +/dev/fuse设备时，FUSE客户端都可以选择要传输的请求，从而可以使某些请求优先于其他\
> +请求。虚拟队列有其队列语义，无法更改已入队请求的顺序。在虚拟队列已满的情况下尤
> +其关键，因为此时不可能加入高优先级的请求。为了解决此差异，virtio-fs设备采用“hiprio”\
> +（高优先级）虚拟队列，专门用于有别于普通请求的高优先级请求。
Thanks,
Mauro
Reviewed-by: Alex Shi <[email protected]>
在 2020/3/15 下午11:52, Wang Wenhu 写道:
> Add filesystems subdirectory into the table of Contents for zh_CN,
> all translations residing on it would be indexed conveniently.
>
> Signed-off-by: Wang Wenhu <[email protected]>
> ---
> Changelog:
> - v2 added SPDX header
> ---
> Documentation/filesystems/index.rst | 2 ++
> .../translations/zh_CN/filesystems/index.rst | 29 +++++++++++++++++++
> Documentation/translations/zh_CN/index.rst | 1 +
> 3 files changed, 32 insertions(+)
> create mode 100644 Documentation/translations/zh_CN/filesystems/index.rst
>
> diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst
> index 386eaad008b2..ab47d5b1f092 100644
> --- a/Documentation/filesystems/index.rst
> +++ b/Documentation/filesystems/index.rst
> @@ -1,3 +1,5 @@
> +.. _filesystems_index:
> +
> ===============================
> Filesystems in the Linux kernel
> ===============================
> diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
> new file mode 100644
> index 000000000000..0a2cabfeaf7b
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/filesystems/index.rst
> @@ -0,0 +1,29 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +.. raw:: latex
> +
> + \renewcommand\thesection*
> + \renewcommand\thesubsection*
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :ref:`Documentation/filesystems/index.rst <filesystems_index>`
> +:Translator: Wang Wenhu <[email protected]>
> +
> +.. _cn_filesystems_index:
> +
> +========================
> +Linux Kernel中的文件系统
> +========================
> +
> +这份正在开发的手册或许在未来某个辉煌的日子里以易懂的形式将Linux虚拟\
> +文件系统（VFS）层以及基于其上的各种文件系统如何工作呈现给大家。当前\
> +可以看到下面的内容。
> +
> +文件系统
> +========
> +
> +文件系统实现文档。
> +
> +.. toctree::
> + :maxdepth: 2
> +
> diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
> index d3165535ec9e..76850a5dd982 100644
> --- a/Documentation/translations/zh_CN/index.rst
> +++ b/Documentation/translations/zh_CN/index.rst
> @@ -14,6 +14,7 @@
> :maxdepth: 2
>
> process/index
> + filesystems/index
>
> 目录和表格
> ----------
>
Reviewed-by: Alex Shi <[email protected]>
在 2020/3/15 下午11:52, Wang Wenhu 写道:
> Translate virtiofs.rst in Documentation/filesystems/ into Chinese.
>
> Acked-by: Stefan Hajnoczi <[email protected]>
> Signed-off-by: Wang Wenhu <[email protected]>
> ---
> Changelog v2:
> - add a blank line in the end of index.rst to index virtiofs.rst
> - Asked-by Stefan Hajnoczi
> - added SPDX header and Copyright info
> ---
> Documentation/filesystems/virtiofs.rst | 2 +
> .../translations/zh_CN/filesystems/index.rst | 2 +
> .../zh_CN/filesystems/virtiofs.rst | 61 +++++++++++++++++++
> 3 files changed, 65 insertions(+)
> create mode 100644 Documentation/translations/zh_CN/filesystems/virtiofs.rst
>
> diff --git a/Documentation/filesystems/virtiofs.rst b/Documentation/filesystems/virtiofs.rst
> index 4f338e3cb3f7..7c4301d962f8 100644
> --- a/Documentation/filesystems/virtiofs.rst
> +++ b/Documentation/filesystems/virtiofs.rst
> @@ -1,3 +1,5 @@
> +.. _virtiofs_index:
> +
> .. SPDX-License-Identifier: GPL-2.0
>
> ===================================================
> diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
> index 0a2cabfeaf7b..fd3700a4db6d 100644
> --- a/Documentation/translations/zh_CN/filesystems/index.rst
> +++ b/Documentation/translations/zh_CN/filesystems/index.rst
> @@ -27,3 +27,5 @@ Linux Kernel中的文件系统
> .. toctree::
> :maxdepth: 2
>
> + virtiofs
> +
> diff --git a/Documentation/translations/zh_CN/filesystems/virtiofs.rst b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
> new file mode 100644
> index 000000000000..cd836a9b2ac4
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
> @@ -0,0 +1,61 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +.. raw:: latex
> +
> + \renewcommand\thesection*
> + \renewcommand\thesubsection*
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :ref:`Documentation/filesystems/virtiofs.rst <virtiofs_index>`
> +
> +译者
> +::
> +
> + 中文版维护者： 王文虎 Wang Wenhu <[email protected]>
> + 中文版翻译者： 王文虎 Wang Wenhu <[email protected]>
> + 中文版校译者: 王文虎 Wang Wenhu <[email protected]>
> +
> +===========================================
> +virtiofs: virtio-fs 主机<->客机共享文件系统
> +===========================================
> +
> +- Copyright (C) 2020 Vivo Communication Technology Co. Ltd.
> +
> +介绍
> +====
> +Linux的virtiofs文件系统实现了一个半虚拟化VIRTIO类型“virtio-fs”设备的驱动，通过该\
> +类型设备实现客机<->主机文件系统共享。它允许客机挂载一个已经导出到主机的目录。
> +
> +客机通常需要访问主机或者远程系统上的文件。使用场景包括：在新客机安装时让文件对其\
> +可见；从主机上的根文件系统启动；对无状态或临时客机提供持久存储和在客机之间共享目录。
> +
> +尽管在某些任务可能通过使用已有的网络文件系统完成，但是却需要非常难以自动化的配置\
> +步骤，且将存储网络暴露给客机。而virtio-fs设备通过提供不经过网络的文件系统访问文件\
> +的设计方式解决了这些问题。
> +
> +另外，virto-fs设备发挥了主客机共存的优点提高了性能，并且提供了网络文件系统所不具备
> +的一些语义功能。
> +
> +用法
> +====
> +以``myfs``标签将文件系统挂载到``/mnt``:
> +
> +.. code-block:: sh
> +
> + guest# mount -t virtiofs myfs /mnt
> +
> +请查阅 https://virtio-fs.gitlab.io/ 了解配置QEMU和virtiofsd守护程序的详细信息。
> +
> +内幕
> +====
> +由于virtio-fs设备将FUSE协议用于文件系统请求，因此Linux的virtiofs文件系统与FUSE文\
> +件系统客户端紧密集成在一起。客机充当FUSE客户端而主机充当FUSE服务器，内核与用户空\
> +间之间的/dev/fuse接口由virtio-fs设备接口代替。
> +
> +FUSE请求被置于虚拟队列中由主机处理。主机填充缓冲区中的响应部分，而客机处理请求的完成部分。
> +
> +将/dev/fuse映射到虚拟队列需要解决/dev/fuse和虚拟队列之间语义上的差异。每次读取\
> +/dev/fuse设备时，FUSE客户端都可以选择要传输的请求，从而可以使某些请求优先于其他\
> +请求。虚拟队列有其队列语义，无法更改已入队请求的顺序。在虚拟队列已满的情况下尤
> +其关键，因为此时不可能加入高优先级的请求。为了解决此差异，virtio-fs设备采用“hiprio”\
> +（高优先级）虚拟队列，专门用于有别于普通请求的高优先级请求。
>
Add filesystems subdirectory into the table of Contents for zh_CN,
all translations residing on it would be indexed conveniently.
Reviewed-by: Alex Shi <[email protected]>
Reviewed-by: Mauro Carvalho Chehab <[email protected]>
Signed-off-by: Wang Wenhu <[email protected]>
---
Changelog since v1:
- v2: added SPDX header
- v3: rm raw latex field in translations/zh_CN/filesystems/index.rst
for none compatibility test with Sphinx 1.7.9 or later.
Actually only Sphinx v1.6.7 avalible for me currently.
Reviewed-by labels added
---
Documentation/filesystems/index.rst | 2 ++
.../translations/zh_CN/filesystems/index.rst | 25 +++++++++++++++++++
Documentation/translations/zh_CN/index.rst | 1 +
3 files changed, 28 insertions(+)
create mode 100644 Documentation/translations/zh_CN/filesystems/index.rst
diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst
index 386eaad008b2..ab47d5b1f092 100644
--- a/Documentation/filesystems/index.rst
+++ b/Documentation/filesystems/index.rst
@@ -1,3 +1,5 @@
+.. _filesystems_index:
+
===============================
Filesystems in the Linux kernel
===============================
diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
new file mode 100644
index 000000000000..f5adcdc5fa1c
--- /dev/null
+++ b/Documentation/translations/zh_CN/filesystems/index.rst
@@ -0,0 +1,25 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/filesystems/index.rst <filesystems_index>`
+:Translator: Wang Wenhu <[email protected]>
+
+.. _cn_filesystems_index:
+
+========================
+Linux Kernel中的文件系统
+========================
+
+这份正在开发的手册或许在未来某个辉煌的日子里以易懂的形式将Linux虚拟\
+文件系统（VFS）层以及基于其上的各种文件系统如何工作呈现给大家。当前\
+可以看到下面的内容。
+
+文件系统
+========
+
+文件系统实现文档。
+
+.. toctree::
+ :maxdepth: 2
+
diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst
index d3165535ec9e..76850a5dd982 100644
--- a/Documentation/translations/zh_CN/index.rst
+++ b/Documentation/translations/zh_CN/index.rst
@@ -14,6 +14,7 @@
:maxdepth: 2
process/index
+ filesystems/index
目录和表格
----------
--
2.17.1
On Mon, 16 Mar 2020 04:01:31 -0700
Wang Wenhu <[email protected]> wrote:
> Add filesystems subdirectory into the table of Contents for zh_CN,
> all translations residing on it would be indexed conveniently.
>
> Reviewed-by: Alex Shi <[email protected]>
> Reviewed-by: Mauro Carvalho Chehab <[email protected]>
> Signed-off-by: Wang Wenhu <[email protected]>
> ---
> Changelog since v1:
> - v2: added SPDX header
> - v3: rm raw latex field in translations/zh_CN/filesystems/index.rst
> for none compatibility test with Sphinx 1.7.9 or later.
> Actually only Sphinx v1.6.7 avalible for me currently.
> Reviewed-by labels added
Both patches applied, thanks.
jon