linux-doc.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] Documentation: Chinese translation of Documentation/arm64/hugetlbpage.rst
@ 2020-09-26 10:18 Bailu Lin
  2020-10-13 12:36 ` [PATCH v2] " Bailu Lin
  0 siblings, 1 reply; 6+ messages in thread
From: Bailu Lin @ 2020-09-26 10:18 UTC (permalink / raw)
  To: Catalin Marinas, Will Deacon, Jonathan Corbet, Harry Wei,
	Alex Shi, Bailu Lin, linux-arm-kernel, linux-doc, linux-kernel
  Cc: kernel

This is a Chinese translated version of 
 Documentation/arm64/hugetlbpage.rst

Signed-off-by: Bailu Lin <bailu.lin@vivo.com>
---
 Documentation/arm64/hugetlbpage.rst           |  2 +
 .../translations/zh_CN/arm64/hugetlbpage.rst  | 45 +++++++++++++++++++
 .../translations/zh_CN/arm64/index.rst        |  1 +
 3 files changed, 48 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/arm64/hugetlbpage.rst

diff --git a/Documentation/arm64/hugetlbpage.rst b/Documentation/arm64/hugetlbpage.rst
index b44f939e5210..a110124c11e3 100644
--- a/Documentation/arm64/hugetlbpage.rst
+++ b/Documentation/arm64/hugetlbpage.rst
@@ -1,3 +1,5 @@
+.. _hugetlbpage_index:
+
 ====================
 HugeTLBpage on ARM64
 ====================
diff --git a/Documentation/translations/zh_CN/arm64/hugetlbpage.rst b/Documentation/translations/zh_CN/arm64/hugetlbpage.rst
new file mode 100644
index 000000000000..64b3b00ea851
--- /dev/null
+++ b/Documentation/translations/zh_CN/arm64/hugetlbpage.rst
@@ -0,0 +1,45 @@
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/arm64/hugetlbpage.rst <hugetlbpage_index>`
+
+Translator: Bailu Lin <bailu.lin@vivo.com>
+
+=====================
+ARM64中的 HugeTLBpage
+=====================
+
+大页依靠有效利用 TLBs 来提高地址翻译的性能。这取决于以下
+两点 -
+
+  - 大页的大小
+  - TLBs 支持的条目大小
+
+ARM64 接口支持2种大页方式。
+
+1) pud/pmd 级别的块映射
+---------------------
+
+这是常规大页,他们的 pmd 或 pud 页面表条目指向一个内存块。
+不管 TLB 中支持的条目大小如何,块映射可以减少翻译大页地址
+所需遍历的页表深度。
+
+2) 使用连续位
+-------------
+
+架构中转换页表条目(D4.5.3, ARM DDI 0487C.a)中提供一个连续
+位告诉 MMU 这个条目是一个连续条目集的一员,它可以被缓存在单
+个 TLB 条目中。
+
+在 Linux 中连续位用来增加 pmd 和 pte(最后一级)级别映射的大
+小。受支持的连续页表条目数量因页面大小和页表级别而异。
+
+
+支持以下大页大小配置 -
+
+  ====== ========   ====    ========    ===
+  -      CONT PTE    PMD    CONT PMD    PUD
+  ====== ========   ====    ========    ===
+  4K:         64K     2M         32M     1G
+  16K:         2M    32M          1G
+  64K:         2M   512M         16G
+  ====== ========   ====    ========    ===
diff --git a/Documentation/translations/zh_CN/arm64/index.rst b/Documentation/translations/zh_CN/arm64/index.rst
index 646ed1f7aea3..e31a6090384d 100644
--- a/Documentation/translations/zh_CN/arm64/index.rst
+++ b/Documentation/translations/zh_CN/arm64/index.rst
@@ -14,3 +14,4 @@ ARM64 架构
     :maxdepth: 2
 
     amu
+    hugetlbpage
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 6+ messages in thread

* [PATCH v2] Documentation: Chinese translation of Documentation/arm64/hugetlbpage.rst
  2020-09-26 10:18 [PATCH] Documentation: Chinese translation of Documentation/arm64/hugetlbpage.rst Bailu Lin
@ 2020-10-13 12:36 ` Bailu Lin
  2020-10-14  0:42   ` Alex Shi
  0 siblings, 1 reply; 6+ messages in thread
From: Bailu Lin @ 2020-10-13 12:36 UTC (permalink / raw)
  To: alex.shi, catalin.marinas, corbet, harryxiyou, linux-arm-kernel,
	linux-doc, linux-kernel, will
  Cc: bailu.lin, kernel

This is a Chinese translated version of
 Documentation/arm64/hugetlbpage.rst

Signed-off-by: Bailu Lin <bailu.lin@vivo.com>
---
Changes in v2:
 - Fix Sphinx 2.4.4's waring by increasing underline' size.
---
 Documentation/arm64/hugetlbpage.rst           |  2 +
 .../translations/zh_CN/arm64/hugetlbpage.rst  | 45 +++++++++++++++++++
 .../translations/zh_CN/arm64/index.rst        |  1 +
 3 files changed, 48 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/arm64/hugetlbpage.rst

diff --git a/Documentation/arm64/hugetlbpage.rst b/Documentation/arm64/hugetlbpage.rst
index b44f939e5210..a110124c11e3 100644
--- a/Documentation/arm64/hugetlbpage.rst
+++ b/Documentation/arm64/hugetlbpage.rst
@@ -1,3 +1,5 @@
+.. _hugetlbpage_index:
+
 ====================
 HugeTLBpage on ARM64
 ====================
diff --git a/Documentation/translations/zh_CN/arm64/hugetlbpage.rst b/Documentation/translations/zh_CN/arm64/hugetlbpage.rst
new file mode 100644
index 000000000000..dfc88195deb2
--- /dev/null
+++ b/Documentation/translations/zh_CN/arm64/hugetlbpage.rst
@@ -0,0 +1,45 @@
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/arm64/hugetlbpage.rst <hugetlbpage_index>`
+
+Translator: Bailu Lin <bailu.lin@vivo.com>
+
+=====================
+ARM64中的 HugeTLBpage
+=====================
+
+大页依靠有效利用 TLBs 来提高地址翻译的性能。这取决于以下
+两点 -
+
+  - 大页的大小
+  - TLBs 支持的条目大小
+
+ARM64 接口支持2种大页方式。
+
+1) pud/pmd 级别的块映射
+-----------------------
+
+这是常规大页,他们的 pmd 或 pud 页面表条目指向一个内存块。
+不管 TLB 中支持的条目大小如何,块映射可以减少翻译大页地址
+所需遍历的页表深度。
+
+2) 使用连续位
+-------------
+
+架构中转换页表条目(D4.5.3, ARM DDI 0487C.a)中提供一个连续
+位告诉 MMU 这个条目是一个连续条目集的一员,它可以被缓存在单
+个 TLB 条目中。
+
+在 Linux 中连续位用来增加 pmd 和 pte(最后一级)级别映射的大
+小。受支持的连续页表条目数量因页面大小和页表级别而异。
+
+
+支持以下大页大小配置 -
+
+  ====== ========   ====    ========    ===
+  -      CONT PTE    PMD    CONT PMD    PUD
+  ====== ========   ====    ========    ===
+  4K:         64K     2M         32M     1G
+  16K:         2M    32M          1G
+  64K:         2M   512M         16G
+  ====== ========   ====    ========    ===
diff --git a/Documentation/translations/zh_CN/arm64/index.rst b/Documentation/translations/zh_CN/arm64/index.rst
index 646ed1f7aea3..e31a6090384d 100644
--- a/Documentation/translations/zh_CN/arm64/index.rst
+++ b/Documentation/translations/zh_CN/arm64/index.rst
@@ -14,3 +14,4 @@ ARM64 架构
     :maxdepth: 2
 
     amu
+    hugetlbpage
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 6+ messages in thread

* Re: [PATCH v2] Documentation: Chinese translation of Documentation/arm64/hugetlbpage.rst
  2020-10-13 12:36 ` [PATCH v2] " Bailu Lin
@ 2020-10-14  0:42   ` Alex Shi
  2020-10-14  2:20     ` [PATCH v3] " Bailu Lin
  0 siblings, 1 reply; 6+ messages in thread
From: Alex Shi @ 2020-10-14  0:42 UTC (permalink / raw)
  To: Bailu Lin, catalin.marinas, corbet, harryxiyou, linux-arm-kernel,
	linux-doc, linux-kernel, will
  Cc: kernel



在 2020/10/13 下午8:36, Bailu Lin 写道:
> This is a Chinese translated version of
>  Documentation/arm64/hugetlbpage.rst
> 
> Signed-off-by: Bailu Lin <bailu.lin@vivo.com>
> ---
> Changes in v2:
>  - Fix Sphinx 2.4.4's waring by increasing underline' size.
> ---
>  Documentation/arm64/hugetlbpage.rst           |  2 +
>  .../translations/zh_CN/arm64/hugetlbpage.rst  | 45 +++++++++++++++++++
>  .../translations/zh_CN/arm64/index.rst        |  1 +
>  3 files changed, 48 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/arm64/hugetlbpage.rst
> 
> diff --git a/Documentation/arm64/hugetlbpage.rst b/Documentation/arm64/hugetlbpage.rst
> index b44f939e5210..a110124c11e3 100644
> --- a/Documentation/arm64/hugetlbpage.rst
> +++ b/Documentation/arm64/hugetlbpage.rst
> @@ -1,3 +1,5 @@
> +.. _hugetlbpage_index:
> +
>  ====================
>  HugeTLBpage on ARM64
>  ====================
> diff --git a/Documentation/translations/zh_CN/arm64/hugetlbpage.rst b/Documentation/translations/zh_CN/arm64/hugetlbpage.rst
> new file mode 100644
> index 000000000000..dfc88195deb2
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/arm64/hugetlbpage.rst
> @@ -0,0 +1,45 @@
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :ref:`Documentation/arm64/hugetlbpage.rst <hugetlbpage_index>`
> +
> +Translator: Bailu Lin <bailu.lin@vivo.com>
> +
> +=====================
> +ARM64中的 HugeTLBpage
> +=====================
> +
> +大页依靠有效利用 TLBs 来提高地址翻译的性能。这取决于以下
> +两点 -
> +
> +  - 大页的大小
> +  - TLBs 支持的条目大小
> +
> +ARM64 接口支持2种大页方式。
> +
> +1) pud/pmd 级别的块映射
> +-----------------------
> +
> +这是常规大页,他们的 pmd 或 pud 页面表条目指向一个内存块。
> +不管 TLB 中支持的条目大小如何,块映射可以减少翻译大页地址
> +所需遍历的页表深度。
> +
> +2) 使用连续位
> +-------------
> +
> +架构中转换页表条目(D4.5.3, ARM DDI 0487C.a)中提供一个连续
> +位告诉 MMU 这个条目是一个连续条目集的一员,它可以被缓存在单
> +个 TLB 条目中。
> +
> +在 Linux 中连续位用来增加 pmd 和 pte(最后一级)级别映射的大
> +小。受支持的连续页表条目数量因页面大小和页表级别而异。
> +
> +
> +支持以下大页大小配置 -

Is this better to s/大小/尺寸/ ?

for other part.

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

> +
> +  ====== ========   ====    ========    ===
> +  -      CONT PTE    PMD    CONT PMD    PUD
> +  ====== ========   ====    ========    ===
> +  4K:         64K     2M         32M     1G
> +  16K:         2M    32M          1G
> +  64K:         2M   512M         16G
> +  ====== ========   ====    ========    ===
> diff --git a/Documentation/translations/zh_CN/arm64/index.rst b/Documentation/translations/zh_CN/arm64/index.rst
> index 646ed1f7aea3..e31a6090384d 100644
> --- a/Documentation/translations/zh_CN/arm64/index.rst
> +++ b/Documentation/translations/zh_CN/arm64/index.rst
> @@ -14,3 +14,4 @@ ARM64 架构
>      :maxdepth: 2
>  
>      amu
> +    hugetlbpage
> 

^ permalink raw reply	[flat|nested] 6+ messages in thread

* [PATCH v3] Documentation: Chinese translation of  Documentation/arm64/hugetlbpage.rst
  2020-10-14  0:42   ` Alex Shi
@ 2020-10-14  2:20     ` Bailu Lin
  2020-10-14  2:33       ` Alex Shi
  2020-10-21 21:15       ` Jonathan Corbet
  0 siblings, 2 replies; 6+ messages in thread
From: Bailu Lin @ 2020-10-14  2:20 UTC (permalink / raw)
  To: alex.shi
  Cc: bailu.lin, catalin.marinas, corbet, harryxiyou, kernel,
	linux-arm-kernel, linux-doc, linux-kernel, will

This is a Chinese translated version of
 Documentation/arm64/hugetlbpage.rst

Signed-off-by: Bailu Lin <bailu.lin@vivo.com>
---
Changes in v3:
 - Modify a translation as Alex sugguested.
Changes in v2:
 - Fix Sphinx 2.4.4's waring by increasing underline' size.
---
 Documentation/arm64/hugetlbpage.rst           |  2 +
 .../translations/zh_CN/arm64/hugetlbpage.rst  | 45 +++++++++++++++++++
 .../translations/zh_CN/arm64/index.rst        |  1 +
 3 files changed, 48 insertions(+)
 create mode 100644 Documentation/translations/zh_CN/arm64/hugetlbpage.rst

diff --git a/Documentation/arm64/hugetlbpage.rst b/Documentation/arm64/hugetlbpage.rst
index b44f939e5210..a110124c11e3 100644
--- a/Documentation/arm64/hugetlbpage.rst
+++ b/Documentation/arm64/hugetlbpage.rst
@@ -1,3 +1,5 @@
+.. _hugetlbpage_index:
+
 ====================
 HugeTLBpage on ARM64
 ====================
diff --git a/Documentation/translations/zh_CN/arm64/hugetlbpage.rst b/Documentation/translations/zh_CN/arm64/hugetlbpage.rst
new file mode 100644
index 000000000000..13304d269d0b
--- /dev/null
+++ b/Documentation/translations/zh_CN/arm64/hugetlbpage.rst
@@ -0,0 +1,45 @@
+.. include:: ../disclaimer-zh_CN.rst
+
+:Original: :ref:`Documentation/arm64/hugetlbpage.rst <hugetlbpage_index>`
+
+Translator: Bailu Lin <bailu.lin@vivo.com>
+
+=====================
+ARM64中的 HugeTLBpage
+=====================
+
+大页依靠有效利用 TLBs 来提高地址翻译的性能。这取决于以下
+两点 -
+
+  - 大页的大小
+  - TLBs 支持的条目大小
+
+ARM64 接口支持2种大页方式。
+
+1) pud/pmd 级别的块映射
+-----------------------
+
+这是常规大页,他们的 pmd 或 pud 页面表条目指向一个内存块。
+不管 TLB 中支持的条目大小如何,块映射可以减少翻译大页地址
+所需遍历的页表深度。
+
+2) 使用连续位
+-------------
+
+架构中转换页表条目(D4.5.3, ARM DDI 0487C.a)中提供一个连续
+位告诉 MMU 这个条目是一个连续条目集的一员,它可以被缓存在单
+个 TLB 条目中。
+
+在 Linux 中连续位用来增加 pmd 和 pte(最后一级)级别映射的大
+小。受支持的连续页表条目数量因页面大小和页表级别而异。
+
+
+支持以下大页尺寸配置 -
+
+  ====== ========   ====    ========    ===
+  -      CONT PTE    PMD    CONT PMD    PUD
+  ====== ========   ====    ========    ===
+  4K:         64K     2M         32M     1G
+  16K:         2M    32M          1G
+  64K:         2M   512M         16G
+  ====== ========   ====    ========    ===
diff --git a/Documentation/translations/zh_CN/arm64/index.rst b/Documentation/translations/zh_CN/arm64/index.rst
index 646ed1f7aea3..e31a6090384d 100644
--- a/Documentation/translations/zh_CN/arm64/index.rst
+++ b/Documentation/translations/zh_CN/arm64/index.rst
@@ -14,3 +14,4 @@ ARM64 架构
     :maxdepth: 2
 
     amu
+    hugetlbpage
-- 
2.20.1


^ permalink raw reply related	[flat|nested] 6+ messages in thread

* Re: [PATCH v3] Documentation: Chinese translation of Documentation/arm64/hugetlbpage.rst
  2020-10-14  2:20     ` [PATCH v3] " Bailu Lin
@ 2020-10-14  2:33       ` Alex Shi
  2020-10-21 21:15       ` Jonathan Corbet
  1 sibling, 0 replies; 6+ messages in thread
From: Alex Shi @ 2020-10-14  2:33 UTC (permalink / raw)
  To: Bailu Lin
  Cc: catalin.marinas, corbet, harryxiyou, kernel, linux-arm-kernel,
	linux-doc, linux-kernel, will

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


在 2020/10/14 上午10:20, Bailu Lin 写道:
> This is a Chinese translated version of
>  Documentation/arm64/hugetlbpage.rst
> 
> Signed-off-by: Bailu Lin <bailu.lin@vivo.com>
> ---
> Changes in v3:
>  - Modify a translation as Alex sugguested.
> Changes in v2:
>  - Fix Sphinx 2.4.4's waring by increasing underline' size.
> ---
>  Documentation/arm64/hugetlbpage.rst           |  2 +
>  .../translations/zh_CN/arm64/hugetlbpage.rst  | 45 +++++++++++++++++++
>  .../translations/zh_CN/arm64/index.rst        |  1 +
>  3 files changed, 48 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/arm64/hugetlbpage.rst
> 
> diff --git a/Documentation/arm64/hugetlbpage.rst b/Documentation/arm64/hugetlbpage.rst
> index b44f939e5210..a110124c11e3 100644
> --- a/Documentation/arm64/hugetlbpage.rst
> +++ b/Documentation/arm64/hugetlbpage.rst
> @@ -1,3 +1,5 @@
> +.. _hugetlbpage_index:
> +
>  ====================
>  HugeTLBpage on ARM64
>  ====================
> diff --git a/Documentation/translations/zh_CN/arm64/hugetlbpage.rst b/Documentation/translations/zh_CN/arm64/hugetlbpage.rst
> new file mode 100644
> index 000000000000..13304d269d0b
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/arm64/hugetlbpage.rst
> @@ -0,0 +1,45 @@
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: :ref:`Documentation/arm64/hugetlbpage.rst <hugetlbpage_index>`
> +
> +Translator: Bailu Lin <bailu.lin@vivo.com>
> +
> +=====================
> +ARM64中的 HugeTLBpage
> +=====================
> +
> +大页依靠有效利用 TLBs 来提高地址翻译的性能。这取决于以下
> +两点 -
> +
> +  - 大页的大小
> +  - TLBs 支持的条目大小
> +
> +ARM64 接口支持2种大页方式。
> +
> +1) pud/pmd 级别的块映射
> +-----------------------
> +
> +这是常规大页,他们的 pmd 或 pud 页面表条目指向一个内存块。
> +不管 TLB 中支持的条目大小如何,块映射可以减少翻译大页地址
> +所需遍历的页表深度。
> +
> +2) 使用连续位
> +-------------
> +
> +架构中转换页表条目(D4.5.3, ARM DDI 0487C.a)中提供一个连续
> +位告诉 MMU 这个条目是一个连续条目集的一员,它可以被缓存在单
> +个 TLB 条目中。
> +
> +在 Linux 中连续位用来增加 pmd 和 pte(最后一级)级别映射的大
> +小。受支持的连续页表条目数量因页面大小和页表级别而异。
> +
> +
> +支持以下大页尺寸配置 -
> +
> +  ====== ========   ====    ========    ===
> +  -      CONT PTE    PMD    CONT PMD    PUD
> +  ====== ========   ====    ========    ===
> +  4K:         64K     2M         32M     1G
> +  16K:         2M    32M          1G
> +  64K:         2M   512M         16G
> +  ====== ========   ====    ========    ===
> diff --git a/Documentation/translations/zh_CN/arm64/index.rst b/Documentation/translations/zh_CN/arm64/index.rst
> index 646ed1f7aea3..e31a6090384d 100644
> --- a/Documentation/translations/zh_CN/arm64/index.rst
> +++ b/Documentation/translations/zh_CN/arm64/index.rst
> @@ -14,3 +14,4 @@ ARM64 架构
>      :maxdepth: 2
>  
>      amu
> +    hugetlbpage
> 

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: [PATCH v3] Documentation: Chinese translation of  Documentation/arm64/hugetlbpage.rst
  2020-10-14  2:20     ` [PATCH v3] " Bailu Lin
  2020-10-14  2:33       ` Alex Shi
@ 2020-10-21 21:15       ` Jonathan Corbet
  1 sibling, 0 replies; 6+ messages in thread
From: Jonathan Corbet @ 2020-10-21 21:15 UTC (permalink / raw)
  To: Bailu Lin
  Cc: alex.shi, catalin.marinas, harryxiyou, kernel, linux-arm-kernel,
	linux-doc, linux-kernel, will

On Tue, 13 Oct 2020 19:20:03 -0700
Bailu Lin <bailu.lin@vivo.com> wrote:

> This is a Chinese translated version of
>  Documentation/arm64/hugetlbpage.rst
> 
> Signed-off-by: Bailu Lin <bailu.lin@vivo.com>
> ---
> Changes in v3:
>  - Modify a translation as Alex sugguested.
> Changes in v2:
>  - Fix Sphinx 2.4.4's waring by increasing underline' size.
> ---
>  Documentation/arm64/hugetlbpage.rst           |  2 +
>  .../translations/zh_CN/arm64/hugetlbpage.rst  | 45 +++++++++++++++++++
>  .../translations/zh_CN/arm64/index.rst        |  1 +
>  3 files changed, 48 insertions(+)
>  create mode 100644 Documentation/translations/zh_CN/arm64/hugetlbpage.rst

Applied, thanks.

jon

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2020-10-21 21:15 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-09-26 10:18 [PATCH] Documentation: Chinese translation of Documentation/arm64/hugetlbpage.rst Bailu Lin
2020-10-13 12:36 ` [PATCH v2] " Bailu Lin
2020-10-14  0:42   ` Alex Shi
2020-10-14  2:20     ` [PATCH v3] " Bailu Lin
2020-10-14  2:33       ` Alex Shi
2020-10-21 21:15       ` Jonathan Corbet

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).