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/xarraymodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/zh_TW/core-api/xarraymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/it_IT/core-api/xarraymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ja_JP/core-api/xarraymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/ko_KR/core-api/xarraymodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget#/translations/sp_SP/core-api/xarraymodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h!SPDX-License-Identifier: GPL-2.0+h]h!SPDX-License-Identifier: GPL-2.0+}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh=/var/lib/git/docbuild/linux/Documentation/core-api/xarray.rsthKubhsection)}(hhh](htitle)}(hXArrayh]hXArray}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh field_list)}(hhh]hfield)}(hhh](h field_name)}(hAuthorh]hAuthor}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhKubh field_body)}(hMatthew Wilcox h]h paragraph)}(hMatthew Wilcoxh]hMatthew Wilcox}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hOverviewh]hOverview}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhK ubh)}(hXThe XArray is an abstract data type which behaves like a very large array of pointers. It meets many of the same needs as a hash or a conventional resizable array. Unlike a hash, it allows you to sensibly go to the next or previous entry in a cache-efficient manner. In contrast to a resizable array, there is no need to copy data or change MMU mappings in order to grow the array. It is more memory-efficient, parallelisable and cache friendly than a doubly-linked list. It takes advantage of RCU to perform lookups without locking.h]hXThe XArray is an abstract data type which behaves like a very large array of pointers. It meets many of the same needs as a hash or a conventional resizable array. Unlike a hash, it allows you to sensibly go to the next or previous entry in a cache-efficient manner. In contrast to a resizable array, there is no need to copy data or change MMU mappings in order to grow the array. It is more memory-efficient, parallelisable and cache friendly than a doubly-linked list. It takes advantage of RCU to perform lookups without locking.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hj hhubh)}(hXThe XArray implementation is efficient when the indices used are densely clustered; hashing the object and using the hash as the index will not perform well. The XArray is optimised for small indices, but still has good performance with large indices. If your index can be larger than ``ULONG_MAX`` then the XArray is not the data type for you. The most important user of the XArray is the page cache.h](hXThe XArray implementation is efficient when the indices used are densely clustered; hashing the object and using the hash as the index will not perform well. The XArray is optimised for small indices, but still has good performance with large indices. If your index can be larger than }(hj*hhhNhNubhliteral)}(h ``ULONG_MAX``h]h ULONG_MAX}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj*ubhh then the XArray is not the data type for you. The most important user of the XArray is the page cache.}(hj*hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(hX[Normal pointers may be stored in the XArray directly. They must be 4-byte aligned, which is true for any pointer returned from kmalloc() and alloc_page(). It isn't true for arbitrary user-space pointers, nor for function pointers. You can store pointers to statically allocated objects, as long as those objects have an alignment of at least 4.h]hX]Normal pointers may be stored in the XArray directly. They must be 4-byte aligned, which is true for any pointer returned from kmalloc() and alloc_page(). It isn’t true for arbitrary user-space pointers, nor for function pointers. You can store pointers to statically allocated objects, as long as those objects have an alignment of at least 4.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(hX.You can also store integers between 0 and ``LONG_MAX`` in the XArray. You must first convert it into an entry using xa_mk_value(). When you retrieve an entry from the XArray, you can check whether it is a value entry by calling xa_is_value(), and convert it back to an integer by calling xa_to_value().h](h*You can also store integers between 0 and }(hjZhhhNhNubj3)}(h ``LONG_MAX``h]hLONG_MAX}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjZubh in the XArray. You must first convert it into an entry using xa_mk_value(). When you retrieve an entry from the XArray, you can check whether it is a value entry by calling xa_is_value(), and convert it back to an integer by calling xa_to_value().}(hjZhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK"hj hhubh)}(hXSome users want to tag the pointers they store in the XArray. You can call xa_tag_pointer() to create an entry with a tag, xa_untag_pointer() to turn a tagged entry back into an untagged pointer and xa_pointer_tag() to retrieve the tag of an entry. Tagged pointers use the same bits that are used to distinguish value entries from normal pointers, so you must decide whether you want to store value entries or tagged pointers in any particular XArray.h]hXSome users want to tag the pointers they store in the XArray. You can call xa_tag_pointer() to create an entry with a tag, xa_untag_pointer() to turn a tagged entry back into an untagged pointer and xa_pointer_tag() to retrieve the tag of an entry. Tagged pointers use the same bits that are used to distinguish value entries from normal pointers, so you must decide whether you want to store value entries or tagged pointers in any particular XArray.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK(hj hhubh)}(hnThe XArray does not support storing IS_ERR() pointers as some conflict with value entries or internal entries.h]hnThe XArray does not support storing IS_ERR() pointers as some conflict with value entries or internal entries.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hj hhubh)}(hXAn unusual feature of the XArray is the ability to create entries which occupy a range of indices. Once stored to, looking up any index in the range will return the same entry as looking up any other index in the range. Storing to any index will store to all of them. Multi-index entries can be explicitly split into smaller entries. Unsetting (using xa_erase() or xa_store() with ``NULL``) any entry will cause the XArray to forget about the range.h](hXAn unusual feature of the XArray is the ability to create entries which occupy a range of indices. Once stored to, looking up any index in the range will return the same entry as looking up any other index in the range. Storing to any index will store to all of them. Multi-index entries can be explicitly split into smaller entries. Unsetting (using xa_erase() or xa_store() with }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh<) any entry will cause the XArray to forget about the range.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK3hj hhubeh}(h]overviewah ]h"]overviewah$]h&]uh1hhhhhhhhK ubh)}(hhh](h)}(h Normal APIh]h Normal API}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKhjhhubh)}(hXYou can then set entries using xa_store() and get entries using xa_load(). xa_store() will overwrite any entry with the new entry and return the previous entry stored at that index. You can unset entries using xa_erase() or by setting the entry to ``NULL`` using xa_store(). There is no difference between an entry that has never been stored to and one that has been erased with xa_erase(); an entry that has most recently had ``NULL`` stored to it is also equivalent except if the XArray was initialized with ``XA_FLAGS_ALLOC``.h](hYou can then set entries using xa_store() and get entries using xa_load(). xa_store() will overwrite any entry with the new entry and return the previous entry stored at that index. You can unset entries using xa_erase() or by setting the entry to }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh using xa_store(). There is no difference between an entry that has never been stored to and one that has been erased with xa_erase(); an entry that has most recently had }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubhK stored to it is also equivalent except if the XArray was initialized with }(hjhhhNhNubj3)}(h``XA_FLAGS_ALLOC``h]hXA_FLAGS_ALLOC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKChjhhubh)}(hX(You can conditionally replace an entry at an index by using xa_cmpxchg(). Like cmpxchg(), it will only succeed if the entry at that index has the 'old' value. It also returns the entry which was at that index; if it returns the same entry which was passed as 'old', then xa_cmpxchg() succeeded.h]hX0You can conditionally replace an entry at an index by using xa_cmpxchg(). Like cmpxchg(), it will only succeed if the entry at that index has the ‘old’ value. It also returns the entry which was at that index; if it returns the same entry which was passed as ‘old’, then xa_cmpxchg() succeeded.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKLhjhhubh)}(hIf you want to only store a new entry to an index if the current entry at that index is ``NULL``, you can use xa_insert() which returns ``-EBUSY`` if the entry is not empty.h](hXIf you want to only store a new entry to an index if the current entry at that index is }(hjAhhhNhNubj3)}(h``NULL``h]hNULL}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjAubh(, you can use xa_insert() which returns }(hjAhhhNhNubj3)}(h ``-EBUSY``h]h-EBUSY}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjAubh if the entry is not empty.}(hjAhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKRhjhhubh)}(hX7You can copy entries out of the XArray into a plain array by calling xa_extract(). Or you can iterate over the present entries in the XArray by calling xa_for_each(), xa_for_each_start() or xa_for_each_range(). You may prefer to use xa_find() or xa_find_after() to move to the next present entry in the XArray.h]hX7You can copy entries out of the XArray into a plain array by calling xa_extract(). Or you can iterate over the present entries in the XArray by calling xa_for_each(), xa_for_each_start() or xa_for_each_range(). You may prefer to use xa_find() or xa_find_after() to move to the next present entry in the XArray.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKVhjhhubh)}(hXCalling xa_store_range() stores the same entry in a range of indices. If you do this, some of the other operations will behave in a slightly odd way. For example, marking the entry at one index may result in the entry being marked at some, but not all of the other indices. Storing into one index may result in the entry retrieved by some, but not all of the other indices changing.h]hXCalling xa_store_range() stores the same entry in a range of indices. If you do this, some of the other operations will behave in a slightly odd way. For example, marking the entry at one index may result in the entry being marked at some, but not all of the other indices. Storing into one index may result in the entry retrieved by some, but not all of the other indices changing.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK\hjhhubh)}(hX2Sometimes you need to ensure that a subsequent call to xa_store() will not need to allocate memory. The xa_reserve() function will store a reserved entry at the indicated index. Users of the normal API will see this entry as containing ``NULL``. If you do not need to use the reserved entry, you can call xa_release() to remove the unused entry. If another user has stored to the entry in the meantime, xa_release() will do nothing; if instead you want the entry to become ``NULL``, you should use xa_erase(). Using xa_insert() on a reserved entry will fail.h](hSometimes you need to ensure that a subsequent call to xa_store() will not need to allocate memory. The xa_reserve() function will store a reserved entry at the indicated index. Users of the normal API will see this entry as containing }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh. If you do not need to use the reserved entry, you can call xa_release() to remove the unused entry. If another user has stored to the entry in the meantime, xa_release() will do nothing; if instead you want the entry to become }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubhM, you should use xa_erase(). Using xa_insert() on a reserved entry will fail.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKchjhhubh)}(hWIf all entries in the array are ``NULL``, the xa_empty() function will return ``true``.h](h If all entries in the array are }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh&, the xa_empty() function will return }(hjhhhNhNubj3)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKmhjhhubh)}(hFinally, you can remove all entries from an XArray by calling xa_destroy(). If the XArray entries are pointers, you may wish to free the entries first. You can do this by iterating over all present entries in the XArray using the xa_for_each() iterator.h]hFinally, you can remove all entries from an XArray by calling xa_destroy(). If the XArray entries are pointers, you may wish to free the entries first. You can do this by iterating over all present entries in the XArray using the xa_for_each() iterator.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphjhhubh)}(hhh](h)}(h Search Marksh]h Search Marks}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKvubh)}(hEach entry in the array has three bits associated with it called marks. Each mark may be set or cleared independently of the others. You can iterate over marked entries by using the xa_for_each_marked() iterator.h]hEach entry in the array has three bits associated with it called marks. Each mark may be set or cleared independently of the others. You can iterate over marked entries by using the xa_for_each_marked() iterator.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKxhjhhubh)}(hXYou can enquire whether a mark is set on an entry by using xa_get_mark(). If the entry is not ``NULL``, you can set a mark on it by using xa_set_mark() and remove the mark from an entry by calling xa_clear_mark(). You can ask whether any entry in the XArray has a particular mark set by calling xa_marked(). Erasing an entry from the XArray causes all marks associated with that entry to be cleared.h](h_You can enquire whether a mark is set on an entry by using xa_get_mark(). If the entry is not }(hj hhhNhNubj3)}(h``NULL``h]hNULL}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubhX+, you can set a mark on it by using xa_set_mark() and remove the mark from an entry by calling xa_clear_mark(). You can ask whether any entry in the XArray has a particular mark set by calling xa_marked(). Erasing an entry from the XArray causes all marks associated with that entry to be cleared.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK|hjhhubh)}(hSetting or clearing a mark on any index of a multi-index entry will affect all indices covered by that entry. Querying the mark on any index will return the same result.h]hSetting or clearing a mark on any index of a multi-index entry will affect all indices covered by that entry. Querying the mark on any index will return the same result.}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hXThere is no way to iterate over entries which are not marked; the data structure does not allow this to be implemented efficiently. There are not currently iterators to search for logical combinations of bits (eg iterate over all entries which have both ``XA_MARK_1`` and ``XA_MARK_2`` set, or iterate over all entries which have ``XA_MARK_0`` or ``XA_MARK_2`` set). It would be possible to add these if a user arises.h](hThere is no way to iterate over entries which are not marked; the data structure does not allow this to be implemented efficiently. There are not currently iterators to search for logical combinations of bits (eg iterate over all entries which have both }(hjNhhhNhNubj3)}(h ``XA_MARK_1``h]h XA_MARK_1}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjNubh and }(hjNhhhNhNubj3)}(h ``XA_MARK_2``h]h XA_MARK_2}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjNubh- set, or iterate over all entries which have }(hjNhhhNhNubj3)}(h ``XA_MARK_0``h]h XA_MARK_0}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjNubh or }(hjNhhhNhNubj3)}(h ``XA_MARK_2``h]h XA_MARK_2}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjNubh; set). It would be possible to add these if a user arises.}(hjNhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] search-marksah ]h"] search marksah$]h&]uh1hhjhhhhhKvubh)}(hhh](h)}(hAllocating XArraysh]hAllocating XArrays}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hIf you use DEFINE_XARRAY_ALLOC() to define the XArray, or initialise it by passing ``XA_FLAGS_ALLOC`` to xa_init_flags(), the XArray changes to track whether entries are in use or not.h](hSIf you use DEFINE_XARRAY_ALLOC() to define the XArray, or initialise it by passing }(hjhhhNhNubj3)}(h``XA_FLAGS_ALLOC``h]hXA_FLAGS_ALLOC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubhS to xa_init_flags(), the XArray changes to track whether entries are in use or not.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hYou can call xa_alloc() to store the entry at an unused index in the XArray. If you need to modify the array from interrupt context, you can use xa_alloc_bh() or xa_alloc_irq() to disable interrupts while allocating the ID.h]hYou can call xa_alloc() to store the entry at an unused index in the XArray. If you need to modify the array from interrupt context, you can use xa_alloc_bh() or xa_alloc_irq() to disable interrupts while allocating the ID.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hX$Using xa_store(), xa_cmpxchg() or xa_insert() will also mark the entry as being allocated. Unlike a normal XArray, storing ``NULL`` will mark the entry as being in use, like xa_reserve(). To free an entry, use xa_erase() (or xa_release() if you only want to free the entry if it's ``NULL``).h](h|Using xa_store(), xa_cmpxchg() or xa_insert() will also mark the entry as being allocated. Unlike a normal XArray, storing }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh will mark the entry as being in use, like xa_reserve(). To free an entry, use xa_erase() (or xa_release() if you only want to free the entry if it’s }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh).}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hX4By default, the lowest free entry is allocated starting from 0. If you want to allocate entries starting at 1, it is more efficient to use DEFINE_XARRAY_ALLOC1() or ``XA_FLAGS_ALLOC1``. If you want to allocate IDs up to a maximum, then wrap back around to the lowest free ID, you can use xa_alloc_cyclic().h](hBy default, the lowest free entry is allocated starting from 0. If you want to allocate entries starting at 1, it is more efficient to use DEFINE_XARRAY_ALLOC1() or }(hjhhhNhNubj3)}(h``XA_FLAGS_ALLOC1``h]hXA_FLAGS_ALLOC1}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh{. If you want to allocate IDs up to a maximum, then wrap back around to the lowest free ID, you can use xa_alloc_cyclic().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hYou cannot use ``XA_MARK_0`` with an allocating XArray as this mark is used to track whether an entry is free or not. The other marks are available for your use.h](hYou cannot use }(hj=hhhNhNubj3)}(h ``XA_MARK_0``h]h XA_MARK_0}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj=ubh with an allocating XArray as this mark is used to track whether an entry is free or not. The other marks are available for your use.}(hj=hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h]allocating-xarraysah ]h"]allocating xarraysah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hMemory allocationh]hMemory allocation}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehhhhhKubh)}(hX The xa_store(), xa_cmpxchg(), xa_alloc(), xa_reserve() and xa_insert() functions take a gfp_t parameter in case the XArray needs to allocate memory to store this entry. If the entry is being deleted, no memory allocation needs to be performed, and the GFP flags specified will be ignored.h]hX The xa_store(), xa_cmpxchg(), xa_alloc(), xa_reserve() and xa_insert() functions take a gfp_t parameter in case the XArray needs to allocate memory to store this entry. If the entry is being deleted, no memory allocation needs to be performed, and the GFP flags specified will be ignored.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjehhubh)}(hX4It is possible for no memory to be allocatable, particularly if you pass a restrictive set of GFP flags. In that case, the functions return a special value which can be turned into an errno using xa_err(). If you don't need to know exactly which error occurred, using xa_is_err() is slightly more efficient.h]hX6It is possible for no memory to be allocatable, particularly if you pass a restrictive set of GFP flags. In that case, the functions return a special value which can be turned into an errno using xa_err(). If you don’t need to know exactly which error occurred, using xa_is_err() is slightly more efficient.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjehhubeh}(h]memory-allocationah ]h"]memory allocationah$]h&]uh1hhjhhhhhKubh)}(hhh](h)}(hLockingh]hLocking}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hWhen using the Normal API, you do not have to worry about locking. The XArray uses RCU and an internal spinlock to synchronise access:h]hWhen using the Normal API, you do not have to worry about locking. The XArray uses RCU and an internal spinlock to synchronise access:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubhdefinition_list)}(hhh](hdefinition_list_item)}(h+No lock needed: * xa_empty() * xa_marked() h](hterm)}(hNo lock needed:h]hNo lock needed:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhjubh definition)}(hhh]h bullet_list)}(hhh](h list_item)}(h xa_empty()h]h)}(hjh]h xa_empty()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_marked() h]h)}(h xa_marked()h]h xa_marked()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]bullet*uh1jhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(hTakes RCU read lock: * xa_load() * xa_for_each() * xa_for_each_start() * xa_for_each_range() * xa_find() * xa_find_after() * xa_extract() * xa_get_mark() h](j)}(hTakes RCU read lock:h]hTakes RCU read lock:}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhj#ubj)}(hhh]j)}(hhh](j)}(h xa_load()h]h)}(hj=h]h xa_load()}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj;ubah}(h]h ]h"]h$]h&]uh1jhj8ubj)}(h xa_for_each()h]h)}(hjTh]h xa_for_each()}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjRubah}(h]h ]h"]h$]h&]uh1jhj8ubj)}(hxa_for_each_start()h]h)}(hjkh]hxa_for_each_start()}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjiubah}(h]h ]h"]h$]h&]uh1jhj8ubj)}(hxa_for_each_range()h]h)}(hjh]hxa_for_each_range()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj8ubj)}(h xa_find()h]h)}(hjh]h xa_find()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj8ubj)}(hxa_find_after()h]h)}(hjh]hxa_find_after()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj8ubj)}(h xa_extract()h]h)}(hjh]h xa_extract()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj8ubj)}(hxa_get_mark() h]h)}(h xa_get_mark()h]h xa_get_mark()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]jjuh1jhhhKhj5ubah}(h]h ]h"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubj)}(hXTakes xa_lock internally: * xa_store() * xa_store_bh() * xa_store_irq() * xa_insert() * xa_insert_bh() * xa_insert_irq() * xa_erase() * xa_erase_bh() * xa_erase_irq() * xa_cmpxchg() * xa_cmpxchg_bh() * xa_cmpxchg_irq() * xa_store_range() * xa_alloc() * xa_alloc_bh() * xa_alloc_irq() * xa_reserve() * xa_reserve_bh() * xa_reserve_irq() * xa_destroy() * xa_set_mark() * xa_clear_mark() h](j)}(hTakes xa_lock internally:h]hTakes xa_lock internally:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhjubj)}(hhh]j)}(hhh](j)}(h xa_store()h]h)}(hj h]h xa_store()}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_store_bh()h]h)}(hj7h]h xa_store_bh()}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj5ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_store_irq()h]h)}(hjNh]hxa_store_irq()}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjLubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_insert()h]h)}(hjeh]h xa_insert()}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjcubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_insert_bh()h]h)}(hj|h]hxa_insert_bh()}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjzubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_insert_irq()h]h)}(hjh]hxa_insert_irq()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_erase()h]h)}(hjh]h xa_erase()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_erase_bh()h]h)}(hjh]h xa_erase_bh()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_erase_irq()h]h)}(hjh]hxa_erase_irq()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_cmpxchg()h]h)}(hjh]h xa_cmpxchg()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_cmpxchg_bh()h]h)}(hjh]hxa_cmpxchg_bh()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_cmpxchg_irq()h]h)}(hjh]hxa_cmpxchg_irq()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_store_range()h]h)}(hj4h]hxa_store_range()}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj2ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_alloc()h]h)}(hjKh]h xa_alloc()}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjIubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_alloc_bh()h]h)}(hjbh]h xa_alloc_bh()}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj`ubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_alloc_irq()h]h)}(hjyh]hxa_alloc_irq()}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjwubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_reserve()h]h)}(hjh]h xa_reserve()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_reserve_bh()h]h)}(hjh]hxa_reserve_bh()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_reserve_irq()h]h)}(hjh]hxa_reserve_irq()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_destroy()h]h)}(hjh]h xa_destroy()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(h xa_set_mark()h]h)}(hjh]h xa_set_mark()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubj)}(hxa_clear_mark() h]h)}(hxa_clear_mark()h]hxa_clear_mark()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]jjuh1jhhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubj)}(hAssumes xa_lock held on entry: * __xa_store() * __xa_insert() * __xa_erase() * __xa_cmpxchg() * __xa_alloc() * __xa_set_mark() * __xa_clear_mark() h](j)}(hAssumes xa_lock held on entry:h]hAssumes xa_lock held on entry:}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKhj+ubj)}(hhh]j)}(hhh](j)}(h __xa_store()h]h)}(hjEh]h __xa_store()}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjCubah}(h]h ]h"]h$]h&]uh1jhj@ubj)}(h __xa_insert()h]h)}(hj\h]h __xa_insert()}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjZubah}(h]h ]h"]h$]h&]uh1jhj@ubj)}(h __xa_erase()h]h)}(hjsh]h __xa_erase()}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjqubah}(h]h ]h"]h$]h&]uh1jhj@ubj)}(h__xa_cmpxchg()h]h)}(hjh]h__xa_cmpxchg()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj@ubj)}(h __xa_alloc()h]h)}(hjh]h __xa_alloc()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj@ubj)}(h__xa_set_mark()h]h)}(hjh]h__xa_set_mark()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj@ubj)}(h__xa_clear_mark() h]h)}(h__xa_clear_mark()h]h__xa_clear_mark()}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhj@ubeh}(h]h ]h"]h$]h&]jjuh1jhhhKhj=ubah}(h]h ]h"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]uh1jhhhKhjhhubeh}(h]h ]h"]h$]h&]uh1jhjhhhNhNubh)}(hXIf you want to take advantage of the lock to protect the data structures that you are storing in the XArray, you can call xa_lock() before calling xa_load(), then take a reference count on the object you have found before calling xa_unlock(). This will prevent stores from removing the object from the array between looking up the object and incrementing the refcount. You can also use RCU to avoid dereferencing freed memory, but an explanation of that is beyond the scope of this document.h]hXIf you want to take advantage of the lock to protect the data structures that you are storing in the XArray, you can call xa_lock() before calling xa_load(), then take a reference count on the object you have found before calling xa_unlock(). This will prevent stores from removing the object from the array between looking up the object and incrementing the refcount. You can also use RCU to avoid dereferencing freed memory, but an explanation of that is beyond the scope of this document.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hThe XArray does not disable interrupts or softirqs while modifying the array. It is safe to read the XArray from interrupt or softirq context as the RCU lock provides enough protection.h]hThe XArray does not disable interrupts or softirqs while modifying the array. It is safe to read the XArray from interrupt or softirq context as the RCU lock provides enough protection.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hIf, for example, you want to store entries in the XArray in process context and then erase them in softirq context, you can do that this way::h]hIf, for example, you want to store entries in the XArray in process context and then erase them in softirq context, you can do that this way:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh literal_block)}(hX9void foo_init(struct foo *foo) { xa_init_flags(&foo->array, XA_FLAGS_LOCK_BH); } int foo_store(struct foo *foo, unsigned long index, void *entry) { int err; xa_lock_bh(&foo->array); err = xa_err(__xa_store(&foo->array, index, entry, GFP_KERNEL)); if (!err) foo->count++; xa_unlock_bh(&foo->array); return err; } /* foo_erase() is only called from softirq context */ void foo_erase(struct foo *foo, unsigned long index) { xa_lock(&foo->array); __xa_erase(&foo->array, index); foo->count--; xa_unlock(&foo->array); }h]hX9void foo_init(struct foo *foo) { xa_init_flags(&foo->array, XA_FLAGS_LOCK_BH); } int foo_store(struct foo *foo, unsigned long index, void *entry) { int err; xa_lock_bh(&foo->array); err = xa_err(__xa_store(&foo->array, index, entry, GFP_KERNEL)); if (!err) foo->count++; xa_unlock_bh(&foo->array); return err; } /* foo_erase() is only called from softirq context */ void foo_erase(struct foo *foo, unsigned long index) { xa_lock(&foo->array); __xa_erase(&foo->array, index); foo->count--; xa_unlock(&foo->array); }}hj) sbah}(h]h ]h"]h$]h&]hhuh1j' hhhKhjhhubh)}(hIf you are going to modify the XArray from interrupt or softirq context, you need to initialise the array using xa_init_flags(), passing ``XA_FLAGS_LOCK_IRQ`` or ``XA_FLAGS_LOCK_BH``.h](hIf you are going to modify the XArray from interrupt or softirq context, you need to initialise the array using xa_init_flags(), passing }(hj7 hhhNhNubj3)}(h``XA_FLAGS_LOCK_IRQ``h]hXA_FLAGS_LOCK_IRQ}(hj? hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj7 ubh or }(hj7 hhhNhNubj3)}(h``XA_FLAGS_LOCK_BH``h]hXA_FLAGS_LOCK_BH}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj7 ubh.}(hj7 hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh)}(hThe above example also shows a common pattern of wanting to extend the coverage of the xa_lock on the store side to protect some statistics associated with the array.h]hThe above example also shows a common pattern of wanting to extend the coverage of the xa_lock on the store side to protect some statistics associated with the array.}(hji hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubh)}(hX}Sharing the XArray with interrupt context is also possible, either using xa_lock_irqsave() in both the interrupt handler and process context, or xa_lock_irq() in process context and xa_lock() in the interrupt handler. Some of the more common patterns have helper functions such as xa_store_bh(), xa_store_irq(), xa_erase_bh(), xa_erase_irq(), xa_cmpxchg_bh() and xa_cmpxchg_irq().h]hX}Sharing the XArray with interrupt context is also possible, either using xa_lock_irqsave() in both the interrupt handler and process context, or xa_lock_irq() in process context and xa_lock() in the interrupt handler. Some of the more common patterns have helper functions such as xa_store_bh(), xa_store_irq(), xa_erase_bh(), xa_erase_irq(), xa_cmpxchg_bh() and xa_cmpxchg_irq().}(hjw hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM hjhhubh)}(hX<Sometimes you need to protect access to the XArray with a mutex because that lock sits above another mutex in the locking hierarchy. That does not entitle you to use functions like __xa_erase() without taking the xa_lock; the xa_lock is used for lockdep validation and will be used for other purposes in the future.h]hX<Sometimes you need to protect access to the XArray with a mutex because that lock sits above another mutex in the locking hierarchy. That does not entitle you to use functions like __xa_erase() without taking the xa_lock; the xa_lock is used for lockdep validation and will be used for other purposes in the future.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM(hjhhubh)}(hX The __xa_set_mark() and __xa_clear_mark() functions are also available for situations where you look up an entry and want to atomically set or clear a mark. It may be more efficient to use the advanced API in this case, as it will save you from walking the tree twice.h]hX The __xa_set_mark() and __xa_clear_mark() functions are also available for situations where you look up an entry and want to atomically set or clear a mark. It may be more efficient to use the advanced API in this case, as it will save you from walking the tree twice.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM.hjhhubeh}(h]lockingah ]h"]lockingah$]h&]uh1hhjhhhhhKubeh}(h] normal-apiah ]h"] normal apiah$]h&]uh1hhhhhhhhK hhhNhNubah}(h]h ]h"]h$]h&]uh1j< hj ubh more memory was allocated). If it has previously allocated memory, and that memory wasn’t used, and there is no error (or some error that isn’t }(hj hhhNhNubj3)}(h ``ENOMEM``h]hENOMEM}(hjP hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubh5), then it will free the memory previously allocated.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMShj hhubh)}(hhh](h)}(hInternal Entriesh]hInternal Entries}(hjk hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjh hhhhhM`ubh)}(hXThe XArray reserves some entries for its own purposes. These are never exposed through the normal API, but when using the advanced API, it's possible to see them. Usually the best way to handle them is to pass them to xas_retry(), and retry the operation if it returns ``true``.h](hXThe XArray reserves some entries for its own purposes. These are never exposed through the normal API, but when using the advanced API, it’s possible to see them. Usually the best way to handle them is to pass them to xas_retry(), and retry the operation if it returns }(hjy hhhNhNubj3)}(h``true``h]htrue}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjy ubh.}(hjy hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMbhjh hhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hj ubj )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hj ubj )}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1j hj ubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(hNameh]hName}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMjhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hTesth]hTest}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMkhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hUsageh]hUsage}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMlhj ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(hNodeh]hNode}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMnhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(h xa_is_node()h]h xa_is_node()}(hj7 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMohj4 ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hBAn XArray node. May be visible when using a multi-index xa_state.h]hBAn XArray node. May be visible when using a multi-index xa_state.}(hjN hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMphjK ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(hSiblingh]hSibling}(hjn hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMrhjk ubah}(h]h ]h"]h$]h&]uh1j hjh ubj )}(hhh]h)}(hxa_is_sibling()h]hxa_is_sibling()}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMshj ubah}(h]h ]h"]h$]h&]uh1j hjh ubj )}(hhh]h)}(htA non-canonical entry for a multi-index entry. The value indicates which slot in this node has the canonical entry.h]htA non-canonical entry for a multi-index entry. The value indicates which slot in this node has the canonical entry.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMthj ubah}(h]h ]h"]h$]h&]uh1j hjh ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(hRetryh]hRetry}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMwhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(h xa_is_retry()h]h xa_is_retry()}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMxhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hThis entry is currently being modified by a thread which has the xa_lock. The node containing this entry may be freed at the end of this RCU period. You should restart the lookup from the head of the array.h]hThis entry is currently being modified by a thread which has the xa_lock. The node containing this entry may be freed at the end of this RCU period. You should restart the lookup from the head of the array.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMyhj ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh](j )}(hhh]h)}(hZeroh]hZero}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM~hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(h xa_is_zero()h]h xa_is_zero()}(hj! hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj ubah}(h]h ]h"]h$]h&]uh1j hj ubj )}(hhh]h)}(hZero entries appear as ``NULL`` through the Normal API, but occupy an entry in the XArray which can be used to reserve the index for future use. This is used by allocating XArrays for allocated entries which are ``NULL``.h](hZero entries appear as }(hj8 hhhNhNubj3)}(h``NULL``h]hNULL}(hj@ hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj8 ubh through the Normal API, but occupy an entry in the XArray which can be used to reserve the index for future use. This is used by allocating XArrays for allocated entries which are }(hj8 hhhNhNubj3)}(h``NULL``h]hNULL}(hjR hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj8 ubh.}(hj8 hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj5 ubah}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubeh}(h]h ]h"]h$]h&]colsKuh1j hj ubah}(h]h ]h"]h$]h&]uh1j hjh hhhNhNubh)}(hlOther internal entries may be added in the future. As far as possible, they will be handled by xas_retry().h]hlOther internal entries may be added in the future. As far as possible, they will be handled by xas_retry().}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjh hhubeh}(h]internal-entriesah ]h"]internal entriesah$]h&]uh1hhj hhhhhM`ubh)}(hhh](h)}(hAdditional functionalityh]hAdditional functionality}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhMubh)}(hThe xas_create_range() function allocates all the necessary memory to store every entry in a range. It will set ENOMEM in the xa_state if it cannot allocate memory.h]hThe xas_create_range() function allocates all the necessary memory to store every entry in a range. It will set ENOMEM in the xa_state if it cannot allocate memory.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hXYou can use xas_init_marks() to reset the marks on an entry to their default state. This is usually all marks clear, unless the XArray is marked with ``XA_FLAGS_TRACK_FREE``, in which case mark 0 is set and all other marks are clear. Replacing one entry with another using xas_store() will not reset the marks on that entry; if you want the marks reset, you should do that explicitly.h](hYou can use xas_init_marks() to reset the marks on an entry to their default state. This is usually all marks clear, unless the XArray is marked with }(hj hhhNhNubj3)}(h``XA_FLAGS_TRACK_FREE``h]hXA_FLAGS_TRACK_FREE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubh, in which case mark 0 is set and all other marks are clear. Replacing one entry with another using xas_store() will not reset the marks on that entry; if you want the marks reset, you should do that explicitly.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hThe xas_load() will walk the xa_state as close to the entry as it can. If you know the xa_state has already been walked to the entry and need to check that the entry hasn't changed, you can use xas_reload() to save a function call.h]hThe xas_load() will walk the xa_state as close to the entry as it can. If you know the xa_state has already been walked to the entry and need to check that the entry hasn’t changed, you can use xas_reload() to save a function call.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hXIf you need to move to a different index in the XArray, call xas_set(). This resets the cursor to the top of the tree, which will generally make the next operation walk the cursor to the desired spot in the tree. If you want to move to the next or previous index, call xas_next() or xas_prev(). Setting the index does not walk the cursor around the array so does not require a lock to be held, while moving to the next or previous index does.h]hXIf you need to move to a different index in the XArray, call xas_set(). This resets the cursor to the top of the tree, which will generally make the next operation walk the cursor to the desired spot in the tree. If you want to move to the next or previous index, call xas_next() or xas_prev(). Setting the index does not walk the cursor around the array so does not require a lock to be held, while moving to the next or previous index does.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hXYou can search for the next present entry using xas_find(). This is the equivalent of both xa_find() and xa_find_after(); if the cursor has been walked to an entry, then it will find the next entry after the one currently referenced. If not, it will return the entry at the index of the xa_state. Using xas_next_entry() to move to the next present entry instead of xas_find() will save a function call in the majority of cases at the expense of emitting more inline code.h]hXYou can search for the next present entry using xas_find(). This is the equivalent of both xa_find() and xa_find_after(); if the cursor has been walked to an entry, then it will find the next entry after the one currently referenced. If not, it will return the entry at the index of the xa_state. Using xas_next_entry() to move to the next present entry instead of xas_find() will save a function call in the majority of cases at the expense of emitting more inline code.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hX=The xas_find_marked() function is similar. If the xa_state has not been walked, it will return the entry at the index of the xa_state, if it is marked. Otherwise, it will return the first marked entry after the entry referenced by the xa_state. The xas_next_marked() function is the equivalent of xas_next_entry().h]hX=The xas_find_marked() function is similar. If the xa_state has not been walked, it will return the entry at the index of the xa_state, if it is marked. Otherwise, it will return the first marked entry after the entry referenced by the xa_state. The xas_next_marked() function is the equivalent of xas_next_entry().}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hXWhen iterating over a range of the XArray using xas_for_each() or xas_for_each_marked(), it may be necessary to temporarily stop the iteration. The xas_pause() function exists for this purpose. After you have done the necessary work and wish to resume, the xa_state is in an appropriate state to continue the iteration after the entry you last processed. If you have interrupts disabled while iterating, then it is good manners to pause the iteration and reenable interrupts every ``XA_CHECK_SCHED`` entries.h](hXWhen iterating over a range of the XArray using xas_for_each() or xas_for_each_marked(), it may be necessary to temporarily stop the iteration. The xas_pause() function exists for this purpose. After you have done the necessary work and wish to resume, the xa_state is in an appropriate state to continue the iteration after the entry you last processed. If you have interrupts disabled while iterating, then it is good manners to pause the iteration and reenable interrupts every }(hj hhhNhNubj3)}(h``XA_CHECK_SCHED``h]hXA_CHECK_SCHED}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubh entries.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hThe xas_get_mark(), xas_set_mark() and xas_clear_mark() functions require the xa_state cursor to have been moved to the appropriate location in the XArray; they will do nothing if you have called xas_pause() or xas_set() immediately before.h]hThe xas_get_mark(), xas_set_mark() and xas_clear_mark() functions require the xa_state cursor to have been moved to the appropriate location in the XArray; they will do nothing if you have called xas_pause() or xas_set() immediately before.}(hj6 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubh)}(hYou can call xas_set_update() to have a callback function called each time the XArray updates a node. This is used by the page cache workingset code to maintain its list of nodes which contain only shadow entries.h]hYou can call xas_set_update() to have a callback function called each time the XArray updates a node. This is used by the page cache workingset code to maintain its list of nodes which contain only shadow entries.}(hjD hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubeh}(h]additional-functionalityah ]h"]additional functionalityah$]h&]uh1hhj hhhhhMubh)}(hhh](h)}(hMulti-Index Entriesh]hMulti-Index Entries}(hj] hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjZ hhhhhMubh)}(hXAThe XArray has the ability to tie multiple indices together so that operations on one index affect all indices. For example, storing into any index will change the value of the entry retrieved from any index. Setting or clearing a mark on any index will set or clear the mark on every index that is tied together. The current implementation only allows tying ranges which are aligned powers of two together; eg indices 64-127 may be tied together, but 2-6 may not be. This may save substantial quantities of memory; for example tying 512 entries together will save over 4kB.h]hXAThe XArray has the ability to tie multiple indices together so that operations on one index affect all indices. For example, storing into any index will change the value of the entry retrieved from any index. Setting or clearing a mark on any index will set or clear the mark on every index that is tied together. The current implementation only allows tying ranges which are aligned powers of two together; eg indices 64-127 may be tied together, but 2-6 may not be. This may save substantial quantities of memory; for example tying 512 entries together will save over 4kB.}(hjk hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjZ hhubh)}(hXLYou can create a multi-index entry by using XA_STATE_ORDER() or xas_set_order() followed by a call to xas_store(). Calling xas_load() with a multi-index xa_state will walk the xa_state to the right location in the tree, but the return value is not meaningful, potentially being an internal entry or ``NULL`` even when there is an entry stored within the range. Calling xas_find_conflict() will return the first entry within the range or ``NULL`` if there are no entries in the range. The xas_for_each_conflict() iterator will iterate over every entry which overlaps the specified range.h](hX+You can create a multi-index entry by using XA_STATE_ORDER() or xas_set_order() followed by a call to xas_store(). Calling xas_load() with a multi-index xa_state will walk the xa_state to the right location in the tree, but the return value is not meaningful, potentially being an internal entry or }(hjy hhhNhNubj3)}(h``NULL``h]hNULL}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjy ubh even when there is an entry stored within the range. Calling xas_find_conflict() will return the first entry within the range or }(hjy hhhNhNubj3)}(h``NULL``h]hNULL}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjy ubh if there are no entries in the range. The xas_for_each_conflict() iterator will iterate over every entry which overlaps the specified range.}(hjy hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjZ hhubh)}(hXIf xas_load() encounters a multi-index entry, the xa_index in the xa_state will not be changed. When iterating over an XArray or calling xas_find(), if the initial index is in the middle of a multi-index entry, it will not be altered. Subsequent calls or iterations will move the index to the first index in the range. Each entry will only be returned once, no matter how many indices it occupies.h]hXIf xas_load() encounters a multi-index entry, the xa_index in the xa_state will not be changed. When iterating over an XArray or calling xas_find(), if the initial index is in the middle of a multi-index entry, it will not be altered. Subsequent calls or iterations will move the index to the first index in the range. Each entry will only be returned once, no matter how many indices it occupies.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjZ hhubh)}(hUsing xas_next() or xas_prev() with a multi-index xa_state is not supported. Using either of these functions on a multi-index entry will reveal sibling entries; these should be skipped over by the caller.h]hUsing xas_next() or xas_prev() with a multi-index xa_state is not supported. Using either of these functions on a multi-index entry will reveal sibling entries; these should be skipped over by the caller.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjZ hhubh)}(hXStoring ``NULL`` into any index of a multi-index entry will set the entry at every index to ``NULL`` and dissolve the tie. A multi-index entry can be split into entries occupying smaller ranges by calling xas_split_alloc() without the xa_lock held, followed by taking the lock and calling xas_split() or calling xas_try_split() with xa_lock. The difference between xas_split_alloc()+xas_split() and xas_try_alloc() is that xas_split_alloc() + xas_split() split the entry from the original order to the new order in one shot uniformly, whereas xas_try_split() iteratively splits the entry containing the index non-uniformly. For example, to split an order-9 entry, which takes 2^(9-6)=8 slots, assuming ``XA_CHUNK_SHIFT`` is 6, xas_split_alloc() + xas_split() need 8 xa_node. xas_try_split() splits the order-9 entry into 2 order-8 entries, then split one order-8 entry, based on the given index, to 2 order-7 entries, ..., and split one order-1 entry to 2 order-0 entries. When splitting the order-6 entry and a new xa_node is needed, xas_try_split() will try to allocate one if possible. As a result, xas_try_split() would only need 1 xa_node instead of 8.h](hStoring }(hj hhhNhNubj3)}(h``NULL``h]hNULL}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubhL into any index of a multi-index entry will set the entry at every index to }(hj hhhNhNubj3)}(h``NULL``h]hNULL}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubhX[ and dissolve the tie. A multi-index entry can be split into entries occupying smaller ranges by calling xas_split_alloc() without the xa_lock held, followed by taking the lock and calling xas_split() or calling xas_try_split() with xa_lock. The difference between xas_split_alloc()+xas_split() and xas_try_alloc() is that xas_split_alloc() + xas_split() split the entry from the original order to the new order in one shot uniformly, whereas xas_try_split() iteratively splits the entry containing the index non-uniformly. For example, to split an order-9 entry, which takes 2^(9-6)=8 slots, assuming }(hj hhhNhNubj3)}(h``XA_CHUNK_SHIFT``h]hXA_CHUNK_SHIFT}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubhX is 6, xas_split_alloc() + xas_split() need 8 xa_node. xas_try_split() splits the order-9 entry into 2 order-8 entries, then split one order-8 entry, based on the given index, to 2 order-7 entries, ..., and split one order-1 entry to 2 order-0 entries. When splitting the order-6 entry and a new xa_node is needed, xas_try_split() will try to allocate one if possible. As a result, xas_try_split() would only need 1 xa_node instead of 8.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhMhjZ hhubeh}(h]multi-index-entriesah ]h"]multi-index entriesah$]h&]uh1hhj hhhhhMubeh}(h] advanced-apiah ]h"] advanced apiah$]h&]uh1hhhhhhhhM4ubh)}(hhh](h)}(hFunctions and structuresh]hFunctions and structures}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhMubhindex)}(hhh]h}(h]h ]h"]h$]h&]entries](singlexa_mk_value (C function) c.xa_mk_valuehNtauh1j,hjhhhNhNubhdesc)}(hhh](hdesc_signature)}(h$void * xa_mk_value (unsigned long v)h]hdesc_signature_line)}(h"void *xa_mk_value(unsigned long v)h](hdesc_sig_keyword_type)}(hvoidh]hvoid}(hjPhhhNhNubah}(h]h ]ktah"]h$]h&]uh1jNhjJhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK:ubhdesc_sig_space)}(h h]h }(hjbhhhNhNubah}(h]h ]wah"]h$]h&]uh1j`hjJhhhj_hK:ubhdesc_sig_punctuation)}(hjh]h*}(hjshhhNhNubah}(h]h ]pah"]h$]h&]uh1jqhjJhhhj_hK:ubh desc_name)}(h xa_mk_valueh]h desc_sig_name)}(h xa_mk_valueh]h xa_mk_value}(hjhhhNhNubah}(h]h ]nah"]h$]h&]uh1jhjubah}(h]h ](sig-namedescnameeh"]h$]h&]hhuh1jhjJhhhj_hK:ubhdesc_parameterlist)}(h(unsigned long v)h]hdesc_parameter)}(hunsigned long vh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hvh]hv}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjJhhhj_hK:ubeh}(h]h ]h"]h$]h&]hh add_permalinkuh1jHsphinx_line_type declaratorhjDhhhj_hK:ubah}(h]j;ah ](sig sig-objecteh"]h$]h&] is_multiline _toc_parts) _toc_namehuh1jBhj_hK:hj?hhubh desc_content)}(hhh]h)}(h'Create an XArray entry from an integer.h]h'Create an XArray entry from an integer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK4hjhhubah}(h]h ]h"]h$]h&]uh1jhj?hhhj_hK:ubeh}(h]h ](cfunctioneh"]h$]h&]domainj0objtypej1desctypej1noindex noindexentrynocontentsentryuh1j=hhhjhNhNubh container)}(h**Parameters** ``unsigned long v`` Value to store in XArray. **Context** Any context. **Return** An entry suitable for storing in the XArray.h](h)}(h**Parameters**h]hstrong)}(hjCh]h Parameters}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjAubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK8hj=ubj)}(hhh]j)}(h.``unsigned long v`` Value to store in XArray. h](j)}(h``unsigned long v``h]j3)}(hjdh]hunsigned long v}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjbubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK5hj^ubj)}(hhh]h)}(hValue to store in XArray.h]hValue to store in XArray.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjyhK5hjzubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1jhjyhK5hj[ubah}(h]h ]h"]h$]h&]uh1jhj=ubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK7hj=ubh)}(h Any context.h]h Any context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK7hj=ubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK9hj=ubh)}(h,An entry suitable for storing in the XArray.h]h,An entry suitable for storing in the XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK8hj=ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_to_value (C function) c.xa_to_valuehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h-unsigned long xa_to_value (const void *entry)h]jI)}(h,unsigned long xa_to_value(const void *entry)h](jO)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKGubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhKGubjO)}(hlongh]hlong}(hj(hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhjhKGubja)}(h h]h }(hj6hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhKGubj)}(h xa_to_valueh]j)}(h xa_to_valueh]h xa_to_value}(hjHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKGubj)}(h(const void *entry)h]j)}(hconst void *entryh](hdesc_sig_keyword)}(hconsth]hconst}(hjfhhhNhNubah}(h]h ]kah"]h$]h&]uh1jdhj`ubja)}(h h]h }(hjuhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj`ubjO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj`ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj`ubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj`ubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj\ubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhKGubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhKGubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhKGhjhhubj)}(hhh]h)}(h$Get value stored in an XArray entry.h]h$Get value stored in an XArray entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKAhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKGubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``const void *entry`` XArray entry. **Context** Any context. **Return** The value stored in the XArray entry.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKEhjubj)}(hhh]j)}(h$``const void *entry`` XArray entry. h](j)}(h``const void *entry``h]j3)}(hjh]hconst void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKBhjubj)}(hhh]h)}(h XArray entry.h]h XArray entry.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,hKBhj-ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj,hKBhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Context**h]jF)}(hjRh]hContext}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjPubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKDhjubh)}(h Any context.h]h Any context.}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKDhjubh)}(h **Return**h]jF)}(hjyh]hReturn}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjwubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKFhjubh)}(h%The value stored in the XArray entry.h]h%The value stored in the XArray entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKEhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_is_value (C function) c.xa_is_valuehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h$bool xa_is_value (const void *entry)h]jI)}(h#bool xa_is_value(const void *entry)h](jO)}(hboolh]hbool}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKSubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhKSubj)}(h xa_is_valueh]j)}(h xa_is_valueh]h xa_is_value}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKSubj)}(h(const void *entry)h]j)}(hconst void *entryh](je)}(hjhh]hconst}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj$hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj2hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhKSubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhKSubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhKShjhhubj)}(hhh]h)}(h!Determine if an entry is a value.h]h!Determine if an entry is a value.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKMhjfhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKSubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``const void *entry`` XArray entry. **Context** Any context. **Return** True if the entry is a value, false if it is a pointer.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKQhjubj)}(hhh]j)}(h$``const void *entry`` XArray entry. h](j)}(h``const void *entry``h]j3)}(hjh]hconst void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKNhjubj)}(hhh]h)}(h XArray entry.h]h XArray entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKNhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKNhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKPhjubh)}(h Any context.h]h Any context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKPhjubh)}(h **Return**h]jF)}(hj h]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKRhjubh)}(h7True if the entry is a value, false if it is a pointer.h]h7True if the entry is a value, false if it is a pointer.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKQhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_tag_pointer (C function)c.xa_tag_pointerhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h2void * xa_tag_pointer (void *p, unsigned long tag)h]jI)}(h0void *xa_tag_pointer(void *p, unsigned long tag)h](jO)}(hvoidh]hvoid}(hjQhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjMhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKeubja)}(h h]h }(hj`hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjMhhhj_hKeubjr)}(hjh]h*}(hjnhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjMhhhj_hKeubj)}(hxa_tag_pointerh]j)}(hxa_tag_pointerh]hxa_tag_pointer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjMhhhj_hKeubj)}(h(void *p, unsigned long tag)h](j)}(hvoid *ph](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hj}h]hp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long tagh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(htagh]htag}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjMhhhj_hKeubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjIhhhj_hKeubah}(h]jDah ](j j eh"]h$]h&]jj)jhuh1jBhj_hKehjFhhubj)}(hhh]h)}(h,Create an XArray entry for a tagged pointer.h]h,Create an XArray entry for a tagged pointer.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKYhj;hhubah}(h]h ]h"]h$]h&]uh1jhjFhhhj_hKeubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jVj7jVj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``void *p`` Plain pointer. ``unsigned long tag`` Tag value (0, 1 or 3). **Description** If the user of the XArray prefers, they can tag their pointers instead of storing value entries. Three tags are available (0, 1 and 3). These are distinct from the xa_mark_t as they are not replicated up through the array and cannot be searched for. **Context** Any context. **Return** An XArray entry.h](h)}(h**Parameters**h]jF)}(hj`h]h Parameters}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj^ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK]hjZubj)}(hhh](j)}(h``void *p`` Plain pointer. h](j)}(h ``void *p``h]j3)}(hjh]hvoid *p}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj}ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKZhjyubj)}(hhh]h)}(hPlain pointer.h]hPlain pointer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKZhjubah}(h]h ]h"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]uh1jhjhKZhjvubj)}(h-``unsigned long tag`` Tag value (0, 1 or 3). h](j)}(h``unsigned long tag``h]j3)}(hjh]hunsigned long tag}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK[hjubj)}(hhh]h)}(hTag value (0, 1 or 3).h]hTag value (0, 1 or 3).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhK[hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhK[hjvubeh}(h]h ]h"]h$]h&]uh1jhjZubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK]hjZubh)}(hIf the user of the XArray prefers, they can tag their pointers instead of storing value entries. Three tags are available (0, 1 and 3). These are distinct from the xa_mark_t as they are not replicated up through the array and cannot be searched for.h]hIf the user of the XArray prefers, they can tag their pointers instead of storing value entries. Three tags are available (0, 1 and 3). These are distinct from the xa_mark_t as they are not replicated up through the array and cannot be searched for.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK]hjZubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKbhjZubh)}(h Any context.h]h Any context.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKbhjZubh)}(h **Return**h]jF)}(hjAh]hReturn}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj?ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKdhjZubh)}(hAn XArray entry.h]hAn XArray entry.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKchjZubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_untag_pointer (C function)c.xa_untag_pointerhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h%void * xa_untag_pointer (void *entry)h]jI)}(h#void *xa_untag_pointer(void *entry)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKtubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhKtubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhjhKtubj)}(hxa_untag_pointerh]j)}(hxa_untag_pointerh]hxa_untag_pointer}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKtubj)}(h (void *entry)h]j)}(h void *entryh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhKtubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj~hhhjhKtubah}(h]jyah ](j j eh"]h$]h&]jj)jhuh1jBhjhKthj{hhubj)}(hhh]h)}(h*Turn an XArray entry into a plain pointer.h]h*Turn an XArray entry into a plain pointer.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKkhj hhubah}(h]h ]h"]h$]h&]uh1jhj{hhhjhKtubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j;j7j;j8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``void *entry`` XArray entry. **Description** If you have stored a tagged pointer in the XArray, call this function to get the untagged version of the pointer. **Context** Any context. **Return** A pointer.h](h)}(h**Parameters**h]jF)}(hjEh]h Parameters}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjCubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKohj?ubj)}(hhh]j)}(h``void *entry`` XArray entry. h](j)}(h``void *entry``h]j3)}(hjdh]h void *entry}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjbubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKlhj^ubj)}(hhh]h)}(h XArray entry.h]h XArray entry.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjyhKlhjzubah}(h]h ]h"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]uh1jhjyhKlhj[ubah}(h]h ]h"]h$]h&]uh1jhj?ubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKnhj?ubh)}(hqIf you have stored a tagged pointer in the XArray, call this function to get the untagged version of the pointer.h]hqIf you have stored a tagged pointer in the XArray, call this function to get the untagged version of the pointer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKnhj?ubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKqhj?ubh)}(h Any context.h]h Any context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKqhj?ubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKshj?ubh)}(h A pointer.h]h A pointer.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKrhj?ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_pointer_tag (C function)c.xa_pointer_taghNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h)unsigned int xa_pointer_tag (void *entry)h]jI)}(h(unsigned int xa_pointer_tag(void *entry)h](jO)}(hunsignedh]hunsigned}(hj2hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj.hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKubja)}(h h]h }(hjAhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj.hhhj@hKubjO)}(hinth]hint}(hjOhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj.hhhj@hKubja)}(h h]h }(hj]hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj.hhhj@hKubj)}(hxa_pointer_tagh]j)}(hxa_pointer_tagh]hxa_pointer_tag}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ](jjeh"]h$]h&]hhuh1jhj.hhhj@hKubj)}(h (void *entry)h]j)}(h void *entryh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhj.hhhj@hKubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj*hhhj@hKubah}(h]j%ah ](j j eh"]h$]h&]jj)jhuh1jBhj@hKhj'hhubj)}(hhh]h)}(h&Get the tag stored in an XArray entry.h]h&Get the tag stored in an XArray entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKzhjhhubah}(h]h ]h"]h$]h&]uh1jhj'hhhj@hKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``void *entry`` XArray entry. **Description** If you have stored a tagged pointer in the XArray, call this function to get the tag of that pointer. **Context** Any context. **Return** A tag.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK~hjubj)}(hhh]j)}(h``void *entry`` XArray entry. h](j)}(h``void *entry``h]j3)}(hjh]h void *entry}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK{hjubj)}(hhh]h)}(h XArray entry.h]h XArray entry.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hK{hj5ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj4hK{hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjZh]h Description}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjXubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK}hjubh)}(heIf you have stored a tagged pointer in the XArray, call this function to get the tag of that pointer.h]heIf you have stored a tagged pointer in the XArray, call this function to get the tag of that pointer.}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhK}hjubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(h Any context.h]h Any context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(hA tag.h]hA tag.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_is_zero (C function) c.xa_is_zerohNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h#bool xa_is_zero (const void *entry)h]jI)}(h"bool xa_is_zero(const void *entry)h](jO)}(hjh]hbool}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhKubj)}(h xa_is_zeroh]j)}(h xa_is_zeroh]h xa_is_zero}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKubj)}(h(const void *entry)h]j)}(hconst void *entryh](je)}(hjhh]hconst}(hj)hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj%ubja)}(h h]h }(hj6hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj%ubjO)}(hvoidh]hvoid}(hjDhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj%ubja)}(h h]h }(hjRhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj%ubjr)}(hjh]h*}(hj`hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj%ubj)}(hentryh]hentry}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj!ubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhKubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhKhjhhubj)}(hhh]h)}(hIs the entry a zero entry?h]hIs the entry a zero entry?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``const void *entry`` Entry retrieved from the XArray **Description** The normal API will return NULL as the contents of a slot containing a zero entry. You can only see zero entries by using the advanced API. **Return** ``true`` if the entry is a zero entry.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubj)}(hhh]j)}(h6``const void *entry`` Entry retrieved from the XArray h](j)}(h``const void *entry``h]j3)}(hjh]hconst void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubj)}(hhh]h)}(hEntry retrieved from the XArrayh]hEntry retrieved from the XArray}(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]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(hThe normal API will return NULL as the contents of a slot containing a zero entry. You can only see zero entries by using the advanced API.h]hThe normal API will return NULL as the contents of a slot containing a zero entry. You can only see zero entries by using the advanced API.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(h **Return**h]jF)}(hj:h]hReturn}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj8ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(h&``true`` if the entry is a zero entry.h](j3)}(h``true``h]htrue}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjPubh if the entry is a zero entry.}(hjPhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_is_err (C function) c.xa_is_errhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h"bool xa_is_err (const void *entry)h]jI)}(h!bool xa_is_err(const void *entry)h](jO)}(hjh]hbool}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhKubj)}(h xa_is_errh]j)}(h xa_is_errh]h xa_is_err}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKubj)}(h(const void *entry)h]j)}(hconst void *entryh](je)}(hjhh]hconst}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhKubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhKhjhhubj)}(hhh]h)}(h4Report whether an XArray operation returned an errorh]h4Report whether an XArray operation returned an error}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhj4hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jOj7jOj8j9j:uh1j=hhhjhNhNubj<)}(hXx**Parameters** ``const void *entry`` Result from calling an XArray function **Description** If an XArray operation cannot complete an operation, it will return a special value indicating an error. This function tells you whether an error occurred; xa_err() tells you which error occurred. **Context** Any context. **Return** ``true`` if the entry indicates an error.h](h)}(h**Parameters**h]jF)}(hjYh]h Parameters}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjWubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjSubj)}(hhh]j)}(h=``const void *entry`` Result from calling an XArray function h](j)}(h``const void *entry``h]j3)}(hjxh]hconst void *entry}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjvubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjrubj)}(hhh]h)}(h&Result from calling an XArray functionh]h&Result from calling an XArray function}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]uh1jhjhKhjoubah}(h]h ]h"]h$]h&]uh1jhjSubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjSubh)}(hIf an XArray operation cannot complete an operation, it will return a special value indicating an error. This function tells you whether an error occurred; xa_err() tells you which error occurred.h]hIf an XArray operation cannot complete an operation, it will return a special value indicating an error. This function tells you whether an error occurred; xa_err() tells you which error occurred.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjSubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjSubh)}(h Any context.h]h Any context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjSubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjSubh)}(h)``true`` if the entry indicates an error.h](j3)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh! if the entry indicates an error.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjSubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_err (C function)c.xa_errhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hint xa_err (void *entry)h]jI)}(hint xa_err(void *entry)h](jO)}(hinth]hint}(hjThhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjPhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKubja)}(h h]h }(hjchhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjPhhhjbhKubj)}(hxa_errh]j)}(hxa_errh]hxa_err}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubah}(h]h ](jjeh"]h$]h&]hhuh1jhjPhhhjbhKubj)}(h (void *entry)h]j)}(h void *entryh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjPhhhjbhKubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjLhhhjbhKubah}(h]jGah ](j j eh"]h$]h&]jj)jhuh1jBhjbhKhjIhhubj)}(hhh]h)}(h$Turn an XArray result into an errno.h]h$Turn an XArray result into an errno.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjhhubah}(h]h ]h"]h$]h&]uh1jhjIhhhjbhKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``void *entry`` Result from calling an XArray function. **Description** If an XArray operation cannot complete an operation, it will return a special pointer value which encodes an errno. This function extracts the errno from the pointer value, or returns 0 if the pointer does not represent an errno. **Context** Any context. **Return** A negative errno or 0.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubj)}(hhh]j)}(h8``void *entry`` Result from calling an XArray function. h](j)}(h``void *entry``h]j3)}(hj%h]h void *entry}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj#ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubj)}(hhh]h)}(h'Result from calling an XArray function.h]h'Result from calling an XArray function.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:hKhj;ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj:hKhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hj`h]h Description}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj^ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(hIf an XArray operation cannot complete an operation, it will return a special pointer value which encodes an errno. This function extracts the errno from the pointer value, or returns 0 if the pointer does not represent an errno.h]hIf an XArray operation cannot complete an operation, it will return a special pointer value which encodes an errno. This function extracts the errno from the pointer value, or returns 0 if the pointer does not represent an errno.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(h Any context.h]h Any context.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubh)}(hA negative errno or 0.h]hA negative errno or 0.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_limit (C struct) c.xa_limithNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hxa_limith]jI)}(hstruct xa_limith](je)}(hstructh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhKubj)}(hxa_limith]j)}(hjh]hxa_limit}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhKubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhKubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhKhjhhubj)}(hhh]h)}(hRepresents a range of IDs.h]hRepresents a range of IDs.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhj3hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhKubeh}(h]h ](j0structeh"]h$]h&]j5j0j6jNj7jNj8j9j:uh1j=hhhjhNhNubj<)}(h**Definition**:: struct xa_limit { u32 max; u32 min; }; **Members** ``max`` The maximum ID to allocate (inclusive). ``min`` The lowest ID to allocate (inclusive).h](h)}(h**Definition**::h](jF)}(h**Definition**h]h Definition}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjVubh:}(hjVhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjRubj( )}(h.struct xa_limit { u32 max; u32 min; };h]h.struct xa_limit { u32 max; u32 min; };}hjssbah}(h]h ]h"]h$]h&]hhuh1j' hW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjRubh)}(h **Members**h]jF)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjRubj)}(hhh](j)}(h0``max`` The maximum ID to allocate (inclusive). h](j)}(h``max``h]j3)}(hjh]hmax}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubj)}(hhh]h)}(h'The maximum ID to allocate (inclusive).h]h'The maximum ID to allocate (inclusive).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubj)}(h.``min`` The lowest ID to allocate (inclusive).h](j)}(h``min``h]j3)}(hjh]hmin}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubj)}(hhh]h)}(h&The lowest ID to allocate (inclusive).h]h&The lowest ID to allocate (inclusive).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhKhjubeh}(h]h ]h"]h$]h&]uh1jhjRubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubh)}(h**Description**h]jF)}(hjh]h Description}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjhhubh)}(hXThis structure is used either directly or via the XA_LIMIT() macro to communicate the range of IDs that are valid for allocation. Three common ranges are predefined for you: * xa_limit_32b - [0 - UINT_MAX] * xa_limit_31b - [0 - INT_MAX] * xa_limit_16b - [0 - USHRT_MAX]h]hXThis structure is used either directly or via the XA_LIMIT() macro to communicate the range of IDs that are valid for allocation. Three common ranges are predefined for you: * xa_limit_32b - [0 - UINT_MAX] * xa_limit_31b - [0 - INT_MAX] * xa_limit_16b - [0 - USHRT_MAX]}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKhjhhubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xarray (C struct)c.xarrayhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hxarrayh]jI)}(h struct xarrayh](je)}(hjh]hstruct}(hj]hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjYhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhKubja)}(h h]h }(hjkhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjYhhhjjhKubj)}(hxarrayh]j)}(hjWh]hxarray}(hj}hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ](jjeh"]h$]h&]hhuh1jhjYhhhjjhKubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjUhhhjjhKubah}(h]jPah ](j j eh"]h$]h&]jj)jhuh1jBhjjhKhjRhhubj)}(hhh]h)}(hThe anchor of the XArray.h]hThe anchor of the XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jhjRhhhjjhKubeh}(h]h ](j0structeh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h**Definition**:: struct xarray { spinlock_t xa_lock; }; **Members** ``xa_lock`` Lock that protects the contents of the XArray.h](h)}(h**Definition**::h](jF)}(h**Definition**h]h Definition}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh:}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM!hjubj( )}(h*struct xarray { spinlock_t xa_lock; };h]h*struct xarray { spinlock_t xa_lock; };}hjsbah}(h]h ]h"]h$]h&]hhuh1j' hW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM#hjubh)}(h **Members**h]jF)}(hjh]hMembers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM'hjubj)}(hhh]j)}(h:``xa_lock`` Lock that protects the contents of the XArray.h](j)}(h ``xa_lock``h]j3)}(hj h]hxa_lock}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj ubj)}(hhh]h)}(h.Lock that protects the contents of the XArray.h]h.Lock that protects the contents of the XArray.}(hj% hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj" ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj! hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubh)}(h**Description**h]jF)}(hjO h]h Description}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjM ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM"hjhhubh)}(hTo use the xarray, define it statically or embed it in your data structure. It is a very small data structure, so it does not usually make sense to allocate it separately and keep a pointer to it in your data structure.h]hTo use the xarray, define it statically or embed it in your data structure. It is a very small data structure, so it does not usually make sense to allocate it separately and keep a pointer to it in your data structure.}(hje hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM hjhhubh)}(hDYou may use the xa_lock to protect your own data structures as well.h]hDYou may use the xa_lock to protect your own data structures as well.}(hjt hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM$hjhhubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9DEFINE_XARRAY_FLAGS (C macro)c.DEFINE_XARRAY_FLAGShNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hDEFINE_XARRAY_FLAGSh]jI)}(hDEFINE_XARRAY_FLAGSh]j)}(hDEFINE_XARRAY_FLAGSh]j)}(hj h]hDEFINE_XARRAY_FLAGS}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMCubah}(h]h ]h"]h$]h&]hhjuh1jHjjhj hhhj hMCubah}(h]j ah ](j j eh"]h$]h&]jj)jhuh1jBhj hMChj hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj hhhj hMCubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6j j7j j8j9j:uh1j=hhhjhNhNubh)}(h%``DEFINE_XARRAY_FLAGS (name, flags)``h]j3)}(hj h]h!DEFINE_XARRAY_FLAGS (name, flags)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMEhjhhubh block_quote)}(h$Define an XArray with custom flags. h]h)}(h#Define an XArray with custom flags.h]h#Define an XArray with custom flags.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM:hj ubah}(h]h ]h"]h$]h&]uh1j hj hM:hjhhubj<)}(hXl**Parameters** ``name`` A string that names your XArray. ``flags`` XA_FLAG values. **Description** This is intended for file scope definitions of XArrays. It declares and initialises an empty XArray with the chosen name and flags. It is equivalent to calling xa_init_flags() on the array, but it does the initialisation at compiletime instead of runtime.h](h)}(h**Parameters**h]jF)}(hj !h]h Parameters}(hj !hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj!ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM>hj!ubj)}(hhh](j)}(h*``name`` A string that names your XArray. h](j)}(h``name``h]j3)}(hj(!h]hname}(hj*!hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj&!ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM;hj"!ubj)}(hhh]h)}(h A string that names your XArray.h]h A string that names your XArray.}(hjA!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``flags`` XA_FLAG values. h](j)}(h ``flags``h]j3)}(hja!h]hflags}(hjc!hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj_!ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM<hj[!ubj)}(hhh]h)}(hXA_FLAG values.h]hXA_FLAG values.}(hjz!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjv!hM<hjw!ubah}(h]h ]h"]h$]h&]uh1jhj[!ubeh}(h]h ]h"]h$]h&]uh1jhjv!hM<hj!ubeh}(h]h ]h"]h$]h&]uh1jhj!ubh)}(h**Description**h]jF)}(hj!h]h Description}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj!ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM>hj!ubh)}(hXThis is intended for file scope definitions of XArrays. It declares and initialises an empty XArray with the chosen name and flags. It is equivalent to calling xa_init_flags() on the array, but it does the initialisation at compiletime instead of runtime.h]hXThis is intended for file scope definitions of XArrays. It declares and initialises an empty XArray with the chosen name and flags. It is equivalent to calling xa_init_flags() on the array, but it does the initialisation at compiletime instead of runtime.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM>hj!ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9DEFINE_XARRAY (C macro)c.DEFINE_XARRAYhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h DEFINE_XARRAYh]jI)}(h DEFINE_XARRAYh]j)}(h DEFINE_XARRAYh]j)}(hj!h]h DEFINE_XARRAY}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj!hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMOubah}(h]h ]h"]h$]h&]hhjuh1jHjjhj!hhhj!hMOubah}(h]j!ah ](j j eh"]h$]h&]jj)jhuh1jBhj!hMOhj!hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj!hhhj!hMOubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6j"j7j"j8j9j:uh1j=hhhjhNhNubh)}(h``DEFINE_XARRAY (name)``h]j3)}(hj"h]hDEFINE_XARRAY (name)}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj"ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMQhjhhubj )}(hDefine an XArray. h]h)}(hDefine an XArray.h]hDefine an XArray.}(hj1"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMGhj-"ubah}(h]h ]h"]h$]h&]uh1j hj?"hMGhjhhubj<)}(hX?**Parameters** ``name`` A string that names your XArray. **Description** This is intended for file scope definitions of XArrays. It declares and initialises an empty XArray with the chosen name. It is equivalent to calling xa_init() on the array, but it does the initialisation at compiletime instead of runtime.h](h)}(h**Parameters**h]jF)}(hjL"h]h Parameters}(hjN"hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjJ"ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMKhjF"ubj)}(hhh]j)}(h*``name`` A string that names your XArray. h](j)}(h``name``h]j3)}(hjk"h]hname}(hjm"hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hji"ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMHhje"ubj)}(hhh]h)}(h A string that names your XArray.h]h A string that names your XArray.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj"hMHhj"ubah}(h]h ]h"]h$]h&]uh1jhje"ubeh}(h]h ]h"]h$]h&]uh1jhj"hMHhjb"ubah}(h]h ]h"]h$]h&]uh1jhjF"ubh)}(h**Description**h]jF)}(hj"h]h Description}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj"ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMJhjF"ubh)}(hThis is intended for file scope definitions of XArrays. It declares and initialises an empty XArray with the chosen name. It is equivalent to calling xa_init() on the array, but it does the initialisation at compiletime instead of runtime.h]hThis is intended for file scope definitions of XArrays. It declares and initialises an empty XArray with the chosen name. It is equivalent to calling xa_init() on the array, but it does the initialisation at compiletime instead of runtime.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMJhjF"ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9DEFINE_XARRAY_ALLOC (C macro)c.DEFINE_XARRAY_ALLOChNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hDEFINE_XARRAY_ALLOCh]jI)}(hDEFINE_XARRAY_ALLOCh]j)}(hDEFINE_XARRAY_ALLOCh]j)}(hj"h]hDEFINE_XARRAY_ALLOC}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj"hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMXubah}(h]h ]h"]h$]h&]hhjuh1jHjjhj"hhhj#hMXubah}(h]j"ah ](j j eh"]h$]h&]jj)jhuh1jBhj#hMXhj"hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj"hhhj#hMXubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6j#j7j#j8j9j:uh1j=hhhjhNhNubh)}(h``DEFINE_XARRAY_ALLOC (name)``h]j3)}(hj!#h]hDEFINE_XARRAY_ALLOC (name)}(hj##hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj#ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMZhjhhubj )}(h4Define an XArray which allocates IDs starting at 0. h]h)}(h3Define an XArray which allocates IDs starting at 0.h]h3Define an XArray which allocates IDs starting at 0.}(hj;#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMRhj7#ubah}(h]h ]h"]h$]h&]uh1j hjI#hMRhjhhubj<)}(h**Parameters** ``name`` A string that names your XArray. **Description** This is intended for file scope definitions of allocating XArrays. See also DEFINE_XARRAY().h](h)}(h**Parameters**h]jF)}(hjV#h]h Parameters}(hjX#hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjT#ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMVhjP#ubj)}(hhh]j)}(h*``name`` A string that names your XArray. h](j)}(h``name``h]j3)}(hju#h]hname}(hjw#hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjs#ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMShjo#ubj)}(hhh]h)}(h A string that names your XArray.h]h A string that names your XArray.}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj#hMShj#ubah}(h]h ]h"]h$]h&]uh1jhjo#ubeh}(h]h ]h"]h$]h&]uh1jhj#hMShjl#ubah}(h]h ]h"]h$]h&]uh1jhjP#ubh)}(h**Description**h]jF)}(hj#h]h Description}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj#ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMUhjP#ubh)}(h\This is intended for file scope definitions of allocating XArrays. See also DEFINE_XARRAY().h]h\This is intended for file scope definitions of allocating XArrays. See also DEFINE_XARRAY().}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMUhjP#ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9DEFINE_XARRAY_ALLOC1 (C macro)c.DEFINE_XARRAY_ALLOC1hNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hDEFINE_XARRAY_ALLOC1h]jI)}(hDEFINE_XARRAY_ALLOC1h]j)}(hDEFINE_XARRAY_ALLOC1h]j)}(hj#h]hDEFINE_XARRAY_ALLOC1}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj#hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMaubah}(h]h ]h"]h$]h&]hhjuh1jHjjhj#hhhj $hMaubah}(h]j#ah ](j j eh"]h$]h&]jj)jhuh1jBhj $hMahj#hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj#hhhj $hMaubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6j%$j7j%$j8j9j:uh1j=hhhjhNhNubh)}(h``DEFINE_XARRAY_ALLOC1 (name)``h]j3)}(hj+$h]hDEFINE_XARRAY_ALLOC1 (name)}(hj-$hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj)$ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMchjhhubj )}(h4Define an XArray which allocates IDs starting at 1. h]h)}(h3Define an XArray which allocates IDs starting at 1.h]h3Define an XArray which allocates IDs starting at 1.}(hjE$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM[hjA$ubah}(h]h ]h"]h$]h&]uh1j hjS$hM[hjhhubj<)}(h**Parameters** ``name`` A string that names your XArray. **Description** This is intended for file scope definitions of allocating XArrays. See also DEFINE_XARRAY().h](h)}(h**Parameters**h]jF)}(hj`$h]h Parameters}(hjb$hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj^$ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM_hjZ$ubj)}(hhh]j)}(h*``name`` A string that names your XArray. h](j)}(h``name``h]j3)}(hj$h]hname}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj}$ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM\hjy$ubj)}(hhh]h)}(h A string that names your XArray.h]h A string that names your XArray.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj$hM\hj$ubah}(h]h ]h"]h$]h&]uh1jhjy$ubeh}(h]h ]h"]h$]h&]uh1jhj$hM\hjv$ubah}(h]h ]h"]h$]h&]uh1jhjZ$ubh)}(h**Description**h]jF)}(hj$h]h Description}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj$ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM^hjZ$ubh)}(h\This is intended for file scope definitions of allocating XArrays. See also DEFINE_XARRAY().h]h\This is intended for file scope definitions of allocating XArrays. See also DEFINE_XARRAY().}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM^hjZ$ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_init_flags (C function)c.xa_init_flagshNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h3void xa_init_flags (struct xarray *xa, gfp_t flags)h]jI)}(h2void xa_init_flags(struct xarray *xa, gfp_t flags)h](jO)}(hvoidh]hvoid}(hj$hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj$hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM~ubja)}(h h]h }(hj%hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj$hhhj %hM~ubj)}(h xa_init_flagsh]j)}(h xa_init_flagsh]h xa_init_flags}(hj %hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj$hhhj %hM~ubj)}(h (struct xarray *xa, gfp_t flags)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj<%hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj8%ubja)}(h h]h }(hjI%hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj8%ubh)}(hhh]j)}(hxarrayh]hxarray}(hjZ%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW%ubah}(h]h ]h"]h$]h&] refdomainj0reftype identifier reftargetj\%modnameN classnameN c:parent_keysphinx.domains.c LookupKey)}data]ju% ASTIdentifier)}jp%j"%sbc.xa_init_flagsasbuh1hhj8%ubja)}(h h]h }(hj%hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj8%ubjr)}(hjh]h*}(hj%hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj8%ubj)}(hxah]hxa}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8%ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj4%ubj)}(h gfp_t flagsh](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj%modnameN classnameNjt%jw%)}jz%]j~%c.xa_init_flagsasbuh1hhj%ubja)}(h h]h }(hj%hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj%ubj)}(hflagsh]hflags}(hj%hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj4%ubeh}(h]h ]h"]h$]h&]hhuh1jhj$hhhj %hM~ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj$hhhj %hM~ubah}(h]j$ah ](j j eh"]h$]h&]jj)jhuh1jBhj %hM~hj$hhubj)}(hhh]h)}(h&Initialise an empty XArray with flags.h]h&Initialise an empty XArray with flags.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMthj &hhubah}(h]h ]h"]h$]h&]uh1jhj$hhhj %hM~ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j'&j7j'&j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``gfp_t flags`` XA_FLAG values. **Description** If you need to initialise an XArray with special flags (eg you need to take the lock from interrupt context), use this function instead of xa_init(). **Context** Any context.h](h)}(h**Parameters**h]jF)}(hj1&h]h Parameters}(hj3&hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj/&ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMxhj+&ubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjP&h]hstruct xarray *xa}(hjR&hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjN&ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMuhjJ&ubj)}(hhh]h)}(hXArray.h]hXArray.}(hji&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhje&hMuhjf&ubah}(h]h ]h"]h$]h&]uh1jhjJ&ubeh}(h]h ]h"]h$]h&]uh1jhje&hMuhjG&ubj)}(h ``gfp_t flags`` XA_FLAG values. h](j)}(h``gfp_t flags``h]j3)}(hj&h]h gfp_t flags}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj&ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMvhj&ubj)}(hhh]h)}(hXA_FLAG values.h]hXA_FLAG values.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&hMvhj&ubah}(h]h ]h"]h$]h&]uh1jhj&ubeh}(h]h ]h"]h$]h&]uh1jhj&hMvhjG&ubeh}(h]h ]h"]h$]h&]uh1jhj+&ubh)}(h**Description**h]jF)}(hj&h]h Description}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj&ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMxhj+&ubh)}(hIf you need to initialise an XArray with special flags (eg you need to take the lock from interrupt context), use this function instead of xa_init().h]hIf you need to initialise an XArray with special flags (eg you need to take the lock from interrupt context), use this function instead of xa_init().}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMxhj+&ubh)}(h **Context**h]jF)}(hj&h]hContext}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj&ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM|hj+&ubh)}(h Any context.h]h Any context.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM|hj+&ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_init (C function) c.xa_inithNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h void xa_init (struct xarray *xa)h]jI)}(hvoid xa_init(struct xarray *xa)h](jO)}(hvoidh]hvoid}(hj0'hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj,'hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hj?'hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj,'hhhj>'hMubj)}(hxa_inith]j)}(hxa_inith]hxa_init}(hjQ'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjM'ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj,'hhhj>'hMubj)}(h(struct xarray *xa)h]j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjm'hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhji'ubja)}(h h]h }(hjz'hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hji'ubh)}(hhh]j)}(hxarrayh]hxarray}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj'modnameN classnameNjt%jw%)}jz%]j}%)}jp%jS'sb c.xa_initasbuh1hhji'ubja)}(h h]h }(hj'hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hji'ubjr)}(hjh]h*}(hj'hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhji'ubj)}(hxah]hxa}(hj'hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhji'ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhje'ubah}(h]h ]h"]h$]h&]hhuh1jhj,'hhhj>'hMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj('hhhj>'hMubah}(h]j#'ah ](j j eh"]h$]h&]jj)jhuh1jBhj>'hMhj%'hhubj)}(hhh]h)}(hInitialise an empty XArray.h]hInitialise an empty XArray.}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj'hhubah}(h]h ]h"]h$]h&]uh1jhj%'hhhj>'hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j(j7j(j8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``struct xarray *xa`` XArray. **Description** An empty XArray is full of NULL entries. **Context** Any context.h](h)}(h**Parameters**h]jF)}(hj(h]h Parameters}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj(ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj (ubj)}(hhh]j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hj1(h]hstruct xarray *xa}(hj3(hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj/(ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj+(ubj)}(hhh]h)}(hXArray.h]hXArray.}(hjJ(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjF(hMhjG(ubah}(h]h ]h"]h$]h&]uh1jhj+(ubeh}(h]h ]h"]h$]h&]uh1jhjF(hMhj((ubah}(h]h ]h"]h$]h&]uh1jhj (ubh)}(h**Description**h]jF)}(hjl(h]h Description}(hjn(hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjj(ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj (ubh)}(h(An empty XArray is full of NULL entries.h]h(An empty XArray is full of NULL entries.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj (ubh)}(h **Context**h]jF)}(hj(h]hContext}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj(ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj (ubh)}(h Any context.h]h Any context.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj (ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_empty (C function) c.xa_emptyhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h'bool xa_empty (const struct xarray *xa)h]jI)}(h&bool xa_empty(const struct xarray *xa)h](jO)}(hjh]hbool}(hj(hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj(hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hj(hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj(hhhj(hMubj)}(hxa_emptyh]j)}(hxa_emptyh]hxa_empty}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj(hhhj(hMubj)}(h(const struct xarray *xa)h]j)}(hconst struct xarray *xah](je)}(hjhh]hconst}(hj)hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj)ubja)}(h h]h }(hj!)hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj)ubje)}(hjh]hstruct}(hj/)hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj)ubja)}(h h]h }(hj<)hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj)ubh)}(hhh]j)}(hxarrayh]hxarray}(hjM)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJ)ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjO)modnameN classnameNjt%jw%)}jz%]j}%)}jp%j(sb c.xa_emptyasbuh1hhj)ubja)}(h h]h }(hjm)hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj)ubjr)}(hjh]h*}(hj{)hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj)ubj)}(hxah]hxa}(hj)hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj )ubah}(h]h ]h"]h$]h&]hhuh1jhj(hhhj(hMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj(hhhj(hMubah}(h]j(ah ](j j eh"]h$]h&]jj)jhuh1jBhj(hMhj(hhubj)}(hhh]h)}(h.Determine if an array has any present entries.h]h.Determine if an array has any present entries.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj)hhubah}(h]h ]h"]h$]h&]uh1jhj(hhhj(hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j)j7j)j8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``const struct xarray *xa`` XArray. **Context** Any context. **Return** ``true`` if the array contains only NULL pointers.h](h)}(h**Parameters**h]jF)}(hj)h]h Parameters}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj)ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj)ubj)}(hhh]j)}(h$``const struct xarray *xa`` XArray. h](j)}(h``const struct xarray *xa``h]j3)}(hj)h]hconst struct xarray *xa}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj)ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj)ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj *hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj*hMhj *ubah}(h]h ]h"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]uh1jhj*hMhj)ubah}(h]h ]h"]h$]h&]uh1jhj)ubh)}(h **Context**h]jF)}(hj.*h]hContext}(hj0*hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj,*ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj)ubh)}(h Any context.h]h Any context.}(hjD*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj)ubh)}(h **Return**h]jF)}(hjU*h]hReturn}(hjW*hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjS*ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj)ubh)}(h2``true`` if the array contains only NULL pointers.h](j3)}(h``true``h]htrue}(hjo*hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjk*ubh* if the array contains only NULL pointers.}(hjk*hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj)ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_marked (C function) c.xa_markedhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h8bool xa_marked (const struct xarray *xa, xa_mark_t mark)h]jI)}(h7bool xa_marked(const struct xarray *xa, xa_mark_t mark)h](jO)}(hjh]hbool}(hj*hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj*hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hj*hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj*hhhj*hMubj)}(h xa_markedh]j)}(h xa_markedh]h xa_marked}(hj*hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj*hhhj*hMubj)}(h)(const struct xarray *xa, xa_mark_t mark)h](j)}(hconst struct xarray *xah](je)}(hjhh]hconst}(hj*hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj*ubja)}(h h]h }(hj*hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj*ubje)}(hjh]hstruct}(hj*hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj*ubja)}(h h]h }(hj +hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj*ubh)}(hhh]j)}(hxarrayh]hxarray}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj+modnameN classnameNjt%jw%)}jz%]j}%)}jp%j*sb c.xa_markedasbuh1hhj*ubja)}(h h]h }(hj=+hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj*ubjr)}(hjh]h*}(hjK+hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj*ubj)}(hxah]hxa}(hjX+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj*ubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjt+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjq+ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjv+modnameN classnameNjt%jw%)}jz%]j9+ c.xa_markedasbuh1hhjm+ubja)}(h h]h }(hj+hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjm+ubj)}(hmarkh]hmark}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjm+ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj*ubeh}(h]h ]h"]h$]h&]hhuh1jhj*hhhj*hMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj*hhhj*hMubah}(h]j*ah ](j j eh"]h$]h&]jj)jhuh1jBhj*hMhj*hhubj)}(hhh]h)}(h6Inquire whether any entry in this array has a mark seth]h6Inquire whether any entry in this array has a mark set}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj+hhubah}(h]h ]h"]h$]h&]uh1jhj*hhhj*hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j+j7j+j8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``const struct xarray *xa`` Array ``xa_mark_t mark`` Mark value **Context** Any context. **Return** ``true`` if any entry has this mark set.h](h)}(h**Parameters**h]jF)}(hj+h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj+ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj+ubj)}(hhh](j)}(h"``const struct xarray *xa`` Array h](j)}(h``const struct xarray *xa``h]j3)}(hj ,h]hconst struct xarray *xa}(hj ,hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ,ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj,ubj)}(hhh]h)}(hArrayh]hArray}(hj$,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ,hMhj!,ubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhj ,hMhj,ubj)}(h``xa_mark_t mark`` Mark value h](j)}(h``xa_mark_t mark``h]j3)}(hjD,h]hxa_mark_t mark}(hjF,hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjB,ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj>,ubj)}(hhh]h)}(h Mark valueh]h Mark value}(hj],hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjY,hMhjZ,ubah}(h]h ]h"]h$]h&]uh1jhj>,ubeh}(h]h ]h"]h$]h&]uh1jhjY,hMhj,ubeh}(h]h ]h"]h$]h&]uh1jhj+ubh)}(h **Context**h]jF)}(hj,h]hContext}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj},ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj+ubh)}(h Any context.h]h Any context.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj+ubh)}(h **Return**h]jF)}(hj,h]hReturn}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj,ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj+ubh)}(h(``true`` if any entry has this mark set.h](j3)}(h``true``h]htrue}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj,ubh if any entry has this mark set.}(hj,hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj+ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_for_each_range (C macro)c.xa_for_each_rangehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hxa_for_each_rangeh]jI)}(hxa_for_each_rangeh]j)}(hxa_for_each_rangeh]j)}(hj,h]hxa_for_each_range}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj,ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj,hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubah}(h]h ]h"]h$]h&]hhjuh1jHjjhj,hhhj-hMubah}(h]j,ah ](j j eh"]h$]h&]jj)jhuh1jBhj-hMhj,hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj,hhhj-hMubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6j)-j7j)-j8j9j:uh1j=hhhjhNhNubh)}(h5``xa_for_each_range (xa, index, entry, start, last)``h]j3)}(hj/-h]h1xa_for_each_range (xa, index, entry, start, last)}(hj1-hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj--ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubj )}(h%Iterate over a portion of an XArray. h]h)}(h$Iterate over a portion of an XArray.h]h$Iterate over a portion of an XArray.}(hjI-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjE-ubah}(h]h ]h"]h$]h&]uh1j hjW-hMhjhhubj<)}(hX:**Parameters** ``xa`` XArray. ``index`` Index of **entry**. ``entry`` Entry retrieved from array. ``start`` First index to retrieve from array. ``last`` Last index to retrieve from array. **Description** During the iteration, **entry** will have the value of the entry stored in **xa** at **index**. You may modify **index** during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, **entry** will be set to NULL and **index** will have a value less than or equal to max. xa_for_each_range() is O(n.log(n)) while xas_for_each() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each_range() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each() iterator instead. The xas_for_each() iterator will expand into more inline code than xa_for_each_range(). **Context** Any context. Takes and releases the RCU lock.h](h)}(h**Parameters**h]jF)}(hjd-h]h Parameters}(hjf-hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjb-ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj^-ubj)}(hhh](j)}(h``xa`` XArray. h](j)}(h``xa``h]j3)}(hj-h]hxa}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj-ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj}-ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hMhj-ubah}(h]h ]h"]h$]h&]uh1jhj}-ubeh}(h]h ]h"]h$]h&]uh1jhj-hMhjz-ubj)}(h``index`` Index of **entry**. h](j)}(h ``index``h]j3)}(hj-h]hindex}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj-ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj-ubj)}(hhh]h)}(hIndex of **entry**.h](h Index of }(hj-hhhNhNubjF)}(h **entry**h]hentry}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj-ubh.}(hj-hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj-hMhj-ubah}(h]h ]h"]h$]h&]uh1jhj-ubeh}(h]h ]h"]h$]h&]uh1jhj-hMhjz-ubj)}(h&``entry`` Entry retrieved from array. h](j)}(h ``entry``h]j3)}(hj.h]hentry}(hj .hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj.ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj.ubj)}(hhh]h)}(hEntry retrieved from array.h]hEntry retrieved from array.}(hj .hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhj.hMhjz-ubj)}(h.``start`` First index to retrieve from array. h](j)}(h ``start``h]j3)}(hj@.h]hstart}(hjB.hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj>.ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj:.ubj)}(hhh]h)}(h#First index to retrieve from array.h]h#First index to retrieve from array.}(hjY.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjU.hMhjV.ubah}(h]h ]h"]h$]h&]uh1jhj:.ubeh}(h]h ]h"]h$]h&]uh1jhjU.hMhjz-ubj)}(h,``last`` Last index to retrieve from array. h](j)}(h``last``h]j3)}(hjy.h]hlast}(hj{.hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjw.ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjs.ubj)}(hhh]h)}(h"Last index to retrieve from array.h]h"Last index to retrieve from array.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj.hMhj.ubah}(h]h ]h"]h$]h&]uh1jhjs.ubeh}(h]h ]h"]h$]h&]uh1jhj.hMhjz-ubeh}(h]h ]h"]h$]h&]uh1jhj^-ubh)}(h**Description**h]jF)}(hj.h]h Description}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj.ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj^-ubh)}(hXeDuring the iteration, **entry** will have the value of the entry stored in **xa** at **index**. You may modify **index** during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, **entry** will be set to NULL and **index** will have a value less than or equal to max.h](hDuring the iteration, }(hj.hhhNhNubjF)}(h **entry**h]hentry}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj.ubh, will have the value of the entry stored in }(hj.hhhNhNubjF)}(h**xa**h]hxa}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj.ubh at }(hj.hhhNhNubjF)}(h **index**h]hindex}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj.ubh. You may modify }(hj.hhhNhNubjF)}(h **index**h]hindex}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj.ubh during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, }(hj.hhhNhNubjF)}(h **entry**h]hentry}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj.ubh will be set to NULL and }(hj.hhhNhNubjF)}(h **index**h]hindex}(hj,/hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj.ubh- will have a value less than or equal to max.}(hj.hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj^-ubh)}(hXxa_for_each_range() is O(n.log(n)) while xas_for_each() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each_range() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each() iterator instead. The xas_for_each() iterator will expand into more inline code than xa_for_each_range().h]hXxa_for_each_range() is O(n.log(n)) while xas_for_each() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each_range() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each() iterator instead. The xas_for_each() iterator will expand into more inline code than xa_for_each_range().}(hjE/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj^-ubh)}(h **Context**h]jF)}(hjV/h]hContext}(hjX/hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjT/ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj^-ubh)}(h.Any context. Takes and releases the RCU lock.h]h.Any context. Takes and releases the RCU lock.}(hjl/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj^-ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_for_each_start (C macro)c.xa_for_each_starthNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hxa_for_each_starth]jI)}(hxa_for_each_starth]j)}(hxa_for_each_starth]j)}(hj/h]hxa_for_each_start}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj/hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubah}(h]h ]h"]h$]h&]hhjuh1jHjjhj/hhhj/hMubah}(h]j/ah ](j j eh"]h$]h&]jj)jhuh1jBhj/hMhj/hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj/hhhj/hMubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6j/j7j/j8j9j:uh1j=hhhjhNhNubh)}(h/``xa_for_each_start (xa, index, entry, start)``h]j3)}(hj/h]h+xa_for_each_start (xa, index, entry, start)}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj/ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubj )}(h%Iterate over a portion of an XArray. h]h)}(h$Iterate over a portion of an XArray.h]h$Iterate over a portion of an XArray.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj/ubah}(h]h ]h"]h$]h&]uh1j hj/hMhjhhubj<)}(hX **Parameters** ``xa`` XArray. ``index`` Index of **entry**. ``entry`` Entry retrieved from array. ``start`` First index to retrieve from array. **Description** During the iteration, **entry** will have the value of the entry stored in **xa** at **index**. You may modify **index** during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, **entry** will be set to NULL and **index** will have a value less than or equal to max. xa_for_each_start() is O(n.log(n)) while xas_for_each() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each_start() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each() iterator instead. The xas_for_each() iterator will expand into more inline code than xa_for_each_start(). **Context** Any context. Takes and releases the RCU lock.h](h)}(h**Parameters**h]jF)}(hj0h]h Parameters}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj0ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj0ubj)}(hhh](j)}(h``xa`` XArray. h](j)}(h``xa``h]j3)}(hj%0h]hxa}(hj'0hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj#0ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj0ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj>0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj:0hMhj;0ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhj:0hMhj0ubj)}(h``index`` Index of **entry**. h](j)}(h ``index``h]j3)}(hj^0h]hindex}(hj`0hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj\0ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjX0ubj)}(hhh]h)}(hIndex of **entry**.h](h Index of }(hjw0hhhNhNubjF)}(h **entry**h]hentry}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjw0ubh.}(hjw0hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhjs0hMhjt0ubah}(h]h ]h"]h$]h&]uh1jhjX0ubeh}(h]h ]h"]h$]h&]uh1jhjs0hMhj0ubj)}(h&``entry`` Entry retrieved from array. h](j)}(h ``entry``h]j3)}(hj0h]hentry}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj0ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj0ubj)}(hhh]h)}(hEntry retrieved from array.h]hEntry retrieved from array.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMhj0ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhj0hMhj0ubj)}(h.``start`` First index to retrieve from array. h](j)}(h ``start``h]j3)}(hj0h]hstart}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj0ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj0ubj)}(hhh]h)}(h#First index to retrieve from array.h]h#First index to retrieve from array.}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj0hMhj0ubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhj0hMhj0ubeh}(h]h ]h"]h$]h&]uh1jhj0ubh)}(h**Description**h]jF)}(hj1h]h Description}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj1ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj0ubh)}(hXeDuring the iteration, **entry** will have the value of the entry stored in **xa** at **index**. You may modify **index** during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, **entry** will be set to NULL and **index** will have a value less than or equal to max.h](hDuring the iteration, }(hj31hhhNhNubjF)}(h **entry**h]hentry}(hj;1hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj31ubh, will have the value of the entry stored in }(hj31hhhNhNubjF)}(h**xa**h]hxa}(hjM1hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj31ubh at }(hj31hhhNhNubjF)}(h **index**h]hindex}(hj_1hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj31ubh. You may modify }(hj31hhhNhNubjF)}(h **index**h]hindex}(hjq1hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj31ubh during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, }(hj31hhhNhNubjF)}(h **entry**h]hentry}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj31ubh will be set to NULL and }(hj31hhhNhNubjF)}(h **index**h]hindex}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj31ubh- will have a value less than or equal to max.}(hj31hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj0ubh)}(hXxa_for_each_start() is O(n.log(n)) while xas_for_each() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each_start() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each() iterator instead. The xas_for_each() iterator will expand into more inline code than xa_for_each_start().h]hXxa_for_each_start() is O(n.log(n)) while xas_for_each() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each_start() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each() iterator instead. The xas_for_each() iterator will expand into more inline code than xa_for_each_start().}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj0ubh)}(h **Context**h]jF)}(hj1h]hContext}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj1ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj0ubh)}(h.Any context. Takes and releases the RCU lock.h]h.Any context. Takes and releases the RCU lock.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj0ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_for_each (C macro) c.xa_for_eachhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h xa_for_eachh]jI)}(h xa_for_eachh]j)}(h xa_for_eachh]j)}(hj1h]h xa_for_each}(hj2hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj2hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubah}(h]h ]h"]h$]h&]hhjuh1jHjjhj1hhhj2hMubah}(h]j1ah ](j j eh"]h$]h&]jj)jhuh1jBhj2hMhj1hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj1hhhj2hMubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6j42j7j42j8j9j:uh1j=hhhjhNhNubh)}(h"``xa_for_each (xa, index, entry)``h]j3)}(hj:2h]hxa_for_each (xa, index, entry)}(hj<2hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj82ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubj )}(h+Iterate over present entries in an XArray. h]h)}(h*Iterate over present entries in an XArray.h]h*Iterate over present entries in an XArray.}(hjT2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjP2ubah}(h]h ]h"]h$]h&]uh1j hjb2hMhjhhubj<)}(hX**Parameters** ``xa`` XArray. ``index`` Index of **entry**. ``entry`` Entry retrieved from array. **Description** During the iteration, **entry** will have the value of the entry stored in **xa** at **index**. You may modify **index** during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, **entry** will be set to NULL and **index** will have a value less than or equal to max. xa_for_each() is O(n.log(n)) while xas_for_each() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each() iterator instead. The xas_for_each() iterator will expand into more inline code than xa_for_each(). **Context** Any context. Takes and releases the RCU lock.h](h)}(h**Parameters**h]jF)}(hjo2h]h Parameters}(hjq2hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjm2ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhji2ubj)}(hhh](j)}(h``xa`` XArray. h](j)}(h``xa``h]j3)}(hj2h]hxa}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj2ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj2ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj2hMhj2ubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhj2hMhj2ubj)}(h``index`` Index of **entry**. h](j)}(h ``index``h]j3)}(hj2h]hindex}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj2ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj2ubj)}(hhh]h)}(hIndex of **entry**.h](h Index of }(hj2hhhNhNubjF)}(h **entry**h]hentry}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj2ubh.}(hj2hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj2hMhj2ubah}(h]h ]h"]h$]h&]uh1jhj2ubeh}(h]h ]h"]h$]h&]uh1jhj2hMhj2ubj)}(h&``entry`` Entry retrieved from array. h](j)}(h ``entry``h]j3)}(hj3h]hentry}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj3ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj 3ubj)}(hhh]h)}(hEntry retrieved from array.h]hEntry retrieved from array.}(hj+3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'3hMhj(3ubah}(h]h ]h"]h$]h&]uh1jhj 3ubeh}(h]h ]h"]h$]h&]uh1jhj'3hMhj2ubeh}(h]h ]h"]h$]h&]uh1jhji2ubh)}(h**Description**h]jF)}(hjM3h]h Description}(hjO3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjK3ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhji2ubh)}(hXeDuring the iteration, **entry** will have the value of the entry stored in **xa** at **index**. You may modify **index** during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, **entry** will be set to NULL and **index** will have a value less than or equal to max.h](hDuring the iteration, }(hjc3hhhNhNubjF)}(h **entry**h]hentry}(hjk3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjc3ubh, will have the value of the entry stored in }(hjc3hhhNhNubjF)}(h**xa**h]hxa}(hj}3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjc3ubh at }(hjc3hhhNhNubjF)}(h **index**h]hindex}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjc3ubh. You may modify }(hjc3hhhNhNubjF)}(h **index**h]hindex}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjc3ubh during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, }(hjc3hhhNhNubjF)}(h **entry**h]hentry}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjc3ubh will be set to NULL and }(hjc3hhhNhNubjF)}(h **index**h]hindex}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjc3ubh- will have a value less than or equal to max.}(hjc3hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhji2ubh)}(hXxa_for_each() is O(n.log(n)) while xas_for_each() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each() iterator instead. The xas_for_each() iterator will expand into more inline code than xa_for_each().h]hXxa_for_each() is O(n.log(n)) while xas_for_each() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each() iterator instead. The xas_for_each() iterator will expand into more inline code than xa_for_each().}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhji2ubh)}(h **Context**h]jF)}(hj3h]hContext}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj3ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhji2ubh)}(h.Any context. Takes and releases the RCU lock.h]h.Any context. Takes and releases the RCU lock.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhji2ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_for_each_marked (C macro)c.xa_for_each_markedhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hxa_for_each_markedh]jI)}(hxa_for_each_markedh]j)}(hxa_for_each_markedh]j)}(hj.4h]hxa_for_each_marked}(hj84hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj44ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj04hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubah}(h]h ]h"]h$]h&]hhjuh1jHjjhj,4hhhjK4hMubah}(h]j'4ah ](j j eh"]h$]h&]jj)jhuh1jBhjK4hMhj)4hhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhj)4hhhjK4hMubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6jd4j7jd4j8j9j:uh1j=hhhjhNhNubh)}(h1``xa_for_each_marked (xa, index, entry, filter)``h]j3)}(hjj4h]h-xa_for_each_marked (xa, index, entry, filter)}(hjl4hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjh4ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubj )}(h*Iterate over marked entries in an XArray. h]h)}(h)Iterate over marked entries in an XArray.h]h)Iterate over marked entries in an XArray.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj4ubah}(h]h ]h"]h$]h&]uh1j hj4hMhjhhubj<)}(hXf**Parameters** ``xa`` XArray. ``index`` Index of **entry**. ``entry`` Entry retrieved from array. ``filter`` Selection criterion. **Description** During the iteration, **entry** will have the value of the entry stored in **xa** at **index**. The iteration will skip all entries in the array which do not match **filter**. You may modify **index** during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, **entry** will be set to NULL and **index** will have a value less than or equal to max. xa_for_each_marked() is O(n.log(n)) while xas_for_each_marked() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each_marked() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each_marked() iterator instead. The xas_for_each_marked() iterator will expand into more inline code than xa_for_each_marked(). **Context** Any context. Takes and releases the RCU lock.h](h)}(h**Parameters**h]jF)}(hj4h]h Parameters}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj4ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj4ubj)}(hhh](j)}(h``xa`` XArray. h](j)}(h``xa``h]j3)}(hj4h]hxa}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj4ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj4ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj4hMhj4ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhj4hMhj4ubj)}(h``index`` Index of **entry**. h](j)}(h ``index``h]j3)}(hj4h]hindex}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj4ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj4ubj)}(hhh]h)}(hIndex of **entry**.h](h Index of }(hj5hhhNhNubjF)}(h **entry**h]hentry}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5ubh.}(hj5hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhj 5hMhj 5ubah}(h]h ]h"]h$]h&]uh1jhj4ubeh}(h]h ]h"]h$]h&]uh1jhj 5hMhj4ubj)}(h&``entry`` Entry retrieved from array. h](j)}(h ``entry``h]j3)}(hjB5h]hentry}(hjD5hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj@5ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj<5ubj)}(hhh]h)}(hEntry retrieved from array.h]hEntry retrieved from array.}(hj[5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjW5hMhjX5ubah}(h]h ]h"]h$]h&]uh1jhj<5ubeh}(h]h ]h"]h$]h&]uh1jhjW5hMhj4ubj)}(h ``filter`` Selection criterion. h](j)}(h ``filter``h]j3)}(hj{5h]hfilter}(hj}5hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjy5ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhju5ubj)}(hhh]h)}(hSelection criterion.h]hSelection criterion.}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hMhj5ubah}(h]h ]h"]h$]h&]uh1jhju5ubeh}(h]h ]h"]h$]h&]uh1jhj5hMhj4ubeh}(h]h ]h"]h$]h&]uh1jhj4ubh)}(h**Description**h]jF)}(hj5h]h Description}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj4ubh)}(hXDuring the iteration, **entry** will have the value of the entry stored in **xa** at **index**. The iteration will skip all entries in the array which do not match **filter**. You may modify **index** during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, **entry** will be set to NULL and **index** will have a value less than or equal to max.h](hDuring the iteration, }(hj5hhhNhNubjF)}(h **entry**h]hentry}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5ubh, will have the value of the entry stored in }(hj5hhhNhNubjF)}(h**xa**h]hxa}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5ubh at }(hj5hhhNhNubjF)}(h **index**h]hindex}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5ubhG. The iteration will skip all entries in the array which do not match }(hj5hhhNhNubjF)}(h **filter**h]hfilter}(hj 6hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5ubh. You may modify }(hj5hhhNhNubjF)}(h **index**h]hindex}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5ubh during the iteration if you want to skip or reprocess indices. It is safe to modify the array during the iteration. At the end of the iteration, }(hj5hhhNhNubjF)}(h **entry**h]hentry}(hj.6hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5ubh will be set to NULL and }(hj5hhhNhNubjF)}(h **index**h]hindex}(hj@6hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5ubh- will have a value less than or equal to max.}(hj5hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj4ubh)}(hXxa_for_each_marked() is O(n.log(n)) while xas_for_each_marked() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each_marked() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each_marked() iterator instead. The xas_for_each_marked() iterator will expand into more inline code than xa_for_each_marked().h]hXxa_for_each_marked() is O(n.log(n)) while xas_for_each_marked() is O(n). You have to handle your own locking with xas_for_each(), and if you have to unlock after each iteration, it will also end up being O(n.log(n)). xa_for_each_marked() will spin if it hits a retry entry; if you intend to see retry entries, you should use the xas_for_each_marked() iterator instead. The xas_for_each_marked() iterator will expand into more inline code than xa_for_each_marked().}(hjY6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM hj4ubh)}(h **Context**h]jF)}(hjj6h]hContext}(hjl6hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjh6ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj4ubh)}(h.Any context. Takes and releases the RCU lock.h]h.Any context. Takes and releases the RCU lock.}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj4ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_store_bh (C function) c.xa_store_bhhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hSvoid * xa_store_bh (struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h]jI)}(hQvoid *xa_store_bh(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](jO)}(hvoidh]hvoid}(hj6hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj6hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMMubja)}(h h]h }(hj6hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj6hhhj6hMMubjr)}(hjh]h*}(hj6hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj6hhhj6hMMubj)}(h xa_store_bhh]j)}(h xa_store_bhh]h xa_store_bh}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj6hhhj6hMMubj)}(h@(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj6hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj6ubja)}(h h]h }(hj7hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj6ubh)}(hhh]j)}(hxarrayh]hxarray}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj7modnameN classnameNjt%jw%)}jz%]j}%)}jp%j6sb c.xa_store_bhasbuh1hhj6ubja)}(h h]h }(hj77hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj6ubjr)}(hjh]h*}(hjE7hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj6ubj)}(hxah]hxa}(hjR7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj6ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjk7hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjg7ubja)}(h h]h }(hjy7hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjg7ubjO)}(hlongh]hlong}(hj7hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjg7ubja)}(h h]h }(hj7hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjg7ubj)}(hindexh]hindex}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjg7ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj6ubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hj7hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj7ubja)}(h h]h }(hj7hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj7ubjr)}(hjh]h*}(hj7hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj7ubj)}(hentryh]hentry}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj6ubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj8modnameN classnameNjt%jw%)}jz%]j37 c.xa_store_bhasbuh1hhj7ubja)}(h h]h }(hj8hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj7ubj)}(hgfph]hgfp}(hj-8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj6ubeh}(h]h ]h"]h$]h&]hhuh1jhj6hhhj6hMMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj6hhhj6hMMubah}(h]j6ah ](j j eh"]h$]h&]jj)jhuh1jBhj6hMMhj6hhubj)}(hhh]h)}(hStore this entry in the XArray.h]hStore this entry in the XArray.}(hjW8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM@hjT8hhubah}(h]h ]h"]h$]h&]uh1jhj6hhhj6hMMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jo8j7jo8j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *entry`` New entry. ``gfp_t gfp`` Memory allocation flags. **Description** This function is like calling xa_store() except it disables softirqs while holding the array lock. **Context** Any context. Takes and releases the xa_lock while disabling softirqs. **Return** The old entry at this index or xa_err() if an error happened.h](h)}(h**Parameters**h]jF)}(hjy8h]h Parameters}(hj{8hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjw8ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMDhjs8ubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hj8h]hstruct xarray *xa}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj8ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMAhj8ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMAhj8ubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8hMAhj8ubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hj8h]hunsigned long index}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj8ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMBhj8ubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMBhj8ubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhj8hMBhj8ubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hj 9h]h void *entry}(hj 9hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj9ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMChj9ubj)}(hhh]h)}(h New entry.h]h New entry.}(hj#9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hMChj 9ubah}(h]h ]h"]h$]h&]uh1jhj9ubeh}(h]h ]h"]h$]h&]uh1jhj9hMChj8ubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjC9h]h gfp_t gfp}(hjE9hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjA9ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMDhj=9ubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hj\9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjX9hMDhjY9ubah}(h]h ]h"]h$]h&]uh1jhj=9ubeh}(h]h ]h"]h$]h&]uh1jhjX9hMDhj8ubeh}(h]h ]h"]h$]h&]uh1jhjs8ubh)}(h**Description**h]jF)}(hj~9h]h Description}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj|9ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMFhjs8ubh)}(hbThis function is like calling xa_store() except it disables softirqs while holding the array lock.h]hbThis function is like calling xa_store() except it disables softirqs while holding the array lock.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMFhjs8ubh)}(h **Context**h]jF)}(hj9h]hContext}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj9ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMIhjs8ubh)}(hFAny context. Takes and releases the xa_lock while disabling softirqs.h]hFAny context. Takes and releases the xa_lock while disabling softirqs.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMIhjs8ubh)}(h **Return**h]jF)}(hj9h]hReturn}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj9ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMLhjs8ubh)}(h=The old entry at this index or xa_err() if an error happened.h]h=The old entry at this index or xa_err() if an error happened.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMKhjs8ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_store_irq (C function)c.xa_store_irqhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hTvoid * xa_store_irq (struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h]jI)}(hRvoid *xa_store_irq(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](jO)}(hvoidh]hvoid}(hj:hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj :hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhubja)}(h h]h }(hj :hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj :hhhj:hMhubjr)}(hjh]h*}(hj.:hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj :hhhj:hMhubj)}(h xa_store_irqh]j)}(h xa_store_irqh]h xa_store_irq}(hj?:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;:ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj :hhhj:hMhubj)}(h@(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj[:hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjW:ubja)}(h h]h }(hjh:hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjW:ubh)}(hhh]j)}(hxarrayh]hxarray}(hjy:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjv:ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj{:modnameN classnameNjt%jw%)}jz%]j}%)}jp%jA:sbc.xa_store_irqasbuh1hhjW:ubja)}(h h]h }(hj:hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjW:ubjr)}(hjh]h*}(hj:hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjW:ubj)}(hxah]hxa}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjW:ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjS:ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hj:hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj:ubja)}(h h]h }(hj:hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj:ubjO)}(hlongh]hlong}(hj:hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj:ubja)}(h h]h }(hj:hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj:ubj)}(hindexh]hindex}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjS:ubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hj;hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj;ubja)}(h h]h }(hj,;hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj;ubjr)}(hjh]h*}(hj:;hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj;ubj)}(hentryh]hentry}(hjG;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjS:ubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjc;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj`;ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetje;modnameN classnameNjt%jw%)}jz%]j:c.xa_store_irqasbuh1hhj\;ubja)}(h h]h }(hj;hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj\;ubj)}(hgfph]hgfp}(hj;hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\;ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjS:ubeh}(h]h ]h"]h$]h&]hhuh1jhj :hhhj:hMhubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj :hhhj:hMhubah}(h]j:ah ](j j eh"]h$]h&]jj)jhuh1jBhj:hMhhj:hhubj)}(hhh]h)}(hStore this entry in the XArray.h]hStore this entry in the XArray.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM[hj;hhubah}(h]h ]h"]h$]h&]uh1jhj:hhhj:hMhubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j;j7j;j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *entry`` New entry. ``gfp_t gfp`` Memory allocation flags. **Description** This function is like calling xa_store() except it disables interrupts while holding the array lock. **Context** Process context. Takes and releases the xa_lock while disabling interrupts. **Return** The old entry at this index or xa_err() if an error happened.h](h)}(h**Parameters**h]jF)}(hj;h]h Parameters}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj;ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM_hj;ubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hj;h]hstruct xarray *xa}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj;ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM\hj;ubj)}(hhh]h)}(hXArray.h]hXArray.}(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 index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hj3<h]hunsigned long index}(hj5<hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj1<ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM]hj-<ubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hjL<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjH<hM]hjI<ubah}(h]h ]h"]h$]h&]uh1jhj-<ubeh}(h]h ]h"]h$]h&]uh1jhjH<hM]hj;ubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjl<h]h void *entry}(hjn<hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjj<ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM^hjf<ubj)}(hhh]h)}(h New entry.h]h New entry.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj<hM^hj<ubah}(h]h ]h"]h$]h&]uh1jhjf<ubeh}(h]h ]h"]h$]h&]uh1jhj<hM^hj;ubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hj<h]h gfp_t gfp}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj<ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM_hj<ubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(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&]uh1jhj;ubh)}(h**Description**h]jF)}(hj<h]h Description}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj<ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMahj;ubh)}(hdThis function is like calling xa_store() except it disables interrupts while holding the array lock.h]hdThis function is like calling xa_store() except it disables interrupts while holding the array lock.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMahj;ubh)}(h **Context**h]jF)}(hj=h]hContext}(hj =hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj=ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMdhj;ubh)}(hLProcess context. Takes and releases the xa_lock while disabling interrupts.h]hLProcess context. Takes and releases the xa_lock while disabling interrupts.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMdhj;ubh)}(h **Return**h]jF)}(hj.=h]hReturn}(hj0=hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj,=ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMghj;ubh)}(h=The old entry at this index or xa_err() if an error happened.h]h=The old entry at this index or xa_err() if an error happened.}(hjD=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMfhj;ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_erase_bh (C function) c.xa_erase_bhhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h;void * xa_erase_bh (struct xarray *xa, unsigned long index)h]jI)}(h9void *xa_erase_bh(struct xarray *xa, unsigned long index)h](jO)}(hvoidh]hvoid}(hjs=hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjo=hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hj=hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjo=hhhj=hMubjr)}(hjh]h*}(hj=hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjo=hhhj=hMubj)}(h xa_erase_bhh]j)}(h xa_erase_bhh]h xa_erase_bh}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjo=hhhj=hMubj)}(h((struct xarray *xa, unsigned long index)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj=hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj=ubja)}(h h]h }(hj=hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj=ubh)}(hhh]j)}(hxarrayh]hxarray}(hj=hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj=modnameN classnameNjt%jw%)}jz%]j}%)}jp%j=sb c.xa_erase_bhasbuh1hhj=ubja)}(h h]h }(hj=hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj=ubjr)}(hjh]h*}(hj >hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj=ubj)}(hxah]hxa}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj=ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hj/>hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj+>ubja)}(h h]h }(hj=>hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj+>ubjO)}(hlongh]hlong}(hjK>hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj+>ubja)}(h h]h }(hjY>hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj+>ubj)}(hindexh]hindex}(hjg>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+>ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj=ubeh}(h]h ]h"]h$]h&]hhuh1jhjo=hhhj=hMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjk=hhhj=hMubah}(h]jf=ah ](j j eh"]h$]h&]jj)jhuh1jBhj=hMhjh=hhubj)}(hhh]h)}(h!Erase this entry from the XArray.h]h!Erase this entry from the XArray.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMvhj>hhubah}(h]h ]h"]h$]h&]uh1jhjh=hhhj=hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j>j7j>j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index of entry. **Description** After this function returns, loading from **index** will return ``NULL``. If the index is part of a multi-index entry, all indices will be erased and none of the entries will be part of a multi-index entry. **Context** Any context. Takes and releases the xa_lock while disabling softirqs. **Return** The entry which used to be at this index.h](h)}(h**Parameters**h]jF)}(hj>h]h Parameters}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj>ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMzhj>ubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hj>h]hstruct xarray *xa}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj>ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMwhj>ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj>hMwhj>ubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhj>hMwhj>ubj)}(h(``unsigned long index`` Index of entry. h](j)}(h``unsigned long index``h]j3)}(hj ?h]hunsigned long index}(hj ?hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ?ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMxhj?ubj)}(hhh]h)}(hIndex of entry.h]hIndex of entry.}(hj$?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ?hMxhj!?ubah}(h]h ]h"]h$]h&]uh1jhj?ubeh}(h]h ]h"]h$]h&]uh1jhj ?hMxhj>ubeh}(h]h ]h"]h$]h&]uh1jhj>ubh)}(h**Description**h]jF)}(hjF?h]h Description}(hjH?hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjD?ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMzhj>ubh)}(hAfter this function returns, loading from **index** will return ``NULL``. If the index is part of a multi-index entry, all indices will be erased and none of the entries will be part of a multi-index entry.h](h*After this function returns, loading from }(hj\?hhhNhNubjF)}(h **index**h]hindex}(hjd?hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj\?ubh will return }(hj\?hhhNhNubj3)}(h``NULL``h]hNULL}(hjv?hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj\?ubh. If the index is part of a multi-index entry, all indices will be erased and none of the entries will be part of a multi-index entry.}(hj\?hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMzhj>ubh)}(h **Context**h]jF)}(hj?h]hContext}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj?ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM~hj>ubh)}(hFAny context. Takes and releases the xa_lock while disabling softirqs.h]hFAny context. Takes and releases the xa_lock while disabling softirqs.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM~hj>ubh)}(h **Return**h]jF)}(hj?h]hReturn}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj?ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj>ubh)}(h)The entry which used to be at this index.h]h)The entry which used to be at this index.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj>ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_erase_irq (C function)c.xa_erase_irqhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h)}(hhh](jC)}(h]void * xa_cmpxchg (struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h]jI)}(h[void *xa_cmpxchg(struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h](jO)}(hvoidh]hvoid}(hjBhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjBhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjBhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjBhhhjBhMubjr)}(hjh]h*}(hjBhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjBhhhjBhMubj)}(h xa_cmpxchgh]j)}(h xa_cmpxchgh]h xa_cmpxchg}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ](jjeh"]h$]h&]hhuh1jhjBhhhjBhMubj)}(hK(struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjBubja)}(h h]h }(hjBhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjBubh)}(hhh]j)}(hxarrayh]hxarray}(hjBhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjBmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jBsb c.xa_cmpxchgasbuh1hhjBubja)}(h h]h }(hjChhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjBubjr)}(hjh]h*}(hjChhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjBubj)}(hxah]hxa}(hj*ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjBubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjCChhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj?Cubja)}(h h]h }(hjQChhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj?CubjO)}(hlongh]hlong}(hj_ChhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj?Cubja)}(h h]h }(hjmChhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj?Cubj)}(hindexh]hindex}(hj{ChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj?Cubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjBubj)}(h void *oldh](jO)}(hvoidh]hvoid}(hjChhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjCubja)}(h h]h }(hjChhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjCubjr)}(hjh]h*}(hjChhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjCubj)}(holdh]hold}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjBubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjChhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjCubja)}(h h]h }(hjChhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjCubjr)}(hjh]h*}(hjChhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjCubj)}(hentryh]hentry}(hjChhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjBubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjDmodnameN classnameNjt%jw%)}jz%]j C c.xa_cmpxchgasbuh1hhjDubja)}(h h]h }(hj9DhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjDubj)}(hgfph]hgfp}(hjGDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjBubeh}(h]h ]h"]h$]h&]hhuh1jhjBhhhjBhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjBhhhjBhMubah}(h]jzBah ](j j eh"]h$]h&]jj)jhuh1jBhjBhMhj|Bhhubj)}(hhh]h)}(h-Conditionally replace an entry in the XArray.h]h-Conditionally replace an entry in the XArray.}(hjqDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjnDhhubah}(h]h ]h"]h$]h&]uh1jhj|BhhhjBhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jDj7jDj8j9j:uh1j=hhhjhNhNubj<)}(hX;**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *old`` Old value to test against. ``void *entry`` New value to place in array. ``gfp_t gfp`` Memory allocation flags. **Description** If the entry at **index** is the same as **old**, replace it with **entry**. If the return value is equal to **old**, then the exchange was successful. **Context** Any context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit. **Return** The old value at this index or xa_err() if an error happened.h](h)}(h**Parameters**h]jF)}(hjDh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjDubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjDh]hstruct xarray *xa}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjDubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDubj)}(hhh]h)}(hXArray.h]hXArray.}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjDhMhjDubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjDhMhjDubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hjDh]hunsigned long index}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjDubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjEhMhjEubah}(h]h ]h"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]uh1jhjEhMhjDubj)}(h)``void *old`` Old value to test against. h](j)}(h ``void *old``h]j3)}(hj$Eh]h void *old}(hj&EhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj"Eubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjEubj)}(hhh]h)}(hOld value to test against.h]hOld value to test against.}(hj=EhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9EhMhj:Eubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj9EhMhjDubj)}(h-``void *entry`` New value to place in array. h](j)}(h``void *entry``h]j3)}(hj]Eh]h void *entry}(hj_EhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj[Eubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjWEubj)}(hhh]h)}(hNew value to place in array.h]hNew value to place in array.}(hjvEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrEhMhjsEubah}(h]h ]h"]h$]h&]uh1jhjWEubeh}(h]h ]h"]h$]h&]uh1jhjrEhMhjDubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjEh]h gfp_t gfp}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjEubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjEubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjEhMhjEubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhjEhMhjDubeh}(h]h ]h"]h$]h&]uh1jhjDubh)}(h**Description**h]jF)}(hjEh]h Description}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjEubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDubh)}(hIf the entry at **index** is the same as **old**, replace it with **entry**. If the return value is equal to **old**, then the exchange was successful.h](hIf the entry at }(hjEhhhNhNubjF)}(h **index**h]hindex}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjEubh is the same as }(hjEhhhNhNubjF)}(h**old**h]hold}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjEubh, replace it with }(hjEhhhNhNubjF)}(h **entry**h]hentry}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjEubh". If the return value is equal to }(hjEhhhNhNubjF)}(h**old**h]hold}(hj%FhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjEubh#, then the exchange was successful.}(hjEhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDubh)}(h **Context**h]jF)}(hj@Fh]hContext}(hjBFhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj>Fubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDubh)}(hUAny context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit.h](h@Any context. Takes and releases the xa_lock. May sleep if the }(hjVFhhhNhNubjF)}(h**gfp**h]hgfp}(hj^FhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjVFubh flags permit.}(hjVFhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDubh)}(h **Return**h]jF)}(hjyFh]hReturn}(hj{FhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjwFubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDubh)}(h=The old value at this index or xa_err() if an error happened.h]h=The old value at this index or xa_err() if an error happened.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_cmpxchg_bh (C function)c.xa_cmpxchg_bhhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h`void * xa_cmpxchg_bh (struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h]jI)}(h^void *xa_cmpxchg_bh(struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h](jO)}(hvoidh]hvoid}(hjFhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjFhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjFhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjFhhhjFhMubjr)}(hjh]h*}(hjFhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjFhhhjFhMubj)}(h xa_cmpxchg_bhh]j)}(h xa_cmpxchg_bhh]h xa_cmpxchg_bh}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubah}(h]h ](jjeh"]h$]h&]hhuh1jhjFhhhjFhMubj)}(hK(struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjGhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjGubja)}(h h]h }(hjGhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjGubh)}(hhh]j)}(hxarrayh]hxarray}(hj&GhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#Gubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj(GmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jFsbc.xa_cmpxchg_bhasbuh1hhjGubja)}(h h]h }(hjFGhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjGubjr)}(hjh]h*}(hjTGhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjGubj)}(hxah]hxa}(hjaGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjGubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjzGhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjvGubja)}(h h]h }(hjGhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjvGubjO)}(hlongh]hlong}(hjGhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjvGubja)}(h h]h }(hjGhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjvGubj)}(hindexh]hindex}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvGubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjGubj)}(h void *oldh](jO)}(hvoidh]hvoid}(hjGhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjGubja)}(h h]h }(hjGhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjGubjr)}(hjh]h*}(hjGhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjGubj)}(holdh]hold}(hjGhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjGubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hj HhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj Hubja)}(h h]h }(hjHhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj Hubjr)}(hjh]h*}(hj)HhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj Hubj)}(hentryh]hentry}(hj6HhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Hubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjGubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjRHhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOHubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjTHmodnameN classnameNjt%jw%)}jz%]jBGc.xa_cmpxchg_bhasbuh1hhjKHubja)}(h h]h }(hjpHhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjKHubj)}(hgfph]hgfp}(hj~HhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKHubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjGubeh}(h]h ]h"]h$]h&]hhuh1jhjFhhhjFhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjFhhhjFhMubah}(h]jFah ](j j eh"]h$]h&]jj)jhuh1jBhjFhMhjFhhubj)}(hhh]h)}(h-Conditionally replace an entry in the XArray.h]h-Conditionally replace an entry in the XArray.}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjHhhubah}(h]h ]h"]h$]h&]uh1jhjFhhhjFhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jHj7jHj8j9j:uh1j=hhhjhNhNubj<)}(hX!**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *old`` Old value to test against. ``void *entry`` New value to place in array. ``gfp_t gfp`` Memory allocation flags. **Description** This function is like calling xa_cmpxchg() except it disables softirqs while holding the array lock. **Context** Any context. Takes and releases the xa_lock while disabling softirqs. May sleep if the **gfp** flags permit. **Return** The old value at this index or xa_err() if an error happened.h](h)}(h**Parameters**h]jF)}(hjHh]h Parameters}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjHubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjHubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjHh]hstruct xarray *xa}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjHubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjHubj)}(hhh]h)}(hXArray.h]hXArray.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhMhjHubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjHhMhjHubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hj"Ih]hunsigned long index}(hj$IhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj Iubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjIubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hj;IhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7IhMhj8Iubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhj7IhMhjHubj)}(h)``void *old`` Old value to test against. h](j)}(h ``void *old``h]j3)}(hj[Ih]h void *old}(hj]IhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjYIubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjUIubj)}(hhh]h)}(hOld value to test against.h]hOld value to test against.}(hjtIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjpIhMhjqIubah}(h]h ]h"]h$]h&]uh1jhjUIubeh}(h]h ]h"]h$]h&]uh1jhjpIhMhjHubj)}(h-``void *entry`` New value to place in array. h](j)}(h``void *entry``h]j3)}(hjIh]h void *entry}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjIubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjIubj)}(hhh]h)}(hNew value to place in array.h]hNew value to place in array.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhMhjIubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjIhMhjHubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjIh]h gfp_t gfp}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjIubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjIubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhMhjIubah}(h]h ]h"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]uh1jhjIhMhjHubeh}(h]h ]h"]h$]h&]uh1jhjHubh)}(h**Description**h]jF)}(hjJh]h Description}(hj JhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjJubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjHubh)}(hdThis function is like calling xa_cmpxchg() except it disables softirqs while holding the array lock.h]hdThis function is like calling xa_cmpxchg() except it disables softirqs while holding the array lock.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjHubh)}(h **Context**h]jF)}(hj/Jh]hContext}(hj1JhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj-Jubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjHubh)}(hnAny context. Takes and releases the xa_lock while disabling softirqs. May sleep if the **gfp** flags permit.h](hYAny context. Takes and releases the xa_lock while disabling softirqs. May sleep if the }(hjEJhhhNhNubjF)}(h**gfp**h]hgfp}(hjMJhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjEJubh flags permit.}(hjEJhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjHubh)}(h **Return**h]jF)}(hjhJh]hReturn}(hjjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjfJubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjHubh)}(h=The old value at this index or xa_err() if an error happened.h]h=The old value at this index or xa_err() if an error happened.}(hj~JhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjHubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_cmpxchg_irq (C function)c.xa_cmpxchg_irqhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(havoid * xa_cmpxchg_irq (struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h]jI)}(h_void *xa_cmpxchg_irq(struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h](jO)}(hvoidh]hvoid}(hjJhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjJhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjJhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjJhhhjJhMubjr)}(hjh]h*}(hjJhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjJhhhjJhMubj)}(hxa_cmpxchg_irqh]j)}(hxa_cmpxchg_irqh]hxa_cmpxchg_irq}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ](jjeh"]h$]h&]hhuh1jhjJhhhjJhMubj)}(hK(struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjJhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjJubja)}(h h]h }(hjKhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjJubh)}(hhh]j)}(hxarrayh]hxarray}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjKmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jJsbc.xa_cmpxchg_irqasbuh1hhjJubja)}(h h]h }(hj5KhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjJubjr)}(hjh]h*}(hjCKhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjJubj)}(hxah]hxa}(hjPKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjJubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjiKhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjeKubja)}(h h]h }(hjwKhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjeKubjO)}(hlongh]hlong}(hjKhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjeKubja)}(h h]h }(hjKhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjeKubj)}(hindexh]hindex}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeKubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjJubj)}(h void *oldh](jO)}(hvoidh]hvoid}(hjKhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjKubja)}(h h]h }(hjKhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjKubjr)}(hjh]h*}(hjKhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjKubj)}(holdh]hold}(hjKhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjJubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjKhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjKubja)}(h h]h }(hj LhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjKubjr)}(hjh]h*}(hjLhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjKubj)}(hentryh]hentry}(hj%LhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjJubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjALhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj>Lubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjCLmodnameN classnameNjt%jw%)}jz%]j1Kc.xa_cmpxchg_irqasbuh1hhj:Lubja)}(h h]h }(hj_LhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj:Lubj)}(hgfph]hgfp}(hjmLhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:Lubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjJubeh}(h]h ]h"]h$]h&]hhuh1jhjJhhhjJhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjJhhhjJhMubah}(h]jJah ](j j eh"]h$]h&]jj)jhuh1jBhjJhMhjJhhubj)}(hhh]h)}(h-Conditionally replace an entry in the XArray.h]h-Conditionally replace an entry in the XArray.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjLhhubah}(h]h ]h"]h$]h&]uh1jhjJhhhjJhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jLj7jLj8j9j:uh1j=hhhjhNhNubj<)}(hX)**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *old`` Old value to test against. ``void *entry`` New value to place in array. ``gfp_t gfp`` Memory allocation flags. **Description** This function is like calling xa_cmpxchg() except it disables interrupts while holding the array lock. **Context** Process context. Takes and releases the xa_lock while disabling interrupts. May sleep if the **gfp** flags permit. **Return** The old value at this index or xa_err() if an error happened.h](h)}(h**Parameters**h]jF)}(hjLh]h Parameters}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjLubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjLubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjLh]hstruct xarray *xa}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjLubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjLubj)}(hhh]h)}(hXArray.h]hXArray.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjLhMhjLubah}(h]h ]h"]h$]h&]uh1jhjLubeh}(h]h ]h"]h$]h&]uh1jhjLhMhjLubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hjMh]hunsigned long index}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjMubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj Mubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hj*MhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&MhMhj'Mubah}(h]h ]h"]h$]h&]uh1jhj Mubeh}(h]h ]h"]h$]h&]uh1jhj&MhMhjLubj)}(h)``void *old`` Old value to test against. h](j)}(h ``void *old``h]j3)}(hjJMh]h void *old}(hjLMhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjHMubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDMubj)}(hhh]h)}(hOld value to test against.h]hOld value to test against.}(hjcMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_MhMhj`Mubah}(h]h ]h"]h$]h&]uh1jhjDMubeh}(h]h ]h"]h$]h&]uh1jhj_MhMhjLubj)}(h-``void *entry`` New value to place in array. h](j)}(h``void *entry``h]j3)}(hjMh]h void *entry}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjMubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj}Mubj)}(hhh]h)}(hNew value to place in array.h]hNew value to place in array.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhMhjMubah}(h]h ]h"]h$]h&]uh1jhj}Mubeh}(h]h ]h"]h$]h&]uh1jhjMhMhjLubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjMh]h gfp_t gfp}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjMubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjMubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjMhMhjMubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjMhMhjLubeh}(h]h ]h"]h$]h&]uh1jhjLubh)}(h**Description**h]jF)}(hjMh]h Description}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjMubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjLubh)}(hfThis function is like calling xa_cmpxchg() except it disables interrupts while holding the array lock.h]hfThis function is like calling xa_cmpxchg() except it disables interrupts while holding the array lock.}(hj NhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjLubh)}(h **Context**h]jF)}(hjNh]hContext}(hj NhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjLubh)}(htProcess context. Takes and releases the xa_lock while disabling interrupts. May sleep if the **gfp** flags permit.h](h_Process context. Takes and releases the xa_lock while disabling interrupts. May sleep if the }(hj4NhhhNhNubjF)}(h**gfp**h]hgfp}(hj)}(hhh](jC)}(hNint xa_insert (struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h]jI)}(hMint xa_insert(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](jO)}(hinth]hint}(hjNhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjNhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM ubja)}(h h]h }(hjNhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjNhhhjNhM ubj)}(h xa_inserth]j)}(h xa_inserth]h xa_insert}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ](jjeh"]h$]h&]hhuh1jhjNhhhjNhM ubj)}(h@(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjNhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjNubja)}(h h]h }(hjNhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjNubh)}(hhh]j)}(hxarrayh]hxarray}(hjNhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjNmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jNsb c.xa_insertasbuh1hhjNubja)}(h h]h }(hjOhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjNubjr)}(hjh]h*}(hj%OhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjNubj)}(hxah]hxa}(hj2OhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjNubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjNubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjKOhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjGOubja)}(h h]h }(hjYOhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjGOubjO)}(hlongh]hlong}(hjgOhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjGOubja)}(h h]h }(hjuOhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjGOubj)}(hindexh]hindex}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGOubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjNubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjOhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjOubja)}(h h]h }(hjOhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjOubjr)}(hjh]h*}(hjOhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjOubj)}(hentryh]hentry}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjNubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjOhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjOmodnameN classnameNjt%jw%)}jz%]jO c.xa_insertasbuh1hhjOubja)}(h h]h }(hjOhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjOubj)}(hgfph]hgfp}(hj PhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjNubeh}(h]h ]h"]h$]h&]hhuh1jhjNhhhjNhM ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjNhhhjNhM ubah}(h]jNah ](j j eh"]h$]h&]jj)jhuh1jBhjNhM hjNhhubj)}(hhh]h)}(hGStore this entry in the XArray unless another entry is already present.h]hGStore this entry in the XArray unless another entry is already present.}(hj7PhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj4Phhubah}(h]h ]h"]h$]h&]uh1jhjNhhhjNhM ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jOPj7jOPj8j9j:uh1j=hhhjhNhNubj<)}(hX[**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *entry`` New entry. ``gfp_t gfp`` Memory allocation flags. **Description** Inserting a NULL entry will store a reserved entry (like xa_reserve()) if no entry is present. Inserting will fail if a reserved entry is present, even though loading from this index will return NULL. **Context** Any context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit. **Return** 0 if the store succeeded. -EBUSY if another entry was present. -ENOMEM if memory could not be allocated.h](h)}(h**Parameters**h]jF)}(hjYPh]h Parameters}(hj[PhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjWPubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjSPubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjxPh]hstruct xarray *xa}(hjzPhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjvPubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjrPubj)}(hhh]h)}(hXArray.h]hXArray.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMhjPubah}(h]h ]h"]h$]h&]uh1jhjrPubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjoPubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hjPh]hunsigned long index}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjPubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjPubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMhjPubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjoPubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjPh]h void *entry}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjPubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjPubj)}(hhh]h)}(h New entry.h]h New entry.}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjPhMhjQubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjPhMhjoPubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hj#Qh]h gfp_t gfp}(hj%QhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj!Qubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjQubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hj)}(hhh](jC)}(hQint xa_insert_bh (struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h]jI)}(hPint xa_insert_bh(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](jO)}(hinth]hint}(hjRhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjQhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM(ubja)}(h h]h }(hjRhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjQhhhjRhM(ubj)}(h xa_insert_bhh]j)}(h xa_insert_bhh]h xa_insert_bh}(hj$RhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Rubah}(h]h ](jjeh"]h$]h&]hhuh1jhjQhhhjRhM(ubj)}(h@(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj@RhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj)}(hhh](jC)}(hRint xa_insert_irq (struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h]jI)}(hQint xa_insert_irq(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](jO)}(hinth]hint}(hjjUhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjfUhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMFubja)}(h h]h }(hjyUhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjfUhhhjxUhMFubj)}(h xa_insert_irqh]j)}(h xa_insert_irqh]h xa_insert_irq}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ](jjeh"]h$]h&]hhuh1jhjfUhhhjxUhMFubj)}(h@(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjUhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjUubja)}(h h]h }(hjUhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjUubh)}(hhh]j)}(hxarrayh]hxarray}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjUmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jUsbc.xa_insert_irqasbuh1hhjUubja)}(h h]h }(hjUhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjUubjr)}(hjh]h*}(hjUhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjUubj)}(hxah]hxa}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjUubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjVhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjVubja)}(h h]h }(hj'VhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjVubjO)}(hlongh]hlong}(hj5VhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjVubja)}(h h]h }(hjCVhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjVubj)}(hindexh]hindex}(hjQVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjUubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjjVhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjfVubja)}(h h]h }(hjxVhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjfVubjr)}(hjh]h*}(hjVhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjfVubj)}(hentryh]hentry}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfVubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjUubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjVmodnameN classnameNjt%jw%)}jz%]jUc.xa_insert_irqasbuh1hhjVubja)}(h h]h }(hjVhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjVubj)}(hgfph]hgfp}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjVubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjUubeh}(h]h ]h"]h$]h&]hhuh1jhjfUhhhjxUhMFubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjbUhhhjxUhMFubah}(h]j]Uah ](j j eh"]h$]h&]jj)jhuh1jBhjxUhMFhj_Uhhubj)}(hhh]h)}(hGStore this entry in the XArray unless another entry is already present.h]hGStore this entry in the XArray unless another entry is already present.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM6hjWhhubah}(h]h ]h"]h$]h&]uh1jhj_UhhhjxUhMFubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jWj7jWj8j9j:uh1j=hhhjhNhNubj<)}(hXz**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *entry`` New entry. ``gfp_t gfp`` Memory allocation flags. **Description** Inserting a NULL entry will store a reserved entry (like xa_reserve()) if no entry is present. Inserting will fail if a reserved entry is present, even though loading from this index will return NULL. **Context** Process context. Takes and releases the xa_lock while disabling interrupts. May sleep if the **gfp** flags permit. **Return** 0 if the store succeeded. -EBUSY if another entry was present. -ENOMEM if memory could not be allocated.h](h)}(h**Parameters**h]jF)}(hj'Wh]h Parameters}(hj)WhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj%Wubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM:hj!Wubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjFWh]hstruct xarray *xa}(hjHWhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjDWubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM8hj@Wubj)}(hhh]h)}(hXArray.h]hXArray.}(hj_WhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[WhM8hj\Wubah}(h]h ]h"]h$]h&]uh1jhj@Wubeh}(h]h ]h"]h$]h&]uh1jhj[WhM8hj=Wubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hjWh]hunsigned long index}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj}Wubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM9hjyWubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhM9hjWubah}(h]h ]h"]h$]h&]uh1jhjyWubeh}(h]h ]h"]h$]h&]uh1jhjWhM9hj=Wubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjWh]h void *entry}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjWubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM:hjWubj)}(hhh]h)}(h New entry.h]h New entry.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhM:hjWubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjWhM:hj=Wubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjWh]h gfp_t gfp}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjWubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM;hjWubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hj XhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjXhM;hjXubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjXhM;hj=Wubeh}(h]h ]h"]h$]h&]uh1jhj!Wubh)}(h**Description**h]jF)}(hj,Xh]h Description}(hj.XhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj*Xubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM=hj!Wubh)}(hInserting a NULL entry will store a reserved entry (like xa_reserve()) if no entry is present. Inserting will fail if a reserved entry is present, even though loading from this index will return NULL.h]hInserting a NULL entry will store a reserved entry (like xa_reserve()) if no entry is present. Inserting will fail if a reserved entry is present, even though loading from this index will return NULL.}(hjBXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM=hj!Wubh)}(h **Context**h]jF)}(hjSXh]hContext}(hjUXhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjQXubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMAhj!Wubh)}(htProcess context. Takes and releases the xa_lock while disabling interrupts. May sleep if the **gfp** flags permit.h](h_Process context. Takes and releases the xa_lock while disabling interrupts. May sleep if the }(hjiXhhhNhNubjF)}(h**gfp**h]hgfp}(hjqXhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjiXubh flags permit.}(hjiXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMAhj!Wubh)}(h **Return**h]jF)}(hjXh]hReturn}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjXubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMDhj!Wubh)}(hi0 if the store succeeded. -EBUSY if another entry was present. -ENOMEM if memory could not be allocated.h]hi0 if the store succeeded. -EBUSY if another entry was present. -ENOMEM if memory could not be allocated.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMChj!Wubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_alloc (C function) c.xa_allochNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hXint xa_alloc (struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h]jI)}(hWint xa_alloc(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h](jO)}(hinth]hint}(hjXhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjXhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMgubja)}(h h]h }(hjXhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjXhhhjXhMgubj)}(hxa_alloch]j)}(hxa_alloch]hxa_alloc}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjXubah}(h]h ](jjeh"]h$]h&]hhuh1jhjXhhhjXhMgubj)}(hK(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjYhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj Yubja)}(h h]h }(hjYhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj Yubh)}(hhh]j)}(hxarrayh]hxarray}(hj,YhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)Yubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj.YmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jXsb c.xa_allocasbuh1hhj Yubja)}(h h]h }(hjLYhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj Yubjr)}(hjh]h*}(hjZYhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj Yubj)}(hxah]hxa}(hjgYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj Yubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjYubj)}(hu32 *idh](h)}(hhh]j)}(hu32h]hu32}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjYmodnameN classnameNjt%jw%)}jz%]jHY c.xa_allocasbuh1hhj|Yubja)}(h h]h }(hjYhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj|Yubjr)}(hjh]h*}(hjYhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj|Yubj)}(hidh]hid}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|Yubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjYubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjYhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjYubja)}(h h]h }(hjYhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjYubjr)}(hjh]h*}(hjYhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjYubj)}(hentryh]hentry}(hjYhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjYubj)}(hstruct xa_limit limith](je)}(hjh]hstruct}(hjZhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjZubja)}(h h]h }(hj$ZhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjZubh)}(hhh]j)}(hxa_limith]hxa_limit}(hj5ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj2Zubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj7ZmodnameN classnameNjt%jw%)}jz%]jHY c.xa_allocasbuh1hhjZubja)}(h h]h }(hjSZhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjZubj)}(hlimith]hlimit}(hjaZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjYubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj}ZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzZubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjZmodnameN classnameNjt%jw%)}jz%]jHY c.xa_allocasbuh1hhjvZubja)}(h h]h }(hjZhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjvZubj)}(hgfph]hgfp}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvZubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjYubeh}(h]h ]h"]h$]h&]hhuh1jhjXhhhjXhMgubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjXhhhjXhMgubah}(h]jXah ](j j eh"]h$]h&]jj)jhuh1jBhjXhMghjXhhubj)}(hhh]h)}(h1Find somewhere to store this entry in the XArray.h]h1Find somewhere to store this entry in the XArray.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMThjZhhubah}(h]h ]h"]h$]h&]uh1jhjXhhhjXhMgubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jZj7jZj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``u32 *id`` Pointer to ID. ``void *entry`` New entry. ``struct xa_limit limit`` Range of ID to allocate. ``gfp_t gfp`` Memory allocation flags. **Description** Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags(). **Context** Any context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit. **Return** 0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h)}(h**Parameters**h]jF)}(hjZh]h Parameters}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjZubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMXhjZubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hj[h]hstruct xarray *xa}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj[ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMUhj[ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj-[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)[hMUhj*[ubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhj)[hMUhj [ubj)}(h``u32 *id`` Pointer to ID. h](j)}(h ``u32 *id``h]j3)}(hjM[h]hu32 *id}(hjO[hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjK[ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMVhjG[ubj)}(hhh]h)}(hPointer to ID.h]hPointer to ID.}(hjf[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjb[hMVhjc[ubah}(h]h ]h"]h$]h&]uh1jhjG[ubeh}(h]h ]h"]h$]h&]uh1jhjb[hMVhj [ubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hj[h]h void *entry}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj[ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMWhj[ubj)}(hhh]h)}(h New entry.h]h New entry.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMWhj[ubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhj[hMWhj [ubj)}(h3``struct xa_limit limit`` Range of ID to allocate. h](j)}(h``struct xa_limit limit``h]j3)}(hj[h]hstruct xa_limit limit}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj[ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMXhj[ubj)}(hhh]h)}(hRange of ID to allocate.h]hRange of ID to allocate.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj[hMXhj[ubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhj[hMXhj [ubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hj[h]h gfp_t gfp}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj[ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMYhj[ubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj \hMYhj\ubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhj \hMYhj [ubeh}(h]h ]h"]h$]h&]uh1jhjZubh)}(h**Description**h]jF)}(hj3\h]h Description}(hj5\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj1\ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM[hjZubh)}(hFinds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**.h](hFinds an empty entry in }(hjI\hhhNhNubjF)}(h**xa**h]hxa}(hjQ\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjI\ubh between }(hjI\hhhNhNubjF)}(h **limit.min**h]h limit.min}(hjc\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjI\ubh and }(hjI\hhhNhNubjF)}(h **limit.max**h]h limit.max}(hju\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjI\ubh, stores the index into the }(hjI\hhhNhNubjF)}(h**id**h]hid}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjI\ubhb pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised }(hjI\hhhNhNubjF)}(h**id**h]hid}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjI\ubh.}(hjI\hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM[hjZubh)}(h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().h]h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM_hjZubh)}(h **Context**h]jF)}(hj\h]hContext}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj\ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMbhjZubh)}(hUAny context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit.h](h@Any context. Takes and releases the xa_lock. May sleep if the }(hj\hhhNhNubjF)}(h**gfp**h]hgfp}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj\ubh flags permit.}(hj\hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMbhjZubh)}(h **Return**h]jF)}(hj\h]hReturn}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj\ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMehjZubh)}(hk0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](ha0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in }(hj]hhhNhNubjF)}(h **limit**h]hlimit}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj]ubh.}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMdhjZubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_alloc_bh (C function) c.xa_alloc_bhhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h[int xa_alloc_bh (struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h]jI)}(hZint xa_alloc_bh(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h](jO)}(hinth]hint}(hjS]hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjO]hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjb]hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjO]hhhja]hMubj)}(h xa_alloc_bhh]j)}(h xa_alloc_bhh]h xa_alloc_bh}(hjt]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjp]ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjO]hhhja]hMubj)}(hK(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj]hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj]ubja)}(h h]h }(hj]hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj]ubh)}(hhh]j)}(hxarrayh]hxarray}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj]modnameN classnameNjt%jw%)}jz%]j}%)}jp%jv]sb c.xa_alloc_bhasbuh1hhj]ubja)}(h h]h }(hj]hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj]ubjr)}(hjh]h*}(hj]hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj]ubj)}(hxah]hxa}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj]ubj)}(hu32 *idh](h)}(hhh]j)}(hu32h]hu32}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj^modnameN classnameNjt%jw%)}jz%]j] c.xa_alloc_bhasbuh1hhj]ubja)}(h h]h }(hj#^hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj]ubjr)}(hjh]h*}(hj1^hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj]ubj)}(hidh]hid}(hj>^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj]ubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjW^hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjS^ubja)}(h h]h }(hje^hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjS^ubjr)}(hjh]h*}(hjs^hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjS^ubj)}(hentryh]hentry}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjS^ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj]ubj)}(hstruct xa_limit limith](je)}(hjh]hstruct}(hj^hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj^ubja)}(h h]h }(hj^hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj^ubh)}(hhh]j)}(hxa_limith]hxa_limit}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj^modnameN classnameNjt%jw%)}jz%]j] c.xa_alloc_bhasbuh1hhj^ubja)}(h h]h }(hj^hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj^ubj)}(hlimith]hlimit}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj]ubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj_modnameN classnameNjt%jw%)}jz%]j] c.xa_alloc_bhasbuh1hhj^ubja)}(h h]h }(hj_hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj^ubj)}(hgfph]hgfp}(hj+_hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj^ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj]ubeh}(h]h ]h"]h$]h&]hhuh1jhjO]hhhja]hMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjK]hhhja]hMubah}(h]jF]ah ](j j eh"]h$]h&]jj)jhuh1jBhja]hMhjH]hhubj)}(hhh]h)}(h1Find somewhere to store this entry in the XArray.h]h1Find somewhere to store this entry in the XArray.}(hjU_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMuhjR_hhubah}(h]h ]h"]h$]h&]uh1jhjH]hhhja]hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jm_j7jm_j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``u32 *id`` Pointer to ID. ``void *entry`` New entry. ``struct xa_limit limit`` Range of ID to allocate. ``gfp_t gfp`` Memory allocation flags. **Description** Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags(). **Context** Any context. Takes and releases the xa_lock while disabling softirqs. May sleep if the **gfp** flags permit. **Return** 0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h)}(h**Parameters**h]jF)}(hjw_h]h Parameters}(hjy_hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhju_ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMyhjq_ubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hj_h]hstruct xarray *xa}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj_ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMvhj_ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMvhj_ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhj_hMvhj_ubj)}(h``u32 *id`` Pointer to ID. h](j)}(h ``u32 *id``h]j3)}(hj_h]hu32 *id}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj_ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMwhj_ubj)}(hhh]h)}(hPointer to ID.h]hPointer to ID.}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_hMwhj_ubah}(h]h ]h"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]uh1jhj_hMwhj_ubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hj`h]h void *entry}(hj `hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj`ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMxhj`ubj)}(hhh]h)}(h New entry.h]h New entry.}(hj!`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMxhj`ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMxhj_ubj)}(h3``struct xa_limit limit`` Range of ID to allocate. h](j)}(h``struct xa_limit limit``h]j3)}(hjA`h]hstruct xa_limit limit}(hjC`hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj?`ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMyhj;`ubj)}(hhh]h)}(hRange of ID to allocate.h]hRange of ID to allocate.}(hjZ`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjV`hMyhjW`ubah}(h]h ]h"]h$]h&]uh1jhj;`ubeh}(h]h ]h"]h$]h&]uh1jhjV`hMyhj_ubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjz`h]h gfp_t gfp}(hj|`hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjx`ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMzhjt`ubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMzhj`ubah}(h]h ]h"]h$]h&]uh1jhjt`ubeh}(h]h ]h"]h$]h&]uh1jhj`hMzhj_ubeh}(h]h ]h"]h$]h&]uh1jhjq_ubh)}(h**Description**h]jF)}(hj`h]h Description}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj`ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM|hjq_ubh)}(hFinds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**.h](hFinds an empty entry in }(hj`hhhNhNubjF)}(h**xa**h]hxa}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj`ubh between }(hj`hhhNhNubjF)}(h **limit.min**h]h limit.min}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj`ubh and }(hj`hhhNhNubjF)}(h **limit.max**h]h limit.max}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj`ubh, stores the index into the }(hj`hhhNhNubjF)}(h**id**h]hid}(hj ahhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj`ubhb pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised }(hj`hhhNhNubjF)}(h**id**h]hid}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj`ubh.}(hj`hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM|hjq_ubh)}(h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().h]h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().}(hj4ahhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjq_ubh)}(h **Context**h]jF)}(hjEah]hContext}(hjGahhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjCaubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjq_ubh)}(hnAny context. Takes and releases the xa_lock while disabling softirqs. May sleep if the **gfp** flags permit.h](hYAny context. Takes and releases the xa_lock while disabling softirqs. May sleep if the }(hj[ahhhNhNubjF)}(h**gfp**h]hgfp}(hjcahhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj[aubh flags permit.}(hj[ahhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjq_ubh)}(h **Return**h]jF)}(hj~ah]hReturn}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj|aubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjq_ubh)}(hk0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](ha0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in }(hjahhhNhNubjF)}(h **limit**h]hlimit}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjaubh.}(hjahhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjq_ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_alloc_irq (C function)c.xa_alloc_irqhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h\int xa_alloc_irq (struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h]jI)}(h[int xa_alloc_irq(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h](jO)}(hinth]hint}(hjahhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjahhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjahhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjahhhjahMubj)}(h xa_alloc_irqh]j)}(h xa_alloc_irqh]h xa_alloc_irq}(hjahhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjaubah}(h]h ](jjeh"]h$]h&]hhuh1jhjahhhjahMubj)}(hK(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjbhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjbubja)}(h h]h }(hjbhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjbubh)}(hhh]j)}(hxarrayh]hxarray}(hj0bhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-bubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj2bmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jasbc.xa_alloc_irqasbuh1hhjbubja)}(h h]h }(hjPbhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjbubjr)}(hjh]h*}(hj^bhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjbubj)}(hxah]hxa}(hjkbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj bubj)}(hu32 *idh](h)}(hhh]j)}(hu32h]hu32}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjbmodnameN classnameNjt%jw%)}jz%]jLbc.xa_alloc_irqasbuh1hhjbubja)}(h h]h }(hjbhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjbubjr)}(hjh]h*}(hjbhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjbubj)}(hidh]hid}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj bubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjbhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjbubja)}(h h]h }(hjbhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjbubjr)}(hjh]h*}(hjbhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjbubj)}(hentryh]hentry}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj bubj)}(hstruct xa_limit limith](je)}(hjh]hstruct}(hjchhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjcubja)}(h h]h }(hj(chhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjcubh)}(hhh]j)}(hxa_limith]hxa_limit}(hj9chhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6cubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj;cmodnameN classnameNjt%jw%)}jz%]jLbc.xa_alloc_irqasbuh1hhjcubja)}(h h]h }(hjWchhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjcubj)}(hlimith]hlimit}(hjechhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj bubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~cubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjcmodnameN classnameNjt%jw%)}jz%]jLbc.xa_alloc_irqasbuh1hhjzcubja)}(h h]h }(hjchhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjzcubj)}(hgfph]hgfp}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzcubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj bubeh}(h]h ]h"]h$]h&]hhuh1jhjahhhjahMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjahhhjahMubah}(h]jaah ](j j eh"]h$]h&]jj)jhuh1jBhjahMhjahhubj)}(hhh]h)}(h1Find somewhere to store this entry in the XArray.h]h1Find somewhere to store this entry in the XArray.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjchhubah}(h]h ]h"]h$]h&]uh1jhjahhhjahMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jcj7jcj8j9j:uh1j=hhhjhNhNubj<)}(hX **Parameters** ``struct xarray *xa`` XArray. ``u32 *id`` Pointer to ID. ``void *entry`` New entry. ``struct xa_limit limit`` Range of ID to allocate. ``gfp_t gfp`` Memory allocation flags. **Description** Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags(). **Context** Process context. Takes and releases the xa_lock while disabling interrupts. May sleep if the **gfp** flags permit. **Return** 0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h)}(h**Parameters**h]jF)}(hjch]h Parameters}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjcubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjcubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjdh]hstruct xarray *xa}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjdubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjdubj)}(hhh]h)}(hXArray.h]hXArray.}(hj1dhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-dhMhj.dubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhj-dhMhjdubj)}(h``u32 *id`` Pointer to ID. h](j)}(h ``u32 *id``h]j3)}(hjQdh]hu32 *id}(hjSdhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjOdubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjKdubj)}(hhh]h)}(hPointer to ID.h]hPointer to ID.}(hjjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfdhMhjgdubah}(h]h ]h"]h$]h&]uh1jhjKdubeh}(h]h ]h"]h$]h&]uh1jhjfdhMhjdubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjdh]h void *entry}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjdubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjdubj)}(hhh]h)}(h New entry.h]h New entry.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhMhjdubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjdhMhjdubj)}(h3``struct xa_limit limit`` Range of ID to allocate. h](j)}(h``struct xa_limit limit``h]j3)}(hjdh]hstruct xa_limit limit}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjdubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjdubj)}(hhh]h)}(hRange of ID to allocate.h]hRange of ID to allocate.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjdhMhjdubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjdhMhjdubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjdh]h gfp_t gfp}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjdubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjdubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehMhjeubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjehMhjdubeh}(h]h ]h"]h$]h&]uh1jhjcubh)}(h**Description**h]jF)}(hj7eh]h Description}(hj9ehhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5eubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjcubh)}(hFinds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**.h](hFinds an empty entry in }(hjMehhhNhNubjF)}(h**xa**h]hxa}(hjUehhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjMeubh between }(hjMehhhNhNubjF)}(h **limit.min**h]h limit.min}(hjgehhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjMeubh and }(hjMehhhNhNubjF)}(h **limit.max**h]h limit.max}(hjyehhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjMeubh, stores the index into the }(hjMehhhNhNubjF)}(h**id**h]hid}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjMeubhb pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised }(hjMehhhNhNubjF)}(h**id**h]hid}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjMeubh.}(hjMehhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjcubh)}(h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().h]h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjcubh)}(h **Context**h]jF)}(hjeh]hContext}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjeubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjcubh)}(htProcess context. Takes and releases the xa_lock while disabling interrupts. May sleep if the **gfp** flags permit.h](h_Process context. Takes and releases the xa_lock while disabling interrupts. May sleep if the }(hjehhhNhNubjF)}(h**gfp**h]hgfp}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjeubh flags permit.}(hjehhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjcubh)}(h **Return**h]jF)}(hjfh]hReturn}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjeubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjcubh)}(hk0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](ha0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in }(hjfhhhNhNubjF)}(h **limit**h]hlimit}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjfubh.}(hjfhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjcubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_alloc_cyclic (C function)c.xa_alloc_cyclichNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hjint xa_alloc_cyclic (struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h]jI)}(hiint xa_alloc_cyclic(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h](jO)}(hinth]hint}(hjWfhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjSfhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjffhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjSfhhhjefhMubj)}(hxa_alloc_cyclich]j)}(hxa_alloc_cyclich]hxa_alloc_cyclic}(hjxfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtfubah}(h]h ](jjeh"]h$]h&]hhuh1jhjSfhhhjefhMubj)}(hV(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjfhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjfubja)}(h h]h }(hjfhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjfubh)}(hhh]j)}(hxarrayh]hxarray}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjfmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jzfsbc.xa_alloc_cyclicasbuh1hhjfubja)}(h h]h }(hjfhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjfubjr)}(hjh]h*}(hjfhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjfubj)}(hxah]hxa}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjfubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjfubj)}(hu32 *idh](h)}(hhh]j)}(hu32h]hu32}(hj ghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj gmodnameN classnameNjt%jw%)}jz%]jfc.xa_alloc_cyclicasbuh1hhjgubja)}(h h]h }(hj'ghhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjgubjr)}(hjh]h*}(hj5ghhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjgubj)}(hidh]hid}(hjBghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjfubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hj[ghhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjWgubja)}(h h]h }(hjighhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjWgubjr)}(hjh]h*}(hjwghhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjWgubj)}(hentryh]hentry}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWgubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjfubj)}(hstruct xa_limit limith](je)}(hjh]hstruct}(hjghhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjgubja)}(h h]h }(hjghhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjgubh)}(hhh]j)}(hxa_limith]hxa_limit}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjgmodnameN classnameNjt%jw%)}jz%]jfc.xa_alloc_cyclicasbuh1hhjgubja)}(h h]h }(hjghhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjgubj)}(hlimith]hlimit}(hjghhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjfubj)}(h u32 *nexth](h)}(hhh]j)}(hu32h]hu32}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjhmodnameN classnameNjt%jw%)}jz%]jfc.xa_alloc_cyclicasbuh1hhjgubja)}(h h]h }(hj!hhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjgubjr)}(hjh]h*}(hj/hhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjgubj)}(hnexth]hnext}(hjiubah}(h]h ]h"]h$]h&]uh1jhj"iubeh}(h]h ]h"]h$]h&]uh1jhj=ihMhjhubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjaih]h void *entry}(hjcihhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj_iubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj[iubj)}(hhh]h)}(h New entry.h]h New entry.}(hjzihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvihMhjwiubah}(h]h ]h"]h$]h&]uh1jhj[iubeh}(h]h ]h"]h$]h&]uh1jhjvihMhjhubj)}(h1``struct xa_limit limit`` Range of allocated ID. h](j)}(h``struct xa_limit limit``h]j3)}(hjih]hstruct xa_limit limit}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjiubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjiubj)}(hhh]h)}(hRange of allocated ID.h]hRange of allocated ID.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjihMhjiubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjihMhjhubj)}(h.``u32 *next`` Pointer to next ID to allocate. h](j)}(h ``u32 *next``h]j3)}(hjih]h u32 *next}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjiubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjiubj)}(hhh]h)}(hPointer to next ID to allocate.h]hPointer to next ID to allocate.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjihMhjiubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjihMhjhubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hj jh]h gfp_t gfp}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj jubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjjubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hj%jhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!jhMhj"jubah}(h]h ]h"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]uh1jhj!jhMhjhubeh}(h]h ]h"]h$]h&]uh1jhjhubh)}(h**Description**h]jF)}(hjGjh]h Description}(hjIjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjEjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhubh)}(hX)Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. The search for an empty entry will start at **next** and will wrap around if necessary.h](hFinds an empty entry in }(hj]jhhhNhNubjF)}(h**xa**h]hxa}(hjejhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj]jubh between }(hj]jhhhNhNubjF)}(h **limit.min**h]h limit.min}(hjwjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj]jubh and }(hj]jhhhNhNubjF)}(h **limit.max**h]h limit.max}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj]jubh, stores the index into the }(hj]jhhhNhNubjF)}(h**id**h]hid}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj]jubhb pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised }(hj]jhhhNhNubjF)}(h**id**h]hid}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj]jubh.. The search for an empty entry will start at }(hj]jhhhNhNubjF)}(h**next**h]hnext}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj]jubh# and will wrap around if necessary.}(hj]jhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhubh)}(h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().h]h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhubh)}(h **Context**h]jF)}(hjjh]hContext}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhubh)}(hUAny context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit.h](h@Any context. Takes and releases the xa_lock. May sleep if the }(hjjhhhNhNubjF)}(h**gfp**h]hgfp}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjjubh flags permit.}(hjjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhubh)}(h **Return**h]jF)}(hj"kh]hReturn}(hj$khhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj kubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhubh)}(h0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in }(hj8khhhNhNubjF)}(h **limit**h]hlimit}(hj@khhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj8kubh.}(hj8khhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_alloc_cyclic_bh (C function)c.xa_alloc_cyclic_bhhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hmint xa_alloc_cyclic_bh (struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h]jI)}(hlint xa_alloc_cyclic_bh(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h](jO)}(hinth]hint}(hjykhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjukhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjkhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjukhhhjkhMubj)}(hxa_alloc_cyclic_bhh]j)}(hxa_alloc_cyclic_bhh]hxa_alloc_cyclic_bh}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ](jjeh"]h$]h&]hhuh1jhjukhhhjkhMubj)}(hV(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjkhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjkubja)}(h h]h }(hjkhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjkubh)}(hhh]j)}(hxarrayh]hxarray}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjkmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jksbc.xa_alloc_cyclic_bhasbuh1hhjkubja)}(h h]h }(hjkhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjkubjr)}(hjh]h*}(hjlhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjkubj)}(hxah]hxa}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjkubj)}(hu32 *idh](h)}(hhh]j)}(hu32h]hu32}(hj+lhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(lubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj-lmodnameN classnameNjt%jw%)}jz%]jkc.xa_alloc_cyclic_bhasbuh1hhj$lubja)}(h h]h }(hjIlhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj$lubjr)}(hjh]h*}(hjWlhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj$lubj)}(hidh]hid}(hjdlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj$lubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjkubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hj}lhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjylubja)}(h h]h }(hjlhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjylubjr)}(hjh]h*}(hjlhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjylubj)}(hentryh]hentry}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjylubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjkubj)}(hstruct xa_limit limith](je)}(hjh]hstruct}(hjlhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjlubja)}(h h]h }(hjlhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjlubh)}(hhh]j)}(hxa_limith]hxa_limit}(hjlhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjlmodnameN classnameNjt%jw%)}jz%]jkc.xa_alloc_cyclic_bhasbuh1hhjlubja)}(h h]h }(hjlhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjlubj)}(hlimith]hlimit}(hj mhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjkubj)}(h u32 *nexth](h)}(hhh]j)}(hu32h]hu32}(hj%mhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"mubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj'mmodnameN classnameNjt%jw%)}jz%]jkc.xa_alloc_cyclic_bhasbuh1hhjmubja)}(h h]h }(hjCmhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjmubjr)}(hjh]h*}(hjQmhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjmubj)}(hnexth]hnext}(hj^mhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjkubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjzmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjwmubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj|mmodnameN classnameNjt%jw%)}jz%]jkc.xa_alloc_cyclic_bhasbuh1hhjsmubja)}(h h]h }(hjmhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjsmubj)}(hgfph]hgfp}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsmubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjkubeh}(h]h ]h"]h$]h&]hhuh1jhjukhhhjkhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjqkhhhjkhMubah}(h]jlkah ](j j eh"]h$]h&]jj)jhuh1jBhjkhMhjnkhhubj)}(hhh]h)}(h1Find somewhere to store this entry in the XArray.h]h1Find somewhere to store this entry in the XArray.}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjmhhubah}(h]h ]h"]h$]h&]uh1jhjnkhhhjkhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jmj7jmj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``u32 *id`` Pointer to ID. ``void *entry`` New entry. ``struct xa_limit limit`` Range of allocated ID. ``u32 *next`` Pointer to next ID to allocate. ``gfp_t gfp`` Memory allocation flags. **Description** Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. The search for an empty entry will start at **next** and will wrap around if necessary. Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags(). **Context** Any context. Takes and releases the xa_lock while disabling softirqs. May sleep if the **gfp** flags permit. **Return** 0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h)}(h**Parameters**h]jF)}(hjmh]h Parameters}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjmubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjmubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjnh]hstruct xarray *xa}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjnubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj nubj)}(hhh]h)}(hXArray.h]hXArray.}(hj*nhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj&nhMhj'nubah}(h]h ]h"]h$]h&]uh1jhj nubeh}(h]h ]h"]h$]h&]uh1jhj&nhMhjnubj)}(h``u32 *id`` Pointer to ID. h](j)}(h ``u32 *id``h]j3)}(hjJnh]hu32 *id}(hjLnhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjHnubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjDnubj)}(hhh]h)}(hPointer to ID.h]hPointer to ID.}(hjcnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj_nhMhj`nubah}(h]h ]h"]h$]h&]uh1jhjDnubeh}(h]h ]h"]h$]h&]uh1jhj_nhMhjnubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjnh]h void *entry}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjnubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj}nubj)}(hhh]h)}(h New entry.h]h New entry.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjnhMhjnubah}(h]h ]h"]h$]h&]uh1jhj}nubeh}(h]h ]h"]h$]h&]uh1jhjnhMhjnubj)}(h1``struct xa_limit limit`` Range of allocated ID. h](j)}(h``struct xa_limit limit``h]j3)}(hjnh]hstruct xa_limit limit}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjnubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjnubj)}(hhh]h)}(hRange of allocated ID.h]hRange of allocated ID.}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjnhMhjnubah}(h]h ]h"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]uh1jhjnhMhjnubj)}(h.``u32 *next`` Pointer to next ID to allocate. h](j)}(h ``u32 *next``h]j3)}(hjnh]h u32 *next}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjnubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjnubj)}(hhh]h)}(hPointer to next ID to allocate.h]hPointer to next ID to allocate.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ohMhj oubah}(h]h ]h"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]uh1jhj ohMhjnubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hj.oh]h gfp_t gfp}(hj0ohhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj,oubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj(oubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjGohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjCohMhjDoubah}(h]h ]h"]h$]h&]uh1jhj(oubeh}(h]h ]h"]h$]h&]uh1jhjCohMhjnubeh}(h]h ]h"]h$]h&]uh1jhjmubh)}(h**Description**h]jF)}(hjioh]h Description}(hjkohhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjgoubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjmubh)}(hX)Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. The search for an empty entry will start at **next** and will wrap around if necessary.h](hFinds an empty entry in }(hjohhhNhNubjF)}(h**xa**h]hxa}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjoubh between }(hjohhhNhNubjF)}(h **limit.min**h]h limit.min}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjoubh and }(hjohhhNhNubjF)}(h **limit.max**h]h limit.max}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjoubh, stores the index into the }(hjohhhNhNubjF)}(h**id**h]hid}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjoubhb pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised }(hjohhhNhNubjF)}(h**id**h]hid}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjoubh.. The search for an empty entry will start at }(hjohhhNhNubjF)}(h**next**h]hnext}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjoubh# and will wrap around if necessary.}(hjohhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjmubh)}(h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().h]h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjmubh)}(h **Context**h]jF)}(hj ph]hContext}(hj phhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj pubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjmubh)}(hnAny context. Takes and releases the xa_lock while disabling softirqs. May sleep if the **gfp** flags permit.h](hYAny context. Takes and releases the xa_lock while disabling softirqs. May sleep if the }(hj!phhhNhNubjF)}(h**gfp**h]hgfp}(hj)phhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj!pubh flags permit.}(hj!phhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjmubh)}(h **Return**h]jF)}(hjDph]hReturn}(hjFphhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjBpubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjmubh)}(h0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in }(hjZphhhNhNubjF)}(h **limit**h]hlimit}(hjbphhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjZpubh.}(hjZphhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjmubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9 xa_alloc_cyclic_irq (C function)c.xa_alloc_cyclic_irqhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hnint xa_alloc_cyclic_irq (struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h]jI)}(hmint xa_alloc_cyclic_irq(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h](jO)}(hinth]hint}(hjphhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjphhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjphhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjphhhjphMubj)}(hxa_alloc_cyclic_irqh]j)}(hxa_alloc_cyclic_irqh]hxa_alloc_cyclic_irq}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubah}(h]h ](jjeh"]h$]h&]hhuh1jhjphhhjphMubj)}(hV(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjphhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjpubja)}(h h]h }(hjphhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjpubh)}(hhh]j)}(hxarrayh]hxarray}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjpmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jpsbc.xa_alloc_cyclic_irqasbuh1hhjpubja)}(h h]h }(hjqhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjpubjr)}(hjh]h*}(hj$qhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjpubj)}(hxah]hxa}(hj1qhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjpubj)}(hu32 *idh](h)}(hhh]j)}(hu32h]hu32}(hjMqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJqubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjOqmodnameN classnameNjt%jw%)}jz%]jqc.xa_alloc_cyclic_irqasbuh1hhjFqubja)}(h h]h }(hjkqhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjFqubjr)}(hjh]h*}(hjyqhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjFqubj)}(hidh]hid}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFqubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjpubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjqhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjqubja)}(h h]h }(hjqhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjqubjr)}(hjh]h*}(hjqhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjqubj)}(hentryh]hentry}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjpubj)}(hstruct xa_limit limith](je)}(hjh]hstruct}(hjqhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjqubja)}(h h]h }(hjqhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjqubh)}(hhh]j)}(hxa_limith]hxa_limit}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjrmodnameN classnameNjt%jw%)}jz%]jqc.xa_alloc_cyclic_irqasbuh1hhjqubja)}(h h]h }(hjrhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjqubj)}(hlimith]hlimit}(hj+rhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjpubj)}(h u32 *nexth](h)}(hhh]j)}(hu32h]hu32}(hjGrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDrubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjIrmodnameN classnameNjt%jw%)}jz%]jqc.xa_alloc_cyclic_irqasbuh1hhj@rubja)}(h h]h }(hjerhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj@rubjr)}(hjh]h*}(hjsrhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj@rubj)}(hnexth]hnext}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@rubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjpubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjrmodnameN classnameNjt%jw%)}jz%]jqc.xa_alloc_cyclic_irqasbuh1hhjrubja)}(h h]h }(hjrhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjrubj)}(hgfph]hgfp}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjpubeh}(h]h ]h"]h$]h&]hhuh1jhjphhhjphMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjphhhjphMubah}(h]jpah ](j j eh"]h$]h&]jj)jhuh1jBhjphMhjphhubj)}(hhh]h)}(h1Find somewhere to store this entry in the XArray.h]h1Find somewhere to store this entry in the XArray.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjrhhubah}(h]h ]h"]h$]h&]uh1jhjphhhjphMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j sj7j sj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``u32 *id`` Pointer to ID. ``void *entry`` New entry. ``struct xa_limit limit`` Range of allocated ID. ``u32 *next`` Pointer to next ID to allocate. ``gfp_t gfp`` Memory allocation flags. **Description** Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. The search for an empty entry will start at **next** and will wrap around if necessary. Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags(). **Context** Process context. Takes and releases the xa_lock while disabling interrupts. May sleep if the **gfp** flags permit. **Return** 0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h)}(h**Parameters**h]jF)}(hjsh]h Parameters}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjsubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjsubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hj3sh]hstruct xarray *xa}(hj5shhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj1subah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj-subj)}(hhh]h)}(hXArray.h]hXArray.}(hjLshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHshMhjIsubah}(h]h ]h"]h$]h&]uh1jhj-subeh}(h]h ]h"]h$]h&]uh1jhjHshMhj*subj)}(h``u32 *id`` Pointer to ID. h](j)}(h ``u32 *id``h]j3)}(hjlsh]hu32 *id}(hjnshhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjjsubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjfsubj)}(hhh]h)}(hPointer to ID.h]hPointer to ID.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshMhjsubah}(h]h ]h"]h$]h&]uh1jhjfsubeh}(h]h ]h"]h$]h&]uh1jhjshMhj*subj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjsh]h void *entry}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjsubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjsubj)}(hhh]h)}(h New entry.h]h New entry.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshMhjsubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjshMhj*subj)}(h1``struct xa_limit limit`` Range of allocated ID. h](j)}(h``struct xa_limit limit``h]j3)}(hjsh]hstruct xa_limit limit}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjsubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjsubj)}(hhh]h)}(hRange of allocated ID.h]hRange of allocated ID.}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhjshMhjsubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjshMhj*subj)}(h.``u32 *next`` Pointer to next ID to allocate. h](j)}(h ``u32 *next``h]j3)}(hjth]h u32 *next}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjtubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjtubj)}(hhh]h)}(hPointer to next ID to allocate.h]hPointer to next ID to allocate.}(hj0thhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,thMhj-tubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhj,thMhj*subj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjPth]h gfp_t gfp}(hjRthhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjNtubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjJtubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjithhhNhNubah}(h]h ]h"]h$]h&]uh1hhjethMhjftubah}(h]h ]h"]h$]h&]uh1jhjJtubeh}(h]h ]h"]h$]h&]uh1jhjethMhj*subeh}(h]h ]h"]h$]h&]uh1jhjsubh)}(h**Description**h]jF)}(hjth]h Description}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjtubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM hjsubh)}(hX)Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. The search for an empty entry will start at **next** and will wrap around if necessary.h](hFinds an empty entry in }(hjthhhNhNubjF)}(h**xa**h]hxa}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjtubh between }(hjthhhNhNubjF)}(h **limit.min**h]h limit.min}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjtubh and }(hjthhhNhNubjF)}(h **limit.max**h]h limit.max}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjtubh, stores the index into the }(hjthhhNhNubjF)}(h**id**h]hid}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjtubhb pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised }(hjthhhNhNubjF)}(h**id**h]hid}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjtubh.. The search for an empty entry will start at }(hjthhhNhNubjF)}(h**next**h]hnext}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjtubh# and will wrap around if necessary.}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM hjsubh)}(h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().h]h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjsubh)}(h **Context**h]jF)}(hj-uh]hContext}(hj/uhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj+uubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjsubh)}(htProcess context. Takes and releases the xa_lock while disabling interrupts. May sleep if the **gfp** flags permit.h](h_Process context. Takes and releases the xa_lock while disabling interrupts. May sleep if the }(hjCuhhhNhNubjF)}(h**gfp**h]hgfp}(hjKuhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjCuubh flags permit.}(hjCuhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjsubh)}(h **Return**h]jF)}(hjfuh]hReturn}(hjhuhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjduubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjsubh)}(h0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in }(hj|uhhhNhNubjF)}(h **limit**h]hlimit}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj|uubh.}(hj|uhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjsubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_reserve (C function) c.xa_reservehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hBint xa_reserve (struct xarray *xa, unsigned long index, gfp_t gfp)h]jI)}(hAint xa_reserve(struct xarray *xa, unsigned long index, gfp_t gfp)h](jO)}(hinth]hint}(hjuhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjuhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM7ubja)}(h h]h }(hjuhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjuhhhjuhM7ubj)}(h xa_reserveh]j)}(h xa_reserveh]h xa_reserve}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubah}(h]h ](jjeh"]h$]h&]hhuh1jhjuhhhjuhM7ubj)}(h3(struct xarray *xa, unsigned long index, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjuhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjuubja)}(h h]h }(hjvhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjuubh)}(hhh]j)}(hxarrayh]hxarray}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjvmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jusb c.xa_reserveasbuh1hhjuubja)}(h h]h }(hj8vhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjuubjr)}(hjh]h*}(hjFvhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjuubj)}(hxah]hxa}(hjSvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjuubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjlvhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhvubja)}(h h]h }(hjzvhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhvubjO)}(hlongh]hlong}(hjvhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhvubja)}(h h]h }(hjvhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhvubj)}(hindexh]hindex}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhvubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjuubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjvmodnameN classnameNjt%jw%)}jz%]j4v c.xa_reserveasbuh1hhjvubja)}(h h]h }(hjvhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjvubj)}(hgfph]hgfp}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjuubeh}(h]h ]h"]h$]h&]hhuh1jhjuhhhjuhM7ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjuhhhjuhM7ubah}(h]juah ](j j eh"]h$]h&]jj)jhuh1jBhjuhM7hjuhhubj)}(hhh]h)}(h!Reserve this index in the XArray.h]h!Reserve this index in the XArray.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM&hjwhhubah}(h]h ]h"]h$]h&]uh1jhjuhhhjuhM7ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j.wj7j.wj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``gfp_t gfp`` Memory allocation flags. **Description** Ensures there is somewhere to store an entry at **index** in the array. If there is already something stored at **index**, this function does nothing. If there was nothing there, the entry is marked as reserved. Loading from a reserved entry returns a ``NULL`` pointer. If you do not use the entry that you have reserved, call xa_release() or xa_erase() to free any unnecessary memory. **Context** Any context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit. **Return** 0 if the reservation succeeded or -ENOMEM if it failed.h](h)}(h**Parameters**h]jF)}(hj8wh]h Parameters}(hj:whhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj6wubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM*hj2wubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjWwh]hstruct xarray *xa}(hjYwhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjUwubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM'hjQwubj)}(hhh]h)}(hXArray.h]hXArray.}(hjpwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlwhM'hjmwubah}(h]h ]h"]h$]h&]uh1jhjQwubeh}(h]h ]h"]h$]h&]uh1jhjlwhM'hjNwubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hjwh]hunsigned long index}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjwubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM(hjwubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhM(hjwubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjwhM(hjNwubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjwh]h gfp_t gfp}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjwubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM)hjwubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhM)hjwubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjwhM)hjNwubeh}(h]h ]h"]h$]h&]uh1jhj2wubh)}(h**Description**h]jF)}(hjxh]h Description}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjxubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM+hj2wubh)}(hXEnsures there is somewhere to store an entry at **index** in the array. If there is already something stored at **index**, this function does nothing. If there was nothing there, the entry is marked as reserved. Loading from a reserved entry returns a ``NULL`` pointer.h](h0Ensures there is somewhere to store an entry at }(hjxhhhNhNubjF)}(h **index**h]hindex}(hj"xhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjxubh7 in the array. If there is already something stored at }(hjxhhhNhNubjF)}(h **index**h]hindex}(hj4xhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjxubh, this function does nothing. If there was nothing there, the entry is marked as reserved. Loading from a reserved entry returns a }(hjxhhhNhNubj3)}(h``NULL``h]hNULL}(hjFxhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjxubh pointer.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM+hj2wubh)}(hsIf you do not use the entry that you have reserved, call xa_release() or xa_erase() to free any unnecessary memory.h]hsIf you do not use the entry that you have reserved, call xa_release() or xa_erase() to free any unnecessary memory.}(hj_xhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM0hj2wubh)}(h **Context**h]jF)}(hjpxh]hContext}(hjrxhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjnxubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM3hj2wubh)}(hTAny context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit.h](h?Any context. Takes and releases the xa_lock. May sleep if the }(hjxhhhNhNubjF)}(h**gfp**h]hgfp}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjxubh flags permit.}(hjxhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM3hj2wubh)}(h **Return**h]jF)}(hjxh]hReturn}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjxubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM6hj2wubh)}(h70 if the reservation succeeded or -ENOMEM if it failed.h]h70 if the reservation succeeded or -ENOMEM if it failed.}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM5hj2wubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_reserve_bh (C function)c.xa_reserve_bhhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hEint xa_reserve_bh (struct xarray *xa, unsigned long index, gfp_t gfp)h]jI)}(hDint xa_reserve_bh(struct xarray *xa, unsigned long index, gfp_t gfp)h](jO)}(hinth]hint}(hjxhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjxhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMIubja)}(h h]h }(hjxhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjxhhhjxhMIubj)}(h xa_reserve_bhh]j)}(h xa_reserve_bhh]h xa_reserve_bh}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj yubah}(h]h ](jjeh"]h$]h&]hhuh1jhjxhhhjxhMIubj)}(h3(struct xarray *xa, unsigned long index, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj+yhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj'yubja)}(h h]h }(hj8yhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj'yubh)}(hhh]j)}(hxarrayh]hxarray}(hjIyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFyubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjKymodnameN classnameNjt%jw%)}jz%]j}%)}jp%jysbc.xa_reserve_bhasbuh1hhj'yubja)}(h h]h }(hjiyhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj'yubjr)}(hjh]h*}(hjwyhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj'yubj)}(hxah]hxa}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj'yubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj#yubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjyhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjyubja)}(h h]h }(hjyhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjyubjO)}(hlongh]hlong}(hjyhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjyubja)}(h h]h }(hjyhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjyubj)}(hindexh]hindex}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj#yubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjymodnameN classnameNjt%jw%)}jz%]jeyc.xa_reserve_bhasbuh1hhjyubja)}(h h]h }(hjzhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjyubj)}(hgfph]hgfp}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjyubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj#yubeh}(h]h ]h"]h$]h&]hhuh1jhjxhhhjxhMIubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjxhhhjxhMIubah}(h]jxah ](j j eh"]h$]h&]jj)jhuh1jBhjxhMIhjxhhubj)}(hhh]h)}(h!Reserve this index in the XArray.h]h!Reserve this index in the XArray.}(hjGzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM>hjDzhhubah}(h]h ]h"]h$]h&]uh1jhjxhhhjxhMIubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j_zj7j_zj8j9j:uh1j=hhhjhNhNubj<)}(hX_**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``gfp_t gfp`` Memory allocation flags. **Description** A softirq-disabling version of xa_reserve(). **Context** Any context. Takes and releases the xa_lock while disabling softirqs. **Return** 0 if the reservation succeeded or -ENOMEM if it failed.h](h)}(h**Parameters**h]jF)}(hjizh]h Parameters}(hjkzhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjgzubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMBhjczubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjzh]hstruct xarray *xa}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjzubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM?hjzubj)}(hhh]h)}(hXArray.h]hXArray.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhM?hjzubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhjzhM?hjzubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hjzh]hunsigned long index}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjzubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM@hjzubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjzhM@hjzubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhjzhM@hjzubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjzh]h gfp_t gfp}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjzubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMAhjzubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hMAhj{ubah}(h]h ]h"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]uh1jhj{hMAhjzubeh}(h]h ]h"]h$]h&]uh1jhjczubh)}(h**Description**h]jF)}(hj5{h]h Description}(hj7{hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj3{ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMChjczubh)}(h,A softirq-disabling version of xa_reserve().h]h,A softirq-disabling version of xa_reserve().}(hjK{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMChjczubh)}(h **Context**h]jF)}(hj\{h]hContext}(hj^{hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjZ{ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMEhjczubh)}(hFAny context. Takes and releases the xa_lock while disabling softirqs.h]hFAny context. Takes and releases the xa_lock while disabling softirqs.}(hjr{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMEhjczubh)}(h **Return**h]jF)}(hj{h]hReturn}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj{ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMHhjczubh)}(h70 if the reservation succeeded or -ENOMEM if it failed.h]h70 if the reservation succeeded or -ENOMEM if it failed.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMGhjczubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_reserve_irq (C function)c.xa_reserve_irqhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hFint xa_reserve_irq (struct xarray *xa, unsigned long index, gfp_t gfp)h]jI)}(hEint xa_reserve_irq(struct xarray *xa, unsigned long index, gfp_t gfp)h](jO)}(hinth]hint}(hj{hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj{hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM[ubja)}(h h]h }(hj{hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj{hhhj{hM[ubj)}(hxa_reserve_irqh]j)}(hxa_reserve_irqh]hxa_reserve_irq}(hj{hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj{hhhj{hM[ubj)}(h3(struct xarray *xa, unsigned long index, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj|hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj|ubja)}(h h]h }(hj|hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj|ubh)}(hhh]j)}(hxarrayh]hxarray}(hj#|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj |ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj%|modnameN classnameNjt%jw%)}jz%]j}%)}jp%j{sbc.xa_reserve_irqasbuh1hhj|ubja)}(h h]h }(hjC|hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj|ubjr)}(hjh]h*}(hjQ|hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj|ubj)}(hxah]hxa}(hj^|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj{ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjw|hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjs|ubja)}(h h]h }(hj|hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjs|ubjO)}(hlongh]hlong}(hj|hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjs|ubja)}(h h]h }(hj|hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjs|ubj)}(hindexh]hindex}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjs|ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj{ubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj|modnameN classnameNjt%jw%)}jz%]j?|c.xa_reserve_irqasbuh1hhj|ubja)}(h h]h }(hj|hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj|ubj)}(hgfph]hgfp}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj{ubeh}(h]h ]h"]h$]h&]hhuh1jhj{hhhj{hM[ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj{hhhj{hM[ubah}(h]j{ah ](j j eh"]h$]h&]jj)jhuh1jBhj{hM[hj{hhubj)}(hhh]h)}(h!Reserve this index in the XArray.h]h!Reserve this index in the XArray.}(hj!}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMPhj}hhubah}(h]h ]h"]h$]h&]uh1jhj{hhhj{hM[ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j9}j7j9}j8j9j:uh1j=hhhjhNhNubj<)}(hXh**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``gfp_t gfp`` Memory allocation flags. **Description** An interrupt-disabling version of xa_reserve(). **Context** Process context. Takes and releases the xa_lock while disabling interrupts. **Return** 0 if the reservation succeeded or -ENOMEM if it failed.h](h)}(h**Parameters**h]jF)}(hjC}h]h Parameters}(hjE}hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjA}ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMThj=}ubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjb}h]hstruct xarray *xa}(hjd}hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj`}ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMQhj\}ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj{}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjw}hMQhjx}ubah}(h]h ]h"]h$]h&]uh1jhj\}ubeh}(h]h ]h"]h$]h&]uh1jhjw}hMQhjY}ubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hj}h]hunsigned long index}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj}ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMRhj}ubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}hMRhj}ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj}hMRhjY}ubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hj}h]h gfp_t gfp}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj}ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMShj}ubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}hMShj}ubah}(h]h ]h"]h$]h&]uh1jhj}ubeh}(h]h ]h"]h$]h&]uh1jhj}hMShjY}ubeh}(h]h ]h"]h$]h&]uh1jhj=}ubh)}(h**Description**h]jF)}(hj~h]h Description}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ~ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMUhj=}ubh)}(h/An interrupt-disabling version of xa_reserve().h]h/An interrupt-disabling version of xa_reserve().}(hj%~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMUhj=}ubh)}(h **Context**h]jF)}(hj6~h]hContext}(hj8~hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj4~ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMWhj=}ubh)}(hLProcess context. Takes and releases the xa_lock while disabling interrupts.h]hLProcess context. Takes and releases the xa_lock while disabling interrupts.}(hjL~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMWhj=}ubh)}(h **Return**h]jF)}(hj]~h]hReturn}(hj_~hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj[~ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMZhj=}ubh)}(h70 if the reservation succeeded or -ENOMEM if it failed.h]h70 if the reservation succeeded or -ENOMEM if it failed.}(hjs~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMYhj=}ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_release (C function) c.xa_releasehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h8void xa_release (struct xarray *xa, unsigned long index)h]jI)}(h7void xa_release(struct xarray *xa, unsigned long index)h](jO)}(hvoidh]hvoid}(hj~hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj~hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMjubja)}(h h]h }(hj~hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj~hhhj~hMjubj)}(h xa_releaseh]j)}(h xa_releaseh]h xa_release}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj~hhhj~hMjubj)}(h((struct xarray *xa, unsigned long index)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj~hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj~ubja)}(h h]h }(hj~hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj~ubh)}(hhh]j)}(hxarrayh]hxarray}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj~modnameN classnameNjt%jw%)}jz%]j}%)}jp%j~sb c.xa_releaseasbuh1hhj~ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj~ubjr)}(hjh]h*}(hj+hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj~ubj)}(hxah]hxa}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj~ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjQhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjMubja)}(h h]h }(hj_hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjMubjO)}(hlongh]hlong}(hjmhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjMubja)}(h h]h }(hj{hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjMubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj~ubeh}(h]h ]h"]h$]h&]hhuh1jhj~hhhj~hMjubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj~hhhj~hMjubah}(h]j~ah ](j j eh"]h$]h&]jj)jhuh1jBhj~hMjhj~hhubj)}(hhh]h)}(hRelease a reserved entry.h]hRelease a reserved entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMbhjhhubah}(h]h ]h"]h$]h&]uh1jhj~hhhj~hMjubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX **Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index of entry. **Description** After calling xa_reserve(), you can call this function to release the reservation. If the entry at **index** has been stored to, this function will do nothing.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMfhjubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMchjubj)}(hhh]h)}(hXArray.h]hXArray.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMchj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMchjubj)}(h(``unsigned long index`` Index of entry. h](j)}(h``unsigned long index``h]j3)}(hj-h]hunsigned long index}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj+ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMdhj'ubj)}(hhh]h)}(hIndex of entry.h]hIndex of entry.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjBhMdhjCubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhjBhMdhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjhh]h Description}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjfubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMfhjubh)}(hAfter calling xa_reserve(), you can call this function to release the reservation. If the entry at **index** has been stored to, this function will do nothing.h](hdAfter calling xa_reserve(), you can call this function to release the reservation. If the entry at }(hj~hhhNhNubjF)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj~ubh3 has been stored to, this function will do nothing.}(hj~hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMfhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_is_sibling (C function)c.xa_is_siblinghNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h&bool xa_is_sibling (const void *entry)h]jI)}(h%bool xa_is_sibling(const void *entry)h](jO)}(hjh]hbool}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hj̀hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhj̀hMubj)}(h xa_is_siblingh]j)}(h xa_is_siblingh]h xa_is_sibling}(hj߀hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjۀubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhj̀hMubj)}(h(const void *entry)h]j)}(hconst void *entryh](je)}(hjhh]hconst}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj$hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj2hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhj̀hMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhj̀hMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhj̀hMhjhhubj)}(hhh]h)}(hIs the entry a sibling entry?h]hIs the entry a sibling entry?}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjfhhubah}(h]h ]h"]h$]h&]uh1jhjhhhj̀hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h~**Parameters** ``const void *entry`` Entry retrieved from the XArray **Return** ``true`` if the entry is a sibling entry.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]j)}(h6``const void *entry`` Entry retrieved from the XArray h](j)}(h``const void *entry``h]j3)}(hjh]hconst void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(hEntry retrieved from the XArrayh]hEntry retrieved from the XArray}(hjÁhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(h)``true`` if the entry is a sibling entry.h](j3)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh! if the entry is a sibling entry.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_is_retry (C function) c.xa_is_retryhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h$bool xa_is_retry (const void *entry)h]jI)}(h#bool xa_is_retry(const void *entry)h](jO)}(hjh]hbool}(hj8hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj4hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjFhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj4hhhjEhMubj)}(h xa_is_retryh]j)}(h xa_is_retryh]h xa_is_retry}(hjXhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjTubah}(h]h ](jjeh"]h$]h&]hhuh1jhj4hhhjEhMubj)}(h(const void *entry)h]j)}(hconst void *entryh](je)}(hjhh]hconst}(hjthhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjpubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjpubjO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjpubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjpubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjpubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjlubah}(h]h ]h"]h$]h&]hhuh1jhj4hhhjEhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj0hhhjEhMubah}(h]j+ah ](j j eh"]h$]h&]jj)jhuh1jBhjEhMhj-hhubj)}(hhh]h)}(hIs the entry a retry entry?h]hIs the entry a retry entry?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj߂hhubah}(h]h ]h"]h$]h&]uh1jhj-hhhjEhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h|**Parameters** ``const void *entry`` Entry retrieved from the XArray **Return** ``true`` if the entry is a retry entry.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]j)}(h6``const void *entry`` Entry retrieved from the XArray h](j)}(h``const void *entry``h]j3)}(hj#h]hconst void *entry}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj!ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(hEntry retrieved from the XArrayh]hEntry retrieved from the XArray}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8hMhj9ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj8hMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]jF)}(hj^h]hReturn}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj\ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(h'``true`` if the entry is a retry entry.h](j3)}(h``true``h]htrue}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjtubh if the entry is a retry entry.}(hjthhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_is_advanced (C function)c.xa_is_advancedhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h'bool xa_is_advanced (const void *entry)h]jI)}(h&bool xa_is_advanced(const void *entry)h](jO)}(hjh]hbool}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubj)}(hxa_is_advancedh]j)}(hxa_is_advancedh]hxa_is_advanced}(hjуhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj̓ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h(const void *entry)h]j)}(hconst void *entryh](je)}(hjhh]hconst}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj$hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h1Is the entry only permitted for the advanced API?h]h1Is the entry only permitted for the advanced API?}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjXhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jsj7jsj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``const void *entry`` Entry to be stored in the XArray. **Return** ``true`` if the entry cannot be stored by the normal API.h](h)}(h**Parameters**h]jF)}(hj}h]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj{ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjwubj)}(hhh]j)}(h8``const void *entry`` Entry to be stored in the XArray. h](j)}(h``const void *entry``h]j3)}(hjh]hconst void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(h!Entry to be stored in the XArray.h]h!Entry to be stored in the XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjwubh)}(h **Return**h]jF)}(hjׄh]hReturn}(hjلhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjՄubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjwubh)}(h9``true`` if the entry cannot be stored by the normal API.h](j3)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh1 if the entry cannot be stored by the normal API.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjwubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_update_node_t (C macro)c.xa_update_node_thNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hxa_update_node_th]jI)}(hxa_update_node_th]j)}(hxa_update_node_th]j)}(hj$h]hxa_update_node_t}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj*ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj&hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubah}(h]h ]h"]h$]h&]hhjuh1jHjjhj"hhhjAhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjAhMhjhhubj)}(hhh]h)}(h1**Typedef**: A callback function from the XArray.h](jF)}(h **Typedef**h]hTypedef}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjQubh&: A callback function from the XArray.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM$hjNhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjAhMubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6jwj7jwj8j9j:uh1j=hhhjhNhNubh)}(h **Syntax**h]jF)}(hj}h]hSyntax}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj{ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM'hjhhubj )}(h1``void xa_update_node_t (struct xa_node *node)`` h]h)}(h0``void xa_update_node_t (struct xa_node *node)``h]j3)}(hjh]h,void xa_update_node_t (struct xa_node *node)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM)hjubah}(h]h ]h"]h$]h&]uh1j hjhM)hjhhubj<)}(hX**Parameters** ``struct xa_node *node`` The node which is being processed **Description** This function is called every time the XArray updates the count of present and value entries in a node. It allows advanced users to maintain the private_list in the node. **Context** The xa_lock is held and interrupts may be disabled. Implementations should not drop the xa_lock, nor re-enable interrupts.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM-hjubj)}(hhh]j)}(h;``struct xa_node *node`` The node which is being processed h](j)}(h``struct xa_node *node``h]j3)}(hjڅh]hstruct xa_node *node}(hj܅hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj؅ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM%hjԅubj)}(hhh]h)}(h!The node which is being processedh]h!The node which is being processed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM%hjubah}(h]h ]h"]h$]h&]uh1jhjԅubeh}(h]h ]h"]h$]h&]uh1jhjhM%hjхubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM'hjubh)}(hThis function is called every time the XArray updates the count of present and value entries in a node. It allows advanced users to maintain the private_list in the node.h]hThis function is called every time the XArray updates the count of present and value entries in a node. It allows advanced users to maintain the private_list in the node.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM'hjubh)}(h **Context**h]jF)}(hj<h]hContext}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj:ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM+hjubh)}(hzThe xa_lock is held and interrupts may be disabled. Implementations should not drop the xa_lock, nor re-enable interrupts.h]hzThe xa_lock is held and interrupts may be disabled. Implementations should not drop the xa_lock, nor re-enable interrupts.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM+hjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9XA_STATE (C macro) c.XA_STATEhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hXA_STATEh]jI)}(hXA_STATEh]j)}(hXA_STATEh]j)}(hj{h]hXA_STATE}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhj}hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMnubah}(h]h ]h"]h$]h&]hhjuh1jHjjhjyhhhjhMnubah}(h]jtah ](j j eh"]h$]h&]jj)jhuh1jBhjhMnhjvhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjvhhhjhMnubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubh)}(h!``XA_STATE (name, array, index)``h]j3)}(hjh]hXA_STATE (name, array, index)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMphjhhubj )}(h#Declare an XArray operation state. h]h)}(h"Declare an XArray operation state.h]h"Declare an XArray operation state.}(hjцhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMghj͆ubah}(h]h ]h"]h$]h&]uh1j hj߆hMghjhhubj<)}(h**Parameters** ``name`` Name of this operation state (usually xas). ``array`` Array to operate on. ``index`` Initial index of interest. **Description** Declare and initialise an xa_state on the stack.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMkhjubj)}(hhh](j)}(h5``name`` Name of this operation state (usually xas). h](j)}(h``name``h]j3)}(hj h]hname}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhhjubj)}(hhh]h)}(h+Name of this operation state (usually xas).h]h+Name of this operation state (usually xas).}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhhj!ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hMhhjubj)}(h``array`` Array to operate on. h](j)}(h ``array``h]j3)}(hjDh]harray}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjBubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMihj>ubj)}(hhh]h)}(hArray to operate on.h]hArray to operate on.}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYhMihjZubah}(h]h ]h"]h$]h&]uh1jhj>ubeh}(h]h ]h"]h$]h&]uh1jhjYhMihjubj)}(h%``index`` Initial index of interest. h](j)}(h ``index``h]j3)}(hj}h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj{ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMjhjwubj)}(hhh]h)}(hInitial index of interest.h]hInitial index of interest.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMjhjubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjhMjhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMlhjubh)}(h0Declare and initialise an xa_state on the stack.h]h0Declare and initialise an xa_state on the stack.}(hj·hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMlhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9XA_STATE_ORDER (C macro)c.XA_STATE_ORDERhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hXA_STATE_ORDERh]jI)}(hXA_STATE_ORDERh]j)}(hXA_STATE_ORDERh]j)}(hjh]hXA_STATE_ORDER}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM|ubah}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhM|ubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhM|hjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhM|ubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6j-j7j-j8j9j:uh1j=hhhjhNhNubh)}(h.``XA_STATE_ORDER (name, array, index, order)``h]j3)}(hj3h]h*XA_STATE_ORDER (name, array, index, order)}(hj5hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj1ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM~hjhhubj )}(h#Declare an XArray operation state. h]h)}(h"Declare an XArray operation state.h]h"Declare an XArray operation state.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMrhjIubah}(h]h ]h"]h$]h&]uh1j hj[hMrhjhhubj<)}(hXV**Parameters** ``name`` Name of this operation state (usually xas). ``array`` Array to operate on. ``index`` Initial index of interest. ``order`` Order of entry. **Description** Declare and initialise an xa_state on the stack. This variant of XA_STATE() allows you to specify the 'order' of the element you want to operate on.`h](h)}(h**Parameters**h]jF)}(hjhh]h Parameters}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjfubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMvhjbubj)}(hhh](j)}(h5``name`` Name of this operation state (usually xas). h](j)}(h``name``h]j3)}(hjh]hname}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMshjubj)}(hhh]h)}(h+Name of this operation state (usually xas).h]h+Name of this operation state (usually xas).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMshjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMshj~ubj)}(h``array`` Array to operate on. h](j)}(h ``array``h]j3)}(hjh]harray}(hjˆhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMthjubj)}(hhh]h)}(hArray to operate on.h]hArray to operate on.}(hjوhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjՈhMthjֈubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjՈhMthj~ubj)}(h%``index`` Initial index of interest. h](j)}(h ``index``h]j3)}(hjh]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMuhjubj)}(hhh]h)}(hInitial index of interest.h]hInitial index of interest.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMuhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMuhj~ubj)}(h``order`` Order of entry. h](j)}(h ``order``h]j3)}(hj2h]horder}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj0ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMvhj,ubj)}(hhh]h)}(hOrder of entry.h]hOrder of entry.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGhMvhjHubah}(h]h ]h"]h$]h&]uh1jhj,ubeh}(h]h ]h"]h$]h&]uh1jhjGhMvhj~ubeh}(h]h ]h"]h$]h&]uh1jhjbubh)}(h**Description**h]jF)}(hjmh]h Description}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjkubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMxhjbubh)}(hDeclare and initialise an xa_state on the stack. This variant of XA_STATE() allows you to specify the 'order' of the element you want to operate on.`h]hDeclare and initialise an xa_state on the stack. This variant of XA_STATE() allows you to specify the ‘order’ of the element you want to operate on.`}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMxhjbubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_error (C function) c.xas_errorhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h*int xas_error (const struct xa_state *xas)h]jI)}(h)int xas_error(const struct xa_state *xas)h](jO)}(hinth]hint}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubj)}(h xas_errorh]j)}(h xas_errorh]h xas_error}(hjӉhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjωubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h(const struct xa_state *xas)h]j)}(hconst struct xa_state *xash](je)}(hjhh]hconst}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubje)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj*modnameN classnameNjt%jw%)}jz%]j}%)}jp%jՉsb c.xas_errorasbuh1hhjubja)}(h h]h }(hjHhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjVhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h'Return an errno stored in the xa_state.h]h'Return an errno stored in the xa_state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``const struct xa_state *xas`` XArray operation state. **Return** 0 if no error has been noted. A negative errno if one has.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]j)}(h7``const struct xa_state *xas`` XArray operation state. h](j)}(h``const struct xa_state *xas``h]j3)}(hjΊh]hconst struct xa_state *xas}(hjЊhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj̊ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjȊubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjȊubeh}(h]h ]h"]h$]h&]uh1jhjhMhjŊubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]jF)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(h;0 if no error has been noted. A negative errno if one has.h]h;0 if no error has been noted. A negative errno if one has.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_set_err (C function) c.xas_set_errhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h1void xas_set_err (struct xa_state *xas, long err)h]jI)}(h0void xas_set_err(struct xa_state *xas, long err)h](jO)}(hvoidh]hvoid}(hjNhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjJhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hj]hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjJhhhj\hMubj)}(h xas_set_errh]j)}(h xas_set_errh]h xas_set_err}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ](jjeh"]h$]h&]hhuh1jhjJhhhj\hMubj)}(h (struct xa_state *xas, long err)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jqsb c.xas_set_errasbuh1hhjubja)}(h h]h }(hjɋhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj׋hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hlong errh](jO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(herrh]herr}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjJhhhj\hMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjFhhhj\hMubah}(h]jAah ](j j eh"]h$]h&]jj)jhuh1jBhj\hMhjChhubj)}(hhh]h)}(hNote an error in the xa_state.h]hNote an error in the xa_state.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj@hhubah}(h]h ]h"]h$]h&]uh1jhjChhhj\hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j[j7j[j8j9j:uh1j=hhhjhNhNubj<)}(hX?**Parameters** ``struct xa_state *xas`` XArray operation state. ``long err`` Negative error number. **Description** Only call this function with a negative **err**; zero or positive errors will probably not behave the way you think they should. If you want to clear the error from an xa_state, use xas_reset().h](h)}(h**Parameters**h]jF)}(hjeh]h Parameters}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjcubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj_ubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjh]hstruct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj~ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhMhj{ubj)}(h$``long err`` Negative error number. h](j)}(h ``long err``h]j3)}(hjh]hlong err}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(hNegative error number.h]hNegative error number.}(hj֌hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjҌhMhjӌubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjҌhMhj{ubeh}(h]h ]h"]h$]h&]uh1jhj_ubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj_ubh)}(hOnly call this function with a negative **err**; zero or positive errors will probably not behave the way you think they should. If you want to clear the error from an xa_state, use xas_reset().h](h(Only call this function with a negative }(hjhhhNhNubjF)}(h**err**h]herr}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh; zero or positive errors will probably not behave the way you think they should. If you want to clear the error from an xa_state, use xas_reset().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj_ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_invalid (C function) c.xas_invalidhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h-bool xas_invalid (const struct xa_state *xas)h]jI)}(h,bool xas_invalid(const struct xa_state *xas)h](jO)}(hjh]hbool}(hjOhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjKhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hj]hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjKhhhj\hMubj)}(h xas_invalidh]j)}(h xas_invalidh]h xas_invalid}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjkubah}(h]h ](jjeh"]h$]h&]hhuh1jhjKhhhj\hMubj)}(h(const struct xa_state *xas)h]j)}(hconst struct xa_state *xash](je)}(hjhh]hconst}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubje)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjčhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjƍmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jqsb c.xas_invalidasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjKhhhj\hMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjGhhhj\hMubah}(h]jBah ](j j eh"]h$]h&]jj)jhuh1jBhj\hMhjDhhubj)}(hhh]h)}(h%Is the xas in a retry or error state?h]h%Is the xas in a retry or error state?}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj&hhubah}(h]h ]h"]h$]h&]uh1jhjDhhhj\hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jAj7jAj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``const struct xa_state *xas`` XArray operation state. **Return** ``true`` if the xas cannot be used for operations.h](h)}(h**Parameters**h]jF)}(hjKh]h Parameters}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjIubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjEubj)}(hhh]j)}(h7``const struct xa_state *xas`` XArray operation state. h](j)}(h``const struct xa_state *xas``h]j3)}(hjjh]hconst struct xa_state *xas}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjhubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjdubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjdubeh}(h]h ]h"]h$]h&]uh1jhjhMhjaubah}(h]h ]h"]h$]h&]uh1jhjEubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjEubh)}(h2``true`` if the xas cannot be used for operations.h](j3)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh* if the xas cannot be used for operations.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjEubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_valid (C function) c.xas_validhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h+bool xas_valid (const struct xa_state *xas)h]jI)}(h*bool xas_valid(const struct xa_state *xas)h](jO)}(hjh]hbool}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubj)}(h xas_validh]j)}(h xas_validh]h xas_valid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h(const struct xa_state *xas)h]j)}(hconst struct xa_state *xash](je)}(hjhh]hconst}(hj4hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj0ubja)}(h h]h }(hjAhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj0ubje)}(hjh]hstruct}(hjOhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj0ubja)}(h h]h }(hj\hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj0ubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjmhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjomodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsb c.xas_validasbuh1hhj0ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj0ubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj0ubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj,ubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h)Is the xas a valid cursor into the array?h]h)Is the xas a valid cursor into the array?}(hjҏhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjϏhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``const struct xa_state *xas`` XArray operation state. **Return** ``true`` if the xas can be used for operations.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]j)}(h7``const struct xa_state *xas`` XArray operation state. h](j)}(h``const struct xa_state *xas``h]j3)}(hjh]hconst struct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj(hMhj)ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj(hMhj ubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]jF)}(hjNh]hReturn}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjLubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(h/``true`` if the xas can be used for operations.h](j3)}(h``true``h]htrue}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjdubh' if the xas can be used for operations.}(hjdhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_is_node (C function) c.xas_is_nodehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h-bool xas_is_node (const struct xa_state *xas)h]jI)}(h,bool xas_is_node(const struct xa_state *xas)h](jO)}(hjh]hbool}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubj)}(h xas_is_nodeh]j)}(h xas_is_nodeh]h xas_is_node}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h(const struct xa_state *xas)h]j)}(hconst struct xa_state *xash](je)}(hjhh]hconst}(hjݐhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjِubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjِubje)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjِubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjِubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jÐsb c.xas_is_nodeasbuh1hhjِubja)}(h h]h }(hj6hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjِubjr)}(hjh]h*}(hjDhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjِubj)}(hxash]hxas}(hjQhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjِubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjՐubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(hDoes the xas point to a node?h]hDoes the xas point to a node?}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjxhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``const struct xa_state *xas`` XArray operation state. **Return** ``true`` if the xas currently references a node.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]j)}(h7``const struct xa_state *xas`` XArray operation state. h](j)}(h``const struct xa_state *xas``h]j3)}(hjh]hconst struct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjՑhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjёhMhjґubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjёhMhjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(h0``true`` if the xas currently references a node.h](j3)}(h``true``h]htrue}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubh( if the xas currently references a node.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_reset (C function) c.xas_resethNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h%void xas_reset (struct xa_state *xas)h]jI)}(h$void xas_reset(struct xa_state *xas)h](jO)}(hvoidh]hvoid}(hjJhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjFhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjYhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjFhhhjXhMubj)}(h xas_reseth]j)}(h xas_reseth]h xas_reset}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubah}(h]h ](jjeh"]h$]h&]hhuh1jhjFhhhjXhMubj)}(h(struct xa_state *xas)h]j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jmsb c.xas_resetasbuh1hhjubja)}(h h]h }(hjŒhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjӒhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjFhhhjXhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjBhhhjXhMubah}(h]j=ah ](j j eh"]h$]h&]jj)jhuh1jBhjXhMhj?hhubj)}(hhh]h)}(h Reset an XArray operation state.h]h Reset an XArray operation state.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jhj?hhhjXhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j"j7j"j8j9j:uh1j=hhhjhNhNubj<)}(hX"**Parameters** ``struct xa_state *xas`` XArray operation state. **Description** Resets the error or walk state of the **xas** so future walks of the array will start from the root. Use this if you have dropped the xarray lock and want to reuse the xa_state. **Context** Any context.h](h)}(h**Parameters**h]jF)}(hj,h]h Parameters}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj*ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj&ubj)}(hhh]j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjKh]hstruct xa_state *xas}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjIubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjEubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj`hMhjaubah}(h]h ]h"]h$]h&]uh1jhjEubeh}(h]h ]h"]h$]h&]uh1jhj`hMhjBubah}(h]h ]h"]h$]h&]uh1jhj&ubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj&ubh)}(hResets the error or walk state of the **xas** so future walks of the array will start from the root. Use this if you have dropped the xarray lock and want to reuse the xa_state.h](h&Resets the error or walk state of the }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh so future walks of the array will start from the root. Use this if you have dropped the xarray lock and want to reuse the xa_state.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj&ubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj&ubh)}(h Any context.h]h Any context.}(hjՓhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj&ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_retry (C function) c.xas_retryhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h8bool xas_retry (struct xa_state *xas, const void *entry)h]jI)}(h7bool xas_retry(struct xa_state *xas, const void *entry)h](jO)}(hjh]hbool}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubj)}(h xas_retryh]j)}(h xas_retryh]h xas_retry}(hj$hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h)(struct xa_state *xas, const void *entry)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hj@hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj<ubja)}(h h]h }(hjMhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj<ubh)}(hhh]j)}(hxa_stateh]hxa_state}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj`modnameN classnameNjt%jw%)}jz%]j}%)}jp%j&sb c.xas_retryasbuh1hhj<ubja)}(h h]h }(hj~hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj<ubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj<ubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj8ubj)}(hconst void *entryh](je)}(hjhh]hconst}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hvoidh]hvoid}(hj͔hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj۔hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj8ubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h#Retry the operation if appropriate.h]h#Retry the operation if appropriate.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j8j7j8j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. ``const void *entry`` Entry from xarray. **Description** The advanced functions may sometimes return an internal entry, such as a retry entry or a zero entry. This function sets up the **xas** to restart the walk from the head of the array if needed. **Context** Any context. **Return** true if the operation needs to be retried.h](h)}(h**Parameters**h]jF)}(hjBh]h Parameters}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj@ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj<ubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjah]hstruct xa_state *xas}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj_ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj[ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhMhjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhMhjXubj)}(h)``const void *entry`` Entry from xarray. h](j)}(h``const void *entry``h]j3)}(hjh]hconst void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(hEntry from xarray.h]hEntry from xarray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjXubeh}(h]h ]h"]h$]h&]uh1jhj<ubh)}(h**Description**h]jF)}(hjՕh]h Description}(hjוhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjӕubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj<ubh)}(hThe advanced functions may sometimes return an internal entry, such as a retry entry or a zero entry. This function sets up the **xas** to restart the walk from the head of the array if needed.h](hThe advanced functions may sometimes return an internal entry, such as a retry entry or a zero entry. This function sets up the }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh: to restart the walk from the head of the array if needed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj<ubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj<ubh)}(h Any context.h]h Any context.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj<ubh)}(h **Return**h]jF)}(hj5h]hReturn}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj3ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj<ubh)}(h*true if the operation needs to be retried.h]h*true if the operation needs to be retried.}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj<ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_reload (C function) c.xas_reloadhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h(void * xas_reload (struct xa_state *xas)h]jI)}(h&void *xas_reload(struct xa_state *xas)h](jO)}(hvoidh]hvoid}(hjzhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjvhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMHubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjvhhhjhMHubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjvhhhjhMHubj)}(h xas_reloadh]j)}(h xas_reloadh]h xas_reload}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjvhhhjhMHubj)}(h(struct xa_state *xas)h]j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjĖhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjіhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjߖubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsb c.xas_reloadasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjvhhhjhMHubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjrhhhjhMHubah}(h]jmah ](j j eh"]h$]h&]jj)jhuh1jBhjhMHhjohhubj)}(hhh]h)}(h!Refetch an entry from the xarray.h]h!Refetch an entry from the xarray.}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM;hjDhhubah}(h]h ]h"]h$]h&]uh1jhjohhhjhMHubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j_j7j_j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. **Description** Use this function to check that a previously loaded entry still has the same value. This is useful for the lockless pagecache lookup where we walk the array with only the RCU lock to protect us, lock the page, then check that the page hasn't moved since we looked it up. The caller guarantees that **xas** is still valid. If it may be in an error or restart state, call xas_load() instead. **Return** The entry at this location in the xarray.h](h)}(h**Parameters**h]jF)}(hjih]h Parameters}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjgubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM?hjcubj)}(hhh]j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjh]hstruct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM<hjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM<hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM<hjubah}(h]h ]h"]h$]h&]uh1jhjcubh)}(h**Description**h]jF)}(hj×h]h Description}(hjŗhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM>hjcubh)}(hXUse this function to check that a previously loaded entry still has the same value. This is useful for the lockless pagecache lookup where we walk the array with only the RCU lock to protect us, lock the page, then check that the page hasn't moved since we looked it up.h]hXUse this function to check that a previously loaded entry still has the same value. This is useful for the lockless pagecache lookup where we walk the array with only the RCU lock to protect us, lock the page, then check that the page hasn’t moved since we looked it up.}(hjٗhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM>hjcubh)}(hwThe caller guarantees that **xas** is still valid. If it may be in an error or restart state, call xas_load() instead.h](hThe caller guarantees that }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubhU is still valid. If it may be in an error or restart state, call xas_load() instead.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMChjcubh)}(h **Return**h]jF)}(hj h]hReturn}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMFhjcubh)}(h)The entry at this location in the xarray.h]h)The entry at this location in the xarray.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMFhjcubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_set (C function) c.xas_sethNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h8void xas_set (struct xa_state *xas, unsigned long index)h]jI)}(h7void xas_set(struct xa_state *xas, unsigned long index)h](jO)}(hvoidh]hvoid}(hjPhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjLhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMeubja)}(h h]h }(hj_hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjLhhhj^hMeubj)}(hxas_seth]j)}(hxas_seth]hxas_set}(hjqhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubah}(h]h ](jjeh"]h$]h&]hhuh1jhjLhhhj^hMeubj)}(h+(struct xa_state *xas, unsigned long index)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jssb c.xas_setasbuh1hhjubja)}(h h]h }(hj˘hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj٘hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj)hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hindexh]hindex}(hj7hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjLhhhj^hMeubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjHhhhj^hMeubah}(h]jCah ](j j eh"]h$]h&]jj)jhuh1jBhj^hMehjEhhubj)}(hhh]h)}(h4Set up XArray operation state for a different index.h]h4Set up XArray operation state for a different index.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM]hj^hhubah}(h]h ]h"]h$]h&]uh1jhjEhhhj^hMeubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jyj7jyj8j9j:uh1j=hhhjhNhNubj<)}(hX+**Parameters** ``struct xa_state *xas`` XArray operation state. ``unsigned long index`` New index into the XArray. **Description** Move the operation state to refer to a different index. This will have the effect of starting a walk from the top; see xas_next() to move to an adjacent index.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMahj}ubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjh]hstruct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM^hjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM^hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM^hjubj)}(h3``unsigned long index`` New index into the XArray. h](j)}(h``unsigned long index``h]j3)}(hjۙh]hunsigned long index}(hjݙhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjٙubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM_hjՙubj)}(hhh]h)}(hNew index into the XArray.h]hNew index into the XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM_hjubah}(h]h ]h"]h$]h&]uh1jhjՙubeh}(h]h ]h"]h$]h&]uh1jhjhM_hjubeh}(h]h ]h"]h$]h&]uh1jhj}ubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMahj}ubh)}(hMove the operation state to refer to a different index. This will have the effect of starting a walk from the top; see xas_next() to move to an adjacent index.h]hMove the operation state to refer to a different index. This will have the effect of starting a walk from the top; see xas_next() to move to an adjacent index.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMahj}ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_advance (C function) c.xas_advancehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h)}(hhh](jC)}(hRvoid xas_set_order (struct xa_state *xas, unsigned long index, unsigned int order)h]jI)}(hQvoid xas_set_order(struct xa_state *xas, unsigned long index, unsigned int order)h](jO)}(hvoidh]hvoid}(hjfhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjbhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjuhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjbhhhjthMubj)}(h xas_set_orderh]j)}(h xas_set_orderh]h xas_set_order}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjbhhhjthMubj)}(h?(struct xa_state *xas, unsigned long index, unsigned int order)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjÜmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.xas_set_orderasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj#hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hj1hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj?hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hindexh]hindex}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned int orderh](jO)}(hunsignedh]hunsigned}(hjfhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjbubja)}(h h]h }(hjthhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjbubjO)}(hinth]hint}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjbubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjbubj)}(horderh]horder}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjbhhhjthMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj^hhhjthMubah}(h]jYah ](j j eh"]h$]h&]jj)jhuh1jBhjthMhj[hhubj)}(hhh]h)}(h4Set up XArray operation state for a multislot entry.h]h4Set up XArray operation state for a multislot entry.}(hjȝhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM~hjŝhhubah}(h]h ]h"]h$]h&]uh1jhj[hhhjthMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``struct xa_state *xas`` XArray operation state. ``unsigned long index`` Target of the operation. ``unsigned int order`` Entry occupies 2^**order** indices.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hj h]hstruct xa_state *xas}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h1``unsigned long index`` Target of the operation. h](j)}(h``unsigned long index``h]j3)}(hjBh]hunsigned long index}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj@ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj<ubj)}(hhh]h)}(hTarget of the operation.h]hTarget of the operation.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjWhMhjXubah}(h]h ]h"]h$]h&]uh1jhj<ubeh}(h]h ]h"]h$]h&]uh1jhjWhMhjubj)}(h:``unsigned int order`` Entry occupies 2^**order** indices.h](j)}(h``unsigned int order``h]j3)}(hj{h]hunsigned int order}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjyubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjuubj)}(hhh]h)}(h#Entry occupies 2^**order** indices.h]h#Entry occupies 2^**order** indices.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubah}(h]h ]h"]h$]h&]uh1jhjuubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_set_update (C function)c.xas_set_updatehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hCvoid xas_set_update (struct xa_state *xas, xa_update_node_t update)h]jI)}(hBvoid xas_set_update(struct xa_state *xas, xa_update_node_t update)h](jO)}(hvoidh]hvoid}(hj՞hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjўhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjўhhhjhMubj)}(hxas_set_updateh]j)}(hxas_set_updateh]hxas_set_update}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjўhhhjhMubj)}(h/(struct xa_state *xas, xa_update_node_t update)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj2modnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.xas_set_updateasbuh1hhjubja)}(h h]h }(hjPhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj^hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubj)}(hxa_update_node_t updateh](h)}(hhh]j)}(hxa_update_node_th]hxa_update_node_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]jLc.xas_set_updateasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hupdateh]hupdate}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubeh}(h]h ]h"]h$]h&]hhuh1jhjўhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj͞hhhjhMubah}(h]jȞah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjʞhhubj)}(hhh]h)}(h-Set up XArray operation state for a callback.h]h-Set up XArray operation state for a callback.}(hjݟhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjڟhhubah}(h]h ]h"]h$]h&]uh1jhjʞhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX.**Parameters** ``struct xa_state *xas`` XArray operation state. ``xa_update_node_t update`` Function to call when updating a node. **Description** The XArray can notify a caller after it has updated an xa_node. This is advanced functionality and is only needed by the page cache and swap cache.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjh]hstruct xa_state *xas}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hMhj4ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj3hMhjubj)}(hC``xa_update_node_t update`` Function to call when updating a node. h](j)}(h``xa_update_node_t update``h]j3)}(hjWh]hxa_update_node_t update}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjUubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjQubj)}(hhh]h)}(h&Function to call when updating a node.h]h&Function to call when updating a node.}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhMhjmubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjlhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(hThe XArray can notify a caller after it has updated an xa_node. This is advanced functionality and is only needed by the page cache and swap cache.h]hThe XArray can notify a caller after it has updated an xa_node. This is advanced functionality and is only needed by the page cache and swap cache.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_next_entry (C function)c.xas_next_entryhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h?void * xas_next_entry (struct xa_state *xas, unsigned long max)h]jI)}(h=void *xas_next_entry(struct xa_state *xas, unsigned long max)h](jO)}(hvoidh]hvoid}(hjנhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjӠhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjӠhhhjhMubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjӠhhhjhMubj)}(hxas_next_entryh]j)}(hxas_next_entryh]hxas_next_entry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjӠhhhjhMubj)}(h)(struct xa_state *xas, unsigned long max)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hj!hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hj.hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hj?hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj<ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjAmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.xas_next_entryasbuh1hhjubja)}(h h]h }(hj_hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjmhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjzhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long maxh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hmaxh]hmax}(hjˡhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjӠhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjϠhhhjhMubah}(h]jʠah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhj̠hhubj)}(hhh]h)}(h'Advance iterator to next present entry.h]h'Advance iterator to next present entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jhj̠hhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j j7j j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. ``unsigned long max`` Highest index to return. **Description** xas_next_entry() is an inline function to optimise xarray traversal for speed. It is equivalent to calling xas_find(), and will call xas_find() for all the hard cases. **Return** The next present entry after the one currently referred to by **xas**.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hj6h]hstruct xa_state *xas}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj4ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj0ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhMhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhMhj-ubj)}(h/``unsigned long max`` Highest index to return. h](j)}(h``unsigned long max``h]j3)}(hjoh]hunsigned long max}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjmubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjiubj)}(hhh]h)}(hHighest index to return.h]hHighest index to return.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjiubeh}(h]h ]h"]h$]h&]uh1jhjhMhj-ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(hxas_next_entry() is an inline function to optimise xarray traversal for speed. It is equivalent to calling xas_find(), and will call xas_find() for all the hard cases.h]hxas_next_entry() is an inline function to optimise xarray traversal for speed. It is equivalent to calling xas_find(), and will call xas_find() for all the hard cases.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(h **Return**h]jF)}(hjѢh]hReturn}(hjӢhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjϢubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(hFThe next present entry after the one currently referred to by **xas**.h](h>The next present entry after the one currently referred to by }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_next_marked (C function)c.xas_next_markedhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hPvoid * xas_next_marked (struct xa_state *xas, unsigned long max, xa_mark_t mark)h]jI)}(hNvoid *xas_next_marked(struct xa_state *xas, unsigned long max, xa_mark_t mark)h](jO)}(hvoidh]hvoid}(hj(hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj$hhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubja)}(h h]h }(hj7hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj$hhhj6hMubjr)}(hjh]h*}(hjEhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj$hhhj6hMubj)}(hxas_next_markedh]j)}(hxas_next_markedh]hxas_next_marked}(hjVhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubah}(h]h ](jjeh"]h$]h&]hhuh1jhj$hhhj6hMubj)}(h9(struct xa_state *xas, unsigned long max, xa_mark_t mark)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjrhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjnubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjnubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jXsbc.xas_next_markedasbuh1hhjnubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjnubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjnubj)}(hxash]hxas}(hjˣhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjnubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjjubj)}(hunsigned long maxh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hmaxh]hmax}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjjubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj5ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj:modnameN classnameNjt%jw%)}jz%]jc.xas_next_markedasbuh1hhj1ubja)}(h h]h }(hjVhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj1ubj)}(hmarkh]hmark}(hjdhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjjubeh}(h]h ]h"]h$]h&]hhuh1jhj$hhhj6hMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj hhhj6hMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhj6hMhjhhubj)}(hhh]h)}(h&Advance iterator to next marked entry.h]h&Advance iterator to next marked entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhj6hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. ``unsigned long max`` Highest index to return. ``xa_mark_t mark`` Mark to search for. **Description** xas_next_marked() is an inline function to optimise xarray traversal for speed. It is equivalent to calling xas_find_marked(), and will call xas_find_marked() for all the hard cases. **Return** The next marked entry after the one currently referred to by **xas**.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjϤh]hstruct xa_state *xas}(hjѤhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjͤubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjɤubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjɤubeh}(h]h ]h"]h$]h&]uh1jhjhMhjƤubj)}(h/``unsigned long max`` Highest index to return. h](j)}(h``unsigned long max``h]j3)}(hjh]hunsigned long max}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(hHighest index to return.h]hHighest index to return.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjƤubj)}(h'``xa_mark_t mark`` Mark to search for. h](j)}(h``xa_mark_t mark``h]j3)}(hjAh]hxa_mark_t mark}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj?ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj;ubj)}(hhh]h)}(hMark to search for.h]h#Mark to search for.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhMhjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhMhjƤubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hj|h]h Description}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjzubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(hxas_next_marked() is an inline function to optimise xarray traversal for speed. It is equivalent to calling xas_find_marked(), and will call xas_find_marked() for all the hard cases.h]hxas_next_marked() is an inline function to optimise xarray traversal for speed. It is equivalent to calling xas_find_marked(), and will call xas_find_marked() for all the hard cases.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(hEThe next marked entry after the one currently referred to by **xas**.h](h=The next marked entry after the one currently referred to by }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_for_each (C macro)c.xas_for_eachhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h xas_for_eachh]jI)}(h xas_for_eachh]j)}(h xas_for_eachh]j)}(hjh]h xas_for_each}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMubah}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6j*j7j*j8j9j:uh1j=hhhjhNhNubh)}(h"``xas_for_each (xas, entry, max)``h]j3)}(hj0h]hxas_for_each (xas, entry, max)}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj.ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjhhubj )}(h#Iterate over a range of an XArray. h]h)}(h"Iterate over a range of an XArray.h]h"Iterate over a range of an XArray.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjFubah}(h]h ]h"]h$]h&]uh1j hjXhMhjhhubj<)}(hX **Parameters** ``xas`` XArray operation state. ``entry`` Entry retrieved from the array. ``max`` Maximum index to retrieve from array. **Description** The loop body will be executed for each entry present in the xarray between the current xas position and **max**. **entry** will be set to the entry retrieved from the xarray. It is safe to delete entries from the array in the loop body. You should hold either the RCU lock or the xa_lock while iterating. If you need to drop the lock, call xas_pause() first.h](h)}(h**Parameters**h]jF)}(hjeh]h Parameters}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjcubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM hj_ubj)}(hhh](j)}(h ``xas`` XArray operation state. h](j)}(h``xas``h]j3)}(hjh]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhj~ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj~ubeh}(h]h ]h"]h$]h&]uh1jhjhMhj{ubj)}(h*``entry`` Entry retrieved from the array. h](j)}(h ``entry``h]j3)}(hjh]hentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM hjubj)}(hhh]h)}(hEntry retrieved from the array.h]hEntry retrieved from the array.}(hj֦hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjҦhM hjӦubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjҦhM hj{ubj)}(h.``max`` Maximum index to retrieve from array. h](j)}(h``max``h]j3)}(hjh]hmax}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM hjubj)}(hhh]h)}(h%Maximum index to retrieve from array.h]h%Maximum index to retrieve from array.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hM hj{ubeh}(h]h ]h"]h$]h&]uh1jhj_ubh)}(h**Description**h]jF)}(hj1h]h Description}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj/ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM hj_ubh)}(hXkThe loop body will be executed for each entry present in the xarray between the current xas position and **max**. **entry** will be set to the entry retrieved from the xarray. It is safe to delete entries from the array in the loop body. You should hold either the RCU lock or the xa_lock while iterating. If you need to drop the lock, call xas_pause() first.h](hiThe loop body will be executed for each entry present in the xarray between the current xas position and }(hjGhhhNhNubjF)}(h**max**h]hmax}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjGubh. }(hjGhhhNhNubjF)}(h **entry**h]hentry}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjGubh will be set to the entry retrieved from the xarray. It is safe to delete entries from the array in the loop body. You should hold either the RCU lock or the xa_lock while iterating. If you need to drop the lock, call xas_pause() first.}(hjGhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM hj_ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_for_each_marked (C macro)c.xas_for_each_markedhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hxas_for_each_markedh]jI)}(hxas_for_each_markedh]j)}(hxas_for_each_markedh]j)}(hjh]hxas_for_each_marked}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM%ubah}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhM%ubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhM%hjhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhjhM%ubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6jʧj7jʧj8j9j:uh1j=hhhjhNhNubh)}(h/``xas_for_each_marked (xas, entry, max, mark)``h]j3)}(hjЧh]h+xas_for_each_marked (xas, entry, max, mark)}(hjҧhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjΧubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM'hjhhubj )}(h#Iterate over a range of an XArray. h]h)}(h"Iterate over a range of an XArray.h]h"Iterate over a range of an XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubah}(h]h ]h"]h$]h&]uh1j hjhMhjhhubj<)}(hX,**Parameters** ``xas`` XArray operation state. ``entry`` Entry retrieved from the array. ``max`` Maximum index to retrieve from array. ``mark`` Mark to search for. **Description** The loop body will be executed for each marked entry in the xarray between the current xas position and **max**. **entry** will be set to the entry retrieved from the xarray. It is safe to delete entries from the array in the loop body. You should hold either the RCU lock or the xa_lock while iterating. If you need to drop the lock, call xas_pause() first.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh](j)}(h ``xas`` XArray operation state. h](j)}(h``xas``h]j3)}(hj$h]hxas}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj"ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hMhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hMhjubj)}(h*``entry`` Entry retrieved from the array. h](j)}(h ``entry``h]j3)}(hj]h]hentry}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj[ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjWubj)}(hhh]h)}(hEntry retrieved from the array.h]hEntry retrieved from the array.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhMhjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhMhjubj)}(h.``max`` Maximum index to retrieve from array. h](j)}(h``max``h]j3)}(hjh]hmax}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubj)}(hhh]h)}(h%Maximum index to retrieve from array.h]h%Maximum index to retrieve from array.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``mark`` Mark to search for. h](j)}(h``mark``h]j3)}(hjϨh]hmark}(hjѨhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjͨubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjɨubj)}(hhh]h)}(hMark to search for.h]hMark to search for.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjɨubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubh)}(hXjThe loop body will be executed for each marked entry in the xarray between the current xas position and **max**. **entry** will be set to the entry retrieved from the xarray. It is safe to delete entries from the array in the loop body. You should hold either the RCU lock or the xa_lock while iterating. If you need to drop the lock, call xas_pause() first.h](hhThe loop body will be executed for each marked entry in the xarray between the current xas position and }(hj hhhNhNubjF)}(h**max**h]hmax}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubh. }(hj hhhNhNubjF)}(h **entry**h]hentry}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubh will be set to the entry retrieved from the xarray. It is safe to delete entries from the array in the loop body. You should hold either the RCU lock or the xa_lock while iterating. If you need to drop the lock, call xas_pause() first.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_for_each_conflict (C macro)c.xas_for_each_conflicthNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hxas_for_each_conflicth]jI)}(hxas_for_each_conflicth]j)}(hxas_for_each_conflicth]j)}(hjmh]hxas_for_each_conflict}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubah}(h]h ](jjeh"]h$]h&]hhuh1jhjohhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM5ubah}(h]h ]h"]h$]h&]hhjuh1jHjjhjkhhhjhM5ubah}(h]jfah ](j j eh"]h$]h&]jj)jhuh1jBhjhM5hjhhhubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjhhhhjhM5ubeh}(h]h ](j0macroeh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubh)}(h&``xas_for_each_conflict (xas, entry)``h]j3)}(hjh]h"xas_for_each_conflict (xas, entry)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM7hjhhubj )}(h#Iterate over a range of an XArray. h]h)}(h"Iterate over a range of an XArray.h]h"Iterate over a range of an XArray.}(hjéhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM*hjubah}(h]h ]h"]h$]h&]uh1j hjѩhM*hjhhubj<)}(hX**Parameters** ``xas`` XArray operation state. ``entry`` Entry retrieved from the array. **Description** The loop body will be executed for each entry in the XArray that lies within the range specified by **xas**. If the loop terminates normally, **entry** will be ``NULL``. The user may break out of the loop, which will leave **entry** set to the conflicting entry. The caller may also call xa_set_err() to exit the loop while setting an error to record the reason.h](h)}(h**Parameters**h]jF)}(hjީh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjܩubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM.hjةubj)}(hhh](j)}(h ``xas`` XArray operation state. h](j)}(h``xas``h]j3)}(hjh]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM+hjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM+hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM+hjubj)}(h*``entry`` Entry retrieved from the array. h](j)}(h ``entry``h]j3)}(hj6h]hentry}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj4ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM,hj0ubj)}(hhh]h)}(hEntry retrieved from the array.h]hEntry retrieved from the array.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhM,hjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhM,hjubeh}(h]h ]h"]h$]h&]uh1jhjةubh)}(h**Description**h]jF)}(hjqh]h Description}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjoubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM.hjةubh)}(hXmThe loop body will be executed for each entry in the XArray that lies within the range specified by **xas**. If the loop terminates normally, **entry** will be ``NULL``. The user may break out of the loop, which will leave **entry** set to the conflicting entry. The caller may also call xa_set_err() to exit the loop while setting an error to record the reason.h](hdThe loop body will be executed for each entry in the XArray that lies within the range specified by }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh$. If the loop terminates normally, }(hjhhhNhNubjF)}(h **entry**h]hentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh will be }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh8. The user may break out of the loop, which will leave }(hjhhhNhNubjF)}(h **entry**h]hentry}(hjŪhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh set to the conflicting entry. The caller may also call xa_set_err() to exit the loop while setting an error to record the reason.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM.hjةubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_prev (C function) c.xas_prevhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h&void * xas_prev (struct xa_state *xas)h]jI)}(h$void *xas_prev(struct xa_state *xas)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMKubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhj hMKubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhj hMKubj)}(hxas_prevh]j)}(hxas_prevh]hxas_prev}(hj,hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj(ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhj hMKubj)}(h(struct xa_state *xas)h]j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjHhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjDubja)}(h h]h }(hjUhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjDubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjfhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjcubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjhmodnameN classnameNjt%jw%)}jz%]j}%)}jp%j.sb c.xas_prevasbuh1hhjDubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjDubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjDubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj@ubah}(h]h ]h"]h$]h&]hhuh1jhjhhhj hMKubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhj hMKubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhj hMKhjhhubj)}(hhh]h)}(h Move iterator to previous index.h]h Move iterator to previous index.}(hj˫hhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM<hjȫhhubah}(h]h ]h"]h$]h&]uh1jhjhhhj hMKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hXP**Parameters** ``struct xa_state *xas`` XArray operation state. **Description** If the **xas** was in an error state, it will remain in an error state and this function will return ``NULL``. If the **xas** has never been walked, it will have the effect of calling xas_load(). Otherwise one will be subtracted from the index and the state will be walked to the correct location in the array for the next operation. If the iterator was referencing index 0, this function wraps around to ``ULONG_MAX``. **Return** The entry at the new index. This may be ``NULL`` or an internal entry.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM@hjubj)}(hhh]j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hj h]hstruct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM=hjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj!hM=hj"ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj!hM=hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjGh]h Description}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjEubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM?hjubh)}(hXOIf the **xas** was in an error state, it will remain in an error state and this function will return ``NULL``. If the **xas** has never been walked, it will have the effect of calling xas_load(). Otherwise one will be subtracted from the index and the state will be walked to the correct location in the array for the next operation.h](hIf the }(hj]hhhNhNubjF)}(h**xas**h]hxas}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj]ubhW was in an error state, it will remain in an error state and this function will return }(hj]hhhNhNubj3)}(h``NULL``h]hNULL}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj]ubh . If the }(hj]hhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj]ubh has never been walked, it will have the effect of calling xas_load(). Otherwise one will be subtracted from the index and the state will be walked to the correct location in the array for the next operation.}(hj]hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM?hjubh)}(hUIf the iterator was referencing index 0, this function wraps around to ``ULONG_MAX``.h](hGIf the iterator was referencing index 0, this function wraps around to }(hjhhhNhNubj3)}(h ``ULONG_MAX``h]h ULONG_MAX}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMEhjubh)}(h **Return**h]jF)}(hjŬh]hReturn}(hjǬhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjìubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMHhjubh)}(hGThe entry at the new index. This may be ``NULL`` or an internal entry.h](h)The entry at the new index. This may be }(hj۬hhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj۬ubh or an internal entry.}(hj۬hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMHhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_next (C function) c.xas_nexthNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h&void * xas_next (struct xa_state *xas)h]jI)}(h$void *xas_next(struct xa_state *xas)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMhubja)}(h h]h }(hj+hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhj*hMhubjr)}(hjh]h*}(hj9hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhj*hMhubj)}(hxas_nexth]j)}(hxas_nexth]hxas_next}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjFubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhj*hMhubj)}(h(struct xa_state *xas)h]j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjfhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjbubja)}(h h]h }(hjshhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjbubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jLsb c.xas_nextasbuh1hhjbubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjbubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjbubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjbubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj^ubah}(h]h ]h"]h$]h&]hhuh1jhjhhhj*hMhubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhj*hMhubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhj*hMhhjhhubj)}(hhh]h)}(hMove state to next index.h]hMove state to next index.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMYhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhj*hMhubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hXI**Parameters** ``struct xa_state *xas`` XArray operation state. **Description** If the **xas** was in an error state, it will remain in an error state and this function will return ``NULL``. If the **xas** has never been walked, it will have the effect of calling xas_load(). Otherwise one will be added to the index and the state will be walked to the correct location in the array for the next operation. If the iterator was referencing index ``ULONG_MAX``, this function wraps around to 0. **Return** The entry at the new index. This may be ``NULL`` or an internal entry.h](h)}(h**Parameters**h]jF)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM]hjubj)}(hhh]j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hj*h]hstruct xa_state *xas}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj(ubah}(h]h ]h"]h$]h&]uh1jhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMZhj$ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhj?hMZhj@ubah}(h]h ]h"]h$]h&]uh1jhj$ubeh}(h]h ]h"]h$]h&]uh1jhj?hMZhj!ubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjeh]h Description}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjcubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM\hjubh)}(hXHIf the **xas** was in an error state, it will remain in an error state and this function will return ``NULL``. If the **xas** has never been walked, it will have the effect of calling xas_load(). Otherwise one will be added to the index and the state will be walked to the correct location in the array for the next operation.h](hIf the }(hj{hhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj{ubhW was in an error state, it will remain in an error state and this function will return }(hj{hhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj{ubh . If the }(hj{hhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj{ubh has never been walked, it will have the effect of calling xas_load(). Otherwise one will be added to the index and the state will be walked to the correct location in the array for the next operation.}(hj{hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhM\hjubh)}(hUIf the iterator was referencing index ``ULONG_MAX``, this function wraps around to 0.h](h&If the iterator was referencing index }(hjhhhNhNubj3)}(h ``ULONG_MAX``h]h ULONG_MAX}(hjȮhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh", this function wraps around to 0.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMbhjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMehjubh)}(hGThe entry at the new index. This may be ``NULL`` or an internal entry.h](h)The entry at the new index. This may be }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh or an internal entry.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhW/var/lib/git/docbuild/linux/Documentation/core-api/xarray:509: ./include/linux/xarray.hhMehjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_load (C function) c.xas_loadhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h&void * xas_load (struct xa_state *xas)h]jI)}(h$void *xas_load(struct xa_state *xas)h](jO)}(hvoidh]hvoid}(hj:hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj6hhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKubja)}(h h]h }(hjIhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj6hhhjHhKubjr)}(hjh]h*}(hjWhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj6hhhjHhKubj)}(hxas_loadh]j)}(hxas_loadh]hxas_load}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ](jjeh"]h$]h&]hhuh1jhj6hhhjHhKubj)}(h(struct xa_state *xas)h]j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jjsb c.xas_loadasbuh1hhjubja)}(h h]h }(hj¯hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjЯhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjݯhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj|ubah}(h]h ]h"]h$]h&]hhuh1jhj6hhhjHhKubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj2hhhjHhKubah}(h]j-ah ](j j eh"]h$]h&]jj)jhuh1jBhjHhKhj/hhubj)}(hhh]h)}(h)Load an entry from the XArray (advanced).h]h)Load an entry from the XArray (advanced).}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKhjhhubah}(h]h ]h"]h$]h&]uh1jhj/hhhjHhKubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. **Description** Usually walks the **xas** to the appropriate state to load the entry stored at xa_index. However, it will do nothing and return ``NULL`` if **xas** is in an error state. xas_load() will never expand the tree. If the xa_state is set up to operate on a multi-index entry, xas_load() may return ``NULL`` or an internal entry, even if there are entries present within the range specified by **xas**. **Context** Any context. The caller should hold the xa_lock or the RCU lock. **Return** Usually an entry in the XArray, but see description for exceptions.h](h)}(h**Parameters**h]jF)}(hj)h]h Parameters}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj'ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKhj#ubj)}(hhh]j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjHh]hstruct xa_state *xas}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjFubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKhjBubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhj]hKhj^ubah}(h]h ]h"]h$]h&]uh1jhjBubeh}(h]h ]h"]h$]h&]uh1jhj]hKhj?ubah}(h]h ]h"]h$]h&]uh1jhj#ubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKhj#ubh)}(hUsually walks the **xas** to the appropriate state to load the entry stored at xa_index. However, it will do nothing and return ``NULL`` if **xas** is in an error state. xas_load() will never expand the tree.h](hUsually walks the }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubhh to the appropriate state to load the entry stored at xa_index. However, it will do nothing and return }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh if }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjŰhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh> is in an error state. xas_load() will never expand the tree.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKhj#ubh)}(hIf the xa_state is set up to operate on a multi-index entry, xas_load() may return ``NULL`` or an internal entry, even if there are entries present within the range specified by **xas**.h](hSIf the xa_state is set up to operate on a multi-index entry, xas_load() may return }(hjްhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjްubhW or an internal entry, even if there are entries present within the range specified by }(hjްhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjްubh.}(hjްhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKhj#ubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKhj#ubh)}(hAAny context. The caller should hold the xa_lock or the RCU lock.h]hAAny context. The caller should hold the xa_lock or the RCU lock.}(hj)hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKhj#ubh)}(h **Return**h]jF)}(hj:h]hReturn}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj8ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKhj#ubh)}(hCUsually an entry in the XArray, but see description for exceptions.h]hCUsually an entry in the XArray, but see description for exceptions.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chKhj#ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_nomem (C function) c.xas_nomemhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h0bool xas_nomem (struct xa_state *xas, gfp_t gfp)h]jI)}(h/bool xas_nomem(struct xa_state *xas, gfp_t gfp)h](jO)}(hjh]hbool}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj{hhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM-ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj{hhhjhM-ubj)}(h xas_nomemh]j)}(h xas_nomemh]h xas_nomem}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhj{hhhjhM-ubj)}(h!(struct xa_state *xas, gfp_t gfp)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjȱhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjٱhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjֱubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj۱modnameN classnameNjt%jw%)}jz%]j}%)}jp%jsb c.xas_nomemasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj2modnameN classnameNjt%jw%)}jz%]j c.xas_nomemasbuh1hhj)ubja)}(h h]h }(hjNhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj)ubj)}(hgfph]hgfp}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj)ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhj{hhhjhM-ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjwhhhjhM-ubah}(h]jrah ](j j eh"]h$]h&]jj)jhuh1jBhjhM-hjthhubj)}(hhh]h)}(hAllocate memory if needed.h]hAllocate memory if needed.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjthhhjhM-ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. ``gfp_t gfp`` Memory allocation flags. **Description** If we need to add new nodes to the XArray, we try to allocate memory with GFP_NOWAIT while holding the lock, which will usually succeed. If it fails, **xas** is flagged as needing memory to continue. The caller should drop the lock and call xas_nomem(). If xas_nomem() succeeds, the caller should retry the operation. Forward progress is guaranteed as one node is allocated here and stored in the xa_state where it will be found by xas_alloc(). More nodes will likely be found in the slab allocator, but we do not tie them up here. **Return** true if memory was needed, and was successfully allocated.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjDzh]hstruct xa_state *xas}(hjɲhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjŲubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjܲhMhjݲubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjܲhMhjubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjhhhNhNubah}(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]jF)}(hj;h]h Description}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj9ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubh)}(hX?If we need to add new nodes to the XArray, we try to allocate memory with GFP_NOWAIT while holding the lock, which will usually succeed. If it fails, **xas** is flagged as needing memory to continue. The caller should drop the lock and call xas_nomem(). If xas_nomem() succeeds, the caller should retry the operation.h](hIf we need to add new nodes to the XArray, we try to allocate memory with GFP_NOWAIT while holding the lock, which will usually succeed. If it fails, }(hjQhhhNhNubjF)}(h**xas**h]hxas}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjQubh is flagged as needing memory to continue. The caller should drop the lock and call xas_nomem(). If xas_nomem() succeeds, the caller should retry the operation.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubh)}(hForward progress is guaranteed as one node is allocated here and stored in the xa_state where it will be found by xas_alloc(). More nodes will likely be found in the slab allocator, but we do not tie them up here.h]hForward progress is guaranteed as one node is allocated here and stored in the xa_state where it will be found by xas_alloc(). More nodes will likely be found in the slab allocator, but we do not tie them up here.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM&hjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM+hjubh)}(h:true if memory was needed, and was successfully allocated.h]h:true if memory was needed, and was successfully allocated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM+hjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_free_nodes (C function)c.xas_free_nodeshNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h?void xas_free_nodes (struct xa_state *xas, struct xa_node *top)h]jI)}(h>void xas_free_nodes(struct xa_state *xas, struct xa_node *top)h](jO)}(hvoidh]hvoid}(hjȳhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjijhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hj׳hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjijhhhjֳhMubj)}(hxas_free_nodesh]j)}(hxas_free_nodesh]hxas_free_nodes}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjijhhhjֳhMubj)}(h+(struct xa_state *xas, struct xa_node *top)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj%modnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.xas_free_nodesasbuh1hhjubja)}(h h]h }(hjChhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjQhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hstruct xa_node *toph](je)}(hjh]hstruct}(hjwhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjsubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjsubh)}(hhh]j)}(hxa_nodeh]hxa_node}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j?c.xas_free_nodesasbuh1hhjsubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjsubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjsubj)}(htoph]htop}(hjδhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjijhhhjֳhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjֳhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjֳhMhjhhubj)}(hhh]h)}(h/Free this node and all nodes that it referencesh]h/Free this node and all nodes that it references}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjֳhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX?**Parameters** ``struct xa_state *xas`` Array operation state. ``struct xa_node *top`` Node to free **Description** This node has been removed from the tree. We must now free it and all of its subnodes. There may be RCU walkers with references into the tree, so we must replace all entries with retry markers.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh](j)}(h0``struct xa_state *xas`` Array operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hj9h]hstruct xa_state *xas}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj7ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj3ubj)}(hhh]h)}(hArray operation state.h]hArray operation state.}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjNhM hjOubah}(h]h ]h"]h$]h&]uh1jhj3ubeh}(h]h ]h"]h$]h&]uh1jhjNhM hj0ubj)}(h%``struct xa_node *top`` Node to free h](j)}(h``struct xa_node *top``h]j3)}(hjrh]hstruct xa_node *top}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjpubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjlubj)}(hhh]h)}(h Node to freeh]h Node to free}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]uh1jhjhM hj0ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hThis node has been removed from the tree. We must now free it and all of its subnodes. There may be RCU walkers with references into the tree, so we must replace all entries with retry markers.h]hThis node has been removed from the tree. We must now free it and all of its subnodes. There may be RCU walkers with references into the tree, so we must replace all entries with retry markers.}(hjõhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_create_range (C function)c.xas_create_rangehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h,void xas_create_range (struct xa_state *xas)h]jI)}(h+void xas_create_range(struct xa_state *xas)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubj)}(hxas_create_rangeh]j)}(hxas_create_rangeh]hxas_create_range}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h(struct xa_state *xas)h]j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hj/hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj+ubja)}(h h]h }(hj<hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj+ubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjMhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjJubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjOmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.xas_create_rangeasbuh1hhj+ubja)}(h h]h }(hjmhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj+ubjr)}(hjh]h*}(hj{hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj+ubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj+ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj'ubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h-Ensure that stores to this range will succeedh]h-Ensure that stores to this range will succeed}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jʶj7jʶj8j9j:uh1j=hhhjhNhNubj<)}(hXK**Parameters** ``struct xa_state *xas`` XArray operation state. **Description** Creates all of the slots in the range covered by **xas**. Sets **xas** to create single-index entries and positions it at the beginning of the range. This is for the benefit of users which have not yet been converted to use multi-index entries.h](h)}(h**Parameters**h]jF)}(hjԶh]h Parameters}(hjֶhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjҶubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjζubj)}(hhh]j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjh]hstruct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjζubh)}(h**Description**h]jF)}(hj.h]h Description}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj,ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjζubh)}(hCreates all of the slots in the range covered by **xas**. Sets **xas** to create single-index entries and positions it at the beginning of the range. This is for the benefit of users which have not yet been converted to use multi-index entries.h](h1Creates all of the slots in the range covered by }(hjDhhhNhNubjF)}(h**xas**h]hxas}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjDubh. Sets }(hjDhhhNhNubjF)}(h**xas**h]hxas}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjDubh to create single-index entries and positions it at the beginning of the range. This is for the benefit of users which have not yet been converted to use multi-index entries.}(hjDhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjζubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_store (C function) c.xas_storehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h4void * xas_store (struct xa_state *xas, void *entry)h]jI)}(h2void *xas_store(struct xa_state *xas, void *entry)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhjhMubj)}(h xas_storeh]j)}(h xas_storeh]h xas_store}(hjŷhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h#(struct xa_state *xas, void *entry)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjݷubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjݷubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jǷsb c.xas_storeasbuh1hhjݷubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjݷubjr)}(hjh]h*}(hj-hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjݷubj)}(hxash]hxas}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjݷubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjٷubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjShhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjOubja)}(h h]h }(hjahhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjOubjr)}(hjh]h*}(hjohhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjOubj)}(hentryh]hentry}(hj|hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjٷubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(hStore this entry in the XArray.h]hStore this entry in the XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. ``void *entry`` New entry. **Description** If **xas** is operating on a multi-index entry, the entry returned by this function is essentially meaningless (it may be an internal entry or it may be ``NULL``, even if there are non-NULL entries at some of the indices covered by the range). This is not a problem for any current users, and can be changed if needed. **Return** The old entry at this index.h](h)}(h**Parameters**h]jF)}(hjȸh]h Parameters}(hjʸhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjƸubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj¸ubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjh]hstruct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj޸ubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hj h]h void *entry}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(h New entry.h]h New entry.}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj5hMhj6ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj5hMhj޸ubeh}(h]h ]h"]h$]h&]uh1jhj¸ubh)}(h**Description**h]jF)}(hj[h]h Description}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjYubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj¸ubh)}(hX?If **xas** is operating on a multi-index entry, the entry returned by this function is essentially meaningless (it may be an internal entry or it may be ``NULL``, even if there are non-NULL entries at some of the indices covered by the range). This is not a problem for any current users, and can be changed if needed.h](hIf }(hjqhhhNhNubjF)}(h**xas**h]hxas}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjqubh is operating on a multi-index entry, the entry returned by this function is essentially meaningless (it may be an internal entry or it may be }(hjqhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjqubh, even if there are non-NULL entries at some of the indices covered by the range). This is not a problem for any current users, and can be changed if needed.}(hjqhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj¸ubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj¸ubh)}(hThe old entry at this index.h]hThe old entry at this index.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj¸ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_get_mark (C function)c.xas_get_markhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h>bool xas_get_mark (const struct xa_state *xas, xa_mark_t mark)h]jI)}(h=bool xas_get_mark(const struct xa_state *xas, xa_mark_t mark)h](jO)}(hjh]hbool}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMaubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMaubj)}(h xas_get_markh]j)}(h xas_get_markh]h xas_get_mark}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMaubj)}(h,(const struct xa_state *xas, xa_mark_t mark)h](j)}(hconst struct xa_state *xash](je)}(hjhh]hconst}(hj'hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj#ubja)}(h h]h }(hj4hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj#ubje)}(hjh]hstruct}(hjBhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj#ubja)}(h h]h }(hjOhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj#ubh)}(hhh]j)}(hxa_stateh]hxa_state}(hj`hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj]ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjbmodnameN classnameNjt%jw%)}jz%]j}%)}jp%j sbc.xas_get_markasbuh1hhj#ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj#ubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj#ubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj#ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j|c.xas_get_markasbuh1hhjubja)}(h h]h }(hjպhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hmarkh]hmark}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMaubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMaubah}(h]j޹ah ](j j eh"]h$]h&]jj)jhuh1jBhjhMahjhhubj)}(hhh]h)}(hReturns the state of this mark.h]hReturns the state of this mark.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMZhj hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMaubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j%j7j%j8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``const struct xa_state *xas`` XArray operation state. ``xa_mark_t mark`` Mark number. **Return** true if the mark is set, false if the mark is clear or **xas** is in an error state.h](h)}(h**Parameters**h]jF)}(hj/h]h Parameters}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj-ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM^hj)ubj)}(hhh](j)}(h7``const struct xa_state *xas`` XArray operation state. h](j)}(h``const struct xa_state *xas``h]j3)}(hjNh]hconst struct xa_state *xas}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjLubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM[hjHubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1hhjchM[hjdubah}(h]h ]h"]h$]h&]uh1jhjHubeh}(h]h ]h"]h$]h&]uh1jhjchM[hjEubj)}(h ``xa_mark_t mark`` Mark number. h](j)}(h``xa_mark_t mark``h]j3)}(hjh]hxa_mark_t mark}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM\hjubj)}(hhh]h)}(h Mark number.h]h Mark number.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM\hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM\hjEubeh}(h]h ]h"]h$]h&]uh1jhj)ubh)}(h **Return**h]jF)}(hj»h]hReturn}(hjĻhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM^hj)ubh)}(hTtrue if the mark is set, false if the mark is clear or **xas** is in an error state.h](h7true if the mark is set, false if the mark is clear or }(hjػhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjػubh is in an error state.}(hjػhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM^hj)ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_set_mark (C function)c.xas_set_markhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h>void xas_set_mark (const struct xa_state *xas, xa_mark_t mark)h]jI)}(h=void xas_set_mark(const struct xa_state *xas, xa_mark_t mark)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMtubja)}(h h]h }(hj(hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhj'hMtubj)}(h xas_set_markh]j)}(h xas_set_markh]h xas_set_mark}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhj'hMtubj)}(h,(const struct xa_state *xas, xa_mark_t mark)h](j)}(hconst struct xa_state *xash](je)}(hjhh]hconst}(hjVhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjRubja)}(h h]h }(hjchhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjRubje)}(hjh]hstruct}(hjqhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjRubja)}(h h]h }(hj~hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjRubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%j<sbc.xas_set_markasbuh1hhjRubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjRubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjRubj)}(hxash]hxas}(hjʼhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjRubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjNubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]jc.xas_set_markasbuh1hhj߼ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj߼ubj)}(hmarkh]hmark}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj߼ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjNubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhj'hMtubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhj'hMtubah}(h]j ah ](j j eh"]h$]h&]jj)jhuh1jBhj'hMthjhhubj)}(hhh]h)}(h,Sets the mark on this entry and its parents.h]h,Sets the mark on this entry and its parents.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMlhj9hhubah}(h]h ]h"]h$]h&]uh1jhjhhhj'hMtubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jTj7jTj8j9j:uh1j=hhhjhNhNubj<)}(hX5**Parameters** ``const struct xa_state *xas`` XArray operation state. ``xa_mark_t mark`` Mark number. **Description** Sets the specified mark on this entry, and walks up the tree setting it on all the ancestor entries. Does nothing if **xas** has not been walked to an entry, or is in an error state.h](h)}(h**Parameters**h]jF)}(hj^h]h Parameters}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj\ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMphjXubj)}(hhh](j)}(h7``const struct xa_state *xas`` XArray operation state. h](j)}(h``const struct xa_state *xas``h]j3)}(hj}h]hconst struct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj{ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMmhjwubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMmhjubah}(h]h ]h"]h$]h&]uh1jhjwubeh}(h]h ]h"]h$]h&]uh1jhjhMmhjtubj)}(h ``xa_mark_t mark`` Mark number. h](j)}(h``xa_mark_t mark``h]j3)}(hjh]hxa_mark_t mark}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMnhjubj)}(hhh]h)}(h Mark number.h]h Mark number.}(hjϽhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj˽hMnhj̽ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj˽hMnhjtubeh}(h]h ]h"]h$]h&]uh1jhjXubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMphjXubh)}(hSets the specified mark on this entry, and walks up the tree setting it on all the ancestor entries. Does nothing if **xas** has not been walked to an entry, or is in an error state.h](hvSets the specified mark on this entry, and walks up the tree setting it on all the ancestor entries. Does nothing if }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh: has not been walked to an entry, or is in an error state.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMphjXubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_clear_mark (C function)c.xas_clear_markhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h@void xas_clear_mark (const struct xa_state *xas, xa_mark_t mark)h]jI)}(h?void xas_clear_mark(const struct xa_state *xas, xa_mark_t mark)h](jO)}(hvoidh]hvoid}(hjHhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjDhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjWhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjDhhhjVhMubj)}(hxas_clear_markh]j)}(hxas_clear_markh]hxas_clear_mark}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ](jjeh"]h$]h&]hhuh1jhjDhhhjVhMubj)}(h,(const struct xa_state *xas, xa_mark_t mark)h](j)}(hconst struct xa_state *xash](je)}(hjhh]hconst}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubje)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jksbc.xas_clear_markasbuh1hhjubja)}(h h]h }(hj޾hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj}ubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]jھc.xas_clear_markasbuh1hhjubja)}(h h]h }(hj3hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hmarkh]hmark}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj}ubeh}(h]h ]h"]h$]h&]hhuh1jhjDhhhjVhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj@hhhjVhMubah}(h]j;ah ](j j eh"]h$]h&]jj)jhuh1jBhjVhMhj=hhubj)}(hhh]h)}(h.Clears the mark on this entry and its parents.h]h.Clears the mark on this entry and its parents.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhhubah}(h]h ]h"]h$]h&]uh1jhj=hhhjVhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hXH**Parameters** ``const struct xa_state *xas`` XArray operation state. ``xa_mark_t mark`` Mark number. **Description** Clears the specified mark on this entry, and walks back to the head attempting to clear it on all the ancestor entries. Does nothing if **xas** has not been walked to an entry, or is in an error state.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh](j)}(h7``const struct xa_state *xas`` XArray operation state. h](j)}(h``const struct xa_state *xas``h]j3)}(hjh]hconst struct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjſhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhj¿ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h ``xa_mark_t mark`` Mark number. h](j)}(h``xa_mark_t mark``h]j3)}(hjh]hxa_mark_t mark}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj߿ubj)}(hhh]h)}(h Mark number.h]h Mark number.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhj߿ubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hj h]h Description}(hj"hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hClears the specified mark on this entry, and walks back to the head attempting to clear it on all the ancestor entries. Does nothing if **xas** has not been walked to an entry, or is in an error state.h](hClears the specified mark on this entry, and walks back to the head attempting to clear it on all the ancestor entries. Does nothing if }(hj6hhhNhNubjF)}(h**xas**h]hxas}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj6ubh: has not been walked to an entry, or is in an error state.}(hj6hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_init_marks (C function)c.xas_init_markshNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h0void xas_init_marks (const struct xa_state *xas)h]jI)}(h/void xas_init_marks(const struct xa_state *xas)h](jO)}(hvoidh]hvoid}(hjwhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjshhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjshhhjhMubj)}(hxas_init_marksh]j)}(hxas_init_marksh]hxas_init_marks}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjshhhjhMubj)}(h(const struct xa_state *xas)h]j)}(hconst struct xa_state *xash](je)}(hjhh]hconst}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubje)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.xas_init_marksasbuh1hhjubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjshhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjohhhjhMubah}(h]jjah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjlhhubj)}(hhh]h)}(h"Initialise all marks for the entryh]h"Initialise all marks for the entry}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjOhhubah}(h]h ]h"]h$]h&]uh1jhjlhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jjj7jjj8j9j:uh1j=hhhjhNhNubj<)}(hXa**Parameters** ``const struct xa_state *xas`` Array operations state. **Description** Initialise all marks for the entry specified by **xas**. If we're tracking free entries with a mark, we need to set it on all entries. All other marks are cleared. This implementation is not as efficient as it could be; we may walk up the tree multiple times.h](h)}(h**Parameters**h]jF)}(hjth]h Parameters}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjrubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjnubj)}(hhh]j)}(h7``const struct xa_state *xas`` Array operations state. h](j)}(h``const struct xa_state *xas``h]j3)}(hjh]hconst struct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hArray operations state.h]hArray operations state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjnubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjnubh)}(hInitialise all marks for the entry specified by **xas**. If we're tracking free entries with a mark, we need to set it on all entries. All other marks are cleared.h](h0Initialise all marks for the entry specified by }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubhp. If we’re tracking free entries with a mark, we need to set it on all entries. All other marks are cleared.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjnubh)}(h_This implementation is not as efficient as it could be; we may walk up the tree multiple times.h]h_This implementation is not as efficient as it could be; we may walk up the tree multiple times.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjnubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_split_alloc (C function)c.xas_split_allochNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hWvoid xas_split_alloc (struct xa_state *xas, void *entry, unsigned int order, gfp_t gfp)h]jI)}(hVvoid xas_split_alloc(struct xa_state *xas, void *entry, unsigned int order, gfp_t gfp)h](jO)}(hvoidh]hvoid}(hj4hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj0hhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjChhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj0hhhjBhMubj)}(hxas_split_alloch]j)}(hxas_split_alloch]hxas_split_alloc}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ](jjeh"]h$]h&]hhuh1jhj0hhhjBhMubj)}(hB(struct xa_state *xas, void *entry, unsigned int order, gfp_t gfp)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjqhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjmubja)}(h h]h }(hj~hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjmubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jWsbc.xas_split_allocasbuh1hhjmubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjmubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjmubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjmubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjiubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjiubj)}(hunsigned int orderh](jO)}(hunsignedh]hunsigned}(hj%hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj!ubja)}(h h]h }(hj3hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj!ubjO)}(hinth]hint}(hjAhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj!ubja)}(h h]h }(hjOhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj!ubj)}(horderh]horder}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj!ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjiubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjyhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjvubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj{modnameN classnameNjt%jw%)}jz%]jc.xas_split_allocasbuh1hhjrubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjrubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjrubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjiubeh}(h]h ]h"]h$]h&]hhuh1jhj0hhhjBhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj,hhhjBhMubah}(h]j'ah ](j j eh"]h$]h&]jj)jhuh1jBhjBhMhj)hhubj)}(hhh]h)}(h'Allocate memory for splitting an entry.h]h'Allocate memory for splitting an entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhj)hhhjBhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. ``void *entry`` New entry which will be stored in the array. ``unsigned int order`` Current entry order. ``gfp_t gfp`` Memory allocation flags. **Description** This function should be called before calling xas_split(). If necessary, it will allocate new nodes (and fill them with **entry**) to prepare for the upcoming split of an entry of **order** size into entries of the order stored in the **xas**. **Context** May sleep if **gfp** flags permit.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjh]hstruct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(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 hjubj)}(h=``void *entry`` New entry which will be stored in the array. h](j)}(h``void *entry``h]j3)}(hjIh]h void *entry}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjGubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjCubj)}(hhh]h)}(h,New entry which will be stored in the array.h]h,New entry which will be stored in the array.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^hM hj_ubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhj^hM hjubj)}(h,``unsigned int order`` Current entry order. h](j)}(h``unsigned int order``h]j3)}(hjh]hunsigned int order}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj|ubj)}(hhh]h)}(hCurrent entry order.h]hCurrent entry order.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hThis function should be called before calling xas_split(). If necessary, it will allocate new nodes (and fill them with **entry**) to prepare for the upcoming split of an entry of **order** size into entries of the order stored in the **xas**.h](hxThis function should be called before calling xas_split(). If necessary, it will allocate new nodes (and fill them with }(hj hhhNhNubjF)}(h **entry**h]hentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubh3) to prepare for the upcoming split of an entry of }(hj hhhNhNubjF)}(h **order**h]horder}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubh. size into entries of the order stored in the }(hj hhhNhNubjF)}(h**xas**h]hxas}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubh.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h **Context**h]jF)}(hjSh]hContext}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjQubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h"May sleep if **gfp** flags permit.h](h May sleep if }(hjihhhNhNubjF)}(h**gfp**h]hgfp}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjiubh flags permit.}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_split (C function) c.xas_splithNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hFvoid xas_split (struct xa_state *xas, void *entry, unsigned int order)h]jI)}(hEvoid xas_split(struct xa_state *xas, void *entry, unsigned int order)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM>ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhM>ubj)}(h xas_splith]j)}(h xas_splith]h xas_split}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhM>ubj)}(h7(struct xa_state *xas, void *entry, unsigned int order)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsb c.xas_splitasbuh1hhjubja)}(h h]h }(hj%hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj3hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hj@hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjYhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjUubja)}(h h]h }(hjghhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjUubjr)}(hjh]h*}(hjuhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjUubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned int orderh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hinth]hint}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(horderh]horder}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhM>ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhM>ubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhM>hjhhubj)}(hhh]h)}(h/Split a multi-index entry into smaller entries.h]h/Split a multi-index entry into smaller entries.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM4hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhM>ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hXh**Parameters** ``struct xa_state *xas`` XArray operation state. ``void *entry`` New entry to store in the array. ``unsigned int order`` Current entry order. **Description** The size of the new entries is set in **xas**. The value in **entry** is copied to all the replacement entries. **Context** Any context. The caller should hold the xa_lock.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM8hjubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hj>h]hstruct xa_state *xas}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj<ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM5hj8ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjShM5hjTubah}(h]h ]h"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]uh1jhjShM5hj5ubj)}(h1``void *entry`` New entry to store in the array. h](j)}(h``void *entry``h]j3)}(hjwh]h void *entry}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjuubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM6hjqubj)}(hhh]h)}(h New entry to store in the array.h]h New entry to store in the array.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM6hjubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjhM6hj5ubj)}(h,``unsigned int order`` Current entry order. h](j)}(h``unsigned int order``h]j3)}(hjh]hunsigned int order}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM7hjubj)}(hhh]h)}(hCurrent entry order.h]hCurrent entry order.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM7hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM7hj5ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM9hjubh)}(hpThe size of the new entries is set in **xas**. The value in **entry** is copied to all the replacement entries.h](h&The size of the new entries is set in }(hjhhhNhNubjF)}(h**xas**h]hxas}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh. The value in }(hjhhhNhNubjF)}(h **entry**h]hentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh* is copied to all the replacement entries.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM9hjubh)}(h **Context**h]jF)}(hj6h]hContext}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj4ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM<hjubh)}(h1Any context. The caller should hold the xa_lock.h]h1Any context. The caller should hold the xa_lock.}(hjLhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM<hjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9$xas_try_split_min_order (C function)c.xas_try_split_min_orderhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h9unsigned int xas_try_split_min_order (unsigned int order)h]jI)}(h8unsigned int xas_try_split_min_order(unsigned int order)h](jO)}(hunsignedh]hunsigned}(hj{hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjwhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM~ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjwhhhjhM~ubjO)}(hinth]hint}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjwhhhjhM~ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjwhhhjhM~ubj)}(hxas_try_split_min_orderh]j)}(hxas_try_split_min_orderh]hxas_try_split_min_order}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjwhhhjhM~ubj)}(h(unsigned int order)h]j)}(hunsigned int orderh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hinth]hint}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(horderh]horder}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjwhhhjhM~ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjshhhjhM~ubah}(h]jnah ](j j eh"]h$]h&]jj)jhuh1jBhjhM~hjphhubj)}(hhh]h)}(h.Minimal split order xas_try_split() can accepth]h.Minimal split order xas_try_split() can accept}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMrhj3hhubah}(h]h ]h"]h$]h&]uh1jhjphhhjhM~ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jNj7jNj8j9j:uh1j=hhhjhNhNubj<)}(hXN**Parameters** ``unsigned int order`` Current entry order. **Description** xas_try_split() can split a multi-index entry to smaller than **order** - 1 if no new xa_node is needed. This function provides the minimal order xas_try_split() supports. **Return** the minimal order xas_try_split() supports **Context** Any context.h](h)}(h**Parameters**h]jF)}(hjXh]h Parameters}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjVubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMvhjRubj)}(hhh]j)}(h,``unsigned int order`` Current entry order. h](j)}(h``unsigned int order``h]j3)}(hjwh]hunsigned int order}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjuubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMshjqubj)}(hhh]h)}(hCurrent entry order.h]hCurrent entry order.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMshjubah}(h]h ]h"]h$]h&]uh1jhjqubeh}(h]h ]h"]h$]h&]uh1jhjhMshjnubah}(h]h ]h"]h$]h&]uh1jhjRubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMuhjRubh)}(hxas_try_split() can split a multi-index entry to smaller than **order** - 1 if no new xa_node is needed. This function provides the minimal order xas_try_split() supports.h](h>xas_try_split() can split a multi-index entry to smaller than }(hjhhhNhNubjF)}(h **order**h]horder}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubhd - 1 if no new xa_node is needed. This function provides the minimal order xas_try_split() supports.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMuhjRubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMyhjRubh)}(h*the minimal order xas_try_split() supportsh]h*the minimal order xas_try_split() supports}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMyhjRubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM{hjRubh)}(h Any context.h]h Any context.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM{hjRubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_try_split (C function)c.xas_try_splithNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hJvoid xas_try_split (struct xa_state *xas, void *entry, unsigned int order)h]jI)}(hIvoid xas_try_split(struct xa_state *xas, void *entry, unsigned int order)h](jO)}(hvoidh]hvoid}(hjWhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjShhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjfhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjShhhjehMubj)}(h xas_try_splith]j)}(h xas_try_splith]h xas_try_split}(hjxhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjtubah}(h]h ](jjeh"]h$]h&]hhuh1jhjShhhjehMubj)}(h7(struct xa_state *xas, void *entry, unsigned int order)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jzsbc.xas_try_splitasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj"hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned int orderh](jO)}(hunsignedh]hunsigned}(hjHhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjDubja)}(h h]h }(hjVhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjDubjO)}(hinth]hint}(hjdhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjDubja)}(h h]h }(hjrhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjDubj)}(horderh]horder}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjDubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjShhhjehMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjOhhhjehMubah}(h]jJah ](j j eh"]h$]h&]jj)jhuh1jBhjehMhjLhhubj)}(hhh]h)}(h!Try to split a multi-index entry.h]h!Try to split a multi-index entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjLhhhjehMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. ``void *entry`` New entry to store in the array. ``unsigned int order`` Current entry order. **Description** The size of the new entries is set in **xas**. The value in **entry** is copied to all the replacement entries. If and only if one new xa_node is needed, the function will use GFP_NOWAIT to get one if xas->xa_alloc is NULL. If more new xa_node are needed, the function gives EINVAL error. **NOTE** use xas_try_split_min_order() to get next split order instead of **order** - 1 if you want to minmize xas_try_split() calls. **Context** Any context. The caller should hold the xa_lock.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjh]hstruct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h1``void *entry`` New entry to store in the array. h](j)}(h``void *entry``h]j3)}(hj$h]h void *entry}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj"ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(h New entry to store in the array.h]h New entry to store in the array.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hMhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hMhjubj)}(h,``unsigned int order`` Current entry order. h](j)}(h``unsigned int order``h]j3)}(hj]h]hunsigned int order}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj[ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjWubj)}(hhh]h)}(hCurrent entry order.h]hCurrent entry order.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhMhjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hX!The size of the new entries is set in **xas**. The value in **entry** is copied to all the replacement entries. If and only if one new xa_node is needed, the function will use GFP_NOWAIT to get one if xas->xa_alloc is NULL. If more new xa_node are needed, the function gives EINVAL error.h](h&The size of the new entries is set in }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh. The value in }(hjhhhNhNubjF)}(h **entry**h]hentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh is copied to all the replacement entries. If and only if one new xa_node is needed, the function will use GFP_NOWAIT to get one if xas->xa_alloc is NULL. If more new xa_node are needed, the function gives EINVAL error.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h**NOTE**h]jF)}(hjh]hNOTE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h|use xas_try_split_min_order() to get next split order instead of **order** - 1 if you want to minmize xas_try_split() calls.h](hAuse xas_try_split_min_order() to get next split order instead of }(hjhhhNhNubjF)}(h **order**h]horder}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh2 - 1 if you want to minmize xas_try_split() calls.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h1Any context. The caller should hold the xa_lock.h]h1Any context. The caller should hold the xa_lock.}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_pause (C function) c.xas_pausehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h%void xas_pause (struct xa_state *xas)h]jI)}(h$void xas_pause(struct xa_state *xas)h](jO)}(hvoidh]hvoid}(hjahhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj]hhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjphhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj]hhhjohMubj)}(h xas_pauseh]j)}(h xas_pauseh]h xas_pause}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj]hhhjohMubj)}(h(struct xa_state *xas)h]j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsb c.xas_pauseasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhj]hhhjohMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjYhhhjohMubah}(h]jTah ](j j eh"]h$]h&]jj)jhuh1jBhjohMhjVhhubj)}(hhh]h)}(hPause a walk to drop a lock.h]hPause a walk to drop a lock.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjVhhhjohMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j9j7j9j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. **Description** Some users need to pause a walk and drop the lock they're holding in order to yield to a higher priority thread or carry out an operation on an entry. Those users should call this function before they drop the lock. It resets the **xas** to be suitable for the next iteration of the loop after the user has reacquired the lock. If most entries found during a walk require you to call xas_pause(), the xa_for_each() iterator may be more appropriate. Note that xas_pause() only works for forward iteration. If a user needs to pause a reverse iteration, we will need a xas_pause_rev().h](h)}(h**Parameters**h]jF)}(hjCh]h Parameters}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjAubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj=ubj)}(hhh]j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjbh]hstruct xa_state *xas}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj`ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj\ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhMhjxubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhjwhMhjYubah}(h]h ]h"]h$]h&]uh1jhj=ubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj=ubh)}(hXSome users need to pause a walk and drop the lock they're holding in order to yield to a higher priority thread or carry out an operation on an entry. Those users should call this function before they drop the lock. It resets the **xas** to be suitable for the next iteration of the loop after the user has reacquired the lock. If most entries found during a walk require you to call xas_pause(), the xa_for_each() iterator may be more appropriate.h](hSome users need to pause a walk and drop the lock they’re holding in order to yield to a higher priority thread or carry out an operation on an entry. Those users should call this function before they drop the lock. It resets the }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh to be suitable for the next iteration of the loop after the user has reacquired the lock. If most entries found during a walk require you to call xas_pause(), the xa_for_each() iterator may be more appropriate.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj=ubh)}(hNote that xas_pause() only works for forward iteration. If a user needs to pause a reverse iteration, we will need a xas_pause_rev().h]hNote that xas_pause() only works for forward iteration. If a user needs to pause a reverse iteration, we will need a xas_pause_rev().}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj=ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_find (C function) c.xas_findhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h9void * xas_find (struct xa_state *xas, unsigned long max)h]jI)}(h7void *xas_find(struct xa_state *xas, unsigned long max)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMqubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMqubjr)}(hjh]h*}(hj hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhjhMqubj)}(hxas_findh]j)}(hxas_findh]hxas_find}(hj1hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMqubj)}(h)(struct xa_state *xas, unsigned long max)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjMhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjIubja)}(h h]h }(hjZhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjIubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjhubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmmodnameN classnameNjt%jw%)}jz%]j}%)}jp%j3sb c.xas_findasbuh1hhjIubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjIubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjIubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjIubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjEubj)}(hunsigned long maxh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hmaxh]hmax}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjEubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMqubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMqubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMqhjhhubj)}(hhh]h)}(h*Find the next present entry in the XArray.h]h*Find the next present entry in the XArray.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMbhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMqubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j9j7j9j8j9j:uh1j=hhhjhNhNubj<)}(hXS**Parameters** ``struct xa_state *xas`` XArray operation state. ``unsigned long max`` Highest index to return. **Description** If the **xas** has not yet been walked to an entry, return the entry which has an index >= xas.xa_index. If it has been walked, the entry currently being pointed at has been processed, and so we move to the next entry. If no entry is found and the array is smaller than **max**, the iterator is set to the smallest index not yet in the array. This allows **xas** to be immediately passed to xas_store(). **Return** The entry, if found, otherwise ``NULL``.h](h)}(h**Parameters**h]jF)}(hjCh]h Parameters}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjAubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMfhj=ubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjbh]hstruct xa_state *xas}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj`ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMchj\ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjwhMchjxubah}(h]h ]h"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]uh1jhjwhMchjYubj)}(h/``unsigned long max`` Highest index to return. h](j)}(h``unsigned long max``h]j3)}(hjh]hunsigned long max}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMdhjubj)}(hhh]h)}(hHighest index to return.h]hHighest index to return.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMdhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMdhjYubeh}(h]h ]h"]h$]h&]uh1jhj=ubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMfhj=ubh)}(hIf the **xas** has not yet been walked to an entry, return the entry which has an index >= xas.xa_index. If it has been walked, the entry currently being pointed at has been processed, and so we move to the next entry.h](hIf the }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh has not yet been walked to an entry, return the entry which has an index >= xas.xa_index. If it has been walked, the entry currently being pointed at has been processed, and so we move to the next entry.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMfhj=ubh)}(hIf no entry is found and the array is smaller than **max**, the iterator is set to the smallest index not yet in the array. This allows **xas** to be immediately passed to xas_store().h](h3If no entry is found and the array is smaller than }(hj hhhNhNubjF)}(h**max**h]hmax}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubhO, the iterator is set to the smallest index not yet in the array. This allows }(hj hhhNhNubjF)}(h**xas**h]hxas}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubh) to be immediately passed to xas_store().}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMkhj=ubh)}(h **Return**h]jF)}(hjBh]hReturn}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj@ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMohj=ubh)}(h(The entry, if found, otherwise ``NULL``.h](hThe entry, if found, otherwise }(hjXhhhNhNubj3)}(h``NULL``h]hNULL}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjXubh.}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMohj=ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_find_marked (C function)c.xas_find_markedhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hPvoid * xas_find_marked (struct xa_state *xas, unsigned long max, xa_mark_t mark)h]jI)}(hNvoid *xas_find_marked(struct xa_state *xas, unsigned long max, xa_mark_t mark)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhjhMubj)}(hxas_find_markedh]j)}(hxas_find_markedh]hxas_find_marked}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h9(struct xa_state *xas, unsigned long max, xa_mark_t mark)h](j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.xas_find_markedasbuh1hhjubja)}(h h]h }(hj!hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj/hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long maxh](jO)}(hunsignedh]hunsigned}(hjUhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjQubja)}(h h]h }(hjchhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjQubjO)}(hlongh]hlong}(hjqhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjQubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjQubj)}(hmaxh]hmax}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]jc.xas_find_markedasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hmarkh]hmark}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h)Find the next marked entry in the XArray.h]h)Find the next marked entry in the XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX4**Parameters** ``struct xa_state *xas`` XArray operation state. ``unsigned long max`` Highest index to return. ``xa_mark_t mark`` Mark number to search for. **Description** If the **xas** has not yet been walked to an entry, return the marked entry which has an index >= xas.xa_index. If it has been walked, the entry currently being pointed at has been processed, and so we return the first marked entry with an index > xas.xa_index. If no marked entry is found and the array is smaller than **max**, **xas** is set to the bounds state and xas->xa_index is set to the smallest index not yet in the array. This allows **xas** to be immediately passed to xas_store(). If no entry is found before **max** is reached, **xas** is set to the restart state. **Return** The entry, if found, otherwise ``NULL``.h](h)}(h**Parameters**h]jF)}(hj!h]h Parameters}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh](j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hj@h]hstruct xa_state *xas}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj>ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj:ubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjUhMhjVubah}(h]h ]h"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]uh1jhjUhMhj7ubj)}(h/``unsigned long max`` Highest index to return. h](j)}(h``unsigned long max``h]j3)}(hjyh]hunsigned long max}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjwubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjsubj)}(hhh]h)}(hHighest index to return.h]hHighest index to return.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjsubeh}(h]h ]h"]h$]h&]uh1jhjhMhj7ubj)}(h.``xa_mark_t mark`` Mark number to search for. h](j)}(h``xa_mark_t mark``h]j3)}(hjh]hxa_mark_t mark}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hMark number to search for.h]hMark number to search for.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj7ubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hXIf the **xas** has not yet been walked to an entry, return the marked entry which has an index >= xas.xa_index. If it has been walked, the entry currently being pointed at has been processed, and so we return the first marked entry with an index > xas.xa_index.h](hIf the }(hjhhhNhNubjF)}(h**xas**h]hxas}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh has not yet been walked to an entry, return the marked entry which has an index >= xas.xa_index. If it has been walked, the entry currently being pointed at has been processed, and so we return the first marked entry with an index > xas.xa_index.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hIf no marked entry is found and the array is smaller than **max**, **xas** is set to the bounds state and xas->xa_index is set to the smallest index not yet in the array. This allows **xas** to be immediately passed to xas_store().h](h:If no marked entry is found and the array is smaller than }(hj$hhhNhNubjF)}(h**max**h]hmax}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj$ubh, }(hj$hhhNhNubjF)}(h**xas**h]hxas}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj$ubhn is set to the bounds state and xas->xa_index is set to the smallest index not yet in the array. This allows }(hj$hhhNhNubjF)}(h**xas**h]hxas}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj$ubh) to be immediately passed to xas_store().}(hj$hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hTIf no entry is found before **max** is reached, **xas** is set to the restart state.h](hIf no entry is found before }(hjihhhNhNubjF)}(h**max**h]hmax}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjiubh is reached, }(hjihhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjiubh is set to the restart state.}(hjihhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h(The entry, if found, otherwise ``NULL``.h](hThe entry, if found, otherwise }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_find_conflict (C function)c.xas_find_conflicthNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h/void * xas_find_conflict (struct xa_state *xas)h]jI)}(h-void *xas_find_conflict(struct xa_state *xas)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhjhMubj)}(hxas_find_conflicth]j)}(hxas_find_conflicth]hxas_find_conflict}(hj#hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h(struct xa_state *xas)h]j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hj?hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj;ubja)}(h h]h }(hjLhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj;ubh)}(hhh]j)}(hxa_stateh]hxa_state}(hj]hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj_modnameN classnameNjt%jw%)}jz%]j}%)}jp%j%sbc.xas_find_conflictasbuh1hhj;ubja)}(h h]h }(hj}hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj;ubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj;ubj)}(hxash]hxas}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj7ubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h'Find the next present entry in a range.h]h'Find the next present entry in a range.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xa_state *xas`` XArray operation state. **Description** The **xas** describes both a range and a position within that range. **Context** Any context. Expects xa_lock to be held. **Return** The next entry in the range covered by **xas** or ``NULL``.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubj)}(hhh]j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjh]hstruct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj<ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubh)}(hDThe **xas** describes both a range and a position within that range.h](hThe }(hjThhhNhNubjF)}(h**xas**h]hxas}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjTubh9 describes both a range and a position within that range.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubh)}(h **Context**h]jF)}(hjwh]hContext}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjuubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubh)}(h)Any context. Expects xa_lock to be held.h]h)Any context. Expects xa_lock to be held.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h;The next entry in the range covered by **xas** or ``NULL``.h](h'The next entry in the range covered by }(hjhhhNhNubjF)}(h**xas**h]hxas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh or }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_load (C function) c.xa_loadhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h7void * xa_load (struct xarray *xa, unsigned long index)h]jI)}(h5void *xa_load(struct xarray *xa, unsigned long index)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMLubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMLubjr)}(hjh]h*}(hj$hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhjhMLubj)}(hxa_loadh]j)}(hxa_loadh]hxa_load}(hj5hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMLubj)}(h((struct xarray *xa, unsigned long index)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjQhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjMubja)}(h h]h }(hj^hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjMubh)}(hhh]j)}(hxarrayh]hxarray}(hjohhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjqmodnameN classnameNjt%jw%)}jz%]j}%)}jp%j7sb c.xa_loadasbuh1hhjMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjMubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjMubj)}(hxah]hxa}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjIubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjIubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMLubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMLubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMLhjhhubj)}(hhh]h)}(hLoad an entry from an XArray.h]hLoad an entry from an XArray.}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMEhj"hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMLubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j=j7j=j8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` index into array. **Context** Any context. Takes and releases the RCU lock. **Return** The entry at **index** in **xa**.h](h)}(h**Parameters**h]jF)}(hjGh]h Parameters}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjEubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMIhjAubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjfh]hstruct xarray *xa}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjdubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMFhj`ubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj{hMFhj|ubah}(h]h ]h"]h$]h&]uh1jhj`ubeh}(h]h ]h"]h$]h&]uh1jhj{hMFhj]ubj)}(h*``unsigned long index`` index into array. h](j)}(h``unsigned long index``h]j3)}(hjh]hunsigned long index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMGhjubj)}(hhh]h)}(hindex into array.h]hindex into array.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMGhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMGhj]ubeh}(h]h ]h"]h$]h&]uh1jhjAubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMIhjAubh)}(h.Any context. Takes and releases the RCU lock.h]h.Any context. Takes and releases the RCU lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMIhjAubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMKhjAubh)}(h!The entry at **index** in **xa**.h](h The entry at }(hjhhhNhNubjF)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh in }(hjhhhNhNubjF)}(h**xa**h]hxa}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMJhjAubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9__xa_erase (C function) c.__xa_erasehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h:void * __xa_erase (struct xarray *xa, unsigned long index)h]jI)}(h8void *__xa_erase(struct xarray *xa, unsigned long index)h](jO)}(hvoidh]hvoid}(hjjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjfhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMnubja)}(h h]h }(hjyhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjfhhhjxhMnubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjfhhhjxhMnubj)}(h __xa_eraseh]j)}(h __xa_eraseh]h __xa_erase}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjfhhhjxhMnubj)}(h((struct xarray *xa, unsigned long index)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsb c.__xa_eraseasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hj&hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj"ubja)}(h h]h }(hj4hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj"ubjO)}(hlongh]hlong}(hjBhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj"ubja)}(h h]h }(hjPhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj"ubj)}(hindexh]hindex}(hj^hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjfhhhjxhMnubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjbhhhjxhMnubah}(h]j]ah ](j j eh"]h$]h&]jj)jhuh1jBhjxhMnhj_hhubj)}(hhh]h)}(h.Erase this entry from the XArray while locked.h]h.Erase this entry from the XArray while locked.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMchjhhubah}(h]h ]h"]h$]h&]uh1jhj_hhhjxhMnubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. **Description** After this function returns, loading from **index** will return ``NULL``. If the index is part of a multi-index entry, all indices will be erased and none of the entries will be part of a multi-index entry. **Context** Any context. Expects xa_lock to be held on entry. **Return** The entry which used to be at this index.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMghjubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMdhjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMdhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMdhjubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hjh]hunsigned long index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMehjubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMehjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMehjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hj=h]h Description}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj;ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMghjubh)}(hAfter this function returns, loading from **index** will return ``NULL``. If the index is part of a multi-index entry, all indices will be erased and none of the entries will be part of a multi-index entry.h](h*After this function returns, loading from }(hjShhhNhNubjF)}(h **index**h]hindex}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjSubh will return }(hjShhhNhNubj3)}(h``NULL``h]hNULL}(hjmhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjSubh. If the index is part of a multi-index entry, all indices will be erased and none of the entries will be part of a multi-index entry.}(hjShhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMghjubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMkhjubh)}(h2Any context. Expects xa_lock to be held on entry.h]h2Any context. Expects xa_lock to be held on entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMkhjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMmhjubh)}(h)The entry which used to be at this index.h]h)The entry which used to be at this index.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMlhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_erase (C function) c.xa_erasehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h8void * xa_erase (struct xarray *xa, unsigned long index)h]jI)}(h6void *xa_erase(struct xarray *xa, unsigned long index)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhjhMubj)}(hxa_eraseh]j)}(hxa_eraseh]hxa_erase}(hj"hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h((struct xarray *xa, unsigned long index)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj>hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj:ubja)}(h h]h }(hjKhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj:ubh)}(hhh]j)}(hxarrayh]hxarray}(hj\hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjYubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj^modnameN classnameNjt%jw%)}jz%]j}%)}jp%j$sb c.xa_eraseasbuh1hhj:ubja)}(h h]h }(hj|hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj:ubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj:ubj)}(hxah]hxa}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj:ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj6ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj6ubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h!Erase this entry from the XArray.h]h!Erase this entry from the XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMvhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j*j7j*j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index of entry. **Description** After this function returns, loading from **index** will return ``NULL``. If the index is part of a multi-index entry, all indices will be erased and none of the entries will be part of a multi-index entry. **Context** Any context. Takes and releases the xa_lock. **Return** The entry which used to be at this index.h](h)}(h**Parameters**h]jF)}(hj4h]h Parameters}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj2ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMzhj.ubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjSh]hstruct xarray *xa}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjQubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMwhjMubj)}(hhh]h)}(hXArray.h]hXArray.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhMwhjiubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjhhMwhjJubj)}(h(``unsigned long index`` Index of entry. h](j)}(h``unsigned long index``h]j3)}(hjh]hunsigned long index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMxhjubj)}(hhh]h)}(hIndex of entry.h]hIndex of entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMxhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMxhjJubeh}(h]h ]h"]h$]h&]uh1jhj.ubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMzhj.ubh)}(hAfter this function returns, loading from **index** will return ``NULL``. If the index is part of a multi-index entry, all indices will be erased and none of the entries will be part of a multi-index entry.h](h*After this function returns, loading from }(hjhhhNhNubjF)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh will return }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh. If the index is part of a multi-index entry, all indices will be erased and none of the entries will be part of a multi-index entry.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMzhj.ubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM~hj.ubh)}(h-Any context. Takes and releases the xa_lock.h]h-Any context. Takes and releases the xa_lock.}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM~hj.ubh)}(h **Return**h]jF)}(hj9h]hReturn}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj7ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj.ubh)}(h)The entry which used to be at this index.h]h)The entry which used to be at this index.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj.ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9__xa_store (C function) c.__xa_storehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hRvoid * __xa_store (struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h]jI)}(hPvoid *__xa_store(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](jO)}(hvoidh]hvoid}(hj~hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjzhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjzhhhjhMubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjzhhhjhMubj)}(h __xa_storeh]j)}(h __xa_storeh]h __xa_store}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjzhhhjhMubj)}(h@(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsb c.__xa_storeasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hj!hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hj:hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj6ubja)}(h h]h }(hjHhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj6ubjO)}(hlongh]hlong}(hjVhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj6ubja)}(h h]h }(hjdhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj6ubj)}(hindexh]hindex}(hjrhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j c.__xa_storeasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjzhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjvhhhjhMubah}(h]jqah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjshhubj)}(hhh]h)}(hStore this entry in the XArray.h]hStore this entry in the XArray.}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj#hhubah}(h]h ]h"]h$]h&]uh1jhjshhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j>j7j>j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *entry`` New entry. ``gfp_t gfp`` Memory allocation flags. **Description** You must already be holding the xa_lock when calling this function. It will drop the lock if needed to allocate memory, and then reacquire it afterwards. **Context** Any context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if **gfp** flags permit. **Return** The old entry at this index or xa_err() if an error happened.h](h)}(h**Parameters**h]jF)}(hjHh]h Parameters}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjFubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjBubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjgh]hstruct xarray *xa}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjeubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjaubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|hMhj}ubah}(h]h ]h"]h$]h&]uh1jhjaubeh}(h]h ]h"]h$]h&]uh1jhj|hMhj^ubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hjh]hunsigned long index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj^ubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjh]h void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(h New entry.h]h New entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhj^ubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj ubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj'hMhj(ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj'hMhj^ubeh}(h]h ]h"]h$]h&]uh1jhjBubh)}(h**Description**h]jF)}(hjMh]h Description}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjKubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjBubh)}(hYou must already be holding the xa_lock when calling this function. It will drop the lock if needed to allocate memory, and then reacquire it afterwards.h]hYou must already be holding the xa_lock when calling this function. It will drop the lock if needed to allocate memory, and then reacquire it afterwards.}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjBubh)}(h **Context**h]jF)}(hjth]hContext}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjrubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjBubh)}(hnAny context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if **gfp** flags permit.h](hYAny context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if }(hjhhhNhNubjF)}(h**gfp**h]hgfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh flags permit.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjBubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjBubh)}(h=The old entry at this index or xa_err() if an error happened.h]h=The old entry at this index or xa_err() if an error happened.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjBubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_store (C function) c.xa_storehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hPvoid * xa_store (struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h]jI)}(hNvoid *xa_store(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhjhMubj)}(hxa_storeh]j)}(hxa_storeh]hxa_store}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h@(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj<hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj8ubja)}(h h]h }(hjIhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj8ubh)}(hhh]j)}(hxarrayh]hxarray}(hjZhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjWubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj\modnameN classnameNjt%jw%)}jz%]j}%)}jp%j"sb c.xa_storeasbuh1hhj8ubja)}(h h]h }(hjzhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj8ubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj8ubj)}(hxah]hxa}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj8ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj4ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj4ubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj4ubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjAubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjFmodnameN classnameNjt%jw%)}jz%]jv c.xa_storeasbuh1hhj=ubja)}(h h]h }(hjbhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj=ubj)}(hgfph]hgfp}(hjphhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj=ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj4ubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(hStore this entry in the XArray.h]hStore this entry in the XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *entry`` New entry. ``gfp_t gfp`` Memory allocation flags. **Description** After this function returns, loads from this index will return **entry**. Storing into an existing multi-index entry updates the entry of every index. The marks associated with **index** are unaffected unless **entry** is ``NULL``. **Context** Any context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit. **Return** The old entry at this index on success, xa_err(-EINVAL) if **entry** cannot be stored in an XArray, or xa_err(-ENOMEM) if memory allocation failed.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hjh]hunsigned long index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj)hMhj*ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj)hMhjubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjMh]h void *entry}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjKubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjGubj)}(hhh]h)}(h New entry.h]h New entry.}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbhMhjcubah}(h]h ]h"]h$]h&]uh1jhjGubeh}(h]h ]h"]h$]h&]uh1jhjbhMhjubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjhhhNhNubah}(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]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hAfter this function returns, loads from this index will return **entry**. Storing into an existing multi-index entry updates the entry of every index. The marks associated with **index** are unaffected unless **entry** is ``NULL``.h](h?After this function returns, loads from this index will return }(hjhhhNhNubjF)}(h **entry**h]hentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubhi. Storing into an existing multi-index entry updates the entry of every index. The marks associated with }(hjhhhNhNubjF)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh are unaffected unless }(hjhhhNhNubjF)}(h **entry**h]hentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh is }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h **Context**h]jF)}(hj0h]hContext}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj.ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hTAny context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit.h](h?Any context. Takes and releases the xa_lock. May sleep if the }(hjFhhhNhNubjF)}(h**gfp**h]hgfp}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjFubh flags permit.}(hjFhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h **Return**h]jF)}(hjih]hReturn}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjgubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hThe old entry at this index on success, xa_err(-EINVAL) if **entry** cannot be stored in an XArray, or xa_err(-ENOMEM) if memory allocation failed.h](h;The old entry at this index on success, xa_err(-EINVAL) if }(hjhhhNhNubjF)}(h **entry**h]hentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubhO cannot be stored in an XArray, or xa_err(-ENOMEM) if memory allocation failed.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9__xa_cmpxchg (C function)c.__xa_cmpxchghNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h_void * __xa_cmpxchg (struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h]jI)}(h]void *__xa_cmpxchg(struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhjhMubj)}(h __xa_cmpxchgh]j)}(h __xa_cmpxchgh]h __xa_cmpxchg}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(hK(struct xarray *xa, unsigned long index, void *old, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hj(hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj%ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj*modnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.__xa_cmpxchgasbuh1hhjubja)}(h h]h }(hjHhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjVhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hjchhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hj|hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjxubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjxubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjxubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjxubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjxubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h void *oldh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(holdh]hold}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj ubjr)}(hjh]h*}(hj+hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj ubj)}(hentryh]hentry}(hj8hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjQubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjVmodnameN classnameNjt%jw%)}jz%]jDc.__xa_cmpxchgasbuh1hhjMubja)}(h h]h }(hjrhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjMubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(hStore this entry in the XArray.h]hStore this entry in the XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hXD**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *old`` Old value to test against. ``void *entry`` New entry. ``gfp_t gfp`` Memory allocation flags. **Description** You must already be holding the xa_lock when calling this function. It will drop the lock if needed to allocate memory, and then reacquire it afterwards. **Context** Any context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if **gfp** flags permit. **Return** The old entry at this index or xa_err() if an error happened.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hj$h]hunsigned long index}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj"ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9hMhj:ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj9hMhjubj)}(h)``void *old`` Old value to test against. h](j)}(h ``void *old``h]j3)}(hj]h]h void *old}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj[ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjWubj)}(hhh]h)}(hOld value to test against.h]hOld value to test against.}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjrhMhjsubah}(h]h ]h"]h$]h&]uh1jhjWubeh}(h]h ]h"]h$]h&]uh1jhjrhMhjubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjh]h void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(h New entry.h]h New entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjhhhNhNubah}(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]jF)}(hj h]h Description}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hYou must already be holding the xa_lock when calling this function. It will drop the lock if needed to allocate memory, and then reacquire it afterwards.h]hYou must already be holding the xa_lock when calling this function. It will drop the lock if needed to allocate memory, and then reacquire it afterwards.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h **Context**h]jF)}(hj1h]hContext}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj/ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hnAny context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if **gfp** flags permit.h](hYAny context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if }(hjGhhhNhNubjF)}(h**gfp**h]hgfp}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjGubh flags permit.}(hjGhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h **Return**h]jF)}(hjjh]hReturn}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjhubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h=The old entry at this index or xa_err() if an error happened.h]h=The old entry at this index or xa_err() if an error happened.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9__xa_insert (C function) c.__xa_inserthNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hPint __xa_insert (struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h]jI)}(hOint __xa_insert(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](jO)}(hinth]hint}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhM ubj)}(h __xa_inserth]j)}(h __xa_inserth]h __xa_insert}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhM ubj)}(h@(struct xarray *xa, unsigned long index, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj modnameN classnameNjt%jw%)}jz%]j}%)}jp%jsb c.__xa_insertasbuh1hhjubja)}(h h]h }(hj*hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj8hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hj^hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjZubja)}(h h]h }(hjlhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjZubjO)}(hlongh]hlong}(hjzhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjZubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjZubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjZubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j& c.__xa_insertasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hgfph]hgfp}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhM ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhM ubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhM hjhhubj)}(hhh]h)}(h6Store this entry in the XArray if no entry is present.h]h6Store this entry in the XArray if no entry is present.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjGhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhM ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jbj7jbj8j9j:uh1j=hhhjhNhNubj<)}(hXt**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index into array. ``void *entry`` New entry. ``gfp_t gfp`` Memory allocation flags. **Description** Inserting a NULL entry will store a reserved entry (like xa_reserve()) if no entry is present. Inserting will fail if a reserved entry is present, even though loading from this index will return NULL. **Context** Any context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if **gfp** flags permit. **Return** 0 if the store succeeded. -EBUSY if another entry was present. -ENOMEM if memory could not be allocated.h](h)}(h**Parameters**h]jF)}(hjlh]h Parameters}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjfubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h*``unsigned long index`` Index into array. h](j)}(h``unsigned long index``h]j3)}(hjh]hunsigned long index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hIndex into array.h]hIndex into array.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjh]h void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(h New entry.h]h New entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hj6h]h gfp_t gfp}(hj8hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj4ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj0ubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjKhMhjLubah}(h]h ]h"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]uh1jhjKhMhjubeh}(h]h ]h"]h$]h&]uh1jhjfubh)}(h**Description**h]jF)}(hjqh]h Description}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjoubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjfubh)}(hInserting a NULL entry will store a reserved entry (like xa_reserve()) if no entry is present. Inserting will fail if a reserved entry is present, even though loading from this index will return NULL.h]hInserting a NULL entry will store a reserved entry (like xa_reserve()) if no entry is present. Inserting will fail if a reserved entry is present, even though loading from this index will return NULL.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjfubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjfubh)}(hnAny context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if **gfp** flags permit.h](hYAny context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if }(hjhhhNhNubjF)}(h**gfp**h]hgfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh flags permit.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjfubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjfubh)}(hi0 if the store succeeded. -EBUSY if another entry was present. -ENOMEM if memory could not be allocated.h]hi0 if the store succeeded. -EBUSY if another entry was present. -ENOMEM if memory could not be allocated.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjfubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_store_range (C function)c.xa_store_rangehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hjvoid * xa_store_range (struct xarray *xa, unsigned long first, unsigned long last, void *entry, gfp_t gfp)h]jI)}(hhvoid *xa_store_range(struct xarray *xa, unsigned long first, unsigned long last, void *entry, gfp_t gfp)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMMubja)}(h h]h }(hj%hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhj$hMMubjr)}(hjh]h*}(hj3hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhj$hMMubj)}(hxa_store_rangeh]j)}(hxa_store_rangeh]hxa_store_range}(hjDhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj@ubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhj$hMMubj)}(hT(struct xarray *xa, unsigned long first, unsigned long last, void *entry, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj`hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj\ubja)}(h h]h }(hjmhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj\ubh)}(hhh]j)}(hxarrayh]hxarray}(hj~hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj{ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jFsbc.xa_store_rangeasbuh1hhj\ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj\ubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj\ubj)}(hxah]hxa}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj\ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjXubj)}(hunsigned long firsth](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hfirsth]hfirst}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjXubj)}(hunsigned long lasth](jO)}(hunsignedh]hunsigned}(hj#hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj1hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hj?hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjMhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hlasth]hlast}(hj[hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjXubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjthhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjpubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjpubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjpubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjXubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]jc.xa_store_rangeasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjXubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhj$hMMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhj$hMMubah}(h]j ah ](j j eh"]h$]h&]jj)jhuh1jBhj$hMMhj hhubj)}(hhh]h)}(h5Store this entry at a range of indices in the XArray.h]h5Store this entry at a range of indices in the XArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM<hj hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj$hMMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j'j7j'j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long first`` First index to affect. ``unsigned long last`` Last index to affect. ``void *entry`` New entry. ``gfp_t gfp`` Memory allocation flags. **Description** After this function returns, loads from any index between **first** and **last**, inclusive will return **entry**. Storing into an existing multi-index entry updates the entry of every index. The marks associated with **index** are unaffected unless **entry** is ``NULL``. **Context** Process context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit. **Return** ``NULL`` on success, xa_err(-EINVAL) if **entry** cannot be stored in an XArray, or xa_err(-ENOMEM) if memory allocation failed.h](h)}(h**Parameters**h]jF)}(hj1h]h Parameters}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj/ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM@hj+ubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjPh]hstruct xarray *xa}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjNubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM=hjJubj)}(hhh]h)}(hXArray.h]hXArray.}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1hhjehM=hjfubah}(h]h ]h"]h$]h&]uh1jhjJubeh}(h]h ]h"]h$]h&]uh1jhjehM=hjGubj)}(h/``unsigned long first`` First index to affect. h](j)}(h``unsigned long first``h]j3)}(hjh]hunsigned long first}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM>hjubj)}(hhh]h)}(hFirst index to affect.h]hFirst index to affect.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM>hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM>hjGubj)}(h-``unsigned long last`` Last index to affect. h](j)}(h``unsigned long last``h]j3)}(hjh]hunsigned long last}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM?hjubj)}(hhh]h)}(hLast index to affect.h]hLast index to affect.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM?hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM?hjGubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjh]h void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM@hjubj)}(hhh]h)}(h New entry.h]h New entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM@hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM@hjGubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hj4h]h gfp_t gfp}(hj6hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj2ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMAhj.ubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjIhMAhjJubah}(h]h ]h"]h$]h&]uh1jhj.ubeh}(h]h ]h"]h$]h&]uh1jhjIhMAhjGubeh}(h]h ]h"]h$]h&]uh1jhj+ubh)}(h**Description**h]jF)}(hjoh]h Description}(hjqhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjmubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMChj+ubh)}(hXAfter this function returns, loads from any index between **first** and **last**, inclusive will return **entry**. Storing into an existing multi-index entry updates the entry of every index. The marks associated with **index** are unaffected unless **entry** is ``NULL``.h](h:After this function returns, loads from any index between }(hjhhhNhNubjF)}(h **first**h]hfirst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh and }(hjhhhNhNubjF)}(h**last**h]hlast}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh, inclusive will return }(hjhhhNhNubjF)}(h **entry**h]hentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubhi. Storing into an existing multi-index entry updates the entry of every index. The marks associated with }(hjhhhNhNubjF)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh are unaffected unless }(hjhhhNhNubjF)}(h **entry**h]hentry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh is }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMChj+ubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMHhj+ubh)}(hYProcess context. Takes and releases the xa_lock. May sleep if the **gfp** flags permit.h](hDProcess context. Takes and releases the xa_lock. May sleep if the }(hjhhhNhNubjF)}(h**gfp**h]hgfp}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh flags permit.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMHhj+ubh)}(h **Return**h]jF)}(hj;h]hReturn}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj9ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMKhj+ubh)}(h``NULL`` on success, xa_err(-EINVAL) if **entry** cannot be stored in an XArray, or xa_err(-ENOMEM) if memory allocation failed.h](j3)}(h``NULL``h]hNULL}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjQubh on success, xa_err(-EINVAL) if }(hjQhhhNhNubjF)}(h **entry**h]hentry}(hjghhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjQubhO cannot be stored in an XArray, or xa_err(-ENOMEM) if memory allocation failed.}(hjQhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMJhj+ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xas_get_order (C function)c.xas_get_orderhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h(int xas_get_order (struct xa_state *xas)h]jI)}(h'int xas_get_order(struct xa_state *xas)h](jO)}(hinth]hint}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMyubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMyubj)}(h xas_get_orderh]j)}(h xas_get_orderh]h xas_get_order}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMyubj)}(h(struct xa_state *xas)h]j)}(hstruct xa_state *xash](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_stateh]hxa_state}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.xas_get_orderasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj)hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxash]hxas}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMyubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMyubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMyhjhhubj)}(hhh]h)}(hGet the order of an entry.h]hGet the order of an entry.}(hj`hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMrhj]hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMyubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jxj7jxj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``struct xa_state *xas`` XArray operation state. **Description** Called after xas_load, the xas should not be in an error state. **Return** A number between 0 and 63 indicating the order of the entry.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMvhj|ubj)}(hhh]j)}(h1``struct xa_state *xas`` XArray operation state. h](j)}(h``struct xa_state *xas``h]j3)}(hjh]hstruct xa_state *xas}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMshjubj)}(hhh]h)}(hXArray operation state.h]hXArray operation state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMshjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMshjubah}(h]h ]h"]h$]h&]uh1jhj|ubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMuhj|ubh)}(h?Called after xas_load, the xas should not be in an error state.h]h?Called after xas_load, the xas should not be in an error state.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMuhj|ubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMwhj|ubh)}(h)}(hhh](jC)}(h9int xa_get_order (struct xarray *xa, unsigned long index)h]jI)}(h8int xa_get_order(struct xarray *xa, unsigned long index)h](jO)}(hinth]hint}(hjHhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjDhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjWhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjDhhhjVhMubj)}(h xa_get_orderh]j)}(h xa_get_orderh]h xa_get_order}(hjihhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjeubah}(h]h ](jjeh"]h$]h&]hhuh1jhjDhhhjVhMubj)}(h((struct xarray *xa, unsigned long index)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jksbc.xa_get_orderasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj}ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj!hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hindexh]hindex}(hj/hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj}ubeh}(h]h ]h"]h$]h&]hhuh1jhjDhhhjVhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj@hhhjVhMubah}(h]j;ah ](j j eh"]h$]h&]jj)jhuh1jBhjVhMhj=hhubj)}(hhh]h)}(hGet the order of an entry.h]hGet the order of an entry.}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjVhhubah}(h]h ]h"]h$]h&]uh1jhj=hhhjVhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jqj7jqj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index of the entry. **Return** A number between 0 and 63 indicating the order of the entry.h](h)}(h**Parameters**h]jF)}(hj{h]h Parameters}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjyubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjuubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h,``unsigned long index`` Index of the entry. h](j)}(h``unsigned long index``h]j3)}(hjh]hunsigned long index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hIndex of the entry.h]hIndex of the entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjuubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjuubh)}(h)}(hhh](jC)}(hZint __xa_alloc (struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h]jI)}(hYint __xa_alloc(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h](jO)}(hinth]hint}(hjShhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjOhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjbhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjOhhhjahMubj)}(h __xa_alloch]j)}(h __xa_alloch]h __xa_alloc}(hjthhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjpubah}(h]h ](jjeh"]h$]h&]hhuh1jhjOhhhjahMubj)}(hK(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jvsb c.__xa_allocasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hu32 *idh](h)}(hhh]j)}(hu32h]hu32}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j c.__xa_allocasbuh1hhjubja)}(h h]h }(hj#hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj1hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hidh]hid}(hj>hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjWhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjSubja)}(h h]h }(hjehhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjSubjr)}(hjh]h*}(hjshhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjSubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjSubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hstruct xa_limit limith](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_limith]hxa_limit}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j c.__xa_allocasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hlimith]hlimit}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j c.__xa_allocasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hgfph]hgfp}(hj+hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjOhhhjahMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjKhhhjahMubah}(h]jFah ](j j eh"]h$]h&]jj)jhuh1jBhjahMhjHhhubj)}(hhh]h)}(h1Find somewhere to store this entry in the XArray.h]h1Find somewhere to store this entry in the XArray.}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjRhhubah}(h]h ]h"]h$]h&]uh1jhjHhhhjahMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jmj7jmj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``u32 *id`` Pointer to ID. ``void *entry`` New entry. ``struct xa_limit limit`` Range for allocated ID. ``gfp_t gfp`` Memory allocation flags. **Description** Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags(). **Context** Any context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if **gfp** flags permit. **Return** 0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h)}(h**Parameters**h]jF)}(hjwh]h Parameters}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjuubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjqubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``u32 *id`` Pointer to ID. h](j)}(h ``u32 *id``h]j3)}(hjh]hu32 *id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hPointer to ID.h]hPointer to ID.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjh]h void *entry}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(h New entry.h]h New entry.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h2``struct xa_limit limit`` Range for allocated ID. h](j)}(h``struct xa_limit limit``h]j3)}(hjAh]hstruct xa_limit limit}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj?ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj;ubj)}(hhh]h)}(hRange for allocated ID.h]hRange for allocated ID.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjVhMhjWubah}(h]h ]h"]h$]h&]uh1jhj;ubeh}(h]h ]h"]h$]h&]uh1jhjVhMhjubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjzh]h gfp_t gfp}(hj|hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjxubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjtubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjtubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjqubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjqubh)}(hFinds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**.h](hFinds an empty entry in }(hjhhhNhNubjF)}(h**xa**h]hxa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh between }(hjhhhNhNubjF)}(h **limit.min**h]h limit.min}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh and }(hjhhhNhNubjF)}(h **limit.max**h]h limit.max}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh, stores the index into the }(hjhhhNhNubjF)}(h**id**h]hid}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubhb pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised }(hjhhhNhNubjF)}(h**id**h]hid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjqubh)}(h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().h]h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjqubh)}(h **Context**h]jF)}(hjEh]hContext}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjCubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjqubh)}(hnAny context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if **gfp** flags permit.h](hYAny context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if }(hj[hhhNhNubjF)}(h**gfp**h]hgfp}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj[ubh flags permit.}(hj[hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjqubh)}(h **Return**h]jF)}(hj~h]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj|ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjqubh)}(hk0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](ha0 on success, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in }(hjhhhNhNubjF)}(h **limit**h]hlimit}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjqubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9__xa_alloc_cyclic (C function)c.__xa_alloc_cyclichNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hlint __xa_alloc_cyclic (struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h]jI)}(hkint __xa_alloc_cyclic(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h](jO)}(hinth]hint}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubj)}(h__xa_alloc_cyclich]j)}(h__xa_alloc_cyclich]h__xa_alloc_cyclic}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(hV(struct xarray *xa, u32 *id, void *entry, struct xa_limit limit, u32 *next, gfp_t gfp)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hj0hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj-ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj2modnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.__xa_alloc_cyclicasbuh1hhjubja)}(h h]h }(hjPhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj^hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hjkhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubj)}(hu32 *idh](h)}(hhh]j)}(hu32h]hu32}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]jLc.__xa_alloc_cyclicasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hidh]hid}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubj)}(h void *entryh](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hentryh]hentry}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubj)}(hstruct xa_limit limith](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hj(hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_limith]hxa_limit}(hj9hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj6ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj;modnameN classnameNjt%jw%)}jz%]jLc.__xa_alloc_cyclicasbuh1hhjubja)}(h h]h }(hjWhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hlimith]hlimit}(hjehhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubj)}(h u32 *nexth](h)}(hhh]j)}(hu32h]hu32}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj~ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]jLc.__xa_alloc_cyclicasbuh1hhjzubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjzubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjzubj)}(hnexth]hnext}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjzubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubj)}(h gfp_t gfph](h)}(hhh]j)}(hgfp_th]hgfp_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]jLc.__xa_alloc_cyclicasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hgfph]hgfp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h1Find somewhere to store this entry in the XArray.h]h1Find somewhere to store this entry in the XArray.}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhj)hhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jDj7jDj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``u32 *id`` Pointer to ID. ``void *entry`` New entry. ``struct xa_limit limit`` Range of allocated ID. ``u32 *next`` Pointer to next ID to allocate. ``gfp_t gfp`` Memory allocation flags. **Description** Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. The search for an empty entry will start at **next** and will wrap around if necessary. Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags(). **Context** Any context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if **gfp** flags permit. **Return** 0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h)}(h**Parameters**h]jF)}(hjNh]h Parameters}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjLubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjHubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjmh]hstruct xarray *xa}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjkubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjgubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]uh1jhjhMhjdubj)}(h``u32 *id`` Pointer to ID. h](j)}(h ``u32 *id``h]j3)}(hjh]hu32 *id}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hPointer to ID.h]hPointer to ID.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjdubj)}(h``void *entry`` New entry. h](j)}(h``void *entry``h]j3)}(hjh]h void *entry}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(h New entry.h]h New entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjdubj)}(h1``struct xa_limit limit`` Range of allocated ID. h](j)}(h``struct xa_limit limit``h]j3)}(hjh]hstruct xa_limit limit}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hRange of allocated ID.h]hRange of allocated ID.}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj-hMhj.ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj-hMhjdubj)}(h.``u32 *next`` Pointer to next ID to allocate. h](j)}(h ``u32 *next``h]j3)}(hjQh]h u32 *next}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjOubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjKubj)}(hhh]h)}(hPointer to next ID to allocate.h]hPointer to next ID to allocate.}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjfhMhjgubah}(h]h ]h"]h$]h&]uh1jhjKubeh}(h]h ]h"]h$]h&]uh1jhjfhMhjdubj)}(h'``gfp_t gfp`` Memory allocation flags. h](j)}(h ``gfp_t gfp``h]j3)}(hjh]h gfp_t gfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hMemory allocation flags.h]hMemory allocation flags.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjdubeh}(h]h ]h"]h$]h&]uh1jhjHubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjHubh)}(hX)Finds an empty entry in **xa** between **limit.min** and **limit.max**, stores the index into the **id** pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised **id**. The search for an empty entry will start at **next** and will wrap around if necessary.h](hFinds an empty entry in }(hjhhhNhNubjF)}(h**xa**h]hxa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh between }(hjhhhNhNubjF)}(h **limit.min**h]h limit.min}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh and }(hjhhhNhNubjF)}(h **limit.max**h]h limit.max}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh, stores the index into the }(hjhhhNhNubjF)}(h**id**h]hid}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubhb pointer, then stores the entry at that index. A concurrent lookup will not see an uninitialised }(hjhhhNhNubjF)}(h**id**h]hid}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh.. The search for an empty entry will start at }(hjhhhNhNubjF)}(h**next**h]hnext}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh# and will wrap around if necessary.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjHubh)}(h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().h]h_Must only be operated on an xarray initialized with flag XA_FLAGS_ALLOC set in xa_init_flags().}(hjVhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjHubh)}(h **Context**h]jF)}(hjgh]hContext}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjeubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjHubh)}(hnAny context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if **gfp** flags permit.h](hYAny context. Expects xa_lock to be held on entry. May release and reacquire xa_lock if }(hj}hhhNhNubjF)}(h**gfp**h]hgfp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj}ubh flags permit.}(hj}hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjHubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjHubh)}(h0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in **limit**.h](h0 if the allocation succeeded without wrapping. 1 if the allocation succeeded after wrapping, -ENOMEM if memory could not be allocated or -EBUSY if there are no free entries in }(hjhhhNhNubjF)}(h **limit**h]hlimit}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjHubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9__xa_set_mark (C function)c.__xa_set_markhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hKvoid __xa_set_mark (struct xarray *xa, unsigned long index, xa_mark_t mark)h]jI)}(hJvoid __xa_set_mark(struct xarray *xa, unsigned long index, xa_mark_t mark)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubj)}(h __xa_set_markh]j)}(h __xa_set_markh]h __xa_set_mark}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(h8(struct xarray *xa, unsigned long index, xa_mark_t mark)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj4hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj0ubja)}(h h]h }(hjAhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj0ubh)}(hhh]j)}(hxarrayh]hxarray}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjOubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjTmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.__xa_set_markasbuh1hhj0ubja)}(h h]h }(hjrhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj0ubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj0ubj)}(hxah]hxa}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj0ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj,ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj,ubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]jnc.__xa_set_markasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hmarkh]hmark}(hj&hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj,ubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h)Set this mark on this entry while locked.h]h)Set this mark on this entry while locked.}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjMhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jhj7jhj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index of entry. ``xa_mark_t mark`` Mark number. **Description** Attempting to set a mark on a ``NULL`` entry does not succeed. **Context** Any context. Expects xa_lock to be held on entry.h](h)}(h**Parameters**h]jF)}(hjrh]h Parameters}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjpubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjlubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h(``unsigned long index`` Index of entry. h](j)}(h``unsigned long index``h]j3)}(hjh]hunsigned long index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hIndex of entry.h]hIndex of entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h ``xa_mark_t mark`` Mark number. h](j)}(h``xa_mark_t mark``h]j3)}(hjh]hxa_mark_t mark}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(h Mark number.h]h Mark number.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubeh}(h]h ]h"]h$]h&]uh1jhjlubh)}(h**Description**h]jF)}(hj>h]h Description}(hj@hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj<ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjlubh)}(h>Attempting to set a mark on a ``NULL`` entry does not succeed.h](hAttempting to set a mark on a }(hjThhhNhNubj3)}(h``NULL``h]hNULL}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjTubh entry does not succeed.}(hjThhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjlubh)}(h **Context**h]jF)}(hjwh]hContext}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjuubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjlubh)}(h2Any context. Expects xa_lock to be held on entry.h]h2Any context. Expects xa_lock to be held on entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjlubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9__xa_clear_mark (C function)c.__xa_clear_markhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hMvoid __xa_clear_mark (struct xarray *xa, unsigned long index, xa_mark_t mark)h]jI)}(hLvoid __xa_clear_mark(struct xarray *xa, unsigned long index, xa_mark_t mark)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM(ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhM(ubj)}(h__xa_clear_markh]j)}(h__xa_clear_markh]h__xa_clear_mark}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhM(ubj)}(h8(struct xarray *xa, unsigned long index, xa_mark_t mark)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.__xa_clear_markasbuh1hhjubja)}(h h]h }(hj7hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjEhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hjRhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjkhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjgubja)}(h h]h }(hjyhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjgubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjgubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjgubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjgubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j3c.__xa_clear_markasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hmarkh]hmark}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhM(ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhM(ubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhM(hjhhubj)}(hhh]h)}(h+Clear this mark on this entry while locked.h]h+Clear this mark on this entry while locked.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM!hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhM(ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j-j7j-j8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index of entry. ``xa_mark_t mark`` Mark number. **Context** Any context. Expects xa_lock to be held on entry.h](h)}(h**Parameters**h]jF)}(hj7h]h Parameters}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj5ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM%hj1ubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjVh]hstruct xarray *xa}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjTubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM"hjPubj)}(hhh]h)}(hXArray.h]hXArray.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhjkhM"hjlubah}(h]h ]h"]h$]h&]uh1jhjPubeh}(h]h ]h"]h$]h&]uh1jhjkhM"hjMubj)}(h(``unsigned long index`` Index of entry. h](j)}(h``unsigned long index``h]j3)}(hjh]hunsigned long index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM#hjubj)}(hhh]h)}(hIndex of entry.h]hIndex of entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM#hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM#hjMubj)}(h ``xa_mark_t mark`` Mark number. h](j)}(h``xa_mark_t mark``h]j3)}(hjh]hxa_mark_t mark}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM$hjubj)}(hhh]h)}(h Mark number.h]h Mark number.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM$hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM$hjMubeh}(h]h ]h"]h$]h&]uh1jhj1ubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM&hj1ubh)}(h2Any context. Expects xa_lock to be held on entry.h]h2Any context. Expects xa_lock to be held on entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM&hj1ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_get_mark (C function) c.xa_get_markhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hIbool xa_get_mark (struct xarray *xa, unsigned long index, xa_mark_t mark)h]jI)}(hHbool xa_get_mark(struct xarray *xa, unsigned long index, xa_mark_t mark)h](jO)}(hjh]hbool}(hjHhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjDhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM>ubja)}(h h]h }(hjVhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjDhhhjUhM>ubj)}(h xa_get_markh]j)}(h xa_get_markh]h xa_get_mark}(hjhhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjdubah}(h]h ](jjeh"]h$]h&]hhuh1jhjDhhhjUhM>ubj)}(h8(struct xarray *xa, unsigned long index, xa_mark_t mark)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jjsb c.xa_get_markasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj|ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hindexh]hindex}(hj.hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj|ubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjGubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjLmodnameN classnameNjt%jw%)}jz%]j c.xa_get_markasbuh1hhjCubja)}(h h]h }(hjhhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjCubj)}(hmarkh]hmark}(hjvhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj|ubeh}(h]h ]h"]h$]h&]hhuh1jhjDhhhjUhM>ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj@hhhjUhM>ubah}(h]j;ah ](j j eh"]h$]h&]jj)jhuh1jBhjUhM>hj=hhubj)}(hhh]h)}(h/Inquire whether this mark is set on this entry.h]h/Inquire whether this mark is set on this entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM3hjhhubah}(h]h ]h"]h$]h&]uh1jhj=hhhjUhM>ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index of entry. ``xa_mark_t mark`` Mark number. **Description** This function uses the RCU read lock, so the result may be out of date by the time it returns. If you need the result to be stable, use a lock. **Context** Any context. Takes and releases the RCU lock. **Return** True if the entry at **index** has this mark set, false if it doesn't.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM7hjubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM4hjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM4hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM4hjubj)}(h(``unsigned long index`` Index of entry. h](j)}(h``unsigned long index``h]j3)}(hjh]hunsigned long index}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM5hjubj)}(hhh]h)}(hIndex of entry.h]hIndex of entry.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj/hM5hj0ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj/hM5hjubj)}(h ``xa_mark_t mark`` Mark number. h](j)}(h``xa_mark_t mark``h]j3)}(hjSh]hxa_mark_t mark}(hjUhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjQubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM6hjMubj)}(hhh]h)}(h Mark number.h]h Mark number.}(hjlhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhM6hjiubah}(h]h ]h"]h$]h&]uh1jhjMubeh}(h]h ]h"]h$]h&]uh1jhjhhM6hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM8hjubh)}(hThis function uses the RCU read lock, so the result may be out of date by the time it returns. If you need the result to be stable, use a lock.h]hThis function uses the RCU read lock, so the result may be out of date by the time it returns. If you need the result to be stable, use a lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM8hjubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM;hjubh)}(h.Any context. Takes and releases the RCU lock.h]h.Any context. Takes and releases the RCU lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM;hjubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM=hjubh)}(hFTrue if the entry at **index** has this mark set, false if it doesn't.h](hTrue if the entry at }(hjhhhNhNubjF)}(h **index**h]hindex}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh* has this mark set, false if it doesn’t.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM<hjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_set_mark (C function) c.xa_set_markhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hIvoid xa_set_mark (struct xarray *xa, unsigned long index, xa_mark_t mark)h]jI)}(hHvoid xa_set_mark(struct xarray *xa, unsigned long index, xa_mark_t mark)h](jO)}(hvoidh]hvoid}(hj3hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj/hhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM\ubja)}(h h]h }(hjBhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj/hhhjAhM\ubj)}(h xa_set_markh]j)}(h xa_set_markh]h xa_set_mark}(hjThhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjPubah}(h]h ](jjeh"]h$]h&]hhuh1jhj/hhhjAhM\ubj)}(h8(struct xarray *xa, unsigned long index, xa_mark_t mark)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjphhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjlubja)}(h h]h }(hj}hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjlubh)}(hhh]j)}(hxarrayh]hxarray}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jVsb c.xa_set_markasbuh1hhjlubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjlubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjlubj)}(hxah]hxa}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjhubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hindexh]hindex}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjhubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hj6hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj3ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj8modnameN classnameNjt%jw%)}jz%]j c.xa_set_markasbuh1hhj/ubja)}(h h]h }(hjThhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj/ubj)}(hmarkh]hmark}(hjbhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj/ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjhubeh}(h]h ]h"]h$]h&]hhuh1jhj/hhhjAhM\ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj+hhhjAhM\ubah}(h]j&ah ](j j eh"]h$]h&]jj)jhuh1jBhjAhM\hj(hhubj)}(hhh]h)}(hSet this mark on this entry.h]hSet this mark on this entry.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMShjhhubah}(h]h ]h"]h$]h&]uh1jhj(hhhjAhM\ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index of entry. ``xa_mark_t mark`` Mark number. **Description** Attempting to set a mark on a ``NULL`` entry does not succeed. **Context** Process context. Takes and releases the xa_lock.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMWhjubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMThjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMThjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMThjubj)}(h(``unsigned long index`` Index of entry. h](j)}(h``unsigned long index``h]j3)}(hj h]hunsigned long index}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMUhj ubj)}(hhh]h)}(hIndex of entry.h]hIndex of entry.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMUhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMUhjubj)}(h ``xa_mark_t mark`` Mark number. h](j)}(h``xa_mark_t mark``h]j3)}(hj? h]hxa_mark_t mark}(hjA hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj= ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMVhj9 ubj)}(hhh]h)}(h Mark number.h]h Mark number.}(hjX hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjT hMVhjU ubah}(h]h ]h"]h$]h&]uh1jhj9 ubeh}(h]h ]h"]h$]h&]uh1jhjT hMVhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjz h]h Description}(hj| hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjx ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMXhjubh)}(h>Attempting to set a mark on a ``NULL`` entry does not succeed.h](hAttempting to set a mark on a }(hj hhhNhNubj3)}(h``NULL``h]hNULL}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubh entry does not succeed.}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMXhjubh)}(h **Context**h]jF)}(hj h]hContext}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMZhjubh)}(h1Process context. Takes and releases the xa_lock.h]h1Process context. Takes and releases the xa_lock.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMZhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_clear_mark (C function)c.xa_clear_markhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hKvoid xa_clear_mark (struct xarray *xa, unsigned long index, xa_mark_t mark)h]jI)}(hJvoid xa_clear_mark(struct xarray *xa, unsigned long index, xa_mark_t mark)h](jO)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj hhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMnubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj hhhj hMnubj)}(h xa_clear_markh]j)}(h xa_clear_markh]h xa_clear_mark}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhj hMnubj)}(h8(struct xarray *xa, unsigned long index, xa_mark_t mark)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj5 hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj1 ubja)}(h h]h }(hjB hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj1 ubh)}(hhh]j)}(hxarrayh]hxarray}(hjS hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjP ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjU modnameN classnameNjt%jw%)}jz%]j}%)}jp%j sbc.xa_clear_markasbuh1hhj1 ubja)}(h h]h }(hjs hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj1 ubjr)}(hjh]h*}(hj hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj1 ubj)}(hxah]hxa}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj1 ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj- ubj)}(hunsigned long indexh](jO)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj ubjO)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj ubj)}(hindexh]hindex}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj- ubj)}(hxa_mark_t markh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj modnameN classnameNjt%jw%)}jz%]jo c.xa_clear_markasbuh1hhj ubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj ubj)}(hmarkh]hmark}(hj' hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj- ubeh}(h]h ]h"]h$]h&]hhuh1jhj hhhj hMnubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj hhhj hMnubah}(h]j ah ](j j eh"]h$]h&]jj)jhuh1jBhj hMnhj hhubj)}(hhh]h)}(hClear this mark on this entry.h]hClear this mark on this entry.}(hjQ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMehjN hhubah}(h]h ]h"]h$]h&]uh1jhj hhhj hMnubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6ji j7ji j8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``struct xarray *xa`` XArray. ``unsigned long index`` Index of entry. ``xa_mark_t mark`` Mark number. **Description** Clearing a mark always succeeds. **Context** Process context. Takes and releases the xa_lock.h](h)}(h**Parameters**h]jF)}(hjs h]h Parameters}(hju hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjq ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMihjm ubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hj h]hstruct xarray *xa}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMfhj ubj)}(hhh]h)}(hXArray.h]hXArray.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMfhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMfhj ubj)}(h(``unsigned long index`` Index of entry. h](j)}(h``unsigned long index``h]j3)}(hj h]hunsigned long index}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMghj ubj)}(hhh]h)}(hIndex of entry.h]hIndex of entry.}(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 ``xa_mark_t mark`` Mark number. h](j)}(h``xa_mark_t mark``h]j3)}(hj h]hxa_mark_t mark}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhhj ubj)}(hhh]h)}(h Mark number.h]h Mark number.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hMhhj ubah}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]uh1jhj hMhhj ubeh}(h]h ]h"]h$]h&]uh1jhjm ubh)}(h**Description**h]jF)}(hj? h]h Description}(hjA hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj= ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMjhjm ubh)}(h Clearing a mark always succeeds.h]h Clearing a mark always succeeds.}(hjU hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMjhjm ubh)}(h **Context**h]jF)}(hjf h]hContext}(hjh hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjd ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMlhjm ubh)}(h1Process context. Takes and releases the xa_lock.h]h1Process context. Takes and releases the xa_lock.}(hj| hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMlhjm ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_find (C function) c.xa_findhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h^void * xa_find (struct xarray *xa, unsigned long *indexp, unsigned long max, xa_mark_t filter)h]jI)}(h\void *xa_find(struct xarray *xa, unsigned long *indexp, unsigned long max, xa_mark_t filter)h](jO)}(hvoidh]hvoid}(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj hhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj hhhj hMubjr)}(hjh]h*}(hj hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj hhhj hMubj)}(hxa_findh]j)}(hxa_findh]hxa_find}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ](jjeh"]h$]h&]hhuh1jhj hhhj hMubj)}(hO(struct xarray *xa, unsigned long *indexp, unsigned long max, xa_mark_t filter)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hj hhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhj ubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj ubh)}(hhh]j)}(hxarrayh]hxarray}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj modnameN classnameNjt%jw%)}jz%]j}%)}jp%j sb c.xa_findasbuh1hhj ubja)}(h h]h }(hj3 hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj ubjr)}(hjh]h*}(hjA hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj ubj)}(hxah]hxa}(hjN hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubj)}(hunsigned long *indexph](jO)}(hunsignedh]hunsigned}(hjg hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjc ubja)}(h h]h }(hju hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjc ubjO)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjc ubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjc ubjr)}(hjh]h*}(hj hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjc ubj)}(hindexph]hindexp}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjc ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubj)}(hunsigned long maxh](jO)}(hunsignedh]hunsigned}(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj ubjO)}(hlongh]hlong}(hj hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj ubj)}(hmaxh]hmax}(hj hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubj)}(hxa_mark_t filterh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j/  c.xa_findasbuh1hhjubja)}(h h]h }(hj7hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hfilterh]hfilter}(hjEhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhj ubeh}(h]h ]h"]h$]h&]hhuh1jhj hhhj hMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhj hhhj hMubah}(h]j ah ](j j eh"]h$]h&]jj)jhuh1jBhj hMhj hhubj)}(hhh]h)}(hSearch the XArray for an entry.h]hSearch the XArray for an entry.}(hjohhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMwhjlhhubah}(h]h ]h"]h$]h&]uh1jhj hhhj hMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long *indexp`` Pointer to an index. ``unsigned long max`` Maximum index to search to. ``xa_mark_t filter`` Selection criterion. **Description** Finds the entry in **xa** which matches the **filter**, and has the lowest index that is at least **indexp** and no more than **max**. If an entry is found, **indexp** is updated to be the index of the entry. This function is protected by the RCU read lock, so it may not find entries which are being simultaneously added. It will not return an ``XA_RETRY_ENTRY``; if you need to see retry entries, use xas_find(). **Context** Any context. Takes and releases the RCU lock. **Return** The entry, if found, otherwise ``NULL``.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM{hjubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMxhjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMxhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMxhjubj)}(h/``unsigned long *indexp`` Pointer to an index. h](j)}(h``unsigned long *indexp``h]j3)}(hjh]hunsigned long *indexp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMyhjubj)}(hhh]h)}(hPointer to an index.h]hPointer to an index.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMyhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMyhjubj)}(h2``unsigned long max`` Maximum index to search to. h](j)}(h``unsigned long max``h]j3)}(hj"h]hunsigned long max}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMzhjubj)}(hhh]h)}(hMaximum index to search to.h]hMaximum index to search to.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj7hMzhj8ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj7hMzhjubj)}(h*``xa_mark_t filter`` Selection criterion. h](j)}(h``xa_mark_t filter``h]j3)}(hj[h]hxa_mark_t filter}(hj]hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjYubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM{hjUubj)}(hhh]h)}(hSelection criterion.h]hSelection criterion.}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhjphM{hjqubah}(h]h ]h"]h$]h&]uh1jhjUubeh}(h]h ]h"]h$]h&]uh1jhjphM{hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM}hjubh)}(hXFinds the entry in **xa** which matches the **filter**, and has the lowest index that is at least **indexp** and no more than **max**. If an entry is found, **indexp** is updated to be the index of the entry. This function is protected by the RCU read lock, so it may not find entries which are being simultaneously added. It will not return an ``XA_RETRY_ENTRY``; if you need to see retry entries, use xas_find().h](hFinds the entry in }(hjhhhNhNubjF)}(h**xa**h]hxa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh which matches the }(hjhhhNhNubjF)}(h **filter**h]hfilter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh,, and has the lowest index that is at least }(hjhhhNhNubjF)}(h **indexp**h]hindexp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh and no more than }(hjhhhNhNubjF)}(h**max**h]hmax}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh. If an entry is found, }(hjhhhNhNubjF)}(h **indexp**h]hindexp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh is updated to be the index of the entry. This function is protected by the RCU read lock, so it may not find entries which are being simultaneously added. It will not return an }(hjhhhNhNubj3)}(h``XA_RETRY_ENTRY``h]hXA_RETRY_ENTRY}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh3; if you need to see retry entries, use xas_find().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM}hjubh)}(h **Context**h]jF)}(hj)h]hContext}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj'ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h.Any context. Takes and releases the RCU lock.h]h.Any context. Takes and releases the RCU lock.}(hj?hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h **Return**h]jF)}(hjPh]hReturn}(hjRhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h(The entry, if found, otherwise ``NULL``.h](hThe entry, if found, otherwise }(hjfhhhNhNubj3)}(h``NULL``h]hNULL}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjfubh.}(hjfhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_find_after (C function)c.xa_find_afterhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hdvoid * xa_find_after (struct xarray *xa, unsigned long *indexp, unsigned long max, xa_mark_t filter)h]jI)}(hbvoid *xa_find_after(struct xarray *xa, unsigned long *indexp, unsigned long max, xa_mark_t filter)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjhhhjhMubj)}(h xa_find_afterh]j)}(h xa_find_afterh]h xa_find_after}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMubj)}(hO(struct xarray *xa, unsigned long *indexp, unsigned long max, xa_mark_t filter)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.xa_find_afterasbuh1hhjubja)}(h h]h }(hj/hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hj=hhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hjJhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long *indexph](jO)}(hunsignedh]hunsigned}(hjchhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj_ubja)}(h h]h }(hjqhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj_ubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj_ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj_ubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhj_ubj)}(hindexph]hindexp}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj_ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long maxh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hmaxh]hmax}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hxa_mark_t filterh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j+c.xa_find_afterasbuh1hhjubja)}(h h]h }(hj3hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hfilterh]hfilter}(hjAhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMhjhhubj)}(hhh]h)}(h&Search the XArray for a present entry.h]h&Search the XArray for a present entry.}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` XArray. ``unsigned long *indexp`` Pointer to an index. ``unsigned long max`` Maximum index to search to. ``xa_mark_t filter`` Selection criterion. **Description** Finds the entry in **xa** which matches the **filter** and has the lowest index that is above **indexp** and no more than **max**. If an entry is found, **indexp** is updated to be the index of the entry. This function is protected by the RCU read lock, so it may miss entries which are being simultaneously added. It will not return an ``XA_RETRY_ENTRY``; if you need to see retry entries, use xas_find(). **Context** Any context. Takes and releases the RCU lock. **Return** The pointer, if found, otherwise ``NULL``.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh](j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h/``unsigned long *indexp`` Pointer to an index. h](j)}(h``unsigned long *indexp``h]j3)}(hjh]hunsigned long *indexp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hPointer to an index.h]hPointer to an index.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMhjubj)}(h2``unsigned long max`` Maximum index to search to. h](j)}(h``unsigned long max``h]j3)}(hjh]hunsigned long max}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubj)}(hhh]h)}(hMaximum index to search to.h]hMaximum index to search to.}(hj7hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj3hMhj4ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj3hMhjubj)}(h*``xa_mark_t filter`` Selection criterion. h](j)}(h``xa_mark_t filter``h]j3)}(hjWh]hxa_mark_t filter}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjUubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjQubj)}(hhh]h)}(hSelection criterion.h]hSelection criterion.}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhjlhMhjmubah}(h]h ]h"]h$]h&]uh1jhjQubeh}(h]h ]h"]h$]h&]uh1jhjlhMhjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(hXFinds the entry in **xa** which matches the **filter** and has the lowest index that is above **indexp** and no more than **max**. If an entry is found, **indexp** is updated to be the index of the entry. This function is protected by the RCU read lock, so it may miss entries which are being simultaneously added. It will not return an ``XA_RETRY_ENTRY``; if you need to see retry entries, use xas_find().h](hFinds the entry in }(hjhhhNhNubjF)}(h**xa**h]hxa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh which matches the }(hjhhhNhNubjF)}(h **filter**h]hfilter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh( and has the lowest index that is above }(hjhhhNhNubjF)}(h **indexp**h]hindexp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh and no more than }(hjhhhNhNubjF)}(h**max**h]hmax}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh. If an entry is found, }(hjhhhNhNubjF)}(h **indexp**h]hindexp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh is updated to be the index of the entry. This function is protected by the RCU read lock, so it may miss entries which are being simultaneously added. It will not return an }(hjhhhNhNubj3)}(h``XA_RETRY_ENTRY``h]hXA_RETRY_ENTRY}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh3; if you need to see retry entries, use xas_find().}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h **Context**h]jF)}(hj%h]hContext}(hj'hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj#ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h.Any context. Takes and releases the RCU lock.h]h.Any context. Takes and releases the RCU lock.}(hj;hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h **Return**h]jF)}(hjLh]hReturn}(hjNhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjJubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubh)}(h*The pointer, if found, otherwise ``NULL``.h](h!The pointer, if found, otherwise }(hjbhhhNhNubj3)}(h``NULL``h]hNULL}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjbubh.}(hjbhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_extract (C function)Jw c.xa_extracthNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hunsigned int xa_extract (struct xarray *xa, void **dst, unsigned long start, unsigned long max, unsigned int n, xa_mark_t filter)h]jI)}(hunsigned int xa_extract(struct xarray *xa, void **dst, unsigned long start, unsigned long max, unsigned int n, xa_mark_t filter)h](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhM ubjO)}(hinth]hint}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhjhM ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhM ubj)}(h xa_extracth]j)}(h xa_extracth]h xa_extract}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhM ubj)}(hi(struct xarray *xa, void **dst, unsigned long start, unsigned long max, unsigned int n, xa_mark_t filter)h](j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hj hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j}%)}jp%jsb c.xa_extractasbuh1hhjubja)}(h h]h }(hj:hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjHhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hjUhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(h void **dsth](jO)}(hvoidh]hvoid}(hjnhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjjubja)}(h h]h }(hj|hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjjubjr)}(hjh]h*}(hjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjjubj)}(hdsth]hdst}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long starth](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjO)}(hlongh]hlong}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hstarth]hstart}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned long maxh](jO)}(hunsignedh]hunsigned}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj ubjO)}(hlongh]hlong}(hj*hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj ubja)}(h h]h }(hj8hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj ubj)}(hmaxh]hmax}(hjFhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hunsigned int nh](jO)}(hunsignedh]hunsigned}(hj_hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj[ubja)}(h h]h }(hjmhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj[ubjO)}(hinth]hint}(hj{hhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhj[ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hj[ubj)}(hjh]hn}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hxa_mark_t filterh](h)}(hhh]j)}(h xa_mark_th]h xa_mark_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]j6 c.xa_extractasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hfilterh]hfilter}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhM ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhM ubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhM hjhhubj)}(hhh]h)}(h:Copy selected entries from the XArray into a normal array.h]h:Copy selected entries from the XArray into a normal array.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMhjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhM ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6j j7j j8j9j:uh1j=hhhjhNhNubj<)}(hX**Parameters** ``struct xarray *xa`` The source XArray to copy from. ``void **dst`` The buffer to copy entries into. ``unsigned long start`` The first index in the XArray eligible to be selected. ``unsigned long max`` The last index in the XArray eligible to be selected. ``unsigned int n`` The maximum number of entries to copy. ``xa_mark_t filter`` Selection criterion. **Description** Copies up to **n** entries that match **filter** from the XArray. The copied entries will have indices between **start** and **max**, inclusive. The **filter** may be an XArray mark value, in which case entries which are marked with that mark will be copied. It may also be ``XA_PRESENT``, in which case all entries which are not ``NULL`` will be copied. The entries returned may not represent a snapshot of the XArray at a moment in time. For example, if another thread stores to index 5, then index 10, calling xa_extract() may return the old contents of index 5 and the new contents of index 10. Indices not modified while this function is running will not be skipped. If you need stronger guarantees, holding the xa_lock across calls to this function will prevent concurrent modification. **Context** Any context. Takes and releases the RCU lock. **Return** The number of entries copied.h](h)}(h**Parameters**h]jF)}(hj*h]h Parameters}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhj(ubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj$ubj)}(hhh](j)}(h6``struct xarray *xa`` The source XArray to copy from. h](j)}(h``struct xarray *xa``h]j3)}(hjIh]hstruct xarray *xa}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjGubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjCubj)}(hhh]h)}(hThe source XArray to copy from.h]hThe source XArray to copy from.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj^hM hj_ubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1jhj^hM hj@ubj)}(h0``void **dst`` The buffer to copy entries into. h](j)}(h``void **dst``h]j3)}(hjh]h void **dst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj|ubj)}(hhh]h)}(h The buffer to copy entries into.h]h The buffer to copy entries into.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhj|ubeh}(h]h ]h"]h$]h&]uh1jhjhM hj@ubj)}(hO``unsigned long start`` The first index in the XArray eligible to be selected. h](j)}(h``unsigned long start``h]j3)}(hjh]hunsigned long start}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubj)}(hhh]h)}(h6The first index in the XArray eligible to be selected.h]h6The first index in the XArray eligible to be selected.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhM hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhM hj@ubj)}(hL``unsigned long max`` The last index in the XArray eligible to be selected. h](j)}(h``unsigned long max``h]j3)}(hjh]hunsigned long max}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hjubj)}(hhh]h)}(h5The last index in the XArray eligible to be selected.h]h5The last index in the XArray eligible to be selected.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hM hj ubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhj hM hj@ubj)}(h:``unsigned int n`` The maximum number of entries to copy. h](j)}(h``unsigned int n``h]j3)}(hj-h]hunsigned int n}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj+ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj'ubj)}(hhh]h)}(h&The maximum number of entries to copy.h]h&The maximum number of entries to copy.}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjBhM hjCubah}(h]h ]h"]h$]h&]uh1jhj'ubeh}(h]h ]h"]h$]h&]uh1jhjBhM hj@ubj)}(h*``xa_mark_t filter`` Selection criterion. h](j)}(h``xa_mark_t filter``h]j3)}(hjfh]hxa_mark_t filter}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjdubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj`ubj)}(hhh]h)}(hSelection criterion.h]hSelection criterion.}(hjhhhNhNubah}(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&]uh1jhj$ubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj$ubh)}(hCopies up to **n** entries that match **filter** from the XArray. The copied entries will have indices between **start** and **max**, inclusive.h](h Copies up to }(hjhhhNhNubjF)}(h**n**h]hn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh entries that match }(hjhhhNhNubjF)}(h **filter**h]hfilter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh@ from the XArray. The copied entries will have indices between }(hjhhhNhNubjF)}(h **start**h]hstart}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh and }(hjhhhNhNubjF)}(h**max**h]hmax}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubh , inclusive.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj$ubh)}(hThe **filter** may be an XArray mark value, in which case entries which are marked with that mark will be copied. It may also be ``XA_PRESENT``, in which case all entries which are not ``NULL`` will be copied.h](hThe }(hjhhhNhNubjF)}(h **filter**h]hfilter}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubht may be an XArray mark value, in which case entries which are marked with that mark will be copied. It may also be }(hjhhhNhNubj3)}(h``XA_PRESENT``h]h XA_PRESENT}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh*, in which case all entries which are not }(hjhhhNhNubj3)}(h``NULL``h]hNULL}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubh will be copied.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj$ubh)}(hX>The entries returned may not represent a snapshot of the XArray at a moment in time. For example, if another thread stores to index 5, then index 10, calling xa_extract() may return the old contents of index 5 and the new contents of index 10. Indices not modified while this function is running will not be skipped.h]hX>The entries returned may not represent a snapshot of the XArray at a moment in time. For example, if another thread stores to index 5, then index 10, calling xa_extract() may return the old contents of index 5 and the new contents of index 10. Indices not modified while this function is running will not be skipped.}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj$ubh)}(hxIf you need stronger guarantees, holding the xa_lock across calls to this function will prevent concurrent modification.h]hxIf you need stronger guarantees, holding the xa_lock across calls to this function will prevent concurrent modification.}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj$ubh)}(h **Context**h]jF)}(hjsh]hContext}(hjuhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjqubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj$ubh)}(h.Any context. Takes and releases the RCU lock.h]h.Any context. Takes and releases the RCU lock.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj$ubh)}(h **Return**h]jF)}(hjh]hReturn}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj$ubh)}(hThe number of entries copied.h]hThe number of entries copied.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM hj$ubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_delete_node (C function)c.xa_delete_nodehNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(hCvoid xa_delete_node (struct xa_node *node, xa_update_node_t update)h]jI)}(hBvoid xa_delete_node(struct xa_node *node, xa_update_node_t update)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM/ ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhM/ ubj)}(hxa_delete_nodeh]j)}(hxa_delete_nodeh]hxa_delete_node}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhM/ ubj)}(h/(struct xa_node *node, xa_update_node_t update)h](j)}(hstruct xa_node *nodeh](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hj)hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxa_nodeh]hxa_node}(hj:hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj7ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj<modnameN classnameNjt%jw%)}jz%]j}%)}jp%jsbc.xa_delete_nodeasbuh1hhjubja)}(h h]h }(hjZhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjhhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hnodeh]hnode}(hjuhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubj)}(hxa_update_node_t updateh](h)}(hhh]j)}(hxa_update_node_th]hxa_update_node_t}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetjmodnameN classnameNjt%jw%)}jz%]jVc.xa_delete_nodeasbuh1hhjubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubj)}(hupdateh]hupdate}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubeh}(h]h ]h"]h$]h&]hhuh1jhjhhhjhM/ ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhM/ ubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhM/ hjhhubj)}(hhh]h)}(h&Private interface for workingset code.h]h&Private interface for workingset code.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM) hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhM/ ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(h**Parameters** ``struct xa_node *node`` Node to be removed from the tree. ``xa_update_node_t update`` Function to call to update ancestor nodes. **Context** xa_lock must be held on entry and will not be released.h](h)}(h**Parameters**h]jF)}(hj h]h Parameters}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM- hjubj)}(hhh](j)}(h;``struct xa_node *node`` Node to be removed from the tree. h](j)}(h``struct xa_node *node``h]j3)}(hj(h]hstruct xa_node *node}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj&ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM* hj"ubj)}(hhh]h)}(h!Node to be removed from the tree.h]h!Node to be removed from the tree.}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj=hM* hj>ubah}(h]h ]h"]h$]h&]uh1jhj"ubeh}(h]h ]h"]h$]h&]uh1jhj=hM* hjubj)}(hG``xa_update_node_t update`` Function to call to update ancestor nodes. h](j)}(h``xa_update_node_t update``h]j3)}(hjah]hxa_update_node_t update}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1j2hj_ubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM+ hj[ubj)}(hhh]h)}(h*Function to call to update ancestor nodes.h]h*Function to call to update ancestor nodes.}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjvhM+ hjwubah}(h]h ]h"]h$]h&]uh1jhj[ubeh}(h]h ]h"]h$]h&]uh1jhjvhM+ hjubeh}(h]h ]h"]h$]h&]uh1jhjubh)}(h **Context**h]jF)}(hjh]hContext}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM- hjubh)}(h7xa_lock must be held on entry and will not be released.h]h7xa_lock must be held on entry and will not be released.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM- hjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubj-)}(hhh]h}(h]h ]h"]h$]h&]entries](j9xa_destroy (C function) c.xa_destroyhNtauh1j,hjhhhNhNubj>)}(hhh](jC)}(h#void xa_destroy (struct xarray *xa)h]jI)}(h"void xa_destroy(struct xarray *xa)h](jO)}(hvoidh]hvoid}(hjhhhNhNubah}(h]h ]j[ah"]h$]h&]uh1jNhjhhhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMI ubja)}(h h]h }(hjhhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjhhhjhMI ubj)}(h xa_destroyh]j)}(h xa_destroyh]h xa_destroy}(hjhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubah}(h]h ](jjeh"]h$]h&]hhuh1jhjhhhjhMI ubj)}(h(struct xarray *xa)h]j)}(hstruct xarray *xah](je)}(hjh]hstruct}(hjhhhNhNubah}(h]h ]jqah"]h$]h&]uh1jdhjubja)}(h h]h }(hj+hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubh)}(hhh]j)}(hxarrayh]hxarray}(hj<hhhNhNubah}(h]h ]jah"]h$]h&]uh1jhj9ubah}(h]h ]h"]h$]h&] refdomainj0reftypejp% reftargetj>modnameN classnameNjt%jw%)}jz%]j}%)}jp%jsb c.xa_destroyasbuh1hhjubja)}(h h]h }(hj\hhhNhNubah}(h]h ]jmah"]h$]h&]uh1j`hjubjr)}(hjh]h*}(hjjhhhNhNubah}(h]h ]j}ah"]h$]h&]uh1jqhjubj)}(hxah]hxa}(hjwhhhNhNubah}(h]h ]jah"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]noemphhhuh1jhjubah}(h]h ]h"]h$]h&]hhuh1jhjhhhjhMI ubeh}(h]h ]h"]h$]h&]hhjuh1jHjjhjhhhjhMI ubah}(h]jah ](j j eh"]h$]h&]jj)jhuh1jBhjhMI hjhhubj)}(hhh]h)}(h"Free all internal data structures.h]h"Free all internal data structures.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chM@ hjhhubah}(h]h ]h"]h$]h&]uh1jhjhhhjhMI ubeh}(h]h ](j0functioneh"]h$]h&]j5j0j6jj7jj8j9j:uh1j=hhhjhNhNubj<)}(hXJ**Parameters** ``struct xarray *xa`` XArray. **Description** After calling this function, the XArray is empty and has freed all memory allocated for its internal data structures. You are responsible for freeing the objects referenced by the XArray. **Context** Any context. Takes and releases the xa_lock, interrupt-safe.h](h)}(h**Parameters**h]jF)}(hjh]h Parameters}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMD hjubj)}(hhh]j)}(h``struct xarray *xa`` XArray. h](j)}(h``struct xarray *xa``h]j3)}(hjh]hstruct xarray *xa}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j2hjubah}(h]h ]h"]h$]h&]uh1jhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMA hjubj)}(hhh]h)}(hXArray.h]hXArray.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhMA hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhjhMA hjubah}(h]h ]h"]h$]h&]uh1jhjubh)}(h**Description**h]jF)}(hjh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMC hjubh)}(hAfter calling this function, the XArray is empty and has freed all memory allocated for its internal data structures. You are responsible for freeing the objects referenced by the XArray.h]hAfter calling this function, the XArray is empty and has freed all memory allocated for its internal data structures. You are responsible for freeing the objects referenced by the XArray.}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMC hjubh)}(h **Context**h]jF)}(hjDh]hContext}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jEhjBubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMG hjubh)}(h=Any context. Takes and releases the xa_lock, interrupt-safe.h]h=Any context. Takes and releases the xa_lock, interrupt-safe.}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhM/var/lib/git/docbuild/linux/Documentation/core-api/xarray:510: ./lib/xarray.chMG hjubeh}(h]h ] kernelindentah"]h$]h&]uh1j;hjhhhNhNubeh}(h]functions-and-structuresah ]h"]functions and structuresah$]h&]uh1hhhhhhhhMubeh}(h]xarrayah ]h"]xarrayah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j}jzjjj j jjjbj_jjj j jjj j jW jT jj jujru nametypes}(j}jj jjbjj jj jW jjuuh}(jzhjj j jjjj_jjjej jjj j jh jT j j jZ jrjj;jDjjjjjDjIjyj~j%j*jjjjjGjLjjjPjUj j j!j!j"j"j#j#j$j$j#'j('j(j(j*j*j,j,j/j/j1j1j'4j,4j6j6j:j :jf=jk=j?j?jzBjBjFjFjJjJjNjNjQjQj]UjbUjXjXjF]jK]jajajJfjOfjlkjqkjpjpjujujxjxj{j{j~j~jjj+j0jjjj"jtjyjjjjjAjFjBjGjjjjj=jBjjjmjrjCjHjNjSjYj^jȞj͞jʠjϠjj jjjjjfjkjjjjj-j2jrjwjjjjjjj޹jj jj;j@jjjoj'j,jjjnjsjJjOjTjYjjjjjjjjj]jbjjjqjvjjjjjjj jjjj;j@jFjKjjjjjjj;j@j&j+j j j j jjjjjjjju 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.