[PATCH V4 DOC] doc: zh_CN: add translatation for tmpfs

[PATCH V4 DOC] doc: zh_CN: add translatation for tmpfs

[Wang Qing]

Translate Documentation/filesystems/tmpfs.rst into Chinese.

Signed-off-by: Wang Qing <wangqing@vivo.com>

Changes in v4:
 - Modify as Alex required.
 
Changes in v3:
 - Fix patch format issue.
---
 .../translations/zh_CN/filesystems/tmpfs.rst       | 146 +++++++++++++++++++++
 1 file changed, 146 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/filesystems/tmpfs.rst

diff --git a/Documentation/translations/zh_CN/filesystems/tmpfs.rst b/Documentation/translations/zh_CN/filesystems/tmpfs.rst
new file mode 100644
index 0000000..28f0d09
--- /dev/null
+++ b/Documentation/translations/zh_CN/filesystems/tmpfs.rst
@@ -0,0 +1,146 @@
+.. SPDX-License-Identifier: GPL-2.0
+
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/filesystems/tmpfs.rst <tmpfs_index>`
+
+translated by Wang Qing<wangqing@vivo.com>
+
+=====
+Tmpfs
+=====
+
+Tmpfs是一个将所有文件都保存在虚拟内存中的文件系统。
+
+tmpfs中的所有内容都是临时的，也就是说没有任何文件会在硬盘上创建。
+如果卸载tmpfs实例，所有保存在其中的文件都会丢失。
+
+tmpfs将所有文件保存在内核缓存中，随着文件内容增长或缩小可以将不需要的
+页面swap出去。它具有最大限制，可以通过“mount -o remount ...”调整。
+
+和ramfs（创建tmpfs的模板）相比，tmpfs包含交换和限制检查。和tmpfs相似的另
+一个东西是RAM磁盘（/dev/ram*），可以在物理RAM中模拟固定大小的硬盘，并在
+此之上创建一个普通的文件系统。Ramdisks无法swap，因此无法调整它们的大小。
+
+由于tmpfs完全保存于页面缓存和swap中，因此所有tmpfs页面将在/proc/meminfo
+中显示为“Shmem”，而在free(1)中显示为“Shared”。请注意，这些计数还包括
+共享内存(shmem，请参阅ipcs(1))。获得计数的最可靠方法是使用df(1)和du(1)。
+
+tmpfs具有以下用途：
+
+1) 内核总有一个无法看到的内部挂载，用于共享匿名映射和SYSV共享内存。
+
+   挂载不依赖于CONFIG_TMPFS。如果CONFIG_TMPFS未设置，tmpfs对用户不可见。
+   但是内部机制始终存在。
+
+2) glibc 2.2及更高版本期望将tmpfs挂载在/dev/shm上以用于POSIX共享内存
+   (shm_open，shm_unlink)。添加内容到/etc/fstab应注意如下：
+
+	tmpfs	/dev/shm	tmpfs	defaults	0 0
+
+   使用时需要记住创建挂载tmpfs的目录。
+
+   SYSV共享内存无需挂载，内部已默认支持。(在2.3内核版本中，必须挂载
+   tmpfs的前身(shm fs)才能使用SYSV共享内存)
+
+3) 很多人（包括我）都觉的在/tmp和/var/tmp上挂载非常方便，并具有较大的
+   swap分区。目前循环挂载tmpfs可以正常工作，所以大多数发布都应当可以
+   使用mkinitrd通过/tmp访问/tmp。
+
+4) 也许还有更多我不知道的地方:-)
+
+
+tmpfs有三个用于调整大小的挂载选项：
+
+=========  ===========================================================
+size       tmpfs实例分配的字节数限制。默认值是不swap时物理RAM的一半。
+           如果tmpfs实例过大，机器将死锁，因为OOM处理将无法释放该内存。
+nr_blocks  与size相同，但以PAGE_SIZE为单位。
+nr_inodes  tmpfs实例的最大inode个数。默认值是物理内存页数的一半，或者
+           (有高端内存的机器)低端内存RAM的页数，二者以较低者为准。
+=========  ===========================================================
+
+这些参数接受后缀k，m或g表示千，兆和千兆字节，可以在remount时更改。
+size参数也接受后缀％用来限制tmpfs实例占用物理RAM的百分比：
+未指定size或nr_blocks时，默认值为size=50％
+
+如果nr_blocks=0（或size=0），block个数将不受限制；如果nr_inodes=0，
+inode个数将不受限制。这样挂载通常是不明智的，因为它允许任何具有写权限的
+用户通过访问tmpfs耗尽机器上的所有内存；但同时这样做也会增强在多个CPU的
+场景下的访问。
+
+tmpfs具有为所有文件设置NUMA内存分配策略挂载选项(如果启用了CONFIG_NUMA),
+可以通过“mount -o remount ...”调整
+
+======================== =========================
+mpol=default             采用进程分配策略
+                         (请参阅 set_mempolicy(2))
+mpol=prefer:Node         倾向从给定的节点分配
+mpol=bind:NodeList       只允许从指定的链表分配
+mpol=interleave          倾向于依次从每个节点分配
+mpol=interleave:NodeList 依次从每个节点分配
+mpol=local               优先本地节点分配内存
+======================== =========================
+
+NodeList格式是以逗号分隔的十进制数字表示大小和范围，最大和最小范围是用-
+分隔符的十进制数来表示。例如，mpol=bind0-3,5,7,9-15
+
+带有有效NodeList的内存策略将按指定格式保存，在创建文件时使用。当任务在该
+文件系统上创建文件时，会使用到挂载时的内存策略NodeList选项，如果设置的话，
+由调用任务的cpuset[请参见Documentation/admin-guide/cgroup-v1/cpusets.rst]
+以及下面列出的可选标志约束。如果NodeLists为设置为空集，则文件的内存策略将
+恢复为“默认”策略。
+
+NUMA内存分配策略有可选标志，可以用于模式结合。在挂载tmpfs时指定这些可选
+标志可以在NodeList之前生效。
+Documentation/admin-guide/mm/numa_memory_policy.rst列出所有可用的内存
+分配策略模式标志及其对内存策略。
+
+::
+
+	=static		相当于	MPOL_F_STATIC_NODES
+	=relative	相当于	MPOL_F_RELATIVE_NODES
+
+例如，mpol=bind=staticNodeList相当于MPOL_BIND|MPOL_F_STATIC_NODES的分配策略
+
+请注意，如果内核不支持NUMA，那么使用mpol选项挂载tmpfs将会失败；nodelist指定不
+在线的节点也会失败。如果您的系统依赖于此，但内核会运行不带NUMA功能(也许是安全
+revocery内核)，或者具有较少的节点在线，建议从自动模式中省略mpol选项挂载选项。
+可以在以后通过“mount -o remount,mpol=Policy:NodeList MountPoint”添加到挂载点。
+
+要指定初始根目录，可以使用如下挂载选项：
+
+====	====================
+模式	权限用八进制数字表示
+uid	用户ID
+gid	组ID
+====	====================
+
+这些选项对remount没有任何影响。您可以通过chmod(1),chown(1)和chgrp(1)的更改
+已经挂载的参数。
+
+tmpfs具有选择32位还是64位inode的挂载选项：
+
+=======   =============
+inode64   使用64位inode
+inode32   使用32位inode
+=======   =============
+
+在32位内核上，默认是inode32，挂载时指定inode64会被拒绝。
+在64位内核上，默认配置是CONFIG_TMPFS_INODE64。inode64避免了单个设备上可能有多个
+具有相同inode编号的文件；比如32位应用程序使用glibc如果长期访问tmpfs，一旦达到33
+位inode编号，就有EOVERFLOW失败的危险，无法打开大于2GiB的文件，并返回EINVAL。
+
+所以'mount -t tmpfs -o size=10G,nr_inodes=10k,mode=700 tmpfs /mytmpfs'将在
+/mytmpfs上挂载tmpfs实例，分配只能由root用户访问的10GB RAM/SWAP，可以有10240个
+inode的实例。
+
+
+:作者:
+   Christoph Rohland <cr@sap.com>, 1.12.01
+:更新:
+   Hugh Dickins, 4 June 2007
+:更新:
+   KOSAKI Motohiro, 16 Mar 2010
+:更新:
+   Chris Down, 13 July 2020
-- 
2.7.4

Re: [PATCH V4 DOC] doc: zh_CN: add translatation for tmpfs

[Alex Shi]

Thanks Qing!

Reviewed-by: Alex Shi <alex.shi@linux.alibaba.com>


在 2020/11/9 上午9:57, Wang Qing 写道:
> Translate Documentation/filesystems/tmpfs.rst into Chinese.
> 
> Signed-off-by: Wang Qing <wangqing@vivo.com>
> 
> Changes in v4:
>  - Modify as Alex required.
>  
> Changes in v3:
>  - Fix patch format issue.
> ---
>  .../translations/zh_CN/filesystems/tmpfs.rst       | 146 +++++++++++++++++++++
>  1 file changed, 146 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/filesystems/tmpfs.rst
> 
> diff --git a/Documentation/translations/zh_CN/filesystems/tmpfs.rst b/Documentation/translations/zh_CN/filesystems/tmpfs.rst
> new file mode 100644
> index 0000000..28f0d09
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/filesystems/tmpfs.rst
> @@ -0,0 +1,146 @@
> +.. SPDX-License-Identifier: GPL-2.0
> +
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :ref:`Documentation/filesystems/tmpfs.rst <tmpfs_index>`
> +
> +translated by Wang Qing<wangqing@vivo.com>
> +
> +=====
> +Tmpfs
> +=====
> +
> +Tmpfs是一个将所有文件都保存在虚拟内存中的文件系统。
> +
> +tmpfs中的所有内容都是临时的，也就是说没有任何文件会在硬盘上创建。
> +如果卸载tmpfs实例，所有保存在其中的文件都会丢失。
> +
> +tmpfs将所有文件保存在内核缓存中，随着文件内容增长或缩小可以将不需要的
> +页面swap出去。它具有最大限制，可以通过“mount -o remount ...”调整。
> +
> +和ramfs（创建tmpfs的模板）相比，tmpfs包含交换和限制检查。和tmpfs相似的另
> +一个东西是RAM磁盘（/dev/ram*），可以在物理RAM中模拟固定大小的硬盘，并在
> +此之上创建一个普通的文件系统。Ramdisks无法swap，因此无法调整它们的大小。
> +
> +由于tmpfs完全保存于页面缓存和swap中，因此所有tmpfs页面将在/proc/meminfo
> +中显示为“Shmem”，而在free(1)中显示为“Shared”。请注意，这些计数还包括
> +共享内存(shmem，请参阅ipcs(1))。获得计数的最可靠方法是使用df(1)和du(1)。
> +
> +tmpfs具有以下用途：
> +
> +1) 内核总有一个无法看到的内部挂载，用于共享匿名映射和SYSV共享内存。
> +
> +   挂载不依赖于CONFIG_TMPFS。如果CONFIG_TMPFS未设置，tmpfs对用户不可见。
> +   但是内部机制始终存在。
> +
> +2) glibc 2.2及更高版本期望将tmpfs挂载在/dev/shm上以用于POSIX共享内存
> +   (shm_open，shm_unlink)。添加内容到/etc/fstab应注意如下：
> +
> +	tmpfs	/dev/shm	tmpfs	defaults	0 0
> +
> +   使用时需要记住创建挂载tmpfs的目录。
> +
> +   SYSV共享内存无需挂载，内部已默认支持。(在2.3内核版本中，必须挂载
> +   tmpfs的前身(shm fs)才能使用SYSV共享内存)
> +
> +3) 很多人（包括我）都觉的在/tmp和/var/tmp上挂载非常方便，并具有较大的
> +   swap分区。目前循环挂载tmpfs可以正常工作，所以大多数发布都应当可以
> +   使用mkinitrd通过/tmp访问/tmp。
> +
> +4) 也许还有更多我不知道的地方:-)
> +
> +
> +tmpfs有三个用于调整大小的挂载选项：
> +
> +=========  ===========================================================
> +size       tmpfs实例分配的字节数限制。默认值是不swap时物理RAM的一半。
> +           如果tmpfs实例过大，机器将死锁，因为OOM处理将无法释放该内存。
> +nr_blocks  与size相同，但以PAGE_SIZE为单位。
> +nr_inodes  tmpfs实例的最大inode个数。默认值是物理内存页数的一半，或者
> +           (有高端内存的机器)低端内存RAM的页数，二者以较低者为准。
> +=========  ===========================================================
> +
> +这些参数接受后缀k，m或g表示千，兆和千兆字节，可以在remount时更改。
> +size参数也接受后缀％用来限制tmpfs实例占用物理RAM的百分比：
> +未指定size或nr_blocks时，默认值为size=50％
> +
> +如果nr_blocks=0（或size=0），block个数将不受限制；如果nr_inodes=0，
> +inode个数将不受限制。这样挂载通常是不明智的，因为它允许任何具有写权限的
> +用户通过访问tmpfs耗尽机器上的所有内存；但同时这样做也会增强在多个CPU的
> +场景下的访问。
> +
> +tmpfs具有为所有文件设置NUMA内存分配策略挂载选项(如果启用了CONFIG_NUMA),
> +可以通过“mount -o remount ...”调整
> +
> +======================== =========================
> +mpol=default             采用进程分配策略
> +                         (请参阅 set_mempolicy(2))
> +mpol=prefer:Node         倾向从给定的节点分配
> +mpol=bind:NodeList       只允许从指定的链表分配
> +mpol=interleave          倾向于依次从每个节点分配
> +mpol=interleave:NodeList 依次从每个节点分配
> +mpol=local               优先本地节点分配内存
> +======================== =========================
> +
> +NodeList格式是以逗号分隔的十进制数字表示大小和范围，最大和最小范围是用-
> +分隔符的十进制数来表示。例如，mpol=bind0-3,5,7,9-15
> +
> +带有有效NodeList的内存策略将按指定格式保存，在创建文件时使用。当任务在该
> +文件系统上创建文件时，会使用到挂载时的内存策略NodeList选项，如果设置的话，
> +由调用任务的cpuset[请参见Documentation/admin-guide/cgroup-v1/cpusets.rst]
> +以及下面列出的可选标志约束。如果NodeLists为设置为空集，则文件的内存策略将
> +恢复为“默认”策略。
> +
> +NUMA内存分配策略有可选标志，可以用于模式结合。在挂载tmpfs时指定这些可选
> +标志可以在NodeList之前生效。
> +Documentation/admin-guide/mm/numa_memory_policy.rst列出所有可用的内存
> +分配策略模式标志及其对内存策略。
> +
> +::
> +
> +	=static		相当于	MPOL_F_STATIC_NODES
> +	=relative	相当于	MPOL_F_RELATIVE_NODES
> +
> +例如，mpol=bind=staticNodeList相当于MPOL_BIND|MPOL_F_STATIC_NODES的分配策略
> +
> +请注意，如果内核不支持NUMA，那么使用mpol选项挂载tmpfs将会失败；nodelist指定不
> +在线的节点也会失败。如果您的系统依赖于此，但内核会运行不带NUMA功能(也许是安全
> +revocery内核)，或者具有较少的节点在线，建议从自动模式中省略mpol选项挂载选项。
> +可以在以后通过“mount -o remount,mpol=Policy:NodeList MountPoint”添加到挂载点。
> +
> +要指定初始根目录，可以使用如下挂载选项：
> +
> +====	====================
> +模式	权限用八进制数字表示
> +uid	用户ID
> +gid	组ID
> +====	====================
> +
> +这些选项对remount没有任何影响。您可以通过chmod(1),chown(1)和chgrp(1)的更改
> +已经挂载的参数。
> +
> +tmpfs具有选择32位还是64位inode的挂载选项：
> +
> +=======   =============
> +inode64   使用64位inode
> +inode32   使用32位inode
> +=======   =============
> +
> +在32位内核上，默认是inode32，挂载时指定inode64会被拒绝。
> +在64位内核上，默认配置是CONFIG_TMPFS_INODE64。inode64避免了单个设备上可能有多个
> +具有相同inode编号的文件；比如32位应用程序使用glibc如果长期访问tmpfs，一旦达到33
> +位inode编号，就有EOVERFLOW失败的危险，无法打开大于2GiB的文件，并返回EINVAL。
> +
> +所以'mount -t tmpfs -o size=10G,nr_inodes=10k,mode=700 tmpfs /mytmpfs'将在
> +/mytmpfs上挂载tmpfs实例，分配只能由root用户访问的10GB RAM/SWAP，可以有10240个
> +inode的实例。
> +
> +
> +:作者:
> +   Christoph Rohland <cr@sap.com>, 1.12.01
> +:更新:
> +   Hugh Dickins, 4 June 2007
> +:更新:
> +   KOSAKI Motohiro, 16 Mar 2010
> +:更新:
> +   Chris Down, 13 July 2020
> 

Re: [PATCH V4 DOC] doc: zh_CN: add translatation for tmpfs

[Jonathan Corbet]

On Mon,  9 Nov 2020 09:57:47 +0800
Wang Qing <wangqing@vivo.com> wrote:

> Translate Documentation/filesystems/tmpfs.rst into Chinese.
> 
> Signed-off-by: Wang Qing <wangqing@vivo.com>
> 
> Changes in v4:
>  - Modify as Alex required.
>  
> Changes in v3:
>  - Fix patch format issue.
> ---
>  .../translations/zh_CN/filesystems/tmpfs.rst       | 146 +++++++++++++++++++++
>  1 file changed, 146 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/filesystems/tmpfs.rst

Applied, thanks.

jon