Re: [PATCH v2 5/6] docs/zh_CN: add core-api boot-time-mm translation

[Jiaxun Yang <jiaxun.yang@xxxxxxxxxxx>]

在 2021/7/9 10:57, Yanteng Si 写道:
> Translate Documentation/core-api/boot-time-mm.rst into Chinese.
>
> Signed-off-by: Yanteng Si <siyanteng@xxxxxxxxxxx>
> Reviewed-by: Alex Shi <alexs@xxxxxxxxxx>
> ---
>   .../zh_CN/core-api/boot-time-mm.rst           | 49 +++++++++++++++++++
>   .../translations/zh_CN/core-api/index.rst     |  2 +-
>   2 files changed, 50 insertions(+), 1 deletion(-)
>   create mode 100644 Documentation/translations/zh_CN/core-api/boot-time-mm.rst
>
> diff --git a/Documentation/translations/zh_CN/core-api/boot-time-mm.rst b/Documentation/translations/zh_CN/core-api/boot-time-mm.rst
> new file mode 100644
> index 000000000000..ba20dfed1017
> --- /dev/null
> +++ b/Documentation/translations/zh_CN/core-api/boot-time-mm.rst
> @@ -0,0 +1,49 @@
> +.. include:: ../disclaimer-zh_CN.rst
> +
> +:Original: Documentation/core-api/boot-time-mm.rst
> +
> +:翻译:
> +
> + 司延腾 Yanteng Si <siyanteng@xxxxxxxxxxx>
> +
> +:校译:
> +
> + 时奎亮<alexs@xxxxxxxxxx>
> +
> +.. _cn_core-api_boot-time-mm:
> +
> +================
> +启动时的内存管理
> +================
> +
> +系统初始化早期不能使用“正常”的内存管理，只是因为它还没有被设置好。但是仍
> +然需要为各种数据结构分配内存，例如为物理页分配器分配内存。

系统初始化早期“正常”的内存管理由于没有设置完毕无法使用。但是内核仍然需要为各种数据结构分配内存，例如物理页分配器。 


> +
> +一个叫做 ``memblock`` 的专用分配器执行启动时的内存管理。特定架构的初始化
> +必须在setup_arch()中设置它，并在mem_init()函数中移除它。
> +
> +一旦早期的内存管理可用，它就为内存分配提供了各种函数和宏。分配请求可以指向
> +第一个（也可能是唯一的）节点或NUMA系统中的某个特定节点。有一些API变体在分
> +配失败时panic，也有一些不panic的。
^ 不会panic。
> +
> +Memblock还提供了各种控制其自身行为的API。
> +
> +Memblock概述
> +============
> +
> +该API在以下内核代码中:
> +
> +mm/memblock.c
> +
> +
> +函数和结构体
> +============
> +
> +下面是关于memblock数据结构、函数和宏的描述。其中一些实际上是内部（内联函数注释）
> +的，但由于它们被记录下来，漏掉它们是很愚蠢的。此外，阅读内部函数的注释可以帮助理
> +解引擎盖下真正发生的事情。

I think internal here means not facing memblock users, 内联函数注释 seems 
wired.

Thanks.

- Jiaxun

> +
> +该API在以下内核代码中:
> +
> +include/linux/memblock.h
> +mm/memblock.c
> diff --git a/Documentation/translations/zh_CN/core-api/index.rst b/Documentation/translations/zh_CN/core-api/index.rst
> index 1e8c5963c499..1d6fecd69c3b 100644
> --- a/Documentation/translations/zh_CN/core-api/index.rst
> +++ b/Documentation/translations/zh_CN/core-api/index.rst
> @@ -103,6 +103,7 @@ Todolist:
>      unaligned-memory-access
>      mm-api
>      genalloc
> +   boot-time-mm
>   
>   Todolist:
>   
> @@ -111,7 +112,6 @@ Todolist:
>      dma-attributes
>      dma-isa-lpc
>      pin_user_pages
> -   boot-time-mm
>      gfp_mask-from-fs-io
>   
>   内核调试的接口