Linux内核中__meminit宏的含义及相关资料查询方法

问题 #

在Linux内核源码中经常看到函数前标注__meminit修饰符，比如arch/x86/mm/init_64.c中的这段代码：
static void __meminit remove_pagetable(unsigned long start, unsigned long end, bool direct, struct vmem_altmap *altmap)
想了解该修饰符的具体含义。

已尝试的操作 #

查看了__meminit的宏定义：

/* Used for MEMORY_HOTPLUG */
#define __meminit        __section(.meminit.text) __cold notrace \
                          __latent_entropy

但仍无法理解其实际用法。

后续疑问 #

Linux学习者在哪里可以查询这类内核宏的说明文档？

一、__meminit修饰符的具体含义与用法 #

__meminit是Linux内核专门为内存初始化类函数设计的标记宏，核心作用和细节如下：

• 段划分：通过__section(.meminit.text)将被修饰的函数归类到专属的.meminit.text内存段中，这类段中的代码仅在内核启动初始化或内存热插拔（MEMORY_HOTPLUG）过程中执行；
• 内存回收：当系统完成初始化、内存热插拔操作结束后，.meminit.text段占用的内存可以被内核释放回收，节省运行时的内存资源；
• 辅助修饰的作用：
  • __cold：告诉编译器该函数属于低调用频率的"冷路径"，可针对性做优化（比如不做频繁调用的代码缓存优化）；
  • notrace：禁止调试工具对该函数进行跟踪插桩，避免干扰初始化流程；
  • __latent_entropy：增加函数执行过程的不确定性，缓解侧信道攻击风险。

二、查询内核宏说明的渠道 #

• 源码注释与头文件：这类宏的定义通常集中在include/linux/init.h这类头文件中，定义前后会有配套注释；同时可以查看宏所在文件的周边代码，结合上下文理解其使用场景；
• 内核自带文档：内核源码根目录下的Documentation/文件夹包含大量官方文档，比如Documentation/core-api/memory-hotplug.rst会涉及内存热插拔相关宏的说明，Documentation/process/kernel-doc.rst介绍了内核自带的文档生成工具，可生成函数、宏的详细说明；
• 内核代码中的使用实例：通过查找内核中所有被__meminit修饰的函数，观察它们的调用时机和场景，反向推导该宏的用途。

内容的提问来源于stack exchange，提问作者Tropping