171 lines · plain
1:Original: Documentation/mm/page_owner.rst2 3:翻译:4 5 司延腾 Yanteng Si <siyanteng@loongson.cn>6 7:校译:8 9 10================================11page owner: 跟踪谁分配的每个页面12================================13 14概述15====16 17page owner是用来追踪谁分配的每一个页面。它可以用来调试内存泄漏或找到内存占用者。18当分配发生时，有关分配的信息，如调用堆栈和页面的顺序被存储到每个页面的特定存储中。19当我们需要了解所有页面的状态时，我们可以获得并分析这些信息。20 21尽管我们已经有了追踪页面分配/释放的tracepoint，但用它来分析谁分配的每个页面是22相当复杂的。我们需要扩大跟踪缓冲区，以防止在用户空间程序启动前出现重叠。而且，启23动的程序会不断地将跟踪缓冲区转出，供以后分析，这将会改变系统的行为，会产生更多的24可能性，而不是仅仅保留在内存中，所以不利于调试。25 26页面所有者也可以用于各种目的。例如，可以通过每个页面的gfp标志信息获得精确的碎片27统计。如果启用了page owner，它就已经实现并激活了。我们非常欢迎其他用途。28 29page owner在默认情况下是禁用的。所以，如果你想使用它，你需要在你的启动cmdline30中加入"page_owner=on"。如果内核是用page owner构建的，并且由于没有启用启动31选项而在运行时禁用page owner，那么运行时的开销是很小的。如果在运行时禁用，它不32需要内存来存储所有者信息，所以没有运行时内存开销。而且，页面所有者在页面分配器的33热路径中只插入了两个不可能的分支，如果不启用，那么分配就会像没有页面所有者的内核34一样进行。这两个不可能的分支应该不会影响到分配的性能，特别是在静态键跳转标签修补35功能可用的情况下。以下是由于这个功能而导致的内核代码大小的变化。36 37尽管启用page owner会使内核的大小增加几千字节，但这些代码大部分都在页面分配器和38热路径之外。构建带有page owner的内核，并在需要时打开它，将是调试内核内存问题的39最佳选择。40 41有一个问题是由实现细节引起的。页所有者将信息存储到struct page扩展的内存中。这42个内存的初始化时间比稀疏内存系统中的页面分配器启动的时间要晚一些，所以，在初始化43之前，许多页面可以被分配，但它们没有所有者信息。为了解决这个问题，这些早期分配的44页面在初始化阶段被调查并标记为分配。虽然这并不意味着它们有正确的所有者信息，但至45少，我们可以更准确地判断该页是否被分配。在2GB内存的x86-64虚拟机上，有1334346个早期分配的页面被捕捉和标记，尽管它们大部分是由结构页扩展功能分配的。总之，在这47之后，没有任何页面处于未追踪状态。48 49使用方法50========51 521) 构建用户空间的帮助::53 54 cd tools/mm55 make page_owner_sort56 572) 启用page owner: 添加 "page_owner=on" 到 boot cmdline.58 593) 做你想调试的工作。60 614) 分析来自页面所有者的信息::62 63 cat /sys/kernel/debug/page_owner > page_owner_full.txt64 ./page_owner_sort page_owner_full.txt sorted_page_owner.txt65 66 ``page_owner_full.txt`` 的一般输出情况如下::67 68 Page allocated via order XXX, ...69 PFN XXX ...70 // 栈详情71 72 Page allocated via order XXX, ...73 PFN XXX ...74 // 栈详情75 默认情况下，它将以一个给定的pfn开始，做完整的pfn转储，且page_owner支持fseek。76 77 FILE *fp = fopen("/sys/kernel/debug/page_owner", "r");78 fseek(fp, pfn_start, SEEK_SET);79 80 ``page_owner_sort`` 工具忽略了 ``PFN`` 行，将剩余的行放在buf中，使用regexp提81 取页序值，计算buf的次数和页数，最后根据参数进行排序。82 83 在 ``sorted_page_owner.txt`` 中可以看到关于谁分配了每个页面的结果。一般输出::84 85 XXX times, XXX pages:86 Page allocated via order XXX, ...87 // Detailed stack88 89 默认情况下， ``page_owner_sort`` 是根据buf的时间来排序的。如果你想90 按buf的页数排序，请使用-m参数。详细的参数是:91 92 基本函数::93 94 排序:95 -a 按内存分配时间排序96 -m 按总内存排序97 -p 按pid排序。98 -P 按tgid排序。99 -n 按任务命令名称排序。100 -r 按内存释放时间排序。101 -s 按堆栈跟踪排序。102 -t 按时间排序（默认）。103 --sort <order> 指定排序顺序。排序的语法是[+|-]key[,[+|-]key[,...]]。从104 **标准格式指定器**那一节选择一个键。"+"是可选的，因为默认的方向是数字或105 词法的增加。允许混合使用缩写和完整格式的键。106 107 例子:108 ./page_owner_sort <input> <output> --sort=n,+pid,-tgid109 ./page_owner_sort <input> <output> --sort=at110 111 其它函数::112 113 剔除:114 --cull <rules>115 指定剔除规则。剔除的语法是key[,key[,...]]。从**标准格式指定器**116 部分选择一个多字母键。117 <rules>是一个以逗号分隔的列表形式的单一参数，它提供了一种指定单个剔除规则的118 方法。 识别的关键字在下面的**标准格式指定器**部分有描述。<规则>可以通过键的119 序列k1,k2,...来指定，在下面的标准排序键部分有描述。允许混合使用简写和完整形120 式的键。121 122 Examples:123 ./page_owner_sort <input> <output> --cull=stacktrace124 ./page_owner_sort <input> <output> --cull=st,pid,name125 ./page_owner_sort <input> <output> --cull=n,f126 127 过滤:128 -f 过滤掉内存已被释放的块的信息。129 130 选择:131 --pid <pidlist> 按pid选择。这将选择进程ID号出现在<pidlist>中的块。132 --tgid <tgidlist> 按tgid选择。这将选择其线程组ID号出现在<tgidlist>133 中的块。134 --name <cmdlist> 按任务命令名称选择。这将选择其任务命令名称出现在135 <cmdlist>中的区块。136 137 <pidlist>, <tgidlist>, <cmdlist>是以逗号分隔的列表形式的单个参数，138 它提供了一种指定单个选择规则的方法。139 140 141 例子:142 ./page_owner_sort <input> <output> --pid=1143 ./page_owner_sort <input> <output> --tgid=1,2,3144 ./page_owner_sort <input> <output> --name name1,name2145 146标准格式指定器147==============148::149 150 --sort的选项:151 152 短键 长键 描述153 p pid 进程ID154 tg tgid 线程组ID155 n name 任务命令名称156 st stacktrace 页面分配的堆栈跟踪157 T txt 块的全文158 ft free_ts 页面释放时的时间戳159 at alloc_ts 页面被分配时的时间戳160 ator allocator 页面的内存分配器161 162 --curl的选项:163 164 短键 长键 描述165 p pid 进程ID166 tg tgid 线程组ID167 n name 任务命令名称168 f free 该页是否已经释放169 st stacktrace 页面分配的堆栈跟踪170 ator allocator 页面的内存分配器171