From ce88bab9ae48bacc1c50f07e31cf1900b31253ff Mon Sep 17 00:00:00 2001 From: gatieme Date: Wed, 31 Aug 2016 21:38:17 +0800 Subject: [PATCH] ... --- .../02-memory/05-slaballocator/README.md | 2100 +++++++++-------- .../05-slaballocator/images/cat_procinfo.png | Bin 0 -> 146806 bytes .../images/cat_procinfo_task_struct.png | Bin 0 -> 18341 bytes 3 files changed, 1053 insertions(+), 1047 deletions(-) create mode 100644 study/kernel/02-memory/05-slaballocator/images/cat_procinfo.png create mode 100644 study/kernel/02-memory/05-slaballocator/images/cat_procinfo_task_struct.png diff --git a/study/kernel/02-memory/05-slaballocator/README.md b/study/kernel/02-memory/05-slaballocator/README.md index 295cd53..a652bda 100644 --- a/study/kernel/02-memory/05-slaballocator/README.md +++ b/study/kernel/02-memory/05-slaballocator/README.md @@ -1,1048 +1,1054 @@ -slab分配器 -======= - -| 日期 | 内核版本 | 架构| 作者 | GitHub| CSDN | -| ------- |:-------:|:-------:|:-------:|:-------:|:-------:| -| 2016-06-14 | [Linux-4.7](http://lxr.free-electrons.com/source/?v=4.7) | X86 & arm | [gatieme](http://blog.csdn.net/gatieme) | [LinuxDeviceDrivers](https://github.com/gatieme/LDD-LinuxDeviceDrivers) | [Linux内存管理](http://blog.csdn.net/gatieme/article/category/6225543) | - - -#2 slab分配器 -------- - -##2.1 slab分配器 -------- - -每个C程序员都熟悉malloc, 及其在C标准库中的相关函数. 大多数程序分配若干字节内存时. 经常会调用这些函数. - -内核也必须经常分配内存, 但无法借助于标准库的函数. 上面描述的伙伴系统支持按页分配内存, 但这个单位太大了. 如果需要为一个10个字符的字符串分配空间, 分配一个4 KiB或更多空间的完整页面, 不仅浪费而且完全不可接受. -显然的解决方案是将页拆分为更小的单位, 可以容纳大量的小对象. - -为此必须引入新的管理机制, 这会给内核带来更大的开销. 为最小化这个额外负担对系统性能的影响, 该管理层的实现应该尽可能紧凑, 以便不要对处理器的高速缓存和TLB带来显著影响. 同时, 内核还必须保证内存利用的速度和效率. 不仅Linux, 而且类似的UNIX和所有其他的操作系统, 都需要面对这个问题. 经过一定的时间, 已经提出了一些或好或坏的解决方案, 在一般的操作系统文献中都有讲解 - -此类提议之一, 所谓slab分配, 证明对许多种类工作负荷都非常高效. 它是由Sun公司的一个雇员`Jeff Bonwick`，在`Solaris 2.4`中设计并实现的. 由于他公开了其方法, 因此也可以为Linux实现一个版本. - -提供小内存块不是slab分配器的唯一任务. 由于结构上的特点. 它也用作一个缓存. 主要针对经常分配并释放的对象. 通过建立slab缓存, 内核能够储备一些对象, 供后续使用, 即使在初始化状态, 也是如此. - -举例来说, 为管理与进程关联的文件系统数据, 内核必须经常生成`struct fs_struct`的新实例. 此类型实例占据的内存块同样需要经常回收(在进程结束时). 换句话说, 内核趋向于非常有规律地分配并释放大小为`sizeof{fs_struct}`的内存块. slab分配器将释放的内存块保存在一个内部列表中. 并不马上返回给伙伴系统. 在请求为该类对象分配一个新实例时, 会使用最近释放的内存块. 这有两个优点. 首先, 由于内核不必使用伙伴系统算法, 处理时间会变短. 其次, 由于该内存块仍然是"新"的，因此其仍然驻留在CPU高速缓存的概率较高. - - -slab分配器还有两个更进一步的好处 - -* 调用伙伴系统的操作对系统的数据和指令高速缓存有相当的影响。内核越浪费这些资源, 这些资源对用户空间进程就越不可用. 更轻量级的slab分配器在可能的情况下减少了对伙伴系统的调用, 有助于防止不受欢迎的缓存"污染". - -* 如果数据存储在伙伴系统直接提供的页中，那么其地址总是出现在2的幂次的整数倍附近(许多将页划分为更小块的其他分配方法, 也有同样的特征). 这对CPU高速缓存的利用有负面影响, 由于这种地址分布, 使得某些缓存行过度使用, 而其他的则几乎为空. 多处理器系统可能会加剧这种不利情况, 因为不同的内存地址可能在不同的总线上传输, 上述情况会导致某些总线拥塞, 而其他总线则几乎没有使用. - -通过slab着色(slab coloring), slab分配器能够均匀地分布对象, 以实现均匀的缓存利用 - - -经常使用的内核对象保存在CPU高速缓存中，这是我们想要的效果。前文的注释提到, 从`slab`分配器的角度进行衡量, 伙伴系统的高速缓存和TLB占用较大, 这是一个负面效应. - -因为这会导致不重要的数据驻留在`CPU`高速缓存中, 而重要的数据则被置换到内存, 显然应该防止这种情况出现. - ->着色这个术语是隐喻性的. 它与颜色无关, 只是表示slab中的对象需要移动的特定偏移量, 以便使对象放置到不同的缓存行. - -`slab`分配器由何得名?各个缓存管理的对象，会合并为较大的组，覆盖一个或多个连续页帧. 这种组称作slab，每个缓存由几个这种slab组成. - - -#2.2 备选slab分配器 -------- - - -尽管slab分配器对许多可能的工作负荷都工作良好, 但也有一些情形, 它无法提供最优性能. 如果某些计算机处于当前硬件尺度的边界上, 在此类计算机上使用slab分配会出现一些问题 : 微小的嵌入式系统, 配备有大量物理内存的大规模并行系统. 在第二种情况下, slab分配器所需的大量元数据可能成为一个问题 : 开发者称在大型系统上仅slab的数据结构就需要很多吉字节内存. 对嵌入式系统来说, slab分配器代码量和复杂性都太高. - -为处理此类情形, 在内核版本2.6开发期间, 增加了slab分配器的两个替代品. - -* `slob`分配器进行了特别优化, 以便减少代码量. 它围绕一个简单的内存块链表展开(因此而得名). 在分配内存时, 使用了同样简单的最先适配算法.`slob`分配器只有大约600行代码, 总的代码量很小. 事实上, 从速度来说, 它不是最高效的分配器, 也肯定不是为大型系统设计的. - -* `slub`分配器通过将页帧打包为组，并通过`struct page`中未使用的字段来管理这些组，试图最小化所需的内存开销。读者此前已经看到，这样做不会简化该结构的定义，但在大型计算机上`slub`比`slab`提供了更好的性能，说明了这样做是正确的. - -由于`slab`分配是大多数内核配置的默认选项，我不会详细讨论备选的分配器. 但有很重要的一点需要强调, 内核的其余部分无需关注底层选择使用了哪个分配器. 所有分配器的前端接口都是相同的. - -每个分配器都必须实现一组特定的函数, 用于内存分配和缓存 - - -* `kmalloc`、`__kmalloc`和`kmalloc_node`是一般的(特定于结点)内存分配函数. - -* `kmem_cache_alloc`、`kmem_cache_alloc_node`提供（特定于结点）特定类型的内核缓存. - -下文在讨论`slab`分配器时，会讲解这些函数的行为. 使用这些标准函数, 内核可以提供更方便的函数, 而不涉及内存在内部具体如何管理. 举例来说, kcalloc为数组分配内存，而kzalloc分配一个填充字节0的内存区. - -普通内核代码只需要包含slab.h，即可使用内存分配的所有标准内核函数。连编系统会保证使用编译时选择的分配器，来满足程序的内存分配请求 - - - -##2.3 内核中的内存管理 -------- - -内核中一般的内存分配和释放函数与C标准库中等价函数的名称类似，用法也几乎相同. - -* `kmalloc(size, flags)`分配长度为`size`字节的一个内存区, 并返回指向该内存区起始处的一个`void`指针. 如果没有足够内存(在内核中这种情形不大可能, 但却始终要考虑到), 则结果为`NULL`指针. `flags`参数使用之前讨论的GFP_常数，来指定分配内存的具体内存域，例如GFP_DMA指定分配适合于DMA的内存区. - -* `kfree(*ptr)`释放`*ptr`指向的内存区. - - -与用户空间程序设计相比, 内核还包括`percpu_alloc`和`percpu_free`函数，用于为各个系统CPU分配和释放所需内存区(不是明确地用于当前活动CPU). - -`kmalloc`在内核源代码中的使用数以千计, 但模式都是相同的. 用`kmalloc`分配的内存区, 首先通过类型转换变为正确的类型, 然后赋值到指针变量. - ->info = (struct cdrom_info *) kmalloc (sizeof (struct cdrom_info), GFP_KERNEL); - -从程序员的角度来看，建立和使用缓存的任务不是特别困难. 必须首先用`kmem_cache_create`建立一个适当的缓存, 接下来即可使用`kmem_cache_alloc`和`kmem_cache_free`分配和释放其中包含的对象。slab分配器负责完成与伙伴系统的交互，来分配所需的页. - -所有活动缓存的列表保存在`/proc/slabinfo`中(为节省空间，下文的输出省去了不重要的部分). - -![cat /proc/slabinfo]() - - -输出的各列除了包含用于标识各个缓存的字符串名称(也确保不会创建相同的缓存)之外, 还包含下列信息. - - -* 缓存中活动对象的数量。 - -* 缓存中对象的总数（已用和未用）。 - -* 所管理对象的长度，按字节计算。 - -* 一个slab中对象的数量。 - -* 每个slab中页的数量。 - -* 活动slab的数量。 - -* 在内核决定向缓存分配更多内存时, 所分配对象的数量. 每次会分配一个较大的内存块, 以减少与伙伴系统的交互. 在缩小缓存时，也使用该值作为释放内存块的大小. - - -除了容易识别的缓存名称如`unix_sock`(用于UNIX域套接字, 即`struct unix_sock`类型的对象), 还有其他字段名称`kmalloc-size`. 提供DMA内存域的计算机还包括用于DMA分配的缓存, 在上述的例子中没有. 这些是kmalloc函数的基础，是内核为不同内存长度提供的slab缓存，除极少例外，其长度都是2的幂次，长度的范围从`2^5=32`B（用于页大小为4 KiB的计算机）或64B（所有其他计算机）,到225B. 上界也可以更小，是由`KMALLOC_MAX_SIZE`设置, 后者根据系统页大小和最大允许的分配阶计算: - -```cpp - -#define KMALLOC_SHIFT_HIGH ((MAX_ORDER + PAGE_SHIFT -1) <= 25 ? \ -(MAX_ORDER + PAGE_SHIFT -1) : 25) -#define KMALLOC_MAX_SIZE (1UL << KMALLOC_SHIFT_HIGH) -#define KMALLOC_MAX_ORDER (KMALLOC_SHIFT_HIGH -PAGE_SHIFT) -``` - -每次调用`kmalloc`时, 内核找到最适合的缓存, 并从中分配一个对象满足请求(如果没有刚好适合的缓存，则分配稍大的对象，但不会分配更小的对象). - -在实际实现中，上文中的`slab`分配器和缓存之间的差异迅速消失，以至于本书后文中将这两个名词用作同义词。在讨论slab分配器的实现之后 - - - -#3 slab分配的原理 -------- - -`slab`分配器由一个紧密地交织的数据和内存结构的网络组成, 初看起来不容易理解其运作方式. - -因此在考察其实现之前, 重要的是获得各个结构之间关系的概观。 -基本上, slab缓存由图3-44所示的两部分组成：保存管理性数据的缓存对象和保存被管理对象的各个slab. - -![slab分配器的各部分](./images/slab.png) - -每个缓存只负责一种对象类型（例如struct unix_sock实例），或提供一般性的缓冲区。各个缓存中slab的数目各有不同，这与已经使用的页的数目、对象长度和被管理对象的数目有关。3.6.4节将更详细地描述缓存长度的计算方式。 -另外，系统中所有的缓存都保存在一个双链表中。这使得内核有机会依次遍历所有的缓存。这是有必要的，例如在即将发生内存不足时，内核可能需要缩减分配给缓存的内存数量. - - - -##3.1 缓存的精细结构 -------- - - -如果我们更仔细地研究缓存的结构，就可以注意到一些更重要的细节。图3-45给出了缓存各组成部分的概述. -除了管理性数据（如已用和空闲对象或标志寄存器的数目），缓存结构包括两个特别重要的成员. - -* 指向一个数组的指针, 其中保存了各个CPU最后释放的对象. - -* 每个内存结点都对应3个表头，用于组织slab的链表 - 第1个链表包含完全用尽的slab，第2个是部分空闲的slab，第3个是空闲的slab - - -![slab缓存的精细结构](./images/slab_struct.png) - - -缓存结构指向一个数组, 其中包含了与系统CPU数目相同的数组项. 每个元素都是一个指针，指向一个进一步的结构称之为数组缓存(array cache), 其中包含了对应于特定系统CPU的管理数据(就总体来看，不是用于缓存). 管理性数据之后的内存区包含了一个指针数组，各个数组项指向slab中未使用的对象. - - -为最好地利用CPU高速缓存, 这些per-CPU指针是很重要的。在分配和释放对象时，采用后进先出原理(LIFO，last in first out). 内核假定刚释放的对象仍然处于CPU高速缓存中，会尽快再次分配它(响应下一个分配请求). 仅当per-CPU缓存为空时，才会用slab中的空闲对象重新填充它们. - - -这样，对象分配的体系就形成了一个三级的层次结构，分配成本和操作对CPU高速缓存和TLB的负面影响逐级升高. - -1. 仍然处于CPU高速缓存中的per-CPU对象 - -2. 现存slab中未使用的对象 - -3. 刚使用伙伴系统分配的新slab中未使用的对象 - -![slab缓存的精细结构](./images/slab_struct2.png) - - -##3.2 slab的精细结构 -------- - - -对象在slab中并非连续排列，而是按照一个相当复杂的方案分布。图3-46说明了相关细节. - - -用于每个对象的长度并不反映其确切的大小. 相反, 长度已经进行了舍入，以满足某些对齐方式的要求. 有两种可用的备选对齐方案. - - -* slab创建时使用标志SLAB_HWCACHE_ALIGN，slab用户可以要求对象按硬件缓存行对齐. 那么会按照cache_line_size的返回值进行对齐，该函数返回特定于处理器的L1缓存大小。 -如果对象小于缓存行长度的一半，那么将多个对象放入一个缓存行。 - - -* 如果不要求按硬件缓存行对齐，那么内核保证对象按BYTES_PER_WORD对齐，该值是表示`void`指针所需字节的数目. - - -在32位处理器上，`void`指针需要4个字节。因此，对有6个字节的对象，则需要8 = 2×4个字节, 15个字节的对象需要16=4×4个字节。多余的字节称为填充字节. - - -填充字节可以加速对slab中对象的访问。如果使用对齐的地址, 那么在几乎所有的体系结构上, 内存访问都会更快. 这弥补了使用填充字节必然导致需要更多内存的不利情况. - - -管理结构位于每个slab的起始处，保存了所有的管理数据（和用于连接缓存链表的链表元素). - - -其后面是一个数组，每个（整数）数组项对应于slab中的一个对象。只有在对象没有分配时，相应的数组项才有意义。在这种情况下，它指定了下一个空闲对象的索引。由于最低编号的空闲对象的编号还保存在slab起始处的管理结构中，内核无需使用链表或其他复杂的关联机制，即可轻松找到当前可用的所有对象。 数组的最后一项总是一个结束标记，值为BUFCTL_END. - - -![slab缓存的精细结构](./images/slab_free_manage.png) - - -大多数情况下, slab内存区的长度(减去了头部管理数据)是不能被（可能填补过的）对象长度整除的。因此，内核就有了一些多余的内存，可以用来以偏移量的形式给slab"着色", 如上文所述. - - -缓存的各个slab成员会指定不同的偏移量，以便将数据定位到不同的缓存行，因而slab开始和结束处的空闲内存是不同的。在计算偏移量时，内核必须考虑其他的对齐因素. - - -例如，L1高速缓存中数据的对齐(下文讨论). - - -管理数据可以放置在slab自身，也可以放置到使用kmalloc分配的不同内存区中. 内核如何选择, 取决于slab的长度和已用对象的数量。相应的选择标准稍后讨论。管理数据和slab内存之间的关联很容易建立，因为slab头包含了一个指针，指向slab数据区的起始处(无论管理数据是否在slab上). - - -![slab缓存的精细结构](./images/slab_head.png) - - -最后，内核需要一种方法, 通过对象自身即可识别slab(以及对象驻留的缓存). 根据对象的物理内存地址, 可以找到相关的页, 因此可以在全局mem_map数组中找到对应的page实例. - - -我们已经知道，page结构包括一个链表元素，用于管理各种链表中的页。对于slab缓存中的页而言, 该指针是不必要的，可用于其他用途. - - -* page->lru.next指向页驻留的缓存的管理结构 - - -* page->lru.prev指向保存该页的slab的管理结构 - - -设置或读取slab信息分别由`set_page_slab`和`get_page_slab`函数完成，带有`_cache`后缀的函数则处理缓存信息的设置和读取. - - -```cpp -mm/slab.c -void page_set_cache(struct page *page, struct kmem_cache *cache) -struct kmem_cache *page_get_cache(struct page *page) -void page_set_slab(struct page *page, struct slab *slab) -struct slab *page_get_slab(struct page *page) -``` - - -此外，内核还对分配给`slab`分配器的每个物理内存页都设置标志`PG_SLAB`. - - -#4 实现 -------- - -为实现如上所述的`slab`分配器, 使用了各种数据结构. 尽管看上去并不困难，相关的代码并不总是容易阅读或理解. 这是因为许多内存区需要使用指针运算和类型转换进行操作, 这些可不是C语言中以清晰简明著称的领域。由于slab系统带有大量调试选项，所以代码中遍布着预处理器语句. - -其中一些如下列出. - -* 危险区(Red Zoning) - 在每个对象的开始和结束处增加一个额外的内存区，其中填充已知的字节模式. 如果模式被修改, 程序员在分析内核内存时注意到，可能某些代码访问了不属于它们的内存区. - -* 对象毒化(Object Poisoning) - 在建立和释放slab时，将对象用预定义的模式填充. 如果在对象分配时注意到该模式已经改变，程序员就知道已经发生了未授权访问. - -为简明起见，我们把注意力集中在整体而不是细节上。我们在下文不使用上述选项，只讲解一个"纯粹"的slab分配器. - - - -##4.1 数据结构 -------- - - -每个缓存由`kmem_cache`结构的一个实例表示, 将slab缓存视为通过一组标准函数来高效地创建和释放特定类型对象的机制 - -该结构定义在[mm/slab.h?v=4.7, line 19](http://lxr.free-electrons.com/source/mm/slab.h?v=4.7#L19), 内容如下 - - -| kmem_cache | slab | slob | slub | -|:--------------:|:-----:|:-----:|:-----:| -| [dent?i=kmem_cache](http://lxr.free-electrons.com/ident?v=4.7;i=kmem_cache) | [include/linux/slab_def.h?v=4.7, line 10](http://lxr.free-electrons.com/source/include/linux/slab_def.h?v=4.7#L10) | [mm/slab.h?v=4.7, line 19](http://lxr.free-electrons.com/source/mm/slab.h?v=4.7#L19) | [include/linux/slub_def.h?v=4.7, line 62](http://lxr.free-electrons.com/source/include/linux/slub_def.h?v=4.7#L62) | - - -```cpp -/* - * Definitions unique to the original Linux SLAB allocator. - */ - -struct kmem_cache { - // per-CPU数据，在每次分配/释放期间都会访问 - struct array_cache __percpu *cpu_cache; - -/* 1) Cache tunables. Protected by slab_mutex - * 可调整的缓存参数。由cache_chain_mutex保护 */ - // 要转移本地高速缓存的大批对象的数量 - unsigned int batchcount; - unsigned int limit; - // 本地高速缓存中空闲对象的最大数目 - unsigned int shared; - // 高速缓存的大小 - unsigned int size; - struct reciprocal_value reciprocal_buffer_size; - -/* 2) touched by every alloc & free from the backend - * 后端每次分配和释放内存时都会访问 */ - // 描述高速缓存永久属性的一组标志 - unsigned int flags; /* constant flags */ - // 封装在一个单独slab中的对象个数 - unsigned int num; /* # of objs per slab */ - -/* 3) cache_grow/shrink - * 缓存的增长/缩减 */ - /* order of pgs per slab (2^n) 一个单独slab中包含的连续页框数目的对数*/ - unsigned int gfporder; - - /* force GFP flags, e.g. GFP_DMA 强制的GFP标志，例如GFP_DMA */ - gfp_t allocflags; - - size_t colour; /* cache colouring range 缓存着色范围 */ - unsigned int colour_off; /* colour offset slab中的着色偏移 */ - struct kmem_cache *freelist_cache; - unsigned int freelist_size; - - /* constructor func 构造函数 */ - void (*ctor)(void *obj); - -/* 4) cache creation/removal - * 缓存创建/删除 */ - const char *name; // 存放高速缓存名字的字符数组 - struct list_head list; // 高速缓存描述符双向链表使用的指针 - int refcount; - int object_size; - int align; - -/* 5) statistics - * 统计量 */ -#ifdef CONFIG_DEBUG_SLAB - unsigned long num_active; - unsigned long num_allocations; - unsigned long high_mark; - unsigned long grown; - unsigned long reaped; - unsigned long errors; - unsigned long max_freeable; - unsigned long node_allocs; - unsigned long node_frees; - unsigned long node_overflow; - atomic_t allochit; - atomic_t allocmiss; - atomic_t freehit; - atomic_t freemiss; -#ifdef CONFIG_DEBUG_SLAB_LEAK - atomic_t store_user_clean; -#endif - - /* - * If debugging is enabled, then the allocator can add additional - * fields and/or padding to every object. size contains the total - * object size including these internal fields, the following two - * variables contain the offset to the user object and its size. - */ - int obj_offset; -#endif /* CONFIG_DEBUG_SLAB */ - -#ifdef CONFIG_MEMCG - struct memcg_cache_params memcg_params; -#endif -#ifdef CONFIG_KASAN - struct kasan_cache kasan_info; -#endif - -#ifdef CONFIG_SLAB_FREELIST_RANDOM - void *random_seq; -#endif - - struct kmem_cache_node *node[MAX_NUMNODES]; -}; -``` - -`kmem_cache`是`Linux`内核提供的快速内存缓冲接口, 这些内存块要求是大小相同的, 因为分配出的内存在接口释放时并不真正释放, 而是作为缓存保留, 下一次请求分配时就可以直接使用, 省去了各种内存块初始化或释放的操作, 因此分配速度很快, 通常用于大数量的内存块分配的情况, 如`inode`节点, `skbuff`头, `netfilter`的连接等, 其实`kmalloc`也是从`kmem_cache`中分配的，可通过`/proc/slabinfo`文件直接读取`cache`分配情况. - - -| 字段 | 说明 | -|:-----:|:-----:| -| cpu_cache | 是一个指向数组的指针，每个数组项都对应于系统中的一个CPU，每个数组项都包含了另一个指针，指向下文讨论的array_cache结构的实例 | -| batchcount | 指定了在per-CPU列表为空的情况下，从缓存的slab中获取对象的数目，它还表示在缓存增长时分配的对象数目 | -| limit | 指定了per-CPU列表中保存的对象的最大数目。如果超出了这个值，内核会将batchcount个对象返回到slab | -| size | 指定了缓存中管理的对象的长度1 | -| gfporder | 指定了slab包含的页数目以2为底的对数，简而言之，slab包含2^gfporder页 | -| colorur | 指定了颜色的最大数目 | -| colour_off | 基本偏移量乘以颜色值获得的绝对偏移量 | -| dflags | 另一标志集合，描述slab的动态性质 | -| ctor | 一个指针，指向在对象创建时调用的构造函数 | -| name | 一个字符串，表示缓存的名称 | -| list | 是一个标准链表元素 | - - - -这个冗长的结构分为多个部分，如源代码中的注释所示. - - -###4.1.1 per-cpu数据(第0~1部分) -------- - - -开始的几个成员涉及每次分配期间内核对特定于CPU数据的访问，在本节稍后讨论。 - -* cpu_cache是一个指向数组的指针，每个数组项都对应于系统中的一个CPU。每个数组项都包含了另一个指针，指向下文讨论的array_cache结构的实例。 - -* batchcount指定了在per-CPU列表为空的情况下，从缓存的slab中获取对象的数目。它还表示在缓存增长时分配的对象数目。 - -* limit指定了per-CPU列表中保存的对象的最大数目。如果超出该值，内核会将batchcount个对象返回到slab（如果接下来内核缩减缓存，则释放的内存从slab返回到伙伴系统） - - -内核对每个系统处理器都提供了一个`array_cache`实例. 该结构定义如下 - -```cpp -struct array_cache { - unsigned int avail; - unsigned int limit; - unsigned int batchcount; - unsigned int touched; - void *entry[]; /* - * Must have this definition in here for the proper - * alignment of array_cache. Also simplifies accessing - * the entries. - */ -}; -``` - - -* `batchcount`和`limit`的语义已经在上文给出, `kmem_cache_s`的值用作（通常不修改）`per-CPU`值的默认值，用于缓存的重新填充或清空. - -* `avail`保存了当前可用对象的数目. - -* 在从缓存移除一个对象时，将`touched`设置为1，而缓存收缩时, 则将`touched`设置为0。这使得内核能够确认在缓存上一次收缩之后是否被访问过，也是缓存重要性的一个标志。 - -* 最后一个成员`entry`是一个伪数组, 其中并没有数组项, 只是为了便于访问内存中`array_cache`实例之后缓存中的各个对象而已. - - -###4.1.2 基本数据变量 -------- - - -* kmem_cache的第2、第3部分包含了管理slab所需的全部变量，在填充或清空per-CPU缓存时需要访问这两部分. - -* node[MAX_NUMNODES];是一个数组，每个数组项对应于系统中一个可能的内存结点. 每个数组项都包含kmem_cache_node的一个实例, 该结构中有3个slab列表（完全用尽、空闲、部分空闲） - -该成员必须置于结构的末尾, 尽管它在形式上总是有MAX_NUMNODES项, 但在NUMA计算机上实际可用的结点数目可能会少一些。因而该数组需要的项数也会变少，内核在运行时对该结构分配比理论上更少的内存，就可以缩减该数组的项数。如果nodelists放置在该结构中间，就无法做到这一点. - -在UMA计算机上，这称不上问题，因为只有一个可用结点. - -* flags是一个标志寄存器，定义缓存的全局性质。当前只有一个标志位。如果管理结构存储在slab外部，则置位CFLGS_OFF_SLAB - -* `num`保存了可以放入slab的对象的最大数目 - -kmem_cache_node定义在[mm/slab.h?v=4.7, line 417](http://lxr.free-electrons.com/source/mm/slab.h?v=4.7#L417) - - -```cpp -/* - * The slab lists for all objects. - */ -struct kmem_cache_node { - spinlock_t list_lock; - -#ifdef CONFIG_SLAB - struct list_head slabs_partial; /* partial list first, better asm code */ - struct list_head slabs_full; - struct list_head slabs_free; - unsigned long free_objects; - unsigned int free_limit; - unsigned int colour_next; /* Per-node cache coloring */ - struct array_cache *shared; /* shared per node */ - struct alien_cache **alien; /* on other nodes */ - unsigned long next_reap; /* updated without locking */ - int free_touched; /* updated without locking */ -#endif - -#ifdef CONFIG_SLUB - unsigned long nr_partial; - struct list_head partial; -#ifdef CONFIG_SLUB_DEBUG - atomic_long_t nr_slabs; - atomic_long_t total_objects; - struct list_head full; -#endif -#endif - -}; -``` - -每个数组项都包含kmem_cache_node的一个实例, 该结构中有3个slab列表(完全用尽slabs_full、空闲slabs_free、部分空闲slabs_partial). - -kmem_cache_node作为早期内核中slab描述符struct slab结构的替代品, 要么放在slab自身开始的地方. 如果slab很小或者slab内部有足够的空间容纳slab描述符, 那么描述符就存放在slab里面. - -slab分配器可以创建新的slab, 这是通过kmem_getpages - - -##4.2 slab系统初始化 -------- - - -初看起来, `slab`系统的初始化不是特别麻烦，因为伙伴系统已经完全启用, 内核没有受到其他特别的限制. 尽管如此, 由于`slab`分配器的结构所致, 这里有一个鸡与蛋的问题. - -为初始化`slab`数据结构, 内核需要若干远小于一整页的内存块, 这些最适合由`kmalloc`分配. 这里是关键所在 : 只在`slab`系统已经启用之后，才能使用`kmalloc`. - -更确切地说, 该问题涉及`kmalloc`的`per-CPU`缓存的初始化. 在这些缓存能够初始化之前, `kmalloc`必须可以用来分配所需的内存空间, 而`kmalloc`自身也正处于初始化的过程中. 换句话说, `kmalloc`只能在`kmalloc`已经初始化之后初始化，这是个不可能的场景. 因此内核必须借助一些技巧. - - -###4.2.1 slab分配器的初始化过程 -------- - - -我们之前提到过系统是从start_kernel开始的, 完成了分页机制和内存基本数据结构的初始化, 并将内存管理从bootmem/memblock慢慢迁移到了buddy系统. - - -```cpp -start_kernel() - |---->page_address_init() - | - |---->setup_arch(&command_line); - | - |---->setup_per_cpu_areas(); - | - |---->build_all_zonelist() - | - |---->page_alloc_init() - | - |---->pidhash_init() - | - |---->vfs_caches_init_early() - | - |---->mm_init() -``` - -在完成后, 内核通过[mm_init](http://lxr.free-electrons.com/source/init/main.c?v=4.7#L464)完成了buddy伙伴系统, 该函数定义在[init/main.c?v=4.7, line 464](http://lxr.free-electrons.com/source/init/main.c?v=4.7#L464) - - -```cpp -static void __init mm_init(void) -{ - /* - * page_ext requires contiguous pages, - * bigger than MAX_ORDER unless SPARSEMEM. - */ - page_ext_init_flatmem(); - mem_init(); - kmem_cache_init(); - percpu_init_late(); - pgtable_init(); - vmalloc_init(); - ioremap_huge_init(); -} -``` - -内核通过函数`mem_init`完成了`bootmem/memblock`的释放工作, 从而将内存管理迁移到了`buddy`, 随后就通过`kmem_cache_init`完成了slab初始化分配器. - - -###4.2.2 kmem_cache_init函数初始化slab分配器 -------- - - -`kmem_cache_init`函数用于初始化`slab`分配器. 它在内核初始化阶段(`start_kernel`)、伙伴系统启用之后调用. 但在多处理器系统上，启动`CPU`此时正在运行, 而其他`CPU`尚未初始化. - -`kmem_cache_init`采用了一个多步骤过程，逐步激活slab分配器。 - -1. `kmem_cache_init`创建系统中的第一个`slab`缓存, 以便为`kmem_cache`的实例提供内存. 为此, 内核使用的主要是在编译时创建的静态数据. 实际上, 一个静态数据结构(`initarray_cache`)用作`per-CPU`数组. 该缓存的名称是`cache_cache`. - -2. `kmem_cache_init`接下来初始化一般性的缓存, 用作`kmalloc`内存的来源. 为此, 针对所需的各个缓存长度, 分别调用`kmem_cache_create`. 该函数起初只需要`cache_cache`缓存已经建立. 但在初始化`per-CPU`缓存时，该函数必须借助于`kmalloc`, 这尚且不可能. - -为解决该问题, 内核使用了g_cpucache_up变量，可接受以下4个值（NONE、PARTIAL_AC、 -PARTIAL_L3、FULL），以反映kmalloc初始化的状态。 -最初内核的状态是NONE。在最小的kmalloc缓存（在4 KiB内存页的计算机上提供32字节内存块， -在其他页长度的情况下提供64字节内存块。现有各种分配长度的定义请参见3.6.5节）初始化时，再次 -将一个静态变量用于per-CPU的缓存数据。 -g_cpucache_up中的状态接下来设置为PARTIAL_AC，意味着array_cache实例可以立即分配。 - - -不仅slab, 每个内核分配器都应该提供一个`kmem_cache_init`函数. - -| kmem_cache_init | slab | slob | slub | -|:-------------------:|:-----:|:-----:|:-----:| -| 初始化slab分配器 | [mm/slab.c?v=4.7, line 1298](http://lxr.free-electrons.com/source/mm/slab.c?v=4.7#L1298) | [mm/slob.c?v=4.7, line 649](http://lxr.free-electrons.com/source/mm/slob.c?v=4.7#L649) | [mm/slub.c?v=4.7, line 3913](http://lxr.free-electrons.com/source/mm/slub.c?v=4.7#L3913) | - -```cpp -/* - * Initialisation. Called after the page allocator have been initialised and - * before smp_init(). - */ -void __init kmem_cache_init(void) -{ - int i; - - BUILD_BUG_ON(sizeof(((struct page *)NULL)->lru) < - sizeof(struct rcu_head)); - kmem_cache = &kmem_cache_boot; - - if (!IS_ENABLED(CONFIG_NUMA) || num_possible_nodes() == 1) - use_alien_caches = 0; - - for (i = 0; i < NUM_INIT_LISTS; i++) - kmem_cache_node_init(&init_kmem_cache_node[i]); - - /* - * Fragmentation resistance on low memory - only use bigger - * page orders on machines with more than 32MB of memory if - * not overridden on the command line. - */ - if (!slab_max_order_set && totalram_pages > (32 << 20) >> PAGE_SHIFT) - slab_max_order = SLAB_MAX_ORDER_HI; - - /* Bootstrap is tricky, because several objects are allocated - * from caches that do not exist yet: - * 1) initialize the kmem_cache cache: it contains the struct - * kmem_cache structures of all caches, except kmem_cache itself: - * kmem_cache is statically allocated. - * Initially an __init data area is used for the head array and the - * kmem_cache_node structures, it's replaced with a kmalloc allocated - * array at the end of the bootstrap. - * 2) Create the first kmalloc cache. - * The struct kmem_cache for the new cache is allocated normally. - * An __init data area is used for the head array. - * 3) Create the remaining kmalloc caches, with minimally sized - * head arrays. - * 4) Replace the __init data head arrays for kmem_cache and the first - * kmalloc cache with kmalloc allocated arrays. - * 5) Replace the __init data for kmem_cache_node for kmem_cache and - * the other cache's with kmalloc allocated memory. - * 6) Resize the head arrays of the kmalloc caches to their final sizes. - */ - - /* 1) create the kmem_cache */ - - /* - * struct kmem_cache size depends on nr_node_ids & nr_cpu_ids - */ - create_boot_cache(kmem_cache, "kmem_cache", - offsetof(struct kmem_cache, node) + - nr_node_ids * sizeof(struct kmem_cache_node *), - SLAB_HWCACHE_ALIGN); - list_add(&kmem_cache->list, &slab_caches); - slab_state = PARTIAL; - - /* - * Initialize the caches that provide memory for the kmem_cache_node - * structures first. Without this, further allocations will bug. - */ - kmalloc_caches[INDEX_NODE] = create_kmalloc_cache("kmalloc-node", - kmalloc_size(INDEX_NODE), ARCH_KMALLOC_FLAGS); - slab_state = PARTIAL_NODE; - setup_kmalloc_cache_index_table(); - - slab_early_init = 0; - - /* 5) Replace the bootstrap kmem_cache_node */ - { - int nid; - - for_each_online_node(nid) { - init_list(kmem_cache, &init_kmem_cache_node[CACHE_CACHE + nid], nid); - - init_list(kmalloc_caches[INDEX_NODE], - &init_kmem_cache_node[SIZE_NODE + nid], nid); - } - } - - create_kmalloc_caches(ARCH_KMALLOC_FLAGS); -} -``` - -`kmem_cache_init`用来初始化`cache`, 在初始化阶段使用了全局静态变量`struct kmem_cache *kmem_cache` - -```cpp -// http://lxr.free-electrons.com/source/mm/slab.c?v=4.7#L1304 -kmem_cache = &kmem_cache_boot; -``` - - -这个变量是用来管理所有`cache`的`kmem_cache`的, 也就是说, 在初始化阶段, 将会创建一个`slab`, 用来存放所有`cache`的`kmem_cache`, 而创建`kmem_cache`是通过`kmem_cache_create`来创建的. - -```cpp -#define BOOT_CPUCACHE_ENTRIES 1 -/* internal cache of cache description objs */ -static struct kmem_cache kmem_cache_boot = { - .batchcount = 1, - .limit = BOOT_CPUCACHE_ENTRIES, - .shared = 1, - .size = sizeof(struct kmem_cache), - .name = "kmem_cache", -}; -``` - -kmem_cache_init可以分为六个阶段 - -| 阶段 | 描述 | -|:-----:|:-----:| -| 第一个阶段 | 是根据kmem_cache来设置cache_cache的字段值 | -| 第二个阶段 | 首先是创建arraycache_init对应的高速缓存，同时也是在这个kmem_cache_create的调用过程中，创建了用于保存cache的kmem_cache的slab，并初始化了slab中的各个对象 | -| 第三个阶段 | 创建kmem_list3对应的高速缓存，在这里要注意的一点是，如果sizeof(arraycache_t)和sizeof(kmem_list3)的大小一样大，那么就不再使用kmem_cache_create来为kmem_list3创建cache了，因为如果两者相等的话，两者就可以使用同一个cache | -| 第四个阶段 | 创建并初始化所有的通用cache和dma cache | -| 第五个阶段 | 创建两个arraycache_init对象，分别取代cache_cache中的array字段和malloc_sizes[INDEX_AC].cs_cachep->array字段 | -| 第六个阶段 | 创建两个kmem_list3对象，取代cache_cache中的kmem_list3字段和malloc_sizes[INDEX_AC].cs_cachep->nodelist3字段.如此一来，经过上面的六个阶段后，所有的初始化工作基本完成了 | - ->关于kmem_cache_init函数参见 -> ->[Linux内存管理Slab分配器](http://www.uml.org.cn/embeded/201210165.asp) -> ->[linux内存管理之kmem_cache_init ](http://blog.chinaunix.net/xmlrpc.php?r=blog/article&uid=20786208&id=4831194) -> ->[Linux 内存管理：Kmem_cache_init](http://blog.jobbole.com/91883/) -> ->[ kmem_cache_init初始化文字解析](http://blog.chinaunix.net/uid-20729583-id-1884621.html) - -##4.3 创建缓存 -------- - -创建新的`slab`缓存必须调用`kmem_cache_create`. 该函数需要很多参数 - -```cpp -mm/slab.c -struct kmem_cache *kmem_cache_create(const char *name, - size_t size, - size_t align, - unsigned long flags, - void (*ctor)(void *)) -``` - -除了可读的`name`随后会出现在`/proc/slabinfo`以外, 该函数需要被管理对象以字节计的长度, 在对齐数据时使用的偏移量(`align`, 几乎所有的情形下都是0），flags中是一组标志，而ctor是构造函数. - - - -该函数定义在[mm/slab_common.c?v=4.7, line 388](http://lxr.free-electrons.com/source/mm/slab_common.c?v=4.7#L388) - -| 参数 | 描述 | -|:-----:|:-----:| -| name | 存放着告诉缓存的名字 | -| size | 告诉缓存中每个元素的大小 | -| align | slab内第一个对象的偏移, 用来确保在页内进行特定的对齐, 通常情况下为0, 即标准对齐 | -| flags |配置项, 用来控制告诉缓存的行为. | -| ctor | 高速缓存的构造函数. 只有在新的页追加到高速缓存时, 构造函数才被调用 | - -flags参数是可选的配置项, 用来控制高速缓存的行为. 它可以为0, 表示没有特殊的行为, 或者与以下标志中的一个或多个"或"运算. - -| flags标志 | 描述 | -|:----------:|:-----:| -| SLAB_HWCACHE_ALIGN | | -| SLAB_POISON | | -| SLAB_RED_ZONE | | -| SLAB_PANIC | | -| SLAB_CACHE_DMA | | - - -关于最后一个参数ctor是告诉缓存的构造函数. 只有在新的页追加到高速缓存时, 构造函数才被调用. 实际上, Linux内核的高速缓存不使用构造函数. 事实上这里曾经还有过一个析构函数参数, 但是由于内核代码不使用它, 因此已经被抛弃了. 你可以将ctor参数赋值为NULL. - -`kmem_cache_create`在成功时返回一个指向所构造的高速缓存的针; 否则, 返回NULL. 注意该函数可能会睡眠, 因此不能再中断上下文中调用. - - - -##4.4 分配对象kmem_cache_alloc -------- - - -`kmem_cache_alloc`用于从特定的缓存获取对象. 类似于所有的`malloc`函数, 其结果可能是指向分配内存区的指针, 也可能分配失败, 返回`NULL`指针. - - ->void *kmem_cache_alloc(struct kmem_cache *cachep, gfp_t flags) - - -该函数从给定的高速缓存cachep中返回一个指向对象的指针. 如果高速缓存中的所有slab中没有空闲的对象, 那么slab层就必须通过kmem_getpages获取新的页, flags的值传递给__get_free_pages函数. 这与我们之前所看到的标志相同. 你用到的应该是GFP_KERNEL或GFP_ATOMIC。 - -该函数需要两个参数 : 用于获取对象的缓存, 以及精确描述分配特征的标志变量. 之前提到的任何GFP_值都可以用于指定标志 - -```cpp -/** - * kmem_cache_alloc - Allocate an object - * @cachep: The cache to allocate from. - * @flags: See kmalloc(). - * - * Allocate an object from this cache. The flags are only relevant - * if the cache has no available objects. - */ -void *kmem_cache_alloc(struct kmem_cache *cachep, gfp_t flags) -{ - void *ret = slab_alloc(cachep, flags, _RET_IP_); - - kasan_slab_alloc(cachep, ret, flags); - trace_kmem_cache_alloc(_RET_IP_, ret, - cachep->object_size, cachep->size, flags); - - return ret; -} -EXPORT_SYMBOL(kmem_cache_alloc); -``` - - - -给出了cache_grow的代码流程图 - - -##4.5 释放对象kmem_cache_free -------- - - -如果一个分配的对象已经不再需要, 那么必须使用`kmem_cache_free`将对象释放, 并返回给`slab`分配器. 这样就能把cachep中的对象标记为空闲. - ->void kmem_cache_free(struct kmem_cache *cachep, void *objp) - - - -每一个分配器都应该实现一个`kmem_cache_free`函数 - - -| kmem_cache_free | slab | slob | slub | -|:--------------------:|:-----:|:-----:|:-----:| -| 释放对象 | [mm/slab.c?v=4.7, line 3800](http://lxr.free-electrons.com/source/mm/slab.c?v=4.7#L3800) | [mm/slob.c?v=4.7, line 598](http://lxr.free-electrons.com/source/mm/slob.c?v=4.7#L598) | [mm/slub.c?v=4.7, line 2814](http://lxr.free-electrons.com/source/mm/slub.c?v=4.7#L2814) | - - -`slab`分配器的`kmem_cache_free`函数定义在[mm/slab.c?v=4.7#L3800](http://lxr.free-electrons.com/source/mm/slab.c?v=4.7#L3800) - - -`kmem_cache_free`立即调用了`__cache_free`, 参数直接传递过去。其原因也是防止kfree实现中. - -类似于分配，根据per-CPU缓存的状态不同，有两种可选的操作流程。如果per-CPU缓存中的对象数目低于允许的限制，则在其中存储一个指向缓存中对象的指针. - - - -```cpp -/** - * kmem_cache_free - Deallocate an object - * @cachep: The cache the allocation was from. - * @objp: The previously allocated object. - * - * Free an object which was previously allocated from this - * cache. - */ -void kmem_cache_free(struct kmem_cache *cachep, void *objp) -{ - unsigned long flags; - cachep = cache_from_obj(cachep, objp); - if (!cachep) - return; - - local_irq_save(flags); - debug_check_no_locks_freed(objp, cachep->object_size); - if (!(cachep->flags & SLAB_DEBUG_OBJECTS)) - debug_check_no_obj_freed(objp, cachep->object_size); - __cache_free(cachep, objp, _RET_IP_); - local_irq_restore(flags); - - trace_kmem_cache_free(_RET_IP_, objp); -} -EXPORT_SYMBOL(kmem_cache_free); -``` - -##4.6 销毁缓存 -------- - - -如果要销毁只包含未使用对象的一个缓存, 则必须调用`kmem_cache_destroy`函数. - -该函数主要在删除模块时调用, 此时需要将分配的内存都释放. - -由于该函数的实现没什么新东西, 下面我们只是概述一下删除缓存的主要步骤. - -* 依次扫描`slabs_free`链表上的`slab`. 首先对每个`slab`上的每个对象调用析构器函数，然后将slab的内存空间返回给伙伴系统. - -* 释放用于`per-CPU`缓存的内存空间。 - -* 从`cache_cache`链表移除相关数据。 - - -与kmem_cache_create类似, 不能在中断上下文中调用这个函数. 因为它也可能睡眠. 调用该函数之前必须确保一下两个条件 - -* 告诉缓存中所有slab都必须是NULL, 其实, 不管哪个slab中, 只要还有一个对象被分配出去并正在使用, 那么就不能撤销该告诉缓存 - -* 在调用`kmem_cache_destroy`过程中, 不再访问这个高速缓存. 调用者必须确保这种同步. - -该函数在成功时返回0, 否则返回非0. - - -slab分配器中该函数定义在[mm/slab_common.c?v=4.7, line 706](http://lxr.free-electrons.com/source/mm/slab_common.c?v=4.7#L706) - -```cpp -void kmem_cache_destroy(struct kmem_cache *s) -{ - LIST_HEAD(release); - bool need_rcu_barrier = false; - int err; - - if (unlikely(!s)) - return; - - get_online_cpus(); - get_online_mems(); - - kasan_cache_destroy(s); - mutex_lock(&slab_mutex); - - s->refcount--; - if (s->refcount) - goto out_unlock; - - err = shutdown_memcg_caches(s, &release, &need_rcu_barrier); - if (!err) - err = shutdown_cache(s, &release, &need_rcu_barrier); - - if (err) { - pr_err("kmem_cache_destroy %s: Slab cache still has objects\n", - s->name); - dump_stack(); - } -out_unlock: - mutex_unlock(&slab_mutex); - - put_online_mems(); - put_online_cpus(); - - release_caches(&release, need_rcu_barrier); -} -EXPORT_SYMBOL(kmem_cache_destroy); -``` - -##4.7 slab分配器的使用实例 -------- - -我们来讲解一个slab分配器使用的鲜活的例子. 这个例子创建了task_struct结构, 取自`kernel/fork.c` - -首先, 内核用一个全局变量存放指向`task_struct`高速缓存的指针`task_struct_cachep`. 定义在[`kernel/fork.c, line 1733`](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L1733) - - -```cpp -#ifndef CONFIG_ARCH_TASK_STRUCT_ALLOCATOR -static struct kmem_cache *task_struct_cachep; - -static inline struct task_struct *alloc_task_struct_node(int node) -{ - return kmem_cache_alloc_node(task_struct_cachep, GFP_KERNEL, node); -} - -static inline void free_task_struct(struct task_struct *tsk) -{ - kmem_cache_free(task_struct_cachep, tsk); -} -#endif -``` - -在内核的初始化期间, 在定义`kernel/fork.c`的fork_init中会创建高速缓存, 参见[`kernel/fork.c?v=4.7, line 312·](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L312) - -```cpp -void __init fork_init(void) -{ -#ifndef CONFIG_ARCH_TASK_STRUCT_ALLOCATOR - -#ifndef ARCH_MIN_TASKALIGN - #define ARCH_MIN_TASKALIGN L1_CACHE_BYTES -#endif - - /* create a slab on which task_structs can be allocated */ - task_struct_cachep = kmem_cache_create("task_struct", - arch_task_struct_size, ARCH_MIN_TASKALIGN, - SLAB_PANIC|SLAB_NOTRACK|SLAB_ACCOUNT, NULL); -#endif - /* ...... */ -} -``` - -这样就创建了一个名为`task_struct`的高速缓存, 其中存放的就是类型为`struct task_struct`的对象. 该对象创建后存放在slab中偏移量为`ARCH_MIN_TASKALIGN`个字节的地方. `ARCH_MIN_TASKALIGN`的预定值与[体系结构相关](http://lxr.free-electrons.com/ident?i=L1_CACHE_BYTES), 通常将它定义为`L1_CACHE_BYTES`, 即L1高速缓存的字节大小. 没有构造函数或析构函数. 注意不同检查返回值是否为失败标记`NULL`. 因为`SLAB_PANIC`已经被设置了. 如果分配失败, `slab`分配器就调用`panic()`函数. 如果没有提供`SLAB_PANIC`标志, 就必须自己检查返回值. `SLAB_PANIC`标志用在这儿是因为这是系统操作必不可少的高速缓存(没有进程描述符, 机器自然不能正常运行). - -每当进程调用`fork`函数时, 一定会创建一个新的进程描述符. 这是在`dup_task_struct`中通过`alloc_task_struct_node`完成的, 而前者则会被_do_fork函数调用, 参见[kernel/fork.c?v=4.7, line 351](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L351) - -```cpp -static struct task_struct *dup_task_struct(struct task_struct *orig, int node) -{ - struct task_struct *tsk; - /* ...... */ - tsk = alloc_task_struct_node(node); - if (!tsk) - return NULL; - /* ...... */ -} -``` - -同样进程执行完后, 如果没有子进程在等待的话, 它的进程描述符就会被释放, 并返回个`task_structcachep`的`slab`高速缓存. 这是在`free_task_struct`中通过`kmem_cache_free`完成的. - - -`alloc_task_struct_node`和`free_task_struct`函数分别用来分配和释放进程描述符 - - -| 函数 | 功能 | 定义 | 调用流程 | -|:-----:|:-----:|:-----:|:---------:| -| alloc_task_struct_node | 从task_struct_cachep slab高速缓存中分配一个进程描述符 | [kernel/fork.c?v=4.7, line 140](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L140) | [_do_fork](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L1762)
[copy_process](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L1339)
[dup_task_struct](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L355)
[alloc_task_struct_node](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L142) | -| free_task_struct | 释放进程描述符, 并返回给从task_struct_cachep slab高速缓存 | [kernel/fork.c?v=4.7, line 145](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L145) | [free_task](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L240)
[free_task_struct](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L145) - - -这两个函数定义在[kernel/fork.c?v=4.7, line 140](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L140) - - -```cpp -#ifndef CONFIG_ARCH_TASK_STRUCT_ALLOCATOR -static struct kmem_cache *task_struct_cachep; - -static inline struct task_struct *alloc_task_struct_node(int node) -{ - return kmem_cache_alloc_node(task_struct_cachep, GFP_KERNEL, node); -} - -static inline void free_task_struct(struct task_struct *tsk) -{ - kmem_cache_free(task_struct_cachep, tsk); -} -#endif -``` - -由于进程描述符是内核的核心组成部分, 时刻都要用到, 因此`task_struct_cachep`高速缓存绝不会被撤销掉. 即使真能撤销, 我们也要铜鼓下列函数阻止其被撤销. - - - - - - -##5 通用缓存 -------- - -如果不涉及对象缓存, 而是传统意义上的分配/释放内存, 则必须调用`kmalloc`和`kfree`函数. 这两个函数, 相当于用户空间中C标准库`malloc`和`free`函数的内核等价物. - - -我已经提过几次, `kmalloc`和`kfree`实现为`slab`分配器的前端, 其语义尽可能地模仿malloc/free. - -因此我们只简单讨论一下其实现 - - -##5.1 kmalloc函数的实现 -------- - -`kmalloc`的基础是一个数组, 其中是一些分别用于不同内存长度的`slab`缓存. -数组项是`cache_sizes`的实例, 该数据结构定义如下: - - - - -http://guojing.me/linux-kernel-architecture/posts/slab-structure/ - -http://blog.chinaunix.net/uid-24178783-id-370321.html - -http://www.cnblogs.com/openix/p/3351656.html - +slab分配器 +======= + +| 日期 | 内核版本 | 架构| 作者 | GitHub| CSDN | +| ------- |:-------:|:-------:|:-------:|:-------:|:-------:| +| 2016-06-14 | [Linux-4.7](http://lxr.free-electrons.com/source/?v=4.7) | X86 & arm | [gatieme](http://blog.csdn.net/gatieme) | [LinuxDeviceDrivers](https://github.com/gatieme/LDD-LinuxDeviceDrivers) | [Linux内存管理](http://blog.csdn.net/gatieme/article/category/6225543) | + + +#2 slab分配器 +------- + +##2.1 slab分配器 +------- + +每个C程序员都熟悉malloc, 及其在C标准库中的相关函数. 大多数程序分配若干字节内存时. 经常会调用这些函数. + +内核也必须经常分配内存, 但无法借助于标准库的函数. 上面描述的伙伴系统支持按页分配内存, 但这个单位太大了. 如果需要为一个10个字符的字符串分配空间, 分配一个4 KiB或更多空间的完整页面, 不仅浪费而且完全不可接受. +显然的解决方案是将页拆分为更小的单位, 可以容纳大量的小对象. + +为此必须引入新的管理机制, 这会给内核带来更大的开销. 为最小化这个额外负担对系统性能的影响, 该管理层的实现应该尽可能紧凑, 以便不要对处理器的高速缓存和TLB带来显著影响. 同时, 内核还必须保证内存利用的速度和效率. 不仅Linux, 而且类似的UNIX和所有其他的操作系统, 都需要面对这个问题. 经过一定的时间, 已经提出了一些或好或坏的解决方案, 在一般的操作系统文献中都有讲解 + +此类提议之一, 所谓slab分配, 证明对许多种类工作负荷都非常高效. 它是由Sun公司的一个雇员`Jeff Bonwick`，在`Solaris 2.4`中设计并实现的. 由于他公开了其方法, 因此也可以为Linux实现一个版本. + +提供小内存块不是slab分配器的唯一任务. 由于结构上的特点. 它也用作一个缓存. 主要针对经常分配并释放的对象. 通过建立slab缓存, 内核能够储备一些对象, 供后续使用, 即使在初始化状态, 也是如此. + +举例来说, 为管理与进程关联的文件系统数据, 内核必须经常生成`struct fs_struct`的新实例. 此类型实例占据的内存块同样需要经常回收(在进程结束时). 换句话说, 内核趋向于非常有规律地分配并释放大小为`sizeof{fs_struct}`的内存块. slab分配器将释放的内存块保存在一个内部列表中. 并不马上返回给伙伴系统. 在请求为该类对象分配一个新实例时, 会使用最近释放的内存块. 这有两个优点. 首先, 由于内核不必使用伙伴系统算法, 处理时间会变短. 其次, 由于该内存块仍然是"新"的，因此其仍然驻留在CPU高速缓存的概率较高. + + +slab分配器还有两个更进一步的好处 + +* 调用伙伴系统的操作对系统的数据和指令高速缓存有相当的影响。内核越浪费这些资源, 这些资源对用户空间进程就越不可用. 更轻量级的slab分配器在可能的情况下减少了对伙伴系统的调用, 有助于防止不受欢迎的缓存"污染". + +* 如果数据存储在伙伴系统直接提供的页中，那么其地址总是出现在2的幂次的整数倍附近(许多将页划分为更小块的其他分配方法, 也有同样的特征). 这对CPU高速缓存的利用有负面影响, 由于这种地址分布, 使得某些缓存行过度使用, 而其他的则几乎为空. 多处理器系统可能会加剧这种不利情况, 因为不同的内存地址可能在不同的总线上传输, 上述情况会导致某些总线拥塞, 而其他总线则几乎没有使用. + +通过slab着色(slab coloring), slab分配器能够均匀地分布对象, 以实现均匀的缓存利用 + + +经常使用的内核对象保存在CPU高速缓存中，这是我们想要的效果。前文的注释提到, 从`slab`分配器的角度进行衡量, 伙伴系统的高速缓存和TLB占用较大, 这是一个负面效应. + +因为这会导致不重要的数据驻留在`CPU`高速缓存中, 而重要的数据则被置换到内存, 显然应该防止这种情况出现. + +>着色这个术语是隐喻性的. 它与颜色无关, 只是表示slab中的对象需要移动的特定偏移量, 以便使对象放置到不同的缓存行. + +`slab`分配器由何得名?各个缓存管理的对象，会合并为较大的组，覆盖一个或多个连续页帧. 这种组称作slab，每个缓存由几个这种slab组成. + + +#2.2 备选slab分配器 +------- + + +尽管slab分配器对许多可能的工作负荷都工作良好, 但也有一些情形, 它无法提供最优性能. 如果某些计算机处于当前硬件尺度的边界上, 在此类计算机上使用slab分配会出现一些问题 : 微小的嵌入式系统, 配备有大量物理内存的大规模并行系统. 在第二种情况下, slab分配器所需的大量元数据可能成为一个问题 : 开发者称在大型系统上仅slab的数据结构就需要很多吉字节内存. 对嵌入式系统来说, slab分配器代码量和复杂性都太高. + +为处理此类情形, 在内核版本2.6开发期间, 增加了slab分配器的两个替代品. + +* `slob`分配器进行了特别优化, 以便减少代码量. 它围绕一个简单的内存块链表展开(因此而得名). 在分配内存时, 使用了同样简单的最先适配算法.`slob`分配器只有大约600行代码, 总的代码量很小. 事实上, 从速度来说, 它不是最高效的分配器, 也肯定不是为大型系统设计的. + +* `slub`分配器通过将页帧打包为组，并通过`struct page`中未使用的字段来管理这些组，试图最小化所需的内存开销。读者此前已经看到，这样做不会简化该结构的定义，但在大型计算机上`slub`比`slab`提供了更好的性能，说明了这样做是正确的. + +由于`slab`分配是大多数内核配置的默认选项，我不会详细讨论备选的分配器. 但有很重要的一点需要强调, 内核的其余部分无需关注底层选择使用了哪个分配器. 所有分配器的前端接口都是相同的. + +每个分配器都必须实现一组特定的函数, 用于内存分配和缓存 + + +* `kmalloc`、`__kmalloc`和`kmalloc_node`是一般的(特定于结点)内存分配函数. + +* `kmem_cache_alloc`、`kmem_cache_alloc_node`提供（特定于结点）特定类型的内核缓存. + +下文在讨论`slab`分配器时，会讲解这些函数的行为. 使用这些标准函数, 内核可以提供更方便的函数, 而不涉及内存在内部具体如何管理. 举例来说, kcalloc为数组分配内存，而kzalloc分配一个填充字节0的内存区. + +普通内核代码只需要包含slab.h，即可使用内存分配的所有标准内核函数。连编系统会保证使用编译时选择的分配器，来满足程序的内存分配请求 + + + +##2.3 内核中的内存管理 +------- + +内核中一般的内存分配和释放函数与C标准库中等价函数的名称类似，用法也几乎相同. + +* `kmalloc(size, flags)`分配长度为`size`字节的一个内存区, 并返回指向该内存区起始处的一个`void`指针. 如果没有足够内存(在内核中这种情形不大可能, 但却始终要考虑到), 则结果为`NULL`指针. `flags`参数使用之前讨论的GFP_常数，来指定分配内存的具体内存域，例如GFP_DMA指定分配适合于DMA的内存区. + +* `kfree(*ptr)`释放`*ptr`指向的内存区. + + +与用户空间程序设计相比, 内核还包括`percpu_alloc`和`percpu_free`函数，用于为各个系统CPU分配和释放所需内存区(不是明确地用于当前活动CPU). + +`kmalloc`在内核源代码中的使用数以千计, 但模式都是相同的. 用`kmalloc`分配的内存区, 首先通过类型转换变为正确的类型, 然后赋值到指针变量. + +>info = (struct cdrom_info *) kmalloc (sizeof (struct cdrom_info), GFP_KERNEL); + +从程序员的角度来看，建立和使用缓存的任务不是特别困难. 必须首先用`kmem_cache_create`建立一个适当的缓存, 接下来即可使用`kmem_cache_alloc`和`kmem_cache_free`分配和释放其中包含的对象。slab分配器负责完成与伙伴系统的交互，来分配所需的页. + +所有活动缓存的列表保存在`/proc/slabinfo`中(为节省空间，下文的输出省去了不重要的部分). + +![cat /proc/slabinfo](./images/cat_procinfo.png) + +
我们可以从其中检索到一些特定的高速缓存的信息, 比如task_struct, mm_struct等. + +
+ +![cat /proc/slabinfo](./images/cat_procinfo_task_struct.png) + + +输出的各列除了包含用于标识各个缓存的字符串名称(也确保不会创建相同的缓存)之外, 还包含下列信息. + + +* 缓存中活动对象的数量。 + +* 缓存中对象的总数（已用和未用）。 + +* 所管理对象的长度，按字节计算。 + +* 一个slab中对象的数量。 + +* 每个slab中页的数量。 + +* 活动slab的数量。 + +* 在内核决定向缓存分配更多内存时, 所分配对象的数量. 每次会分配一个较大的内存块, 以减少与伙伴系统的交互. 在缩小缓存时，也使用该值作为释放内存块的大小. + + +除了容易识别的缓存名称如`unix_sock`(用于UNIX域套接字, 即`struct unix_sock`类型的对象), 还有其他字段名称`kmalloc-size`. 提供DMA内存域的计算机还包括用于DMA分配的缓存, 在上述的例子中没有. 这些是kmalloc函数的基础，是内核为不同内存长度提供的slab缓存，除极少例外，其长度都是2的幂次，长度的范围从`2^5=32`B（用于页大小为4 KiB的计算机）或64B（所有其他计算机）,到225B. 上界也可以更小，是由`KMALLOC_MAX_SIZE`设置, 后者根据系统页大小和最大允许的分配阶计算: + +```cpp + +#define KMALLOC_SHIFT_HIGH ((MAX_ORDER + PAGE_SHIFT -1) <= 25 ? \ +(MAX_ORDER + PAGE_SHIFT -1) : 25) +#define KMALLOC_MAX_SIZE (1UL << KMALLOC_SHIFT_HIGH) +#define KMALLOC_MAX_ORDER (KMALLOC_SHIFT_HIGH -PAGE_SHIFT) +``` + +每次调用`kmalloc`时, 内核找到最适合的缓存, 并从中分配一个对象满足请求(如果没有刚好适合的缓存，则分配稍大的对象，但不会分配更小的对象). + +在实际实现中，上文中的`slab`分配器和缓存之间的差异迅速消失，以至于本书后文中将这两个名词用作同义词。在讨论slab分配器的实现之后 + + + +#3 slab分配的原理 +------- + +`slab`分配器由一个紧密地交织的数据和内存结构的网络组成, 初看起来不容易理解其运作方式. + +因此在考察其实现之前, 重要的是获得各个结构之间关系的概观。 +基本上, slab缓存由图3-44所示的两部分组成：保存管理性数据的缓存对象和保存被管理对象的各个slab. + +![slab分配器的各部分](./images/slab.png) + +每个缓存只负责一种对象类型（例如struct unix_sock实例），或提供一般性的缓冲区。各个缓存中slab的数目各有不同，这与已经使用的页的数目、对象长度和被管理对象的数目有关。3.6.4节将更详细地描述缓存长度的计算方式。 +另外，系统中所有的缓存都保存在一个双链表中。这使得内核有机会依次遍历所有的缓存。这是有必要的，例如在即将发生内存不足时，内核可能需要缩减分配给缓存的内存数量. + + + +##3.1 缓存的精细结构 +------- + + +如果我们更仔细地研究缓存的结构，就可以注意到一些更重要的细节。图3-45给出了缓存各组成部分的概述. +除了管理性数据（如已用和空闲对象或标志寄存器的数目），缓存结构包括两个特别重要的成员. + +* 指向一个数组的指针, 其中保存了各个CPU最后释放的对象. + +* 每个内存结点都对应3个表头，用于组织slab的链表 + 第1个链表包含完全用尽的slab，第2个是部分空闲的slab，第3个是空闲的slab + + +![slab缓存的精细结构](./images/slab_struct.png) + + +缓存结构指向一个数组, 其中包含了与系统CPU数目相同的数组项. 每个元素都是一个指针，指向一个进一步的结构称之为数组缓存(array cache), 其中包含了对应于特定系统CPU的管理数据(就总体来看，不是用于缓存). 管理性数据之后的内存区包含了一个指针数组，各个数组项指向slab中未使用的对象. + + +为最好地利用CPU高速缓存, 这些per-CPU指针是很重要的。在分配和释放对象时，采用后进先出原理(LIFO，last in first out). 内核假定刚释放的对象仍然处于CPU高速缓存中，会尽快再次分配它(响应下一个分配请求). 仅当per-CPU缓存为空时，才会用slab中的空闲对象重新填充它们. + + +这样，对象分配的体系就形成了一个三级的层次结构，分配成本和操作对CPU高速缓存和TLB的负面影响逐级升高. + +1. 仍然处于CPU高速缓存中的per-CPU对象 + +2. 现存slab中未使用的对象 + +3. 刚使用伙伴系统分配的新slab中未使用的对象 + +![slab缓存的精细结构](./images/slab_struct2.png) + + +##3.2 slab的精细结构 +------- + + +对象在slab中并非连续排列，而是按照一个相当复杂的方案分布。图3-46说明了相关细节. + + +用于每个对象的长度并不反映其确切的大小. 相反, 长度已经进行了舍入，以满足某些对齐方式的要求. 有两种可用的备选对齐方案. + + +* slab创建时使用标志SLAB_HWCACHE_ALIGN，slab用户可以要求对象按硬件缓存行对齐. 那么会按照cache_line_size的返回值进行对齐，该函数返回特定于处理器的L1缓存大小。 +如果对象小于缓存行长度的一半，那么将多个对象放入一个缓存行。 + + +* 如果不要求按硬件缓存行对齐，那么内核保证对象按BYTES_PER_WORD对齐，该值是表示`void`指针所需字节的数目. + + +在32位处理器上，`void`指针需要4个字节。因此，对有6个字节的对象，则需要8 = 2×4个字节, 15个字节的对象需要16=4×4个字节。多余的字节称为填充字节. + + +填充字节可以加速对slab中对象的访问。如果使用对齐的地址, 那么在几乎所有的体系结构上, 内存访问都会更快. 这弥补了使用填充字节必然导致需要更多内存的不利情况. + + +管理结构位于每个slab的起始处，保存了所有的管理数据（和用于连接缓存链表的链表元素). + + +其后面是一个数组，每个（整数）数组项对应于slab中的一个对象。只有在对象没有分配时，相应的数组项才有意义。在这种情况下，它指定了下一个空闲对象的索引。由于最低编号的空闲对象的编号还保存在slab起始处的管理结构中，内核无需使用链表或其他复杂的关联机制，即可轻松找到当前可用的所有对象。 数组的最后一项总是一个结束标记，值为BUFCTL_END. + + +![slab缓存的精细结构](./images/slab_free_manage.png) + + +大多数情况下, slab内存区的长度(减去了头部管理数据)是不能被（可能填补过的）对象长度整除的。因此，内核就有了一些多余的内存，可以用来以偏移量的形式给slab"着色", 如上文所述. + + +缓存的各个slab成员会指定不同的偏移量，以便将数据定位到不同的缓存行，因而slab开始和结束处的空闲内存是不同的。在计算偏移量时，内核必须考虑其他的对齐因素. + + +例如，L1高速缓存中数据的对齐(下文讨论). + + +管理数据可以放置在slab自身，也可以放置到使用kmalloc分配的不同内存区中. 内核如何选择, 取决于slab的长度和已用对象的数量。相应的选择标准稍后讨论。管理数据和slab内存之间的关联很容易建立，因为slab头包含了一个指针，指向slab数据区的起始处(无论管理数据是否在slab上). + + +![slab缓存的精细结构](./images/slab_head.png) + + +最后，内核需要一种方法, 通过对象自身即可识别slab(以及对象驻留的缓存). 根据对象的物理内存地址, 可以找到相关的页, 因此可以在全局mem_map数组中找到对应的page实例. + + +我们已经知道，page结构包括一个链表元素，用于管理各种链表中的页。对于slab缓存中的页而言, 该指针是不必要的，可用于其他用途. + + +* page->lru.next指向页驻留的缓存的管理结构 + + +* page->lru.prev指向保存该页的slab的管理结构 + + +设置或读取slab信息分别由`set_page_slab`和`get_page_slab`函数完成，带有`_cache`后缀的函数则处理缓存信息的设置和读取. + + +```cpp +mm/slab.c +void page_set_cache(struct page *page, struct kmem_cache *cache) +struct kmem_cache *page_get_cache(struct page *page) +void page_set_slab(struct page *page, struct slab *slab) +struct slab *page_get_slab(struct page *page) +``` + + +此外，内核还对分配给`slab`分配器的每个物理内存页都设置标志`PG_SLAB`. + + +#4 实现 +------- + +为实现如上所述的`slab`分配器, 使用了各种数据结构. 尽管看上去并不困难，相关的代码并不总是容易阅读或理解. 这是因为许多内存区需要使用指针运算和类型转换进行操作, 这些可不是C语言中以清晰简明著称的领域。由于slab系统带有大量调试选项，所以代码中遍布着预处理器语句. + +其中一些如下列出. + +* 危险区(Red Zoning) + 在每个对象的开始和结束处增加一个额外的内存区，其中填充已知的字节模式. 如果模式被修改, 程序员在分析内核内存时注意到，可能某些代码访问了不属于它们的内存区. + +* 对象毒化(Object Poisoning) + 在建立和释放slab时，将对象用预定义的模式填充. 如果在对象分配时注意到该模式已经改变，程序员就知道已经发生了未授权访问. + +为简明起见，我们把注意力集中在整体而不是细节上。我们在下文不使用上述选项，只讲解一个"纯粹"的slab分配器. + + + +##4.1 数据结构 +------- + + +每个缓存由`kmem_cache`结构的一个实例表示, 将slab缓存视为通过一组标准函数来高效地创建和释放特定类型对象的机制 + +该结构定义在[mm/slab.h?v=4.7, line 19](http://lxr.free-electrons.com/source/mm/slab.h?v=4.7#L19), 内容如下 + + +| kmem_cache | slab | slob | slub | +|:--------------:|:-----:|:-----:|:-----:| +| [dent?i=kmem_cache](http://lxr.free-electrons.com/ident?v=4.7;i=kmem_cache) | [include/linux/slab_def.h?v=4.7, line 10](http://lxr.free-electrons.com/source/include/linux/slab_def.h?v=4.7#L10) | [mm/slab.h?v=4.7, line 19](http://lxr.free-electrons.com/source/mm/slab.h?v=4.7#L19) | [include/linux/slub_def.h?v=4.7, line 62](http://lxr.free-electrons.com/source/include/linux/slub_def.h?v=4.7#L62) | + + +```cpp +/* + * Definitions unique to the original Linux SLAB allocator. + */ + +struct kmem_cache { + // per-CPU数据，在每次分配/释放期间都会访问 + struct array_cache __percpu *cpu_cache; + +/* 1) Cache tunables. Protected by slab_mutex + * 可调整的缓存参数。由cache_chain_mutex保护 */ + // 要转移本地高速缓存的大批对象的数量 + unsigned int batchcount; + unsigned int limit; + // 本地高速缓存中空闲对象的最大数目 + unsigned int shared; + // 高速缓存的大小 + unsigned int size; + struct reciprocal_value reciprocal_buffer_size; + +/* 2) touched by every alloc & free from the backend + * 后端每次分配和释放内存时都会访问 */ + // 描述高速缓存永久属性的一组标志 + unsigned int flags; /* constant flags */ + // 封装在一个单独slab中的对象个数 + unsigned int num; /* # of objs per slab */ + +/* 3) cache_grow/shrink + * 缓存的增长/缩减 */ + /* order of pgs per slab (2^n) 一个单独slab中包含的连续页框数目的对数*/ + unsigned int gfporder; + + /* force GFP flags, e.g. GFP_DMA 强制的GFP标志，例如GFP_DMA */ + gfp_t allocflags; + + size_t colour; /* cache colouring range 缓存着色范围 */ + unsigned int colour_off; /* colour offset slab中的着色偏移 */ + struct kmem_cache *freelist_cache; + unsigned int freelist_size; + + /* constructor func 构造函数 */ + void (*ctor)(void *obj); + +/* 4) cache creation/removal + * 缓存创建/删除 */ + const char *name; // 存放高速缓存名字的字符数组 + struct list_head list; // 高速缓存描述符双向链表使用的指针 + int refcount; + int object_size; + int align; + +/* 5) statistics + * 统计量 */ +#ifdef CONFIG_DEBUG_SLAB + unsigned long num_active; + unsigned long num_allocations; + unsigned long high_mark; + unsigned long grown; + unsigned long reaped; + unsigned long errors; + unsigned long max_freeable; + unsigned long node_allocs; + unsigned long node_frees; + unsigned long node_overflow; + atomic_t allochit; + atomic_t allocmiss; + atomic_t freehit; + atomic_t freemiss; +#ifdef CONFIG_DEBUG_SLAB_LEAK + atomic_t store_user_clean; +#endif + + /* + * If debugging is enabled, then the allocator can add additional + * fields and/or padding to every object. size contains the total + * object size including these internal fields, the following two + * variables contain the offset to the user object and its size. + */ + int obj_offset; +#endif /* CONFIG_DEBUG_SLAB */ + +#ifdef CONFIG_MEMCG + struct memcg_cache_params memcg_params; +#endif +#ifdef CONFIG_KASAN + struct kasan_cache kasan_info; +#endif + +#ifdef CONFIG_SLAB_FREELIST_RANDOM + void *random_seq; +#endif + + struct kmem_cache_node *node[MAX_NUMNODES]; +}; +``` + +`kmem_cache`是`Linux`内核提供的快速内存缓冲接口, 这些内存块要求是大小相同的, 因为分配出的内存在接口释放时并不真正释放, 而是作为缓存保留, 下一次请求分配时就可以直接使用, 省去了各种内存块初始化或释放的操作, 因此分配速度很快, 通常用于大数量的内存块分配的情况, 如`inode`节点, `skbuff`头, `netfilter`的连接等, 其实`kmalloc`也是从`kmem_cache`中分配的，可通过`/proc/slabinfo`文件直接读取`cache`分配情况. + + +| 字段 | 说明 | +|:-----:|:-----:| +| cpu_cache | 是一个指向数组的指针，每个数组项都对应于系统中的一个CPU，每个数组项都包含了另一个指针，指向下文讨论的array_cache结构的实例 | +| batchcount | 指定了在per-CPU列表为空的情况下，从缓存的slab中获取对象的数目，它还表示在缓存增长时分配的对象数目 | +| limit | 指定了per-CPU列表中保存的对象的最大数目。如果超出了这个值，内核会将batchcount个对象返回到slab | +| size | 指定了缓存中管理的对象的长度1 | +| gfporder | 指定了slab包含的页数目以2为底的对数，简而言之，slab包含2^gfporder页 | +| colorur | 指定了颜色的最大数目 | +| colour_off | 基本偏移量乘以颜色值获得的绝对偏移量 | +| dflags | 另一标志集合，描述slab的动态性质 | +| ctor | 一个指针，指向在对象创建时调用的构造函数 | +| name | 一个字符串，表示缓存的名称 | +| list | 是一个标准链表元素 | + + + +这个冗长的结构分为多个部分，如源代码中的注释所示. + + +###4.1.1 per-cpu数据(第0~1部分) +------- + + +开始的几个成员涉及每次分配期间内核对特定于CPU数据的访问，在本节稍后讨论。 + +* cpu_cache是一个指向数组的指针，每个数组项都对应于系统中的一个CPU。每个数组项都包含了另一个指针，指向下文讨论的array_cache结构的实例。 + +* batchcount指定了在per-CPU列表为空的情况下，从缓存的slab中获取对象的数目。它还表示在缓存增长时分配的对象数目。 + +* limit指定了per-CPU列表中保存的对象的最大数目。如果超出该值，内核会将batchcount个对象返回到slab（如果接下来内核缩减缓存，则释放的内存从slab返回到伙伴系统） + + +内核对每个系统处理器都提供了一个`array_cache`实例. 该结构定义如下 + +```cpp +struct array_cache { + unsigned int avail; + unsigned int limit; + unsigned int batchcount; + unsigned int touched; + void *entry[]; /* + * Must have this definition in here for the proper + * alignment of array_cache. Also simplifies accessing + * the entries. + */ +}; +``` + + +* `batchcount`和`limit`的语义已经在上文给出, `kmem_cache_s`的值用作（通常不修改）`per-CPU`值的默认值，用于缓存的重新填充或清空. + +* `avail`保存了当前可用对象的数目. + +* 在从缓存移除一个对象时，将`touched`设置为1，而缓存收缩时, 则将`touched`设置为0。这使得内核能够确认在缓存上一次收缩之后是否被访问过，也是缓存重要性的一个标志。 + +* 最后一个成员`entry`是一个伪数组, 其中并没有数组项, 只是为了便于访问内存中`array_cache`实例之后缓存中的各个对象而已. + + +###4.1.2 基本数据变量 +------- + + +* kmem_cache的第2、第3部分包含了管理slab所需的全部变量，在填充或清空per-CPU缓存时需要访问这两部分. + +* node[MAX_NUMNODES];是一个数组，每个数组项对应于系统中一个可能的内存结点. 每个数组项都包含kmem_cache_node的一个实例, 该结构中有3个slab列表（完全用尽、空闲、部分空闲） + +该成员必须置于结构的末尾, 尽管它在形式上总是有MAX_NUMNODES项, 但在NUMA计算机上实际可用的结点数目可能会少一些。因而该数组需要的项数也会变少，内核在运行时对该结构分配比理论上更少的内存，就可以缩减该数组的项数。如果nodelists放置在该结构中间，就无法做到这一点. + +在UMA计算机上，这称不上问题，因为只有一个可用结点. + +* flags是一个标志寄存器，定义缓存的全局性质。当前只有一个标志位。如果管理结构存储在slab外部，则置位CFLGS_OFF_SLAB + +* `num`保存了可以放入slab的对象的最大数目 + +kmem_cache_node定义在[mm/slab.h?v=4.7, line 417](http://lxr.free-electrons.com/source/mm/slab.h?v=4.7#L417) + + +```cpp +/* + * The slab lists for all objects. + */ +struct kmem_cache_node { + spinlock_t list_lock; + +#ifdef CONFIG_SLAB + struct list_head slabs_partial; /* partial list first, better asm code */ + struct list_head slabs_full; + struct list_head slabs_free; + unsigned long free_objects; + unsigned int free_limit; + unsigned int colour_next; /* Per-node cache coloring */ + struct array_cache *shared; /* shared per node */ + struct alien_cache **alien; /* on other nodes */ + unsigned long next_reap; /* updated without locking */ + int free_touched; /* updated without locking */ +#endif + +#ifdef CONFIG_SLUB + unsigned long nr_partial; + struct list_head partial; +#ifdef CONFIG_SLUB_DEBUG + atomic_long_t nr_slabs; + atomic_long_t total_objects; + struct list_head full; +#endif +#endif + +}; +``` + +每个数组项都包含kmem_cache_node的一个实例, 该结构中有3个slab列表(完全用尽slabs_full、空闲slabs_free、部分空闲slabs_partial). + +kmem_cache_node作为早期内核中slab描述符struct slab结构的替代品, 要么放在slab自身开始的地方. 如果slab很小或者slab内部有足够的空间容纳slab描述符, 那么描述符就存放在slab里面. + +slab分配器可以创建新的slab, 这是通过kmem_getpages + + +##4.2 slab系统初始化 +------- + + +初看起来, `slab`系统的初始化不是特别麻烦，因为伙伴系统已经完全启用, 内核没有受到其他特别的限制. 尽管如此, 由于`slab`分配器的结构所致, 这里有一个鸡与蛋的问题. + +为初始化`slab`数据结构, 内核需要若干远小于一整页的内存块, 这些最适合由`kmalloc`分配. 这里是关键所在 : 只在`slab`系统已经启用之后，才能使用`kmalloc`. + +更确切地说, 该问题涉及`kmalloc`的`per-CPU`缓存的初始化. 在这些缓存能够初始化之前, `kmalloc`必须可以用来分配所需的内存空间, 而`kmalloc`自身也正处于初始化的过程中. 换句话说, `kmalloc`只能在`kmalloc`已经初始化之后初始化，这是个不可能的场景. 因此内核必须借助一些技巧. + + +###4.2.1 slab分配器的初始化过程 +------- + + +我们之前提到过系统是从start_kernel开始的, 完成了分页机制和内存基本数据结构的初始化, 并将内存管理从bootmem/memblock慢慢迁移到了buddy系统. + + +```cpp +start_kernel() + |---->page_address_init() + | + |---->setup_arch(&command_line); + | + |---->setup_per_cpu_areas(); + | + |---->build_all_zonelist() + | + |---->page_alloc_init() + | + |---->pidhash_init() + | + |---->vfs_caches_init_early() + | + |---->mm_init() +``` + +在完成后, 内核通过[mm_init](http://lxr.free-electrons.com/source/init/main.c?v=4.7#L464)完成了buddy伙伴系统, 该函数定义在[init/main.c?v=4.7, line 464](http://lxr.free-electrons.com/source/init/main.c?v=4.7#L464) + + +```cpp +static void __init mm_init(void) +{ + /* + * page_ext requires contiguous pages, + * bigger than MAX_ORDER unless SPARSEMEM. + */ + page_ext_init_flatmem(); + mem_init(); + kmem_cache_init(); + percpu_init_late(); + pgtable_init(); + vmalloc_init(); + ioremap_huge_init(); +} +``` + +内核通过函数`mem_init`完成了`bootmem/memblock`的释放工作, 从而将内存管理迁移到了`buddy`, 随后就通过`kmem_cache_init`完成了slab初始化分配器. + + +###4.2.2 kmem_cache_init函数初始化slab分配器 +------- + + +`kmem_cache_init`函数用于初始化`slab`分配器. 它在内核初始化阶段(`start_kernel`)、伙伴系统启用之后调用. 但在多处理器系统上，启动`CPU`此时正在运行, 而其他`CPU`尚未初始化. + +`kmem_cache_init`采用了一个多步骤过程，逐步激活slab分配器。 + +1. `kmem_cache_init`创建系统中的第一个`slab`缓存, 以便为`kmem_cache`的实例提供内存. 为此, 内核使用的主要是在编译时创建的静态数据. 实际上, 一个静态数据结构(`initarray_cache`)用作`per-CPU`数组. 该缓存的名称是`cache_cache`. + +2. `kmem_cache_init`接下来初始化一般性的缓存, 用作`kmalloc`内存的来源. 为此, 针对所需的各个缓存长度, 分别调用`kmem_cache_create`. 该函数起初只需要`cache_cache`缓存已经建立. 但在初始化`per-CPU`缓存时，该函数必须借助于`kmalloc`, 这尚且不可能. + +为解决该问题, 内核使用了g_cpucache_up变量，可接受以下4个值（NONE、PARTIAL_AC、 +PARTIAL_L3、FULL），以反映kmalloc初始化的状态。 +最初内核的状态是NONE。在最小的kmalloc缓存（在4 KiB内存页的计算机上提供32字节内存块， +在其他页长度的情况下提供64字节内存块。现有各种分配长度的定义请参见3.6.5节）初始化时，再次 +将一个静态变量用于per-CPU的缓存数据。 +g_cpucache_up中的状态接下来设置为PARTIAL_AC，意味着array_cache实例可以立即分配。 + + +不仅slab, 每个内核分配器都应该提供一个`kmem_cache_init`函数. + +| kmem_cache_init | slab | slob | slub | +|:-------------------:|:-----:|:-----:|:-----:| +| 初始化slab分配器 | [mm/slab.c?v=4.7, line 1298](http://lxr.free-electrons.com/source/mm/slab.c?v=4.7#L1298) | [mm/slob.c?v=4.7, line 649](http://lxr.free-electrons.com/source/mm/slob.c?v=4.7#L649) | [mm/slub.c?v=4.7, line 3913](http://lxr.free-electrons.com/source/mm/slub.c?v=4.7#L3913) | + +```cpp +/* + * Initialisation. Called after the page allocator have been initialised and + * before smp_init(). + */ +void __init kmem_cache_init(void) +{ + int i; + + BUILD_BUG_ON(sizeof(((struct page *)NULL)->lru) < + sizeof(struct rcu_head)); + kmem_cache = &kmem_cache_boot; + + if (!IS_ENABLED(CONFIG_NUMA) || num_possible_nodes() == 1) + use_alien_caches = 0; + + for (i = 0; i < NUM_INIT_LISTS; i++) + kmem_cache_node_init(&init_kmem_cache_node[i]); + + /* + * Fragmentation resistance on low memory - only use bigger + * page orders on machines with more than 32MB of memory if + * not overridden on the command line. + */ + if (!slab_max_order_set && totalram_pages > (32 << 20) >> PAGE_SHIFT) + slab_max_order = SLAB_MAX_ORDER_HI; + + /* Bootstrap is tricky, because several objects are allocated + * from caches that do not exist yet: + * 1) initialize the kmem_cache cache: it contains the struct + * kmem_cache structures of all caches, except kmem_cache itself: + * kmem_cache is statically allocated. + * Initially an __init data area is used for the head array and the + * kmem_cache_node structures, it's replaced with a kmalloc allocated + * array at the end of the bootstrap. + * 2) Create the first kmalloc cache. + * The struct kmem_cache for the new cache is allocated normally. + * An __init data area is used for the head array. + * 3) Create the remaining kmalloc caches, with minimally sized + * head arrays. + * 4) Replace the __init data head arrays for kmem_cache and the first + * kmalloc cache with kmalloc allocated arrays. + * 5) Replace the __init data for kmem_cache_node for kmem_cache and + * the other cache's with kmalloc allocated memory. + * 6) Resize the head arrays of the kmalloc caches to their final sizes. + */ + + /* 1) create the kmem_cache */ + + /* + * struct kmem_cache size depends on nr_node_ids & nr_cpu_ids + */ + create_boot_cache(kmem_cache, "kmem_cache", + offsetof(struct kmem_cache, node) + + nr_node_ids * sizeof(struct kmem_cache_node *), + SLAB_HWCACHE_ALIGN); + list_add(&kmem_cache->list, &slab_caches); + slab_state = PARTIAL; + + /* + * Initialize the caches that provide memory for the kmem_cache_node + * structures first. Without this, further allocations will bug. + */ + kmalloc_caches[INDEX_NODE] = create_kmalloc_cache("kmalloc-node", + kmalloc_size(INDEX_NODE), ARCH_KMALLOC_FLAGS); + slab_state = PARTIAL_NODE; + setup_kmalloc_cache_index_table(); + + slab_early_init = 0; + + /* 5) Replace the bootstrap kmem_cache_node */ + { + int nid; + + for_each_online_node(nid) { + init_list(kmem_cache, &init_kmem_cache_node[CACHE_CACHE + nid], nid); + + init_list(kmalloc_caches[INDEX_NODE], + &init_kmem_cache_node[SIZE_NODE + nid], nid); + } + } + + create_kmalloc_caches(ARCH_KMALLOC_FLAGS); +} +``` + +`kmem_cache_init`用来初始化`cache`, 在初始化阶段使用了全局静态变量`struct kmem_cache *kmem_cache` + +```cpp +// http://lxr.free-electrons.com/source/mm/slab.c?v=4.7#L1304 +kmem_cache = &kmem_cache_boot; +``` + + +这个变量是用来管理所有`cache`的`kmem_cache`的, 也就是说, 在初始化阶段, 将会创建一个`slab`, 用来存放所有`cache`的`kmem_cache`, 而创建`kmem_cache`是通过`kmem_cache_create`来创建的. + +```cpp +#define BOOT_CPUCACHE_ENTRIES 1 +/* internal cache of cache description objs */ +static struct kmem_cache kmem_cache_boot = { + .batchcount = 1, + .limit = BOOT_CPUCACHE_ENTRIES, + .shared = 1, + .size = sizeof(struct kmem_cache), + .name = "kmem_cache", +}; +``` + +kmem_cache_init可以分为六个阶段 + +| 阶段 | 描述 | +|:-----:|:-----:| +| 第一个阶段 | 是根据kmem_cache来设置cache_cache的字段值 | +| 第二个阶段 | 首先是创建arraycache_init对应的高速缓存，同时也是在这个kmem_cache_create的调用过程中，创建了用于保存cache的kmem_cache的slab，并初始化了slab中的各个对象 | +| 第三个阶段 | 创建kmem_list3对应的高速缓存，在这里要注意的一点是，如果sizeof(arraycache_t)和sizeof(kmem_list3)的大小一样大，那么就不再使用kmem_cache_create来为kmem_list3创建cache了，因为如果两者相等的话，两者就可以使用同一个cache | +| 第四个阶段 | 创建并初始化所有的通用cache和dma cache | +| 第五个阶段 | 创建两个arraycache_init对象，分别取代cache_cache中的array字段和malloc_sizes[INDEX_AC].cs_cachep->array字段 | +| 第六个阶段 | 创建两个kmem_list3对象，取代cache_cache中的kmem_list3字段和malloc_sizes[INDEX_AC].cs_cachep->nodelist3字段.如此一来，经过上面的六个阶段后，所有的初始化工作基本完成了 | + +>关于kmem_cache_init函数参见 +> +>[Linux内存管理Slab分配器](http://www.uml.org.cn/embeded/201210165.asp) +> +>[linux内存管理之kmem_cache_init ](http://blog.chinaunix.net/xmlrpc.php?r=blog/article&uid=20786208&id=4831194) +> +>[Linux 内存管理：Kmem_cache_init](http://blog.jobbole.com/91883/) +> +>[ kmem_cache_init初始化文字解析](http://blog.chinaunix.net/uid-20729583-id-1884621.html) + +##4.3 创建缓存 +------- + +创建新的`slab`缓存必须调用`kmem_cache_create`. 该函数需要很多参数 + +```cpp +mm/slab.c +struct kmem_cache *kmem_cache_create(const char *name, + size_t size, + size_t align, + unsigned long flags, + void (*ctor)(void *)) +``` + +除了可读的`name`随后会出现在`/proc/slabinfo`以外, 该函数需要被管理对象以字节计的长度, 在对齐数据时使用的偏移量(`align`, 几乎所有的情形下都是0），flags中是一组标志，而ctor是构造函数. + + + +该函数定义在[mm/slab_common.c?v=4.7, line 388](http://lxr.free-electrons.com/source/mm/slab_common.c?v=4.7#L388) + +| 参数 | 描述 | +|:-----:|:-----:| +| name | 存放着告诉缓存的名字 | +| size | 告诉缓存中每个元素的大小 | +| align | slab内第一个对象的偏移, 用来确保在页内进行特定的对齐, 通常情况下为0, 即标准对齐 | +| flags |配置项, 用来控制告诉缓存的行为. | +| ctor | 高速缓存的构造函数. 只有在新的页追加到高速缓存时, 构造函数才被调用 | + +flags参数是可选的配置项, 用来控制高速缓存的行为. 它可以为0, 表示没有特殊的行为, 或者与以下标志中的一个或多个"或"运算. + +| flags标志 | 描述 | +|:----------:|:-----:| +| SLAB_HWCACHE_ALIGN | | +| SLAB_POISON | | +| SLAB_RED_ZONE | | +| SLAB_PANIC | | +| SLAB_CACHE_DMA | | + + +关于最后一个参数ctor是告诉缓存的构造函数. 只有在新的页追加到高速缓存时, 构造函数才被调用. 实际上, Linux内核的高速缓存不使用构造函数. 事实上这里曾经还有过一个析构函数参数, 但是由于内核代码不使用它, 因此已经被抛弃了. 你可以将ctor参数赋值为NULL. + +`kmem_cache_create`在成功时返回一个指向所构造的高速缓存的针; 否则, 返回NULL. 注意该函数可能会睡眠, 因此不能再中断上下文中调用. + + + +##4.4 分配对象kmem_cache_alloc +------- + + +`kmem_cache_alloc`用于从特定的缓存获取对象. 类似于所有的`malloc`函数, 其结果可能是指向分配内存区的指针, 也可能分配失败, 返回`NULL`指针. + + +>void *kmem_cache_alloc(struct kmem_cache *cachep, gfp_t flags) + + +该函数从给定的高速缓存cachep中返回一个指向对象的指针. 如果高速缓存中的所有slab中没有空闲的对象, 那么slab层就必须通过kmem_getpages获取新的页, flags的值传递给__get_free_pages函数. 这与我们之前所看到的标志相同. 你用到的应该是GFP_KERNEL或GFP_ATOMIC。 + +该函数需要两个参数 : 用于获取对象的缓存, 以及精确描述分配特征的标志变量. 之前提到的任何GFP_值都可以用于指定标志 + +```cpp +/** + * kmem_cache_alloc - Allocate an object + * @cachep: The cache to allocate from. + * @flags: See kmalloc(). + * + * Allocate an object from this cache. The flags are only relevant + * if the cache has no available objects. + */ +void *kmem_cache_alloc(struct kmem_cache *cachep, gfp_t flags) +{ + void *ret = slab_alloc(cachep, flags, _RET_IP_); + + kasan_slab_alloc(cachep, ret, flags); + trace_kmem_cache_alloc(_RET_IP_, ret, + cachep->object_size, cachep->size, flags); + + return ret; +} +EXPORT_SYMBOL(kmem_cache_alloc); +``` + + + +给出了cache_grow的代码流程图 + + +##4.5 释放对象kmem_cache_free +------- + + +如果一个分配的对象已经不再需要, 那么必须使用`kmem_cache_free`将对象释放, 并返回给`slab`分配器. 这样就能把cachep中的对象标记为空闲. + +>void kmem_cache_free(struct kmem_cache *cachep, void *objp) + + + +每一个分配器都应该实现一个`kmem_cache_free`函数 + + +| kmem_cache_free | slab | slob | slub | +|:--------------------:|:-----:|:-----:|:-----:| +| 释放对象 | [mm/slab.c?v=4.7, line 3800](http://lxr.free-electrons.com/source/mm/slab.c?v=4.7#L3800) | [mm/slob.c?v=4.7, line 598](http://lxr.free-electrons.com/source/mm/slob.c?v=4.7#L598) | [mm/slub.c?v=4.7, line 2814](http://lxr.free-electrons.com/source/mm/slub.c?v=4.7#L2814) | + + +`slab`分配器的`kmem_cache_free`函数定义在[mm/slab.c?v=4.7#L3800](http://lxr.free-electrons.com/source/mm/slab.c?v=4.7#L3800) + + +`kmem_cache_free`立即调用了`__cache_free`, 参数直接传递过去。其原因也是防止kfree实现中. + +类似于分配，根据per-CPU缓存的状态不同，有两种可选的操作流程。如果per-CPU缓存中的对象数目低于允许的限制，则在其中存储一个指向缓存中对象的指针. + + + +```cpp +/** + * kmem_cache_free - Deallocate an object + * @cachep: The cache the allocation was from. + * @objp: The previously allocated object. + * + * Free an object which was previously allocated from this + * cache. + */ +void kmem_cache_free(struct kmem_cache *cachep, void *objp) +{ + unsigned long flags; + cachep = cache_from_obj(cachep, objp); + if (!cachep) + return; + + local_irq_save(flags); + debug_check_no_locks_freed(objp, cachep->object_size); + if (!(cachep->flags & SLAB_DEBUG_OBJECTS)) + debug_check_no_obj_freed(objp, cachep->object_size); + __cache_free(cachep, objp, _RET_IP_); + local_irq_restore(flags); + + trace_kmem_cache_free(_RET_IP_, objp); +} +EXPORT_SYMBOL(kmem_cache_free); +``` + +##4.6 销毁缓存 +------- + + +如果要销毁只包含未使用对象的一个缓存, 则必须调用`kmem_cache_destroy`函数. + +该函数主要在删除模块时调用, 此时需要将分配的内存都释放. + +由于该函数的实现没什么新东西, 下面我们只是概述一下删除缓存的主要步骤. + +* 依次扫描`slabs_free`链表上的`slab`. 首先对每个`slab`上的每个对象调用析构器函数，然后将slab的内存空间返回给伙伴系统. + +* 释放用于`per-CPU`缓存的内存空间。 + +* 从`cache_cache`链表移除相关数据。 + + +与kmem_cache_create类似, 不能在中断上下文中调用这个函数. 因为它也可能睡眠. 调用该函数之前必须确保一下两个条件 + +* 告诉缓存中所有slab都必须是NULL, 其实, 不管哪个slab中, 只要还有一个对象被分配出去并正在使用, 那么就不能撤销该告诉缓存 + +* 在调用`kmem_cache_destroy`过程中, 不再访问这个高速缓存. 调用者必须确保这种同步. + +该函数在成功时返回0, 否则返回非0. + + +slab分配器中该函数定义在[mm/slab_common.c?v=4.7, line 706](http://lxr.free-electrons.com/source/mm/slab_common.c?v=4.7#L706) + +```cpp +void kmem_cache_destroy(struct kmem_cache *s) +{ + LIST_HEAD(release); + bool need_rcu_barrier = false; + int err; + + if (unlikely(!s)) + return; + + get_online_cpus(); + get_online_mems(); + + kasan_cache_destroy(s); + mutex_lock(&slab_mutex); + + s->refcount--; + if (s->refcount) + goto out_unlock; + + err = shutdown_memcg_caches(s, &release, &need_rcu_barrier); + if (!err) + err = shutdown_cache(s, &release, &need_rcu_barrier); + + if (err) { + pr_err("kmem_cache_destroy %s: Slab cache still has objects\n", + s->name); + dump_stack(); + } +out_unlock: + mutex_unlock(&slab_mutex); + + put_online_mems(); + put_online_cpus(); + + release_caches(&release, need_rcu_barrier); +} +EXPORT_SYMBOL(kmem_cache_destroy); +``` + +##4.7 slab分配器的使用实例 +------- + +我们来讲解一个slab分配器使用的鲜活的例子. 这个例子创建了task_struct结构, 取自`kernel/fork.c` + +首先, 内核用一个全局变量存放指向`task_struct`高速缓存的指针`task_struct_cachep`. 定义在[`kernel/fork.c, line 1733`](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L1733) + + +```cpp +#ifndef CONFIG_ARCH_TASK_STRUCT_ALLOCATOR +static struct kmem_cache *task_struct_cachep; + +static inline struct task_struct *alloc_task_struct_node(int node) +{ + return kmem_cache_alloc_node(task_struct_cachep, GFP_KERNEL, node); +} + +static inline void free_task_struct(struct task_struct *tsk) +{ + kmem_cache_free(task_struct_cachep, tsk); +} +#endif +``` + +在内核的初始化期间, 在定义`kernel/fork.c`的fork_init中会创建高速缓存, 参见[`kernel/fork.c?v=4.7, line 312·](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L312) + +```cpp +void __init fork_init(void) +{ +#ifndef CONFIG_ARCH_TASK_STRUCT_ALLOCATOR + +#ifndef ARCH_MIN_TASKALIGN + #define ARCH_MIN_TASKALIGN L1_CACHE_BYTES +#endif + + /* create a slab on which task_structs can be allocated */ + task_struct_cachep = kmem_cache_create("task_struct", + arch_task_struct_size, ARCH_MIN_TASKALIGN, + SLAB_PANIC|SLAB_NOTRACK|SLAB_ACCOUNT, NULL); +#endif + /* ...... */ +} +``` + +这样就创建了一个名为`task_struct`的高速缓存, 其中存放的就是类型为`struct task_struct`的对象. 该对象创建后存放在slab中偏移量为`ARCH_MIN_TASKALIGN`个字节的地方. `ARCH_MIN_TASKALIGN`的预定值与[体系结构相关](http://lxr.free-electrons.com/ident?i=L1_CACHE_BYTES), 通常将它定义为`L1_CACHE_BYTES`, 即L1高速缓存的字节大小. 没有构造函数或析构函数. 注意不同检查返回值是否为失败标记`NULL`. 因为`SLAB_PANIC`已经被设置了. 如果分配失败, `slab`分配器就调用`panic()`函数. 如果没有提供`SLAB_PANIC`标志, 就必须自己检查返回值. `SLAB_PANIC`标志用在这儿是因为这是系统操作必不可少的高速缓存(没有进程描述符, 机器自然不能正常运行). + +每当进程调用`fork`函数时, 一定会创建一个新的进程描述符. 这是在`dup_task_struct`中通过`alloc_task_struct_node`完成的, 而前者则会被_do_fork函数调用, 参见[kernel/fork.c?v=4.7, line 351](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L351) + +```cpp +static struct task_struct *dup_task_struct(struct task_struct *orig, int node) +{ + struct task_struct *tsk; + /* ...... */ + tsk = alloc_task_struct_node(node); + if (!tsk) + return NULL; + /* ...... */ +} +``` + +同样进程执行完后, 如果没有子进程在等待的话, 它的进程描述符就会被释放, 并返回个`task_structcachep`的`slab`高速缓存. 这是在`free_task_struct`中通过`kmem_cache_free`完成的. + + +`alloc_task_struct_node`和`free_task_struct`函数分别用来分配和释放进程描述符 + + +| 函数 | 功能 | 定义 | 调用流程 | +|:-----:|:-----:|:-----:|:---------:| +| alloc_task_struct_node | 从task_struct_cachep slab高速缓存中分配一个进程描述符 | [kernel/fork.c?v=4.7, line 140](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L140) | [_do_fork](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L1762)
[copy_process](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L1339)
[dup_task_struct](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L355)
[alloc_task_struct_node](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L142) | +| free_task_struct | 释放进程描述符, 并返回给从task_struct_cachep slab高速缓存 | [kernel/fork.c?v=4.7, line 145](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L145) | [free_task](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L240)
[free_task_struct](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L145) + + +这两个函数定义在[kernel/fork.c?v=4.7, line 140](http://lxr.free-electrons.com/source/kernel/fork.c?v=4.7#L140) + + +```cpp +#ifndef CONFIG_ARCH_TASK_STRUCT_ALLOCATOR +static struct kmem_cache *task_struct_cachep; + +static inline struct task_struct *alloc_task_struct_node(int node) +{ + return kmem_cache_alloc_node(task_struct_cachep, GFP_KERNEL, node); +} + +static inline void free_task_struct(struct task_struct *tsk) +{ + kmem_cache_free(task_struct_cachep, tsk); +} +#endif +``` + +由于进程描述符是内核的核心组成部分, 时刻都要用到, 因此`task_struct_cachep`高速缓存绝不会被撤销掉. 即使真能撤销, 我们也要铜鼓下列函数阻止其被撤销. + + + + + + +##5 通用缓存 +------- + +如果不涉及对象缓存, 而是传统意义上的分配/释放内存, 则必须调用`kmalloc`和`kfree`函数. 这两个函数, 相当于用户空间中C标准库`malloc`和`free`函数的内核等价物. + + +我已经提过几次, `kmalloc`和`kfree`实现为`slab`分配器的前端, 其语义尽可能地模仿malloc/free. + +因此我们只简单讨论一下其实现 + + +##5.1 kmalloc函数的实现 +------- + +`kmalloc`的基础是一个数组, 其中是一些分别用于不同内存长度的`slab`缓存. +数组项是`cache_sizes`的实例, 该数据结构定义如下: + + + + +http://guojing.me/linux-kernel-architecture/posts/slab-structure/ + +http://blog.chinaunix.net/uid-24178783-id-370321.html + +http://www.cnblogs.com/openix/p/3351656.html + http://www.cnblogs.com/openix/p/3352652.html \ No newline at end of file diff --git a/study/kernel/02-memory/05-slaballocator/images/cat_procinfo.png b/study/kernel/02-memory/05-slaballocator/images/cat_procinfo.png new file mode 100644 index 0000000000000000000000000000000000000000..751268684c7df703e3ecf3545c37ec59e3c3f12e GIT binary patch literal 146806 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 literal 0 HcmV?d00001 diff --git a/study/kernel/02-memory/05-slaballocator/images/cat_procinfo_task_struct.png b/study/kernel/02-memory/05-slaballocator/images/cat_procinfo_task_struct.png new file mode 100644 index 0000000000000000000000000000000000000000..b215e86081d08f3f7bde28155c30dd85e30356d0 GIT binary patch literal 18341 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�wk{|F~u3KmCv42Aye3o}kQ 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 N;OXk;vd$@?2>|SK&;$Sg literal 0 HcmV?d00001