Documentation/translations/zh_CN/core-api/genalloc.rst

Source file repositories/reference/linux-study-clean/Documentation/translations/zh_CN/core-api/genalloc.rst

File Facts

System
Linux kernel
Corpus path
Documentation/translations/zh_CN/core-api/genalloc.rst
Extension
.rst
Size
4885 bytes
Lines
110
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

.. include:: ../disclaimer-zh_CN.rst

:Original: Documentation/core-api/genalloc.rst

:翻译:

 司延腾 Yanteng Si <siyanteng@loongson.cn>

:校译:

 时奎亮 <alexs@kernel.org>

.. _cn_core-api_genalloc:

genalloc/genpool子系统
======================

内核中有许多内存分配子系统，每一个都是针对特定的需求。然而，有时候，内核开发者需
要为特定范围的特殊用途的内存实现一个新的分配器；通常这个内存位于某个设备上。该设
备的驱动程序的作者当然可以写一个小的分配器来完成工作，但这是让内核充满几十个测试
差劲的分配器的方法。早在2005年，Jes Sorensen从sym53c8xx_2驱动中提取了其中的一
个分配器，并将其作为一个通用模块发布，用于创建特设的内存分配器。这段代码在2.6.13
版本中被合并；此后它被大大地修改了。

.. _posted: https://lwn.net/Articles/125842/

使用这个分配器的代码应该包括<linux/genalloc.h>。这个动作从创建一个池开始，使用
一个:

该API在以下内核代码中:

lib/genalloc.c

对gen_pool_create()的调用将创建一个内存池。分配的粒度由min_alloc_order设置；它
是一个log-base-2（以2为底的对数）的数字，就像页面分配器使用的数字一样，但它指的是
字节而不是页面。因此，如果min_alloc_order被传递为3，那么所有的分配将是8字节的倍数。
增加min_alloc_order可以减少跟踪池中内存所需的内存。nid参数指定哪一个NUMA节点应该被
用于分配管家结构体；如果调用者不关心，它可以是-1。

“管理的”接口devm_gen_pool_create()将内存池与一个特定的设备联系起来。在其他方面，
当给定的设备被销毁时，它将自动清理内存池。

一个内存池池被关闭的方法是:

该API在以下内核代码中:

lib/genalloc.c

值得注意的是，如果在给定的内存池中仍有未完成的分配，这个函数将采取相当极端的步骤，调用
BUG()，使整个系统崩溃。你已经被警告了。

一个新创建的内存池没有内存可以分配。在这种状态下，它是相当无用的，所以首要任务之一通常
是向内存池里添加内存。这可以通过以下方式完成:

该API在以下内核代码中:

include/linux/genalloc.h

lib/genalloc.c

对gen_pool_add()的调用将把从地址（在内核的虚拟地址空间）开始的内存的大小字节放入
给定的池中，再次使用nid作为节点ID进行辅助内存分配。gen_pool_add_virt()变体将显式
物理地址与内存联系起来；只有在内存池被用于DMA分配时，这才是必要的。

从内存池中分配内存（并将其放回）的函数是:

该API在以下内核代码中:

include/linux/genalloc.h

Annotation

Implementation Notes