Documentation/core-api/xarray.rst

31 nor for function pointers.  You can store pointers to statically allocated
34 You can also store integers between 0 and ``LONG_MAX`` in the XArray.
35 You must first convert it into an entry using xa_mk_value().
40 Some users want to tag the pointers they store in the XArray.  You can
66 You can then set entries using xa_store() and get entries
68 new entry and return the previous entry stored at that index.  You can
74 You can conditionally replace an entry at an index by using
84 You can copy entries out of the XArray into a plain array by calling
87 You may prefer to use xa_find() or xa_find_after() to move to the next
112 to free the entries first.  You can do this by iterating over all present
119 Each mark may be set or cleared independently of the others.  You can
122 You can enquire whether a mark is set on an entry by using
125 xa_clear_mark().  You can ask whether any entry in the XArray has a
147 You can call xa_alloc() to store the entry at an unused index
164 You cannot use ``XA_MARK_0`` with an allocating XArray as this mark
241 up the object and incrementing the refcount.  You can also use RCU to
311 to use the xa_lock while modifying the array.  You can choose whether
313 the array.  You can mix advanced and normal operations on the same array;
328 The xa_state is also used to store errors.  You can call
377        of this RCU period.  You should restart the lookup from the head
397 You can use xas_init_marks() to reset the marks on an entry
417 You can search for the next present entry using xas_find().  This
446 You can call xas_set_update() to have a callback function
464 You can create a multi-index entry by using XA_STATE_ORDER()