* [PATCH v2,2/2] doc: zh_CN: add translation for virtiofs
2020-03-15 15:52 ` [PATCH v2,1/2] doc: zh_CN: index files in filesystems subdirectory Wang Wenhu
@ 2020-03-15 15:52 ` Wang Wenhu
2020-03-16 7:01 ` Mauro Carvalho Chehab
2020-03-16 7:44 ` Alex Shi
2020-03-16 6:57 ` [PATCH v2,1/2] doc: zh_CN: index files in filesystems subdirectory Mauro Carvalho Chehab
` (2 subsequent siblings)
3 siblings, 2 replies; 16+ messages in thread
From: Wang Wenhu @ 2020-03-15 15:52 UTC (permalink / raw)
To: Jonathan Corbet, Vivek Goyal, Stefan Hajnoczi, Miklos Szeredi,
Harry Wei, Alex Shi, Mauro Carvalho Chehab, Daniel W. S. Almeida,
Christian Brauner, Wang Wenhu, Eric Biggers,
Matthew Wilcox (Oracle),
linux-doc, linux-kernel, virtualization, linux-fsdevel
Cc: kernel
Translate virtiofs.rst in Documentation/filesystems/ into Chinese.
Acked-by: Stefan Hajnoczi <stefanha@redhat.com>
Signed-off-by: Wang Wenhu <wenhu.wang@vivo.com>
---
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 <wenhu.wang@vivo.com>
+ 中文版翻译者： 王文虎 Wang Wenhu <wenhu.wang@vivo.com>
+ 中文版校译者: 王文虎 Wang Wenhu <wenhu.wang@vivo.com>
+
+===========================================
+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
^ permalink raw reply related [flat|nested] 16+ messages in thread* Re: [PATCH v2,2/2] doc: zh_CN: add translation for virtiofs
2020-03-15 15:52 ` [PATCH v2,2/2] doc: zh_CN: add translation for virtiofs Wang Wenhu
@ 2020-03-16 7:01 ` Mauro Carvalho Chehab
2020-03-16 7:44 ` Alex Shi
1 sibling, 0 replies; 16+ messages in thread
From: Mauro Carvalho Chehab @ 2020-03-16 7:01 UTC (permalink / raw)
To: Wang Wenhu, linux-doc, linux-kernel
Cc: Jonathan Corbet, Vivek Goyal, Stefan Hajnoczi, Miklos Szeredi,
Harry Wei, Alex Shi, Daniel W. S. Almeida, Christian Brauner,
Eric Biggers, Matthew Wilcox (Oracle),
virtualization, linux-fsdevel, kernel
Em Sun, 15 Mar 2020 08:52:39 -0700
Wang Wenhu <wenhu.wang@vivo.com> escreveu:
> Translate virtiofs.rst in Documentation/filesystems/ into Chinese.
>
> Acked-by: Stefan Hajnoczi <stefanha@redhat.com>
> Signed-off-by: Wang Wenhu <wenhu.wang@vivo.com>
> ---
> 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 <mchehab+huawei@kernel.org>
(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 <wenhu.wang@vivo.com>
> + 中文版翻译者： 王文虎 Wang Wenhu <wenhu.wang@vivo.com>
> + 中文版校译者: 王文虎 Wang Wenhu <wenhu.wang@vivo.com>
> +
> +===========================================
> +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
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH v2,2/2] doc: zh_CN: add translation for virtiofs
2020-03-15 15:52 ` [PATCH v2,2/2] doc: zh_CN: add translation for virtiofs Wang Wenhu
2020-03-16 7:01 ` Mauro Carvalho Chehab
@ 2020-03-16 7:44 ` Alex Shi
1 sibling, 0 replies; 16+ messages in thread
From: Alex Shi @ 2020-03-16 7:44 UTC (permalink / raw)
To: Wang Wenhu, Jonathan Corbet, Vivek Goyal, Stefan Hajnoczi,
Miklos Szeredi, Harry Wei, Mauro Carvalho Chehab,
Daniel W. S. Almeida, Christian Brauner, Eric Biggers,
Matthew Wilcox (Oracle),
linux-doc, linux-kernel, virtualization, linux-fsdevel
Cc: kernel
Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
在 2020/3/15 下午11:52, Wang Wenhu 写道:
> Translate virtiofs.rst in Documentation/filesystems/ into Chinese.
>
> Acked-by: Stefan Hajnoczi <stefanha@redhat.com>
> Signed-off-by: Wang Wenhu <wenhu.wang@vivo.com>
> ---
> 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 <wenhu.wang@vivo.com>
> + 中文版翻译者： 王文虎 Wang Wenhu <wenhu.wang@vivo.com>
> + 中文版校译者: 王文虎 Wang Wenhu <wenhu.wang@vivo.com>
> +
> +===========================================
> +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”\
> +（高优先级）虚拟队列，专门用于有别于普通请求的高优先级请求。
>
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH v2,1/2] doc: zh_CN: index files in filesystems subdirectory
2020-03-15 15:52 ` [PATCH v2,1/2] doc: zh_CN: index files in filesystems subdirectory Wang Wenhu
2020-03-15 15:52 ` [PATCH v2,2/2] doc: zh_CN: add translation for virtiofs Wang Wenhu
@ 2020-03-16 6:57 ` Mauro Carvalho Chehab
2020-03-16 7:44 ` Alex Shi
2020-03-16 11:01 ` [PATCH v3,1/2] " Wang Wenhu
3 siblings, 0 replies; 16+ messages in thread
From: Mauro Carvalho Chehab @ 2020-03-16 6:57 UTC (permalink / raw)
To: Wang Wenhu
Cc: Jonathan Corbet, Vivek Goyal, Stefan Hajnoczi, Miklos Szeredi,
Harry Wei, Alex Shi, Daniel W. S. Almeida, Eric Biggers,
Jaskaran Singh, Matthew Wilcox (Oracle),
linux-doc, linux-kernel, virtualization, linux-fsdevel, kernel
Em Sun, 15 Mar 2020 08:52:38 -0700
Wang Wenhu <wenhu.wang@vivo.com> 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 <wenhu.wang@vivo.com>
> ---
> 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 <mchehab+huawei@kernel.org>
Regards,
Mauro
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :ref:`Documentation/filesystems/index.rst <filesystems_index>`
> +:Translator: Wang Wenhu <wenhu.wang@vivo.com>
> +
> +.. _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
^ permalink raw reply [flat|nested] 16+ messages in thread
* Re: [PATCH v2,1/2] doc: zh_CN: index files in filesystems subdirectory
2020-03-15 15:52 ` [PATCH v2,1/2] doc: zh_CN: index files in filesystems subdirectory Wang Wenhu
2020-03-15 15:52 ` [PATCH v2,2/2] doc: zh_CN: add translation for virtiofs Wang Wenhu
2020-03-16 6:57 ` [PATCH v2,1/2] doc: zh_CN: index files in filesystems subdirectory Mauro Carvalho Chehab
@ 2020-03-16 7:44 ` Alex Shi
2020-03-16 11:01 ` [PATCH v3,1/2] " Wang Wenhu
3 siblings, 0 replies; 16+ messages in thread
From: Alex Shi @ 2020-03-16 7:44 UTC (permalink / raw)
To: Wang Wenhu, Jonathan Corbet, Vivek Goyal, Stefan Hajnoczi,
Miklos Szeredi, Harry Wei, Mauro Carvalho Chehab,
Daniel W. S. Almeida, Eric Biggers, Jaskaran Singh,
Matthew Wilcox (Oracle),
linux-doc, linux-kernel, virtualization, linux-fsdevel
Cc: kernel
Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
在 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 <wenhu.wang@vivo.com>
> ---
> 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 <wenhu.wang@vivo.com>
> +
> +.. _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
>
> 目录和表格
> ----------
>
^ permalink raw reply [flat|nested] 16+ messages in thread
* [PATCH v3,1/2] doc: zh_CN: index files in filesystems subdirectory
2020-03-15 15:52 ` [PATCH v2,1/2] doc: zh_CN: index files in filesystems subdirectory Wang Wenhu
` (2 preceding siblings ...)
2020-03-16 7:44 ` Alex Shi
@ 2020-03-16 11:01 ` Wang Wenhu
2020-03-16 11:01 ` [PATCH v3,2/2] doc: zh_CN: add translation for virtiofs Wang Wenhu
2020-03-20 23:19 ` [PATCH v3,1/2] doc: zh_CN: index files in filesystems subdirectory Jonathan Corbet
3 siblings, 2 replies; 16+ messages in thread
From: Wang Wenhu @ 2020-03-16 11:01 UTC (permalink / raw)
To: Jonathan Corbet, Vivek Goyal, Stefan Hajnoczi, Miklos Szeredi,
Harry Wei, Alex Shi, Mauro Carvalho Chehab, Daniel W. S. Almeida,
Matthew Wilcox (Oracle),
Jaskaran Singh, Tobin C. Harding, Wang Wenhu, linux-doc,
linux-kernel, virtualization, linux-fsdevel
Cc: kernel
Add filesystems subdirectory into the table of Contents for zh_CN,
all translations residing on it would be indexed conveniently.
Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Wang Wenhu <wenhu.wang@vivo.com>
---
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 <wenhu.wang@vivo.com>
+
+.. _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
^ permalink raw reply related [flat|nested] 16+ messages in thread* [PATCH v3,2/2] doc: zh_CN: add translation for virtiofs
2020-03-16 11:01 ` [PATCH v3,1/2] " Wang Wenhu
@ 2020-03-16 11:01 ` Wang Wenhu
2020-03-20 23:19 ` [PATCH v3,1/2] doc: zh_CN: index files in filesystems subdirectory Jonathan Corbet
1 sibling, 0 replies; 16+ messages in thread
From: Wang Wenhu @ 2020-03-16 11:01 UTC (permalink / raw)
To: Jonathan Corbet, Vivek Goyal, Stefan Hajnoczi, Miklos Szeredi,
Harry Wei, Alex Shi, Mauro Carvalho Chehab, Daniel W. S. Almeida,
Christian Brauner, Jaskaran Singh, Wang Wenhu,
Matthew Wilcox (Oracle),
linux-doc, linux-kernel, virtualization, linux-fsdevel
Cc: kernel
Translate virtiofs.rst in Documentation/filesystems/ into Chinese.
Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>
Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Acked-by: Stefan Hajnoczi <stefanha@redhat.com>
Signed-off-by: Wang Wenhu <wenhu.wang@vivo.com>
---
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
v3:
- rm raw latex field in translations/zh_CN/filesystems/index.rst
for none compatibility test with Sphinx 1.7.9 or later(only v1.6.7 avalible for me now).
- mv SPDX-License-Identifier to the top
- Reviewed-by labels added
---
Documentation/filesystems/virtiofs.rst | 2 +
.../translations/zh_CN/filesystems/index.rst | 2 +
.../zh_CN/filesystems/virtiofs.rst | 58 +++++++++++++++++++
3 files changed, 62 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..e06e4951cb39 100644
--- a/Documentation/filesystems/virtiofs.rst
+++ b/Documentation/filesystems/virtiofs.rst
@@ -1,5 +1,7 @@
.. SPDX-License-Identifier: GPL-2.0
+.. _virtiofs_index:
+
===================================================
virtiofs: virtio-fs host<->guest shared file system
===================================================
diff --git a/Documentation/translations/zh_CN/filesystems/index.rst b/Documentation/translations/zh_CN/filesystems/index.rst
index f5adcdc5fa1c..14f155edaf69 100644
--- a/Documentation/translations/zh_CN/filesystems/index.rst
+++ b/Documentation/translations/zh_CN/filesystems/index.rst
@@ -23,3 +23,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..09bc9e012e2a
--- /dev/null
+++ b/Documentation/translations/zh_CN/filesystems/virtiofs.rst
@@ -0,0 +1,58 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/filesystems/virtiofs.rst <virtiofs_index>`
+
+译者
+::
+
+ 中文版维护者： 王文虎 Wang Wenhu <wenhu.wang@vivo.com>
+ 中文版翻译者： 王文虎 Wang Wenhu <wenhu.wang@vivo.com>
+ 中文版校译者： 王文虎 Wang Wenhu <wenhu.wang@vivo.com>
+
+===========================================
+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
^ permalink raw reply related [flat|nested] 16+ messages in thread* Re: [PATCH v3,1/2] doc: zh_CN: index files in filesystems subdirectory
2020-03-16 11:01 ` [PATCH v3,1/2] " Wang Wenhu
2020-03-16 11:01 ` [PATCH v3,2/2] doc: zh_CN: add translation for virtiofs Wang Wenhu
@ 2020-03-20 23:19 ` Jonathan Corbet
1 sibling, 0 replies; 16+ messages in thread
From: Jonathan Corbet @ 2020-03-20 23:19 UTC (permalink / raw)
To: Wang Wenhu
Cc: Vivek Goyal, Stefan Hajnoczi, Miklos Szeredi, Harry Wei,
Alex Shi, Mauro Carvalho Chehab, Daniel W. S. Almeida,
Matthew Wilcox (Oracle),
Jaskaran Singh, Tobin C. Harding, linux-doc, linux-kernel,
virtualization, linux-fsdevel, kernel
On Mon, 16 Mar 2020 04:01:31 -0700
Wang Wenhu <wenhu.wang@vivo.com> 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 <alex.shi@linux.alibaba.com>
> Reviewed-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
> Signed-off-by: Wang Wenhu <wenhu.wang@vivo.com>
> ---
> 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
^ permalink raw reply [flat|nested] 16+ messages in thread