ySsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/core-api/genallocmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/zh_TW/core-api/genallocmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/it_IT/core-api/genallocmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/ja_JP/core-api/genallocmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/ko_KR/core-api/genallocmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/sp_SP/core-api/genallocmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhnote)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]h paragraph)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hh5Documentation/translations/zh_CN/disclaimer-zh_CN.rsthKhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh field_list)}(hhh](hfield)}(hhh](h field_name)}(hOriginalh]hOriginal}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhR/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/core-api/genalloc.rsthKubh field_body)}(h$Documentation/core-api/genalloc.rst h]h)}(h#Documentation/core-api/genalloc.rsth]h#Documentation/core-api/genalloc.rst}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h翻译h]h翻译}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh)}(h-司延腾 Yanteng Si h]h)}(h,司延腾 Yanteng Si h](h司延腾 Yanteng Si <}(hjhhhNhNubh reference)}(hsiyanteng@loongson.cnh]hsiyanteng@loongson.cn}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:siyanteng@loongson.cnuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hhh](h)}(h校译h]h校译}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hhhKubh)}(h时奎亮 h]h)}(h时奎亮 h](h 时奎亮 <}(hjShhhNhNubj)}(halexs@kernel.orgh]halexs@kernel.org}(hj[hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:alexs@kernel.orguh1jhjSubh>}(hjShhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK hjOubah}(h]h ]h"]h$]h&]uh1hhj>ubeh}(h]h ]h"]h$]h&]uh1hhhhK hhhhubeh}(h]h ]h"]h$]h&]uh1hhhhhhhhKubhtarget)}(h.. _cn_core-api_genalloc:h]h}(h]h ]h"]h$]h&]refidcn-core-api-genallocuh1jhKhhhhhhubhsection)}(hhh](htitle)}(hgenalloc/genpool子系统h]hgenalloc/genpool子系统}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhhhKubh)}(hX~内核中有许多内存分配子系统，每一个都是针对特定的需求。然而，有时候，内核开发者需 要为特定范围的特殊用途的内存实现一个新的分配器；通常这个内存位于某个设备上。该设 备的驱动程序的作者当然可以写一个小的分配器来完成工作，但这是让内核充满几十个测试 差劲的分配器的方法。早在2005年，Jes Sorensen从sym53c8xx_2驱动中提取了其中的一 个分配器，并将其作为一个通用模块发布，用于创建特设的内存分配器。这段代码在2.6.13 版本中被合并；此后它被大大地修改了。h]hX~内核中有许多内存分配子系统，每一个都是针对特定的需求。然而，有时候，内核开发者需 要为特定范围的特殊用途的内存实现一个新的分配器；通常这个内存位于某个设备上。该设 备的驱动程序的作者当然可以写一个小的分配器来完成工作，但这是让内核充满几十个测试 差劲的分配器的方法。早在2005年，Jes Sorensen从sym53c8xx_2驱动中提取了其中的一 个分配器，并将其作为一个通用模块发布，用于创建特设的内存分配器。这段代码在2.6.13 版本中被合并；此后它被大大地修改了。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubj)}(h,.. _posted: https://lwn.net/Articles/125842/h]h}(h]postedah ]h"]postedah$]h&]refuri https://lwn.net/Articles/125842/uh1jhK$hjhhhhubh)}(ht使用这个分配器的代码应该包括。这个动作从创建一个池开始，使用 一个:h]ht使用这个分配器的代码应该包括。这个动作从创建一个池开始，使用 一个:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h该API在以下内核代码中:h]h该API在以下内核代码中:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hlib/genalloc.ch]hlib/genalloc.c}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hjhhubh)}(hX 对gen_pool_create()的调用将创建一个内存池。分配的粒度由min_alloc_order设置；它 是一个log-base-2（以2为底的对数）的数字，就像页面分配器使用的数字一样，但它指的是 字节而不是页面。因此，如果min_alloc_order被传递为3，那么所有的分配将是8字节的倍数。 增加min_alloc_order可以减少跟踪池中内存所需的内存。nid参数指定哪一个NUMA节点应该被 用于分配管家结构体；如果调用者不关心，它可以是-1。h]hX 对gen_pool_create()的调用将创建一个内存池。分配的粒度由min_alloc_order设置；它 是一个log-base-2（以2为底的对数）的数字，就像页面分配器使用的数字一样，但它指的是 字节而不是页面。因此，如果min_alloc_order被传递为3，那么所有的分配将是8字节的倍数。 增加min_alloc_order可以减少跟踪池中内存所需的内存。nid参数指定哪一个NUMA节点应该被 用于分配管家结构体；如果调用者不关心，它可以是-1。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK"hjhhubh)}(h“管理的”接口devm_gen_pool_create()将内存池与一个特定的设备联系起来。在其他方面， 当给定的设备被销毁时，它将自动清理内存池。h]h“管理的”接口devm_gen_pool_create()将内存池与一个特定的设备联系起来。在其他方面， 当给定的设备被销毁时，它将自动清理内存池。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK(hjhhubh)}(h(一个内存池池被关闭的方法是:h]h(一个内存池池被关闭的方法是:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjhhubh)}(h该API在以下内核代码中:h]h该API在以下内核代码中:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjhhubh)}(hlib/genalloc.ch]hlib/genalloc.c}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjhhubh)}(h值得注意的是，如果在给定的内存池中仍有未完成的分配，这个函数将采取相当极端的步骤，调用 BUG()，使整个系统崩溃。你已经被警告了。h]h值得注意的是，如果在给定的内存池中仍有未完成的分配，这个函数将采取相当极端的步骤，调用 BUG()，使整个系统崩溃。你已经被警告了。}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjhhubh)}(h一个新创建的内存池没有内存可以分配。在这种状态下，它是相当无用的，所以首要任务之一通常 是向内存池里添加内存。这可以通过以下方式完成:h]h一个新创建的内存池没有内存可以分配。在这种状态下，它是相当无用的，所以首要任务之一通常 是向内存池里添加内存。这可以通过以下方式完成:}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hjhhubh)}(h该API在以下内核代码中:h]h该API在以下内核代码中:}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK7hjhhubh)}(hinclude/linux/genalloc.hh]hinclude/linux/genalloc.h}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjhhubh)}(hlib/genalloc.ch]hlib/genalloc.c}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hjhhubh)}(hXB对gen_pool_add()的调用将把从地址（在内核的虚拟地址空间）开始的内存的大小字节放入 给定的池中，再次使用nid作为节点ID进行辅助内存分配。gen_pool_add_virt()变体将显式 物理地址与内存联系起来；只有在内存池被用于DMA分配时，这才是必要的。h]hXB对gen_pool_add()的调用将把从地址（在内核的虚拟地址空间）开始的内存的大小字节放入 给定的池中，再次使用nid作为节点ID进行辅助内存分配。gen_pool_add_virt()变体将显式 物理地址与内存联系起来；只有在内存池被用于DMA分配时，这才是必要的。}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK=hjhhubh)}(h=从内存池中分配内存（并将其放回）的函数是:h]h=从内存池中分配内存（并将其放回）的函数是:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjhhubh)}(h该API在以下内核代码中:h]h该API在以下内核代码中:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChjhhubh)}(hinclude/linux/genalloc.hh]hinclude/linux/genalloc.h}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKEhjhhubh)}(hlib/genalloc.ch]hlib/genalloc.c}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjhhubh)}(hX正如人们所期望的，gen_pool_alloc()将从给定的池中分配size<字节。gen_pool_dma_alloc() 变量分配内存用于DMA操作，返回dma所指向的空间中的相关物理地址。这只有在内存是用 gen_pool_add_virt()添加的情况下才会起作用。请注意，这个函数偏离了genpool通常使用 无符号长值来表示内核地址的模式；它返回一个void * 来代替。h]hX正如人们所期望的，gen_pool_alloc()将从给定的池中分配size<字节。gen_pool_dma_alloc() 变量分配内存用于DMA操作，返回dma所指向的空间中的相关物理地址。这只有在内存是用 gen_pool_add_virt()添加的情况下才会起作用。请注意，这个函数偏离了genpool通常使用 无符号长值来表示内核地址的模式；它返回一个void * 来代替。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjhhubh)}(hX这一切看起来都比较简单；事实上，一些开发者显然认为这太简单了。毕竟，上面的接口没有提 供对分配函数如何选择返回哪块特定内存的控制。如果需要这样的控制，下面的函数将是有意义 的:h]hX这一切看起来都比较简单；事实上，一些开发者显然认为这太简单了。毕竟，上面的接口没有提 供对分配函数如何选择返回哪块特定内存的控制。如果需要这样的控制，下面的函数将是有意义 的:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKNhjhhubh)}(h该API在以下内核代码中:h]h该API在以下内核代码中:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjhhubh)}(hlib/genalloc.ch]hlib/genalloc.c}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKThjhhubh)}(hXT使用gen_pool_alloc_algo()进行的分配指定了一种用于选择要分配的内存的算法；默认算法可 以用gen_pool_set_algo()来设置。数据值被传递给算法；大多数算法会忽略它，但偶尔也会需 要它。当然，人们可以写一个特殊用途的算法，但是已经有一套公平的算法可用了:h]hXT使用gen_pool_alloc_algo()进行的分配指定了一种用于选择要分配的内存的算法；默认算法可 以用gen_pool_set_algo()来设置。数据值被传递给算法；大多数算法会忽略它，但偶尔也会需 要它。当然，人们可以写一个特殊用途的算法，但是已经有一套公平的算法可用了:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKVhjhhubh bullet_list)}(hhh](h list_item)}(hmgen_pool_first_fit是一个简单的初配分配器；如果没有指定其他算法，这是默认算法。 h]h)}(hlgen_pool_first_fit是一个简单的初配分配器；如果没有指定其他算法，这是默认算法。h]hlgen_pool_first_fit是一个简单的初配分配器；如果没有指定其他算法，这是默认算法。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKZhjubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubj)}(h}gen_pool_first_fit_align强迫分配有一个特定的对齐方式（通过genpool_data_align结 构中的数据传递）。 h]h)}(h|gen_pool_first_fit_align强迫分配有一个特定的对齐方式（通过genpool_data_align结 构中的数据传递）。h]h|gen_pool_first_fit_align强迫分配有一个特定的对齐方式（通过genpool_data_align结 构中的数据传递）。}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hj'ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubj)}(h|gen_pool_first_fit_order_align 按照大小的顺序排列分配。例如，一个60字节的分配将 以64字节对齐。 h]h)}(h{gen_pool_first_fit_order_align 按照大小的顺序排列分配。例如，一个60字节的分配将 以64字节对齐。h]h{gen_pool_first_fit_order_align 按照大小的顺序排列分配。例如，一个60字节的分配将 以64字节对齐。}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK_hj?ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubj)}(hZgen_pool_best_fit，正如人们所期望的，是一个简单的最佳匹配分配器。 h]h)}(hYgen_pool_best_fit，正如人们所期望的，是一个简单的最佳匹配分配器。h]hYgen_pool_best_fit，正如人们所期望的，是一个简单的最佳匹配分配器。}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhjWubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubj)}(hgen_pool_fixed_alloc在池中的一个特定偏移量（通过数据参数在genpool_data_fixed结 构中传递）进行分配。如果指定的内存不可用，则分配失败。 h]h)}(hgen_pool_fixed_alloc在池中的一个特定偏移量（通过数据参数在genpool_data_fixed结 构中传递）进行分配。如果指定的内存不可用，则分配失败。h]hgen_pool_fixed_alloc在池中的一个特定偏移量（通过数据参数在genpool_data_fixed结 构中传递）进行分配。如果指定的内存不可用，则分配失败。}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKdhjoubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1jhhhKZhjhhubh)}(hX"还有一些其他的函数，主要是为了查询内存池中的可用空间或迭代内存块等目的。然而，大多数 用户应该不需要以上描述的功能。如果幸运的话，对这个模块的广泛认识将有助于防止在未来编 写特殊用途的内存分配器。h]hX"还有一些其他的函数，主要是为了查询内存池中的可用空间或迭代内存块等目的。然而，大多数 用户应该不需要以上描述的功能。如果幸运的话，对这个模块的广泛认识将有助于防止在未来编 写特殊用途的内存分配器。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghjhhubh)}(h该API在以下内核代码中:h]h该API在以下内核代码中:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKkhjhhubh)}(hlib/genalloc.ch]hlib/genalloc.c}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKmhjhhubeh}(h](genalloc-genpooljeh ]h"](genalloc/genpool子系统cn_core-api_genalloceh$]h&]uh1jhhhhhhhKexpect_referenced_by_name}jjsexpect_referenced_by_id}jjsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(jN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh، _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}j]jasnameids}(jjjjjju nametypes}(jjjuh}(jjjjjju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages](hsystem_message)}(hhh]h)}(hhh]h:Hyperlink target "cn-core-api-genalloc" is not referenced.}hjSsbah}(h]h ]h"]h$]h&]uh1hhjPubah}(h]h ]h"]h$]h&]levelKtypeINFOsourceh،lineKuh1jNubjO)}(hhh]h)}(hhh]h,Hyperlink target "posted" is not referenced.}hjnsbah}(h]h ]h"]h$]h&]uh1hhjkubah}(h]h ]h"]h$]h&]levelKtypejhsourceh،lineK$uh1jNube transformerN include_log]6Documentation/translations/zh_CN/core-api/genalloc.rst(NNNNta decorationNhhub.