sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget%/translations/zh_CN/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]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/pt_BR/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_languageEnglishuh1h hh _documenthsourceNlineNubhsection)}(hhh](htitle)}(hThe genalloc/genpool subsystemh]hThe genalloc/genpool subsystem}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhh?/var/lib/git/docbuild/linux/Documentation/core-api/genalloc.rsthKubh paragraph)}(hXThere are a number of memory-allocation subsystems in the kernel, each aimed at a specific need. Sometimes, however, a kernel developer needs to implement a new allocator for a specific range of special-purpose memory; often that memory is located on a device somewhere. The author of the driver for that device can certainly write a little allocator to get the job done, but that is the way to fill the kernel with dozens of poorly tested allocators. Back in 2005, Jes Sorensen lifted one of those allocators from the sym53c8xx_2 driver and posted_ it as a generic module for the creation of ad hoc memory allocators. This code was merged for the 2.6.13 release; it has been modified considerably since then.h](hX!There are a number of memory-allocation subsystems in the kernel, each aimed at a specific need. Sometimes, however, a kernel developer needs to implement a new allocator for a specific range of special-purpose memory; often that memory is located on a device somewhere. The author of the driver for that device can certainly write a little allocator to get the job done, but that is the way to fill the kernel with dozens of poorly tested allocators. Back in 2005, Jes Sorensen lifted one of those allocators from the sym53c8xx_2 driver and }(hhhhhNhNubh reference)}(hposted_h]hposted}(hhhhhNhNubah}(h]h ]h"]h$]h&]namepostedrefuri https://lwn.net/Articles/125842/uh1hhh͌resolvedKubh it as a generic module for the creation of ad hoc memory allocators. This code was merged for the 2.6.13 release; it has been modified considerably since then.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubhtarget)}(h,.. _posted: https://lwn.net/Articles/125842/h]h}(h]postedah ]h"]postedah$]h&]hhuh1hhKhhhhhhʌ referencedKubh)}(hyCode using this allocator should include . The action begins with the creation of a pool using one of:h]hyCode using this allocator should include . The action begins with the creation of a pool using one of:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singlegen_pool_create (C function)c.gen_pool_createhNtauh1jhhhhhNhNubhdesc)}(hhh](hdesc_signature)}(h@struct gen_pool * gen_pool_create (int min_alloc_order, int nid)h]hdesc_signature_line)}(h>struct gen_pool *gen_pool_create(int min_alloc_order, int nid)h](hdesc_sig_keyword)}(hstructh]hstruct}(hj5hhhNhNubah}(h]h ]kah"]h$]h&]uh1j3hj/hhhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:20: ./lib/genalloc.chKubhdesc_sig_space)}(h h]h }(hjGhhhNhNubah}(h]h ]wah"]h$]h&]uh1jEhj/hhhjDhKubh)}(hhh]h desc_sig_name)}(hgen_poolh]hgen_pool}(hj[hhhNhNubah}(h]h ]nah"]h$]h&]uh1jYhjVubah}(h]h ]h"]h$]h&] refdomaincreftype identifier reftargetj]modnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]jx ASTIdentifier)}jsgen_pool_createsbc.gen_pool_createasbuh1hhj/hhhjDhKubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj/hhhjDhKubhdesc_sig_punctuation)}(h*h]h*}(hjhhhNhNubah}(h]h ]pah"]h$]h&]uh1jhj/hhhjDhKubh desc_name)}(hgen_pool_createh]jZ)}(hjh]hgen_pool_create}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ](sig-namedescnameeh"]h$]h&] xml:spacepreserveuh1jhj/hhhjDhKubhdesc_parameterlist)}(h(int min_alloc_order, int nid)h](hdesc_parameter)}(hint min_alloc_orderh](hdesc_sig_keyword_type)}(hinth]hint}(hjhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubjZ)}(hmin_alloc_orderh]hmin_alloc_order}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hint nidh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubjZ)}(hnidh]hnid}(hj"hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhj/hhhjDhKubeh}(h]h ]h"]h$]h&]jj add_permalinkuh1j-sphinx_line_type declaratorhj)hhhjDhKubah}(h]j ah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1j'hjDhKhj$hhubh desc_content)}(hhh]h)}(h create a new special memory poolh]h create a new special memory pool}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:20: ./lib/genalloc.chKhjShhubah}(h]h ]h"]h$]h&]uh1jQhj$hhhjDhKubeh}(h]h ](jqfunctioneh"]h$]h&]domainjqobjtypejndesctypejnnoindex noindexentrynocontentsentryuh1j"hhhhhNhNubh container)}(hXO**Parameters** ``int min_alloc_order`` log base 2 of number of bytes each bitmap bit represents ``int nid`` node id of the node the pool structure should be allocated on, or -1 **Description** Create a new special memory pool that can be used to manage special purpose memory not managed by the regular kmalloc/kfree interface.h](h)}(h**Parameters**h]hstrong)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:20: ./lib/genalloc.chKhjzubhdefinition_list)}(hhh](hdefinition_list_item)}(hQ``int min_alloc_order`` log base 2 of number of bytes each bitmap bit represents h](hterm)}(h``int min_alloc_order``h]hliteral)}(hjh]hint min_alloc_order}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:20: ./lib/genalloc.chKhjubh definition)}(hhh]h)}(h8log base 2 of number of bytes each bitmap bit representsh]h8log base 2 of number of bytes each bitmap bit represents}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(hQ``int nid`` node id of the node the pool structure should be allocated on, or -1 h](j)}(h ``int nid``h]j)}(hjh]hint nid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:20: ./lib/genalloc.chKhjubj)}(hhh]h)}(hDnode id of the node the pool structure should be allocated on, or -1h]hDnode id of the node the pool structure should be allocated on, or -1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjzubh)}(h**Description**h]j)}(hjh]h Description}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:20: ./lib/genalloc.chKhjzubh)}(hCreate a new special memory pool that can be used to manage special purpose memory not managed by the regular kmalloc/kfree interface.h]hCreate a new special memory pool that can be used to manage special purpose memory not managed by the regular kmalloc/kfree interface.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:20: ./lib/genalloc.chKhjzubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j!devm_gen_pool_create (C function)c.devm_gen_pool_createhNtauh1jhhhhhNhNubj#)}(hhh](j()}(hkstruct gen_pool * devm_gen_pool_create (struct device *dev, int min_alloc_order, int nid, const char *name)h]j.)}(histruct gen_pool *devm_gen_pool_create(struct device *dev, int min_alloc_order, int nid, const char *name)h](j4)}(hj7h]hstruct}(hjdhhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj`hhhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:23: ./lib/genalloc.chM3ubjF)}(h h]h }(hjrhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj`hhhjqhM3ubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]j)}jsdevm_gen_pool_createsbc.devm_gen_pool_createasbuh1hhj`hhhjqhM3ubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj`hhhjqhM3ubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`hhhjqhM3ubj)}(hdevm_gen_pool_createh]jZ)}(hjh]hdevm_gen_pool_create}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhj`hhhjqhM3ubj)}(hD(struct device *dev, int min_alloc_order, int nid, const char *name)h](j)}(hstruct device *devh](j4)}(hj7h]hstruct}(hjhhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubh)}(hhh]jZ)}(hdeviceh]hdevice}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]jc.devm_gen_pool_createasbuh1hhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hdevh]hdev}(hj5hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hint min_alloc_orderh](j)}(hinth]hint}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubjF)}(h h]h }(hj\hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjJubjZ)}(hmin_alloc_orderh]hmin_alloc_order}(hjjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjJubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hint nidh](j)}(hinth]hint}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubjZ)}(hnidh]hnid}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hconst char *nameh](j4)}(hconsth]hconst}(hjhhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hcharh]hchar}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hnameh]hname}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhj`hhhjqhM3ubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhj\hhhjqhM3ubah}(h]jWah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hjqhM3hjYhhubjR)}(hhh]h)}(hmanaged gen_pool_createh]hmanaged gen_pool_create}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:23: ./lib/genalloc.chM3hj$hhubah}(h]h ]h"]h$]h&]uh1jQhjYhhhjqhM3ubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsj?jtj?jujvjwuh1j"hhhhhNhNubjy)}(hX2**Parameters** ``struct device *dev`` device that provides the gen_pool ``int min_alloc_order`` log base 2 of number of bytes each bitmap bit represents ``int nid`` node selector for allocated gen_pool, ``NUMA_NO_NODE`` for all nodes ``const char *name`` name of a gen_pool or NULL, identifies a particular gen_pool on device **Description** Create a new special memory pool that can be used to manage special purpose memory not managed by the regular kmalloc/kfree interface. The pool will be automatically destroyed by the device management code.h](h)}(h**Parameters**h]j)}(hjIh]h Parameters}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:23: ./lib/genalloc.chM7hjCubj)}(hhh](j)}(h9``struct device *dev`` device that provides the gen_pool h](j)}(h``struct device *dev``h]j)}(hjhh]hstruct device *dev}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:23: ./lib/genalloc.chM4hjbubj)}(hhh]h)}(h!device that provides the gen_poolh]h!device that provides the gen_pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}hM4hj~ubah}(h]h ]h"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]uh1jhj}hM4hj_ubj)}(hQ``int min_alloc_order`` log base 2 of number of bytes each bitmap bit represents h](j)}(h``int min_alloc_order``h]j)}(hjh]hint min_alloc_order}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:23: ./lib/genalloc.chM5hjubj)}(hhh]h)}(h8log base 2 of number of bytes each bitmap bit representsh]h8log base 2 of number of bytes each bitmap bit represents}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM5hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM5hj_ubj)}(hQ``int nid`` node selector for allocated gen_pool, ``NUMA_NO_NODE`` for all nodes h](j)}(h ``int nid``h]j)}(hjh]hint nid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:23: ./lib/genalloc.chM6hjubj)}(hhh]h)}(hDnode selector for allocated gen_pool, ``NUMA_NO_NODE`` for all nodesh](h&node selector for allocated gen_pool, }(hjhhhNhNubj)}(h``NUMA_NO_NODE``h]h NUMA_NO_NODE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh for all nodes}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhM6hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM6hj_ubj)}(h\``const char *name`` name of a gen_pool or NULL, identifies a particular gen_pool on device h](j)}(h``const char *name``h]j)}(hj%h]hconst char *name}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:23: ./lib/genalloc.chM7hjubj)}(hhh]h)}(hFname of a gen_pool or NULL, identifies a particular gen_pool on deviceh]hFname of a gen_pool or NULL, identifies a particular gen_pool on device}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hM7hj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj:hM7hj_ubeh}(h]h ]h"]h$]h&]uh1jhjCubh)}(h**Description**h]j)}(hj`h]h Description}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:23: ./lib/genalloc.chM9hjCubh)}(hCreate a new special memory pool that can be used to manage special purpose memory not managed by the regular kmalloc/kfree interface. The pool will be automatically destroyed by the device management code.h]hCreate a new special memory pool that can be used to manage special purpose memory not managed by the regular kmalloc/kfree interface. The pool will be automatically destroyed by the device management code.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:23: ./lib/genalloc.chM8hjCubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubh)}(hX)A call to gen_pool_create() will create a pool. The granularity of allocations is set with min_alloc_order; it is a log-base-2 number like those used by the page allocator, but it refers to bytes rather than pages. So, if min_alloc_order is passed as 3, then all allocations will be a multiple of eight bytes. Increasing min_alloc_order decreases the memory required to track the memory in the pool. The nid parameter specifies which NUMA node should be used for the allocation of the housekeeping structures; it can be -1 if the caller doesn't care.h]hX+A call to gen_pool_create() will create a pool. The granularity of allocations is set with min_alloc_order; it is a log-base-2 number like those used by the page allocator, but it refers to bytes rather than pages. So, if min_alloc_order is passed as 3, then all allocations will be a multiple of eight bytes. Increasing min_alloc_order decreases the memory required to track the memory in the pool. The nid parameter specifies which NUMA node should be used for the allocation of the housekeeping structures; it can be -1 if the caller doesn’t care.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hThe "managed" interface devm_gen_pool_create() ties the pool to a specific device. Among other things, it will automatically clean up the pool when the given device is destroyed.h]hThe “managed” interface devm_gen_pool_create() ties the pool to a specific device. Among other things, it will automatically clean up the pool when the given device is destroyed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK#hhhhubh)}(hA pool is shut down with:h]hA pool is shut down with:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hhhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jgen_pool_destroy (C function)c.gen_pool_destroyhNtauh1jhhhhhNhNubj#)}(hhh](j()}(h-void gen_pool_destroy (struct gen_pool *pool)h]j.)}(h,void gen_pool_destroy(struct gen_pool *pool)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:41: ./lib/genalloc.chKubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjhhhjhKubj)}(hgen_pool_destroyh]jZ)}(hgen_pool_destroyh]hgen_pool_destroy}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhjhKubj)}(h(struct gen_pool *pool)h]j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hj hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hj*hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj'ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj,modnameN classnameNjwjz)}j}]j)}jsjsbc.gen_pool_destroyasbuh1hhjubjF)}(h h]h }(hjJhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hpoolh]hpool}(hjehhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubah}(h]h ]h"]h$]h&]jjuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhjhhhjhKubah}(h]jah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hjhKhjhhubjR)}(hhh]h)}(hdestroy a special memory poolh]hdestroy a special memory pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:41: ./lib/genalloc.chKhjhhubah}(h]h ]h"]h$]h&]uh1jQhjhhhjhKubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsjjtjjujvjwuh1j"hhhhhNhNubjy)}(h**Parameters** ``struct gen_pool *pool`` pool to destroy **Description** Destroy the specified special memory pool. Verifies that there are no outstanding allocations.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:41: ./lib/genalloc.chKhjubj)}(hhh]j)}(h*``struct gen_pool *pool`` pool to destroy h](j)}(h``struct gen_pool *pool``h]j)}(hjh]hstruct gen_pool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:41: ./lib/genalloc.chKhjubj)}(hhh]h)}(hpool to destroyh]hpool to destroy}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:41: ./lib/genalloc.chKhjubh)}(h^Destroy the specified special memory pool. Verifies that there are no outstanding allocations.h]h^Destroy the specified special memory pool. Verifies that there are no outstanding allocations.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:41: ./lib/genalloc.chKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubh)}(hIt's worth noting that, if there are still allocations outstanding from the given pool, this function will take the rather extreme step of invoking BUG(), crashing the entire system. You have been warned.h]hIt’s worth noting that, if there are still allocations outstanding from the given pool, this function will take the rather extreme step of invoking BUG(), crashing the entire system. You have been warned.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK,hhhhubh)}(hA freshly created pool has no memory to allocate. It is fairly useless in that state, so one of the first orders of business is usually to add memory to the pool. That can be done with one of:h]hA freshly created pool has no memory to allocate. It is fairly useless in that state, so one of the first orders of business is usually to add memory to the pool. That can be done with one of:}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hhhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jgen_pool_add (C function)c.gen_pool_addhNtauh1jhhhhhNhNubj#)}(hhh](j()}(hRint gen_pool_add (struct gen_pool *pool, unsigned long addr, size_t size, int nid)h]j.)}(hQint gen_pool_add(struct gen_pool *pool, unsigned long addr, size_t size, int nid)h](j)}(hinth]hint}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKmubjF)}(h h]h }(hj{hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjhhhhjzhKmubj)}(h gen_pool_addh]jZ)}(h gen_pool_addh]h gen_pool_add}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhhjzhKmubj)}(hA(struct gen_pool *pool, unsigned long addr, size_t size, int nid)h](j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hjhhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]j)}jsjsbc.gen_pool_addasbuh1hhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hpoolh]hpool}(hj hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjF)}(h h]h }(hj) hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj ubj)}(hlongh]hlong}(hj7 hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjF)}(h h]h }(hjE hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj ubjZ)}(haddrh]haddr}(hjS hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h size_t sizeh](h)}(hhh]jZ)}(hsize_th]hsize_t}(hjo hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjl ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjq modnameN classnameNjwjz)}j}]jc.gen_pool_addasbuh1hhjh ubjF)}(h h]h }(hj hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjh ubjZ)}(hsizeh]hsize}(hj hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjh ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hint nidh](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjF)}(h h]h }(hj hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj ubjZ)}(hnidh]hnid}(hj hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhjhhhhjzhKmubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhjdhhhjzhKmubah}(h]j_ah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hjzhKmhjahhubjR)}(hhh]h)}(h-add a new chunk of special memory to the poolh]h-add a new chunk of special memory to the pool}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKmhj hhubah}(h]h ]h"]h$]h&]uh1jQhjahhhjzhKmubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsj jtj jujvjwuh1j"hhhhhNhNubjy)}(hX**Parameters** ``struct gen_pool *pool`` pool to add new memory chunk to ``unsigned long addr`` starting address of memory chunk to add to pool ``size_t size`` size in bytes of the memory chunk to add to pool ``int nid`` node id of the node the chunk structure and bitmap should be allocated on, or -1 **Description** Add a new chunk of special memory to the specified pool. Returns 0 on success or a -ve errno on failure.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKqhj ubj)}(hhh](j)}(h:``struct gen_pool *pool`` pool to add new memory chunk to h](j)}(h``struct gen_pool *pool``h]j)}(hj; h]hstruct gen_pool *pool}(hj= hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj9 ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKnhj5 ubj)}(hhh]h)}(hpool to add new memory chunk toh]hpool to add new memory chunk to}(hjT hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjP hKnhjQ ubah}(h]h ]h"]h$]h&]uh1jhj5 ubeh}(h]h ]h"]h$]h&]uh1jhjP hKnhj2 ubj)}(hG``unsigned long addr`` starting address of memory chunk to add to pool h](j)}(h``unsigned long addr``h]j)}(hjt h]hunsigned long addr}(hjv hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjr ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKohjn ubj)}(hhh]h)}(h/starting address of memory chunk to add to poolh]h/starting address of memory chunk to add to pool}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKohj ubah}(h]h ]h"]h$]h&]uh1jhjn ubeh}(h]h ]h"]h$]h&]uh1jhj hKohj2 ubj)}(hA``size_t size`` size in bytes of the memory chunk to add to pool h](j)}(h``size_t size``h]j)}(hj h]h size_t size}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKphj ubj)}(hhh]h)}(h0size in bytes of the memory chunk to add to poolh]h0size in bytes of the memory chunk to add to pool}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKphj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKphj2 ubj)}(h]``int nid`` node id of the node the chunk structure and bitmap should be allocated on, or -1 h](j)}(h ``int nid``h]j)}(hj h]hint nid}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKrhj ubj)}(hhh]h)}(hPnode id of the node the chunk structure and bitmap should be allocated on, or -1h]hPnode id of the node the chunk structure and bitmap should be allocated on, or -1}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKqhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKrhj2 ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hj" h]h Description}(hj$ hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKthj ubh)}(h8Add a new chunk of special memory to the specified pool.h]h8Add a new chunk of special memory to the specified pool.}(hj8 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKshj ubh)}(h/Returns 0 on success or a -ve errno on failure.h]h/Returns 0 on success or a -ve errno on failure.}(hjG hhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:52: ./include/linux/genalloc.hhKuhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jgen_pool_add_owner (C function)c.gen_pool_add_ownerhNtauh1jhhhhhNhNubj#)}(hhh](j()}(hwint gen_pool_add_owner (struct gen_pool *pool, unsigned long virt, phys_addr_t phys, size_t size, int nid, void *owner)h]j.)}(hvint gen_pool_add_owner(struct gen_pool *pool, unsigned long virt, phys_addr_t phys, size_t size, int nid, void *owner)h](j)}(hinth]hint}(hjv hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjr hhhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKubjF)}(h h]h }(hj hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjr hhhj hKubj)}(hgen_pool_add_ownerh]jZ)}(hgen_pool_add_ownerh]hgen_pool_add_owner}(hj hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj ubah}(h]h ](jjeh"]h$]h&]jjuh1jhjr hhhj hKubj)}(h`(struct gen_pool *pool, unsigned long virt, phys_addr_t phys, size_t size, int nid, void *owner)h](j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hj hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj ubjF)}(h h]h }(hj hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj ubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hj hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj modnameN classnameNjwjz)}j}]j)}jsj sbc.gen_pool_add_ownerasbuh1hhj ubjF)}(h h]h }(hj hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj ubj)}(hjh]h*}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjZ)}(hpoolh]hpool}(hj hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj ubj)}(hunsigned long virth](j)}(hunsignedh]hunsigned}(hj% hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj! ubjF)}(h h]h }(hj3 hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj! ubj)}(hlongh]hlong}(hjA hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj! ubjF)}(h h]h }(hjO hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj! ubjZ)}(hvirth]hvirt}(hj] hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj! ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj ubj)}(hphys_addr_t physh](h)}(hhh]jZ)}(h phys_addr_th]h phys_addr_t}(hjy hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjv ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj{ modnameN classnameNjwjz)}j}]j c.gen_pool_add_ownerasbuh1hhjr ubjF)}(h h]h }(hj hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjr ubjZ)}(hphysh]hphys}(hj hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjr ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj ubj)}(h size_t sizeh](h)}(hhh]jZ)}(hsize_th]hsize_t}(hj hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj modnameN classnameNjwjz)}j}]j c.gen_pool_add_ownerasbuh1hhj ubjF)}(h h]h }(hj hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj ubjZ)}(hsizeh]hsize}(hj hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj ubj)}(hint nidh](j)}(hinth]hint}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubjF)}(h h]h }(hj hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj ubjZ)}(hnidh]hnid}(hj" hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj ubj)}(h void *ownerh](j)}(hvoidh]hvoid}(hj; hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7 ubjF)}(h h]h }(hjI hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj7 ubj)}(hjh]h*}(hjW hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7 ubjZ)}(hownerh]howner}(hjd hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj7 ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj ubeh}(h]h ]h"]h$]h&]jjuh1jhjr hhhj hKubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhjn hhhj hKubah}(h]ji ah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hj hKhjk hhubjR)}(hhh]h)}(h-add a new chunk of special memory to the poolh]h-add a new chunk of special memory to the pool}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhj hhubah}(h]h ]h"]h$]h&]uh1jQhjk hhhj hKubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsj jtj jujvjwuh1j"hhhhhNhNubjy)}(hXa**Parameters** ``struct gen_pool *pool`` pool to add new memory chunk to ``unsigned long virt`` virtual starting address of memory chunk to add to pool ``phys_addr_t phys`` physical starting address of memory chunk to add to pool ``size_t size`` size in bytes of the memory chunk to add to pool ``int nid`` node id of the node the chunk structure and bitmap should be allocated on, or -1 ``void *owner`` private data the publisher would like to recall at alloc time **Description** Add a new chunk of special memory to the specified pool. Returns 0 on success or a -ve errno on failure.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhj ubj)}(hhh](j)}(h:``struct gen_pool *pool`` pool to add new memory chunk to h](j)}(h``struct gen_pool *pool``h]j)}(hj h]hstruct gen_pool *pool}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhj ubj)}(hhh]h)}(hpool to add new memory chunk toh]hpool to add new memory chunk to}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hKhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hKhj ubj)}(hO``unsigned long virt`` virtual starting address of memory chunk to add to pool h](j)}(h``unsigned long virt``h]j)}(hjh]hunsigned long virt}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhjubj)}(hhh]h)}(h7virtual starting address of memory chunk to add to poolh]h7virtual starting address of memory chunk to add to pool}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj ubj)}(hN``phys_addr_t phys`` physical starting address of memory chunk to add to pool h](j)}(h``phys_addr_t phys``h]j)}(hjAh]hphys_addr_t phys}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jhj?ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhj;ubj)}(hhh]h)}(h8physical starting address of memory chunk to add to poolh]h8physical starting address of memory chunk to add to pool}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhKhjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhKhj ubj)}(hA``size_t size`` size in bytes of the memory chunk to add to pool h](j)}(h``size_t size``h]j)}(hjzh]h size_t size}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjxubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhjtubj)}(hhh]h)}(h0size in bytes of the memory chunk to add to poolh]h0size in bytes of the memory chunk to add to pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjhKhj ubj)}(h]``int nid`` node id of the node the chunk structure and bitmap should be allocated on, or -1 h](j)}(h ``int nid``h]j)}(hjh]hint nid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhjubj)}(hhh]h)}(hPnode id of the node the chunk structure and bitmap should be allocated on, or -1h]hPnode id of the node the chunk structure and bitmap should be allocated on, or -1}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj ubj)}(hN``void *owner`` private data the publisher would like to recall at alloc time h](j)}(h``void *owner``h]j)}(hjh]h void *owner}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhjubj)}(hhh]h)}(h=private data the publisher would like to recall at alloc timeh]h=private data the publisher would like to recall at alloc time}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hj(h]h Description}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhj ubh)}(h8Add a new chunk of special memory to the specified pool.h]h8Add a new chunk of special memory to the specified pool.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhj ubh)}(h/Returns 0 on success or a -ve errno on failure.h]h/Returns 0 on success or a -ve errno on failure.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:55: ./lib/genalloc.chKhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubh)}(hXnA call to gen_pool_add() will place the size bytes of memory starting at addr (in the kernel's virtual address space) into the given pool, once again using nid as the node ID for ancillary memory allocations. The gen_pool_add_virt() variant associates an explicit physical address with the memory; this is only necessary if the pool will be used for DMA allocations.h]hXpA call to gen_pool_add() will place the size bytes of memory starting at addr (in the kernel’s virtual address space) into the given pool, once again using nid as the node ID for ancillary memory allocations. The gen_pool_add_virt() variant associates an explicit physical address with the memory; this is only necessary if the pool will be used for DMA allocations.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hhhhubh)}(hLThe functions for allocating memory from the pool (and putting it back) are:h]hLThe functions for allocating memory from the pool (and putting it back) are:}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhhhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jgen_pool_alloc (C function)c.gen_pool_allochNtauh1jhhhhhNhNubj#)}(hhh](j()}(hAunsigned long gen_pool_alloc (struct gen_pool *pool, size_t size)h]j.)}(h@unsigned long gen_pool_alloc(struct gen_pool *pool, size_t size)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:68: ./include/linux/genalloc.hhKubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjhhhjhKubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhKubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjhhhjhKubj)}(hgen_pool_alloch]jZ)}(hgen_pool_alloch]hgen_pool_alloc}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhjhKubj)}(h$(struct gen_pool *pool, size_t size)h](j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hjhhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]j)}jsjsbc.gen_pool_allocasbuh1hhjubjF)}(h h]h }(hj/hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hpoolh]hpool}(hjJhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h size_t sizeh](h)}(hhh]jZ)}(hsize_th]hsize_t}(hjfhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjcubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjhmodnameN classnameNjwjz)}j}]j+c.gen_pool_allocasbuh1hhj_ubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj_ubjZ)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj_ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhjhhhjhKubah}(h]jah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hjhKhjhhubjR)}(hhh]h)}(h%allocate special memory from the poolh]h%allocate special memory from the pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:68: ./include/linux/genalloc.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jQhjhhhjhKubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsjjtjjujvjwuh1j"hhhhhNhNubjy)}(hXr**Parameters** ``struct gen_pool *pool`` pool to allocate from ``size_t size`` number of bytes to allocate from the pool **Description** Allocate the requested number of bytes from the specified pool. Uses the pool allocation function (with first-fit algorithm by default). Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:68: ./include/linux/genalloc.hhKhjubj)}(hhh](j)}(h0``struct gen_pool *pool`` pool to allocate from h](j)}(h``struct gen_pool *pool``h]j)}(hjh]hstruct gen_pool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:68: ./include/linux/genalloc.hhKhjubj)}(hhh]h)}(hpool to allocate fromh]hpool to allocate from}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h:``size_t size`` number of bytes to allocate from the pool h](j)}(h``size_t size``h]j)}(hj6h]h size_t size}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj4ubah}(h]h ]h"]h$]h&]uh1jhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:68: ./include/linux/genalloc.hhKhj0ubj)}(hhh]h)}(h)number of bytes to allocate from the poolh]h)number of bytes to allocate from the pool}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhKhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhKhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjqh]h Description}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jhjoubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:68: ./include/linux/genalloc.hhKhjubh)}(hAllocate the requested number of bytes from the specified pool. Uses the pool allocation function (with first-fit algorithm by default). Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.h]hAllocate the requested number of bytes from the specified pool. Uses the pool allocation function (with first-fit algorithm by default). Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhZ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:68: ./include/linux/genalloc.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jgen_pool_dma_alloc (C function)c.gen_pool_dma_allochNtauh1jhhhhhNhNubj#)}(hhh](j()}(hOvoid * gen_pool_dma_alloc (struct gen_pool *pool, size_t size, dma_addr_t *dma)h]j.)}(hMvoid *gen_pool_dma_alloc(struct gen_pool *pool, size_t size, dma_addr_t *dma)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:71: ./lib/genalloc.chMIubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjhhhjhMIubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhMIubj)}(hgen_pool_dma_alloch]jZ)}(hgen_pool_dma_alloch]hgen_pool_dma_alloc}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhjhMIubj)}(h5(struct gen_pool *pool, size_t size, dma_addr_t *dma)h](j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hjhhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hjubjF)}(h h]h }(hj hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj modnameN classnameNjwjz)}j}]j)}jsjsbc.gen_pool_dma_allocasbuh1hhjubjF)}(h h]h }(hj>hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hjLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hpoolh]hpool}(hjYhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h size_t sizeh](h)}(hhh]jZ)}(hsize_th]hsize_t}(hjuhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjrubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjwmodnameN classnameNjwjz)}j}]j:c.gen_pool_dma_allocasbuh1hhjnubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjnubjZ)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjnubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hdma_addr_t *dmah](h)}(hhh]jZ)}(h dma_addr_th]h dma_addr_t}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]j:c.gen_pool_dma_allocasbuh1hhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hdmah]hdma}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhjhhhjhMIubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhjhhhjhMIubah}(h]jah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hjhMIhjhhubjR)}(hhh]h)}(h3allocate special memory from the pool for DMA usageh]h3allocate special memory from the pool for DMA usage}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:71: ./lib/genalloc.chMIhjhhubah}(h]h ]h"]h$]h&]uh1jQhjhhhjhMIubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsj8jtj8jujvjwuh1j"hhhhhNhNubjy)}(hX**Parameters** ``struct gen_pool *pool`` pool to allocate from ``size_t size`` number of bytes to allocate from the pool ``dma_addr_t *dma`` dma-view physical address return value. Use ``NULL`` if unneeded. **Description** Allocate the requested number of bytes from the specified pool. Uses the pool allocation function (with first-fit algorithm by default). Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation. **Return** virtual address of the allocated memory, or ``NULL`` on failureh](h)}(h**Parameters**h]j)}(hjBh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj@ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:71: ./lib/genalloc.chMMhj<ubj)}(hhh](j)}(h0``struct gen_pool *pool`` pool to allocate from h](j)}(h``struct gen_pool *pool``h]j)}(hjah]hstruct gen_pool *pool}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jhj_ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:71: ./lib/genalloc.chMJhj[ubj)}(hhh]h)}(hpool to allocate fromh]hpool to allocate from}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhMJhjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhMJhjXubj)}(h:``size_t size`` number of bytes to allocate from the pool h](j)}(h``size_t size``h]j)}(hjh]h size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:71: ./lib/genalloc.chMKhjubj)}(hhh]h)}(h)number of bytes to allocate from the poolh]h)number of bytes to allocate from the pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMKhjXubj)}(hW``dma_addr_t *dma`` dma-view physical address return value. Use ``NULL`` if unneeded. h](j)}(h``dma_addr_t *dma``h]j)}(hjh]hdma_addr_t *dma}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:71: ./lib/genalloc.chMLhjubj)}(hhh]h)}(hBdma-view physical address return value. Use ``NULL`` if unneeded.h](h-dma-view physical address return value. Use }(hjhhhNhNubj)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh if unneeded.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjhMLhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMLhjXubeh}(h]h ]h"]h$]h&]uh1jhj<ubh)}(h**Description**h]j)}(hj h]h Description}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:71: ./lib/genalloc.chMNhj<ubh)}(hAllocate the requested number of bytes from the specified pool. Uses the pool allocation function (with first-fit algorithm by default). Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.h]hAllocate the requested number of bytes from the specified pool. Uses the pool allocation function (with first-fit algorithm by default). Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:71: ./lib/genalloc.chMMhj<ubh)}(h **Return**h]j)}(hjGh]hReturn}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjEubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:71: ./lib/genalloc.chMRhj<ubh)}(h?virtual address of the allocated memory, or ``NULL`` on failureh](h,virtual address of the allocated memory, or }(hj]hhhNhNubj)}(h``NULL``h]hNULL}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jhj]ubh on failure}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:71: ./lib/genalloc.chMShj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j gen_pool_free_owner (C function)c.gen_pool_free_ownerhNtauh1jhhhhhNhNubj#)}(hhh](j()}(h_void gen_pool_free_owner (struct gen_pool *pool, unsigned long addr, size_t size, void **owner)h]j.)}(h^void gen_pool_free_owner(struct gen_pool *pool, unsigned long addr, size_t size, void **owner)h](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:74: ./lib/genalloc.chMubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjhhhjhMubj)}(hgen_pool_free_ownerh]jZ)}(hgen_pool_free_ownerh]hgen_pool_free_owner}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhjhMubj)}(hF(struct gen_pool *pool, unsigned long addr, size_t size, void **owner)h](j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hjhhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]j)}jsjsbc.gen_pool_free_ownerasbuh1hhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hpoolh]hpool}(hj4hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjF)}(h h]h }(hj[hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjIubj)}(hlongh]hlong}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubjF)}(h h]h }(hjwhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjIubjZ)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjIubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h size_t sizeh](h)}(hhh]jZ)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]jc.gen_pool_free_ownerasbuh1hhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubjZ)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h void **ownerh](j)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hownerh]howner}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhjhhhjhMubah}(h]jah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hjhMhjhhubjR)}(hhh]h)}(h.free allocated special memory back to the poolh]h.free allocated special memory back to the pool}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:74: ./lib/genalloc.chMhjChhubah}(h]h ]h"]h$]h&]uh1jQhjhhhjhMubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsj^jtj^jujvjwuh1j"hhhhhNhNubjy)}(hX**Parameters** ``struct gen_pool *pool`` pool to free to ``unsigned long addr`` starting address of memory to free back to pool ``size_t size`` size in bytes of memory to free ``void **owner`` private data stashed at gen_pool_add() time **Description** Free previously allocated special memory back to the specified pool. Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.h](h)}(h**Parameters**h]j)}(hjhh]h Parameters}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:74: ./lib/genalloc.chMhjbubj)}(hhh](j)}(h*``struct gen_pool *pool`` pool to free to h](j)}(h``struct gen_pool *pool``h]j)}(hjh]hstruct gen_pool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:74: ./lib/genalloc.chMhjubj)}(hhh]h)}(hpool to free toh]hpool to free to}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj~ubj)}(hG``unsigned long addr`` starting address of memory to free back to pool h](j)}(h``unsigned long addr``h]j)}(hjh]hunsigned long addr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:74: ./lib/genalloc.chMhjubj)}(hhh]h)}(h/starting address of memory to free back to poolh]h/starting address of memory to free back to pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj~ubj)}(h0``size_t size`` size in bytes of memory to free h](j)}(h``size_t size``h]j)}(hjh]h size_t size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:74: ./lib/genalloc.chMhjubj)}(hhh]h)}(hsize in bytes of memory to freeh]hsize in bytes of memory to free}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj~ubj)}(h=``void **owner`` private data stashed at gen_pool_add() time h](j)}(h``void **owner``h]j)}(hj2h]h void **owner}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj0ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:74: ./lib/genalloc.chMhj,ubj)}(hhh]h)}(h+private data stashed at gen_pool_add() timeh]h+private data stashed at gen_pool_add() time}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhMhjHubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhjGhMhj~ubeh}(h]h ]h"]h$]h&]uh1jhjbubh)}(h**Description**h]j)}(hjmh]h Description}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:74: ./lib/genalloc.chMhjbubh)}(hFree previously allocated special memory back to the specified pool. Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.h]hFree previously allocated special memory back to the specified pool. Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:74: ./lib/genalloc.chMhjbubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubh)}(hXAs one would expect, gen_pool_alloc() will allocate size< bytes from the given pool. The gen_pool_dma_alloc() variant allocates memory for use with DMA operations, returning the associated physical address in the space pointed to by dma. This will only work if the memory was added with gen_pool_add_virt(). Note that this function departs from the usual genpool pattern of using unsigned long values to represent kernel addresses; it returns a void * instead.h]hXAs one would expect, gen_pool_alloc() will allocate size< bytes from the given pool. The gen_pool_dma_alloc() variant allocates memory for use with DMA operations, returning the associated physical address in the space pointed to by dma. This will only work if the memory was added with gen_pool_add_virt(). Note that this function departs from the usual genpool pattern of using unsigned long values to represent kernel addresses; it returns a void * instead.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhhhhubh)}(hX4That all seems relatively simple; indeed, some developers clearly found it to be too simple. After all, the interface above provides no control over how the allocation functions choose which specific piece of memory to return. If that sort of control is needed, the following functions will be of interest:h]hX4That all seems relatively simple; indeed, some developers clearly found it to be too simple. After all, the interface above provides no control over how the allocation functions choose which specific piece of memory to return. If that sort of control is needed, the following functions will be of interest:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKUhhhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j&gen_pool_alloc_algo_owner (C function)c.gen_pool_alloc_algo_ownerhNtauh1jhhhhhNhNubj#)}(hhh](j()}(h{unsigned long gen_pool_alloc_algo_owner (struct gen_pool *pool, size_t size, genpool_algo_t algo, void *data, void **owner)h]j.)}(hzunsigned long gen_pool_alloc_algo_owner(struct gen_pool *pool, size_t size, genpool_algo_t algo, void *data, void **owner)h](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:91: ./lib/genalloc.chM ubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjhhhjhM ubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhhhjhM ubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjhhhjhM ubj)}(hgen_pool_alloc_algo_ownerh]jZ)}(hgen_pool_alloc_algo_ownerh]hgen_pool_alloc_algo_owner}(hj hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhjhM ubj)}(hS(struct gen_pool *pool, size_t size, genpool_algo_t algo, void *data, void **owner)h](j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hj'hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj#ubjF)}(h h]h }(hj4hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj#ubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hjEhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjBubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjGmodnameN classnameNjwjz)}j}]j)}jsj sbc.gen_pool_alloc_algo_ownerasbuh1hhj#ubjF)}(h h]h }(hjehhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj#ubj)}(hjh]h*}(hjshhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubjZ)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj#ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h size_t sizeh](h)}(hhh]jZ)}(hsize_th]hsize_t}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]jac.gen_pool_alloc_algo_ownerasbuh1hhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubjZ)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hgenpool_algo_t algoh](h)}(hhh]jZ)}(hgenpool_algo_th]hgenpool_algo_t}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]jac.gen_pool_alloc_algo_ownerasbuh1hhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubjZ)}(halgoh]halgo}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h void *datah](j)}(hvoidh]hvoid}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjF)}(h h]h }(hj7hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj%ubj)}(hjh]h*}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjZ)}(hdatah]hdata}(hjRhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj%ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h void **ownerh](j)}(hvoidh]hvoid}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubjF)}(h h]h }(hjyhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjgubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubjZ)}(hownerh]howner}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjgubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhjhhhjhM ubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhjhhhjhM ubah}(h]jah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hjhM hjhhubjR)}(hhh]h)}(h%allocate special memory from the poolh]h%allocate special memory from the pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:91: ./lib/genalloc.chM hjhhubah}(h]h ]h"]h$]h&]uh1jQhjhhhjhM ubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsjjtjjujvjwuh1j"hhhhhNhNubjy)}(hX **Parameters** ``struct gen_pool *pool`` pool to allocate from ``size_t size`` number of bytes to allocate from the pool ``genpool_algo_t algo`` algorithm passed from caller ``void *data`` data passed to algorithm ``void **owner`` optionally retrieve the chunk owner **Description** Allocate the requested number of bytes from the specified pool. Uses the pool allocation function (with first-fit algorithm by default). Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:91: ./lib/genalloc.chM hjubj)}(hhh](j)}(h0``struct gen_pool *pool`` pool to allocate from h](j)}(h``struct gen_pool *pool``h]j)}(hj h]hstruct gen_pool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:91: ./lib/genalloc.chM hjubj)}(hhh]h)}(hpool to allocate fromh]hpool to allocate from}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hM hj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hM hjubj)}(h:``size_t size`` number of bytes to allocate from the pool h](j)}(h``size_t size``h]j)}(hjEh]h size_t size}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjCubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:91: ./lib/genalloc.chM hj?ubj)}(hhh]h)}(h)number of bytes to allocate from the poolh]h)number of bytes to allocate from the pool}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjZhM hj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhjZhM hjubj)}(h5``genpool_algo_t algo`` algorithm passed from caller h](j)}(h``genpool_algo_t algo``h]j)}(hj~h]hgenpool_algo_t algo}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:91: ./lib/genalloc.chM hjxubj)}(hhh]h)}(halgorithm passed from callerh]halgorithm passed from caller}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h(``void *data`` data passed to algorithm h](j)}(h``void *data``h]j)}(hjh]h void *data}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:91: ./lib/genalloc.chM hjubj)}(hhh]h)}(hdata passed to algorithmh]hdata passed to algorithm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h5``void **owner`` optionally retrieve the chunk owner h](j)}(h``void **owner``h]j)}(hjh]h void **owner}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:91: ./lib/genalloc.chMhjubj)}(hhh]h)}(h#optionally retrieve the chunk ownerh]h#optionally retrieve the chunk owner}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hj+h]h Description}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)ubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:91: ./lib/genalloc.chMhjubh)}(hAllocate the requested number of bytes from the specified pool. Uses the pool allocation function (with first-fit algorithm by default). Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.h]hAllocate the requested number of bytes from the specified pool. Uses the pool allocation function (with first-fit algorithm by default). Can not be used in NMI handler on architectures without NMI-safe cmpxchg implementation.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:91: ./lib/genalloc.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jgen_pool_set_algo (C function)c.gen_pool_set_algohNtauh1jhhhhhNhNubj#)}(hhh](j()}(hOvoid gen_pool_set_algo (struct gen_pool *pool, genpool_algo_t algo, void *data)h]j.)}(hNvoid gen_pool_set_algo(struct gen_pool *pool, genpool_algo_t algo, void *data)h](j)}(hvoidh]hvoid}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlhhhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:94: ./lib/genalloc.chMeubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjlhhhj~hMeubj)}(hgen_pool_set_algoh]jZ)}(hgen_pool_set_algoh]hgen_pool_set_algo}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjlhhhj~hMeubj)}(h8(struct gen_pool *pool, genpool_algo_t algo, void *data)h](j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hjhhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]j)}jsjsbc.gen_pool_set_algoasbuh1hhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hpoolh]hpool}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(hgenpool_algo_t algoh](h)}(hhh]jZ)}(hgenpool_algo_th]hgenpool_algo_t}(hj"hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj$modnameN classnameNjwjz)}j}]jc.gen_pool_set_algoasbuh1hhjubjF)}(h h]h }(hj@hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubjZ)}(halgoh]halgo}(hjNhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubj)}(h void *datah](j)}(hvoidh]hvoid}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubjF)}(h h]h }(hjuhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjcubj)}(hjh]h*}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubjZ)}(hdatah]hdata}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjcubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhjlhhhj~hMeubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhjhhhhj~hMeubah}(h]jcah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hj~hMehjehhubjR)}(hhh]h)}(hset the allocation algorithmh]hset the allocation algorithm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:94: ./lib/genalloc.chMehjhhubah}(h]h ]h"]h$]h&]uh1jQhjehhhj~hMeubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsjjtjjujvjwuh1j"hhhhhNhNubjy)}(hXQ**Parameters** ``struct gen_pool *pool`` pool to change allocation algorithm ``genpool_algo_t algo`` custom algorithm function ``void *data`` additional data used by **algo** **Description** Call **algo** for each memory allocation in the pool. If **algo** is NULL use gen_pool_first_fit as default memory allocation function.h](h)}(h**Parameters**h]j)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:94: ./lib/genalloc.chMihjubj)}(hhh](j)}(h>``struct gen_pool *pool`` pool to change allocation algorithm h](j)}(h``struct gen_pool *pool``h]j)}(hjh]hstruct gen_pool *pool}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:94: ./lib/genalloc.chMfhjubj)}(hhh]h)}(h#pool to change allocation algorithmh]h#pool to change allocation algorithm}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMfhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMfhjubj)}(h2``genpool_algo_t algo`` custom algorithm function h](j)}(h``genpool_algo_t algo``h]j)}(hj4h]hgenpool_algo_t algo}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj2ubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:94: ./lib/genalloc.chMghj.ubj)}(hhh]h)}(hcustom algorithm functionh]hcustom algorithm function}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhMghjJubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhjIhMghjubj)}(h0``void *data`` additional data used by **algo** h](j)}(h``void *data``h]j)}(hjmh]h void *data}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&]uh1jhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:94: ./lib/genalloc.chMhhjgubj)}(hhh]h)}(h additional data used by **algo**h](hadditional data used by }(hjhhhNhNubj)}(h**algo**h]halgo}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1hhjhMhhjubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjhMhhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]j)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:94: ./lib/genalloc.chMjhjubh)}(hCall **algo** for each memory allocation in the pool. If **algo** is NULL use gen_pool_first_fit as default memory allocation function.h](hCall }(hjhhhNhNubj)}(h**algo**h]halgo}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubh, for each memory allocation in the pool. If }(hjhhhNhNubj)}(h**algo**h]halgo}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjubhF is NULL use gen_pool_first_fit as default memory allocation function.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhP/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:94: ./lib/genalloc.chMihjubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubh)}(hXeAllocations with gen_pool_alloc_algo() specify an algorithm to be used to choose the memory to be allocated; the default algorithm can be set with gen_pool_set_algo(). The data value is passed to the algorithm; most ignore it, but it is occasionally needed. One can, naturally, write a special-purpose algorithm, but there is a fair set already available:h]hXeAllocations with gen_pool_alloc_algo() specify an algorithm to be used to choose the memory to be allocated; the default algorithm can be set with gen_pool_set_algo(). The data value is passed to the algorithm; most ignore it, but it is occasionally needed. One can, naturally, write a special-purpose algorithm, but there is a fair set already available:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKahhhhubh bullet_list)}(hhh](h list_item)}(htgen_pool_first_fit is a simple first-fit allocator; this is the default algorithm if none other has been specified. h]h)}(hsgen_pool_first_fit is a simple first-fit allocator; this is the default algorithm if none other has been specified.h]hsgen_pool_first_fit is a simple first-fit allocator; this is the default algorithm if none other has been specified.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhjubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hgen_pool_first_fit_align forces the allocation to have a specific alignment (passed via data in a genpool_data_align structure). h]h)}(hgen_pool_first_fit_align forces the allocation to have a specific alignment (passed via data in a genpool_data_align structure).h]hgen_pool_first_fit_align forces the allocation to have a specific alignment (passed via data in a genpool_data_align structure).}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKkhj3ubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hgen_pool_first_fit_order_align aligns the allocation to the order of the size. A 60-byte allocation will thus be 64-byte aligned, for example. h]h)}(hgen_pool_first_fit_order_align aligns the allocation to the order of the size. A 60-byte allocation will thus be 64-byte aligned, for example.h]hgen_pool_first_fit_order_align aligns the allocation to the order of the size. A 60-byte allocation will thus be 64-byte aligned, for example.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKnhjKubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hHgen_pool_best_fit, as one would expect, is a simple best-fit allocator. h]h)}(hGgen_pool_best_fit, as one would expect, is a simple best-fit allocator.h]hGgen_pool_best_fit, as one would expect, is a simple best-fit allocator.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKqhjcubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubj)}(hgen_pool_fixed_alloc allocates at a specific offset (passed in a genpool_data_fixed structure via the data parameter) within the pool. If the indicated memory is not available the allocation fails. h]h)}(hgen_pool_fixed_alloc allocates at a specific offset (passed in a genpool_data_fixed structure via the data parameter) within the pool. If the indicated memory is not available the allocation fails.h]hgen_pool_fixed_alloc allocates at a specific offset (passed in a genpool_data_fixed structure via the data parameter) within the pool. If the indicated memory is not available the allocation fails.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshj{ubah}(h]h ]h"]h$]h&]uh1jhjhhhhhNubeh}(h]h ]h"]h$]h&]bullet-uh1jhhhKhhhhhubh)}(hX_There is a handful of other functions, mostly for purposes like querying the space available in the pool or iterating through chunks of memory. Most users, however, should not need much beyond what has been described above. With luck, wider awareness of this module will help to prevent the writing of special-purpose memory allocators in the future.h]hX_There is a handful of other functions, mostly for purposes like querying the space available in the pool or iterating through chunks of memory. Most users, however, should not need much beyond what has been described above. With luck, wider awareness of this module will help to prevent the writing of special-purpose memory allocators in the future.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKwhhhhubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j"gen_pool_virt_to_phys (C function)c.gen_pool_virt_to_physhNtauh1jhhhhhNhNubj#)}(hhh](j()}(hMphys_addr_t gen_pool_virt_to_phys (struct gen_pool *pool, unsigned long addr)h]j.)}(hLphys_addr_t gen_pool_virt_to_phys(struct gen_pool *pool, unsigned long addr)h](h)}(hhh]jZ)}(h phys_addr_th]h phys_addr_t}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjmodnameN classnameNjwjz)}j}]j)}jsgen_pool_virt_to_physsbc.gen_pool_virt_to_physasbuh1hhjhhhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:125: ./lib/genalloc.chKubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjhhhjhKubj)}(hgen_pool_virt_to_physh]jZ)}(hjh]hgen_pool_virt_to_phys}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubah}(h]h ](jjeh"]h$]h&]jjuh1jhjhhhjhKubj)}(h+(struct gen_pool *pool, unsigned long addr)h](j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hjhhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hjubjF)}(h h]h }(hj!hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hj2hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj/ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj4modnameN classnameNjwjz)}j}]jc.gen_pool_virt_to_physasbuh1hhjubjF)}(h h]h }(hjPhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hjh]h*}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjZ)}(hpoolh]hpool}(hjkhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj ubj)}(hunsigned long addrh](j)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubj)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubjF)}(h h]h }(hjhhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjubjZ)}(haddrh]haddr}(hjhhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj ubeh}(h]h ]h"]h$]h&]jjuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhjhhhjhKubah}(h]jah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hjhKhjhhubjR)}(hhh]h)}(h%return the physical address of memoryh]h%return the physical address of memory}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:125: ./lib/genalloc.chKhjhhubah}(h]h ]h"]h$]h&]uh1jQhjhhhjhKubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsjjtjjujvjwuh1j"hhhhhNhNubjy)}(h**Parameters** ``struct gen_pool *pool`` pool to allocate from ``unsigned long addr`` starting address of memory **Description** Returns the physical address on success, or -1 on error.h](h)}(h**Parameters**h]j)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:125: ./lib/genalloc.chKhj ubj)}(hhh](j)}(h0``struct gen_pool *pool`` pool to allocate from h](j)}(h``struct gen_pool *pool``h]j)}(hj' h]hstruct gen_pool *pool}(hj) hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj% ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:125: ./lib/genalloc.chKhj! ubj)}(hhh]h)}(hpool to allocate fromh]hpool to allocate from}(hj@ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj< hKhj= ubah}(h]h ]h"]h$]h&]uh1jhj! ubeh}(h]h ]h"]h$]h&]uh1jhj< hKhj ubj)}(h2``unsigned long addr`` starting address of memory h](j)}(h``unsigned long addr``h]j)}(hj` h]hunsigned long addr}(hjb hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^ ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:125: ./lib/genalloc.chKhjZ ubj)}(hhh]h)}(hstarting address of memoryh]hstarting address of memory}(hjy hhhNhNubah}(h]h ]h"]h$]h&]uh1hhju hKhjv ubah}(h]h ]h"]h$]h&]uh1jhjZ ubeh}(h]h ]h"]h$]h&]uh1jhju hKhj ubeh}(h]h ]h"]h$]h&]uh1jhj ubh)}(h**Description**h]j)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:125: ./lib/genalloc.chKhj ubh)}(h8Returns the physical address on success, or -1 on error.h]h8Returns the physical address on success, or -1 on error.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:125: ./lib/genalloc.chKhj ubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](j$gen_pool_for_each_chunk (C function)c.gen_pool_for_each_chunkhNtauh1jhhhhhNhNubj#)}(hhh](j()}(hvoid gen_pool_for_each_chunk (struct gen_pool *pool, void (*func)(struct gen_pool *pool, struct gen_pool_chunk *chunk, void *data), void *data)h]j.)}(hvoid gen_pool_for_each_chunk(struct gen_pool *pool, void (*func)(struct gen_pool *pool, struct gen_pool_chunk *chunk, void *data), void *data)h](j)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:128: ./lib/genalloc.chM ubjF)}(h h]h }(hj hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj hhhj hM ubj)}(hgen_pool_for_each_chunkh]jZ)}(hgen_pool_for_each_chunkh]hgen_pool_for_each_chunk}(hj!hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj hhhj hM ubj)}(hr(struct gen_pool *pool, void (*func)(struct gen_pool *pool, struct gen_pool_chunk *chunk, void *data), void *data)h](j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hj!hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj!ubjF)}(h h]h }(hj*!hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!ubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hj;!hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj8!ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj=!modnameN classnameNjwjz)}j}]j)}jsj!sbc.gen_pool_for_each_chunkasbuh1hhj!ubjF)}(h h]h }(hj[!hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!ubj)}(hjh]h*}(hji!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjZ)}(hpoolh]hpool}(hjv!hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj!ubj)}(hMvoid (*func)(struct gen_pool *pool, struct gen_pool_chunk *chunk, void *data)h](j)}(hvoidh]hvoid}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjF)}(h h]h }(hj!hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!ubj)}(h(h]h(}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(hjh]h*}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjZ)}(hfunch]hfunc}(hj!hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj!ubj)}(h)h]h)}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj)}(hj!h]h(}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubj4)}(hj7h]hstruct}(hj!hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj!ubjF)}(h h]h }(hj!hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!ubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hj "hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj "ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj"modnameN classnameNjwjz)}j}]jW!c.gen_pool_for_each_chunkasbuh1hhj!ubjF)}(h h]h }(hj+"hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!ubj)}(hjh]h*}(hj9"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjZ)}(hpoolh]hpool}(hjF"hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj!ubj)}(h,h]h,}(hjT"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjF)}(h h]h }(hjb"hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!ubj4)}(hj7h]hstruct}(hjp"hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj!ubjF)}(h h]h }(hj}"hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!ubh)}(hhh]jZ)}(hgen_pool_chunkh]hgen_pool_chunk}(hj"hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj"ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj"modnameN classnameNjwjz)}j}]jW!c.gen_pool_for_each_chunkasbuh1hhj!ubjF)}(h h]h }(hj"hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!ubj)}(hjh]h*}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjZ)}(hchunkh]hchunk}(hj"hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj!ubj)}(hjV"h]h,}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjF)}(h h]h }(hj"hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!ubj)}(hvoidh]hvoid}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjF)}(h h]h }(hj"hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!ubj)}(hjh]h*}(hj #hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubjZ)}(hdatah]hdata}(hj#hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj!ubj)}(hj!h]h)}(hj'#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj!ubj)}(h void *datah](j)}(hvoidh]hvoid}(hj?#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;#ubjF)}(h h]h }(hjM#hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj;#ubj)}(hjh]h*}(hj[#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;#ubjZ)}(hdatah]hdata}(hjh#hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj;#ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj!ubeh}(h]h ]h"]h$]h&]jjuh1jhj hhhj hM ubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhj hhhj hM ubah}(h]j ah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hj hM hj hhubjR)}(hhh]h)}(h0call func for every chunk of generic memory poolh]h0call func for every chunk of generic memory pool}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:128: ./lib/genalloc.chM hj#hhubah}(h]h ]h"]h$]h&]uh1jQhj hhhj hM ubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsj#jtj#jujvjwuh1j"hhhhhNhNubjy)}(hXQ**Parameters** ``struct gen_pool *pool`` the generic memory pool ``void (*func)(struct gen_pool *pool, struct gen_pool_chunk *chunk, void *data)`` func to call ``void *data`` additional data used by **func** **Description** Call **func** for every chunk of generic memory pool. The **func** is called with rcu_read_lock held.h](h)}(h**Parameters**h]j)}(hj#h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:128: ./lib/genalloc.chMhj#ubj)}(hhh](j)}(h2``struct gen_pool *pool`` the generic memory pool h](j)}(h``struct gen_pool *pool``h]j)}(hj#h]hstruct gen_pool *pool}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:128: ./lib/genalloc.chM hj#ubj)}(hhh]h)}(hthe generic memory poolh]hthe generic memory pool}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hM hj#ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhj#hM hj#ubj)}(h_``void (*func)(struct gen_pool *pool, struct gen_pool_chunk *chunk, void *data)`` func to call h](j)}(hQ``void (*func)(struct gen_pool *pool, struct gen_pool_chunk *chunk, void *data)``h]j)}(hj $h]hMvoid (*func)(struct gen_pool *pool, struct gen_pool_chunk *chunk, void *data)}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj $ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:128: ./lib/genalloc.chM hj$ubj)}(hhh]h)}(h func to callh]h func to call}(hj%$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!$hM hj"$ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj!$hM hj#ubj)}(h0``void *data`` additional data used by **func** h](j)}(h``void *data``h]j)}(hjE$h]h void *data}(hjG$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjC$ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:128: ./lib/genalloc.chMhj?$ubj)}(hhh]h)}(h additional data used by **func**h](hadditional data used by }(hj^$hhhNhNubj)}(h**func**h]hfunc}(hjf$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj^$ubeh}(h]h ]h"]h$]h&]uh1hhjZ$hMhj[$ubah}(h]h ]h"]h$]h&]uh1jhj?$ubeh}(h]h ]h"]h$]h&]uh1jhjZ$hMhj#ubeh}(h]h ]h"]h$]h&]uh1jhj#ubh)}(h**Description**h]j)}(hj$h]h Description}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:128: ./lib/genalloc.chMhj#ubh)}(hfCall **func** for every chunk of generic memory pool. The **func** is called with rcu_read_lock held.h](hCall }(hj$hhhNhNubj)}(h**func**h]hfunc}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh. for every chunk of generic memory pool. The }(hj$hhhNhNubj)}(h**func**h]hfunc}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj$ubh# is called with rcu_read_lock held.}(hj$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:128: ./lib/genalloc.chMhj#ubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jgen_pool_has_addr (C function)c.gen_pool_has_addrhNtauh1jhhhhhNhNubj#)}(hhh](j()}(hPbool gen_pool_has_addr (struct gen_pool *pool, unsigned long start, size_t size)h]j.)}(hObool gen_pool_has_addr(struct gen_pool *pool, unsigned long start, size_t size)h](j)}(hboolh]hbool}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:131: ./lib/genalloc.chM!ubjF)}(h h]h }(hj%hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj$hhhj%hM!ubj)}(hgen_pool_has_addrh]jZ)}(hgen_pool_has_addrh]hgen_pool_has_addr}(hj%hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj%ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj$hhhj%hM!ubj)}(h9(struct gen_pool *pool, unsigned long start, size_t size)h](j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hj4%hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj0%ubjF)}(h h]h }(hjA%hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj0%ubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hjR%hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjO%ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjT%modnameN classnameNjwjz)}j}]j)}jsj%sbc.gen_pool_has_addrasbuh1hhj0%ubjF)}(h h]h }(hjr%hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj0%ubj)}(hjh]h*}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0%ubjZ)}(hpoolh]hpool}(hj%hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj0%ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj,%ubj)}(hunsigned long starth](j)}(hunsignedh]hunsigned}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjF)}(h h]h }(hj%hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj%ubj)}(hlongh]hlong}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubjF)}(h h]h }(hj%hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj%ubjZ)}(hstarth]hstart}(hj%hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj%ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj,%ubj)}(h size_t sizeh](h)}(hhh]jZ)}(hsize_th]hsize_t}(hj%hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj%ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj%modnameN classnameNjwjz)}j}]jn%c.gen_pool_has_addrasbuh1hhj%ubjF)}(h h]h }(hj&hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj%ubjZ)}(hsizeh]hsize}(hj&&hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj%ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj,%ubeh}(h]h ]h"]h$]h&]jjuh1jhj$hhhj%hM!ubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhj$hhhj%hM!ubah}(h]j$ah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hj%hM!hj$hhubjR)}(hhh]h)}(h5checks if an address falls within the range of a poolh]h5checks if an address falls within the range of a pool}(hjP&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:131: ./lib/genalloc.chM!hjM&hhubah}(h]h ]h"]h$]h&]uh1jQhj$hhhj%hM!ubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsjh&jtjh&jujvjwuh1j"hhhhhNhNubjy)}(hX4**Parameters** ``struct gen_pool *pool`` the generic memory pool ``unsigned long start`` start address ``size_t size`` size of the region **Description** Check if the range of addresses falls within the specified pool. Returns true if the entire range is contained in the pool and false otherwise.h](h)}(h**Parameters**h]j)}(hjr&h]h Parameters}(hjt&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjp&ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:131: ./lib/genalloc.chM%hjl&ubj)}(hhh](j)}(h2``struct gen_pool *pool`` the generic memory pool h](j)}(h``struct gen_pool *pool``h]j)}(hj&h]hstruct gen_pool *pool}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:131: ./lib/genalloc.chM"hj&ubj)}(hhh]h)}(hthe generic memory poolh]hthe generic memory pool}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hM"hj&ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhj&hM"hj&ubj)}(h&``unsigned long start`` start address h](j)}(h``unsigned long start``h]j)}(hj&h]hunsigned long start}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj&ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:131: ./lib/genalloc.chM#hj&ubj)}(hhh]h)}(h start addressh]h start address}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hM#hj&ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhj&hM#hj&ubj)}(h#``size_t size`` size of the region h](j)}(h``size_t size``h]j)}(hj'h]h size_t size}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:131: ./lib/genalloc.chM$hj&ubj)}(hhh]h)}(hsize of the regionh]hsize of the region}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hM$hj'ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhj'hM$hj&ubeh}(h]h ]h"]h$]h&]uh1jhjl&ubh)}(h**Description**h]j)}(hj>'h]h Description}(hj@'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj<'ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:131: ./lib/genalloc.chM&hjl&ubh)}(hCheck if the range of addresses falls within the specified pool. Returns true if the entire range is contained in the pool and false otherwise.h]hCheck if the range of addresses falls within the specified pool. Returns true if the entire range is contained in the pool and false otherwise.}(hjT'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:131: ./lib/genalloc.chM%hjl&ubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jgen_pool_avail (C function)c.gen_pool_availhNtauh1jhhhhhNhNubj#)}(hhh](j()}(h-size_t gen_pool_avail (struct gen_pool *pool)h]j.)}(h,size_t gen_pool_avail(struct gen_pool *pool)h](h)}(hhh]jZ)}(hsize_th]hsize_t}(hj'hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj'ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj'modnameN classnameNjwjz)}j}]j)}jsgen_pool_availsbc.gen_pool_availasbuh1hhj'hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:134: ./lib/genalloc.chM?ubjF)}(h h]h }(hj'hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj'hhhj'hM?ubj)}(hgen_pool_availh]jZ)}(hj'h]hgen_pool_avail}(hj'hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj'ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj'hhhj'hM?ubj)}(h(struct gen_pool *pool)h]j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hj'hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj'ubjF)}(h h]h }(hj'hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj'ubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hj'hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj'ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj'modnameN classnameNjwjz)}j}]j'c.gen_pool_availasbuh1hhj'ubjF)}(h h]h }(hj(hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj'ubj)}(hjh]h*}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubjZ)}(hpoolh]hpool}(hj,(hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj'ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj'ubah}(h]h ]h"]h$]h&]jjuh1jhj'hhhj'hM?ubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhj{'hhhj'hM?ubah}(h]jv'ah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hj'hM?hjx'hhubjR)}(hhh]h)}(h$get available free space of the poolh]h$get available free space of the pool}(hjV(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:134: ./lib/genalloc.chM?hjS(hhubah}(h]h ]h"]h$]h&]uh1jQhjx'hhhj'hM?ubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsjn(jtjn(jujvjwuh1j"hhhhhNhNubjy)}(h**Parameters** ``struct gen_pool *pool`` pool to get available free space **Description** Return available free space of the specified pool.h](h)}(h**Parameters**h]j)}(hjx(h]h Parameters}(hjz(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjv(ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:134: ./lib/genalloc.chMChjr(ubj)}(hhh]j)}(h;``struct gen_pool *pool`` pool to get available free space h](j)}(h``struct gen_pool *pool``h]j)}(hj(h]hstruct gen_pool *pool}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:134: ./lib/genalloc.chM@hj(ubj)}(hhh]h)}(h pool to get available free spaceh]h pool to get available free space}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hM@hj(ubah}(h]h ]h"]h$]h&]uh1jhj(ubeh}(h]h ]h"]h$]h&]uh1jhj(hM@hj(ubah}(h]h ]h"]h$]h&]uh1jhjr(ubh)}(h**Description**h]j)}(hj(h]h Description}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj(ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:134: ./lib/genalloc.chMBhjr(ubh)}(h2Return available free space of the specified pool.h]h2Return available free space of the specified pool.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:134: ./lib/genalloc.chMAhjr(ubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jgen_pool_size (C function)c.gen_pool_sizehNtauh1jhhhhhNhNubj#)}(hhh](j()}(h,size_t gen_pool_size (struct gen_pool *pool)h]j.)}(h+size_t gen_pool_size(struct gen_pool *pool)h](h)}(hhh]jZ)}(hsize_th]hsize_t}(hj)hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj)ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj)modnameN classnameNjwjz)}j}]j)}js gen_pool_sizesbc.gen_pool_sizeasbuh1hhj)hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:137: ./lib/genalloc.chMRubjF)}(h h]h }(hj<)hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj)hhhj;)hMRubj)}(h gen_pool_sizeh]jZ)}(hj8)h]h gen_pool_size}(hjN)hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjJ)ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj)hhhj;)hMRubj)}(h(struct gen_pool *pool)h]j)}(hstruct gen_pool *poolh](j4)}(hj7h]hstruct}(hji)hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hje)ubjF)}(h h]h }(hjv)hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhje)ubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hj)hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj)ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj)modnameN classnameNjwjz)}j}]j6)c.gen_pool_sizeasbuh1hhje)ubjF)}(h h]h }(hj)hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhje)ubj)}(hjh]h*}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhje)ubjZ)}(hpoolh]hpool}(hj)hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhje)ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhja)ubah}(h]h ]h"]h$]h&]jjuh1jhj)hhhj;)hMRubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhj)hhhj;)hMRubah}(h]j )ah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hj;)hMRhj )hhubjR)}(hhh]h)}(h/get size in bytes of memory managed by the poolh]h/get size in bytes of memory managed by the pool}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:137: ./lib/genalloc.chMRhj)hhubah}(h]h ]h"]h$]h&]uh1jQhj )hhhj;)hMRubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsj*jtj*jujvjwuh1j"hhhhhNhNubjy)}(h**Parameters** ``struct gen_pool *pool`` pool to get size **Description** Return size in bytes of memory managed by the pool.h](h)}(h**Parameters**h]j)}(hj *h]h Parameters}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj *ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:137: ./lib/genalloc.chMVhj*ubj)}(hhh]j)}(h+``struct gen_pool *pool`` pool to get size h](j)}(h``struct gen_pool *pool``h]j)}(hj+*h]hstruct gen_pool *pool}(hj-*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj)*ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:137: ./lib/genalloc.chMShj%*ubj)}(hhh]h)}(hpool to get sizeh]hpool to get size}(hjD*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj@*hMShjA*ubah}(h]h ]h"]h$]h&]uh1jhj%*ubeh}(h]h ]h"]h$]h&]uh1jhj@*hMShj"*ubah}(h]h ]h"]h$]h&]uh1jhj*ubh)}(h**Description**h]j)}(hjf*h]h Description}(hjh*hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjd*ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:137: ./lib/genalloc.chMUhj*ubh)}(h3Return size in bytes of memory managed by the pool.h]h3Return size in bytes of memory managed by the pool.}(hj|*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:137: ./lib/genalloc.chMThj*ubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jgen_pool_get (C function)c.gen_pool_gethNtauh1jhhhhhNhNubj#)}(hhh](j()}(hEstruct gen_pool * gen_pool_get (struct device *dev, const char *name)h]j.)}(hCstruct gen_pool *gen_pool_get(struct device *dev, const char *name)h](j4)}(hj7h]hstruct}(hj*hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj*hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:140: ./lib/genalloc.chM ubjF)}(h h]h }(hj*hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj*hhhj*hM ubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hj*hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj*ubah}(h=]h ]h"]h$]h&] refdomainjqreftypejs reftargetj*modnameN classnameNjwjz)}j}]j)}js gen_pool_getsbc.gen_pool_getasbuh1hhj*hhhj*hM ubjF)}(h h]h }(hj*hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj*hhhj*hM ubj)}(hjh]h*}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*hhhj*hM ubj)}(h gen_pool_geth]jZ)}(hj*h]h gen_pool_get}(hj +hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj+ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj*hhhj*hM ubj)}(h&(struct device *dev, const char *name)h](j)}(hstruct device *devh](j4)}(hj7h]hstruct}(hj%+hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj!+ubjF)}(h h]h }(hj2+hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!+ubh)}(hhh]jZ)}(hdeviceh]hdevice}(hjC+hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj@+ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetjE+modnameN classnameNjwjz)}j}]j*c.gen_pool_getasbuh1hhj!+ubjF)}(h h]h }(hja+hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj!+ubj)}(hjh]h*}(hjo+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!+ubjZ)}(hdevh]hdev}(hj|+hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj!+ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj+ubj)}(hconst char *nameh](j4)}(hjh]hconst}(hj+hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj+ubjF)}(h h]h }(hj+hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj+ubj)}(hcharh]hchar}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjF)}(h h]h }(hj+hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj+ubj)}(hjh]h*}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubjZ)}(hnameh]hname}(hj+hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj+ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhj+ubeh}(h]h ]h"]h$]h&]jjuh1jhj*hhhj*hM ubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhj*hhhj*hM ubah}(h]j*ah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hj*hM hj*hhubjR)}(hhh]h)}(h)Obtain the gen_pool (if any) for a deviceh]h)Obtain the gen_pool (if any) for a device}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:140: ./lib/genalloc.chM hj,hhubah}(h]h ]h"]h$]h&]uh1jQhj*hhhj*hM ubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsj,jtj,jujvjwuh1j"hhhhhNhNubjy)}(h**Parameters** ``struct device *dev`` device to retrieve the gen_pool from ``const char *name`` name of a gen_pool or NULL, identifies a particular gen_pool on device **Description** Returns the gen_pool for the device if one is present, or NULL.h](h)}(h**Parameters**h]j)}(hj%,h]h Parameters}(hj',hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj#,ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:140: ./lib/genalloc.chM$hj,ubj)}(hhh](j)}(h<``struct device *dev`` device to retrieve the gen_pool from h](j)}(h``struct device *dev``h]j)}(hjD,h]hstruct device *dev}(hjF,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjB,ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:140: ./lib/genalloc.chM!hj>,ubj)}(hhh]h)}(h$device to retrieve the gen_pool fromh]h$device to retrieve the gen_pool from}(hj],hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjY,hM!hjZ,ubah}(h]h ]h"]h$]h&]uh1jhj>,ubeh}(h]h ]h"]h$]h&]uh1jhjY,hM!hj;,ubj)}(h\``const char *name`` name of a gen_pool or NULL, identifies a particular gen_pool on device h](j)}(h``const char *name``h]j)}(hj},h]hconst char *name}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj{,ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:140: ./lib/genalloc.chM"hjw,ubj)}(hhh]h)}(hFname of a gen_pool or NULL, identifies a particular gen_pool on deviceh]hFname of a gen_pool or NULL, identifies a particular gen_pool on device}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hM"hj,ubah}(h]h ]h"]h$]h&]uh1jhjw,ubeh}(h]h ]h"]h$]h&]uh1jhj,hM"hj;,ubeh}(h]h ]h"]h$]h&]uh1jhj,ubh)}(h**Description**h]j)}(hj,h]h Description}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj,ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:140: ./lib/genalloc.chM$hj,ubh)}(h?Returns the gen_pool for the device if one is present, or NULL.h]h?Returns the gen_pool for the device if one is present, or NULL.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:140: ./lib/genalloc.chM#hj,ubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubj)}(hhh]h}(h]h ]h"]h$]h&]entries](jof_gen_pool_get (C function)c.of_gen_pool_gethNtauh1jhhhhhNhNubj#)}(hhh](j()}(h[struct gen_pool * of_gen_pool_get (struct device_node *np, const char *propname, int index)h]j.)}(hYstruct gen_pool *of_gen_pool_get(struct device_node *np, const char *propname, int index)h](j4)}(hj7h]hstruct}(hj,hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj,hhhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:143: ./lib/genalloc.chMfubjF)}(h h]h }(hj -hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj,hhhj -hMfubh)}(hhh]jZ)}(hgen_poolh]hgen_pool}(hj-hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj-ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj-modnameN classnameNjwjz)}j}]j)}jsof_gen_pool_getsbc.of_gen_pool_getasbuh1hhj,hhhj -hMfubjF)}(h h]h }(hj=-hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj,hhhj -hMfubj)}(hjh]h*}(hjK-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,hhhj -hMfubj)}(hof_gen_pool_geth]jZ)}(hj:-h]hof_gen_pool_get}(hj\-hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjX-ubah}(h]h ](jjeh"]h$]h&]jjuh1jhj,hhhj -hMfubj)}(h9(struct device_node *np, const char *propname, int index)h](j)}(hstruct device_node *nph](j4)}(hj7h]hstruct}(hjw-hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hjs-ubjF)}(h h]h }(hj-hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjs-ubh)}(hhh]jZ)}(h device_nodeh]h device_node}(hj-hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj-ubah}(h]h ]h"]h$]h&] refdomainjqreftypejs reftargetj-modnameN classnameNjwjz)}j}]j8-c.of_gen_pool_getasbuh1hhjs-ubjF)}(h h]h }(hj-hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhjs-ubj)}(hjh]h*}(hj-hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs-ubjZ)}(hnph]hnp}(hj-hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhjs-ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjo-ubj)}(hconst char *propnameh](j4)}(hjh]hconst}(hj-hhhNhNubah}(h]h ]j@ah"]h$]h&]uh1j3hj-ubjF)}(h h]h }(hj-hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj-ubj)}(hcharh]hchar}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubjF)}(h h]h }(hj.hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj-ubj)}(hjh]h*}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubjZ)}(hpropnameh]hpropname}(hj+.hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj-ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjo-ubj)}(h int indexh](j)}(hinth]hint}(hjD.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@.ubjF)}(h h]h }(hjR.hhhNhNubah}(h]h ]jRah"]h$]h&]uh1jEhj@.ubjZ)}(hindexh]hindex}(hj`.hhhNhNubah}(h]h ]jfah"]h$]h&]uh1jYhj@.ubeh}(h]h ]h"]h$]h&]noemphjjuh1jhjo-ubeh}(h]h ]h"]h$]h&]jjuh1jhj,hhhj -hMfubeh}(h]h ]h"]h$]h&]jjjCuh1j-jDjEhj,hhhj -hMfubah}(h]j,ah ](jIjJeh"]h$]h&]jNjO)jPhuh1j'hj -hMfhj,hhubjR)}(hhh]h)}(hfind a pool by phandle propertyh]hfind a pool by phandle property}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:143: ./lib/genalloc.chMfhj.hhubah}(h]h ]h"]h$]h&]uh1jQhj,hhhj -hMfubeh}(h]h ](jqfunctioneh"]h$]h&]jrjqjsj.jtj.jujvjwuh1j"hhhhhNhNubjy)}(hXT**Parameters** ``struct device_node *np`` device node ``const char *propname`` property name containing phandle(s) ``int index`` index into the phandle array **Description** Returns the pool that contains the chunk starting at the physical address of the device tree node pointed at by the phandle property, or NULL if not found.h](h)}(h**Parameters**h]j)}(hj.h]h Parameters}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:143: ./lib/genalloc.chMjhj.ubj)}(hhh](j)}(h'``struct device_node *np`` device node h](j)}(h``struct device_node *np``h]j)}(hj.h]hstruct device_node *np}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj.ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:143: ./lib/genalloc.chMghj.ubj)}(hhh]h)}(h device nodeh]h device node}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMghj.ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj.hMghj.ubj)}(h=``const char *propname`` property name containing phandle(s) h](j)}(h``const char *propname``h]j)}(hj/h]hconst char *propname}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj/ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:143: ./lib/genalloc.chMhhj.ubj)}(hhh]h)}(h#property name containing phandle(s)h]h#property name containing phandle(s)}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hMhhj/ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj/hMhhj.ubj)}(h+``int index`` index into the phandle array h](j)}(h ``int index``h]j)}(hj=/h]h int index}(hj?/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhj;/ubah}(h]h ]h"]h$]h&]uh1jhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:143: ./lib/genalloc.chMihj7/ubj)}(hhh]h)}(hindex into the phandle arrayh]hindex into the phandle array}(hjV/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjR/hMihjS/ubah}(h]h ]h"]h$]h&]uh1jhj7/ubeh}(h]h ]h"]h$]h&]uh1jhjR/hMihj.ubeh}(h]h ]h"]h$]h&]uh1jhj.ubh)}(h**Description**h]j)}(hjx/h]h Description}(hjz/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhjv/ubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:143: ./lib/genalloc.chMkhj.ubh)}(hReturns the pool that contains the chunk starting at the physical address of the device tree node pointed at by the phandle property, or NULL if not found.h]hReturns the pool that contains the chunk starting at the physical address of the device tree node pointed at by the phandle property, or NULL if not found.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhQ/var/lib/git/docbuild/linux/Documentation/core-api/genalloc:143: ./lib/genalloc.chMjhj.ubeh}(h]h ] kernelindentah"]h$]h&]uh1jxhhhhhNhNubeh}(h]the-genalloc-genpool-subsystemah ]h"]the genalloc/genpool subsystemah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN 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_handlerj/error_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}posted]hasrefids}nameids}(j/j/hhu nametypes}(j/huh}(j/hhhj j)jWj\jjj_jdji jn jjjjjjjjjcjhjjj j j$j$jv'j{'j )j)j*j*j,j,u 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] transformerN include_log] decorationNhhub.