blob: f66bb39324522a4a9a64ddb398050206d208c61a [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * Copyright (C) 2001 Momchil Velikov
3 * Portions Copyright (C) 2001 Christoph Hellwig
Christoph Lametercde53532008-07-04 09:59:22 -07004 * Copyright (C) 2005 SGI, Christoph Lameter
Nick Piggin7cf9c2c2006-12-06 20:33:44 -08005 * Copyright (C) 2006 Nick Piggin
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -07006 * Copyright (C) 2012 Konstantin Khlebnikov
Matthew Wilcox6b053b82016-05-20 17:02:58 -07007 * Copyright (C) 2016 Intel, Matthew Wilcox
8 * Copyright (C) 2016 Intel, Ross Zwisler
Linus Torvalds1da177e2005-04-16 15:20:36 -07009 *
10 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public License as
12 * published by the Free Software Foundation; either version 2, or (at
13 * your option) any later version.
14 *
15 * This program is distributed in the hope that it will be useful, but
16 * WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
19 *
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 */
24
25#include <linux/errno.h>
26#include <linux/init.h>
27#include <linux/kernel.h>
Paul Gortmaker8bc3bcc2011-11-16 21:29:17 -050028#include <linux/export.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070029#include <linux/radix-tree.h>
30#include <linux/percpu.h>
31#include <linux/slab.h>
Catalin Marinasce80b062014-06-06 14:38:18 -070032#include <linux/kmemleak.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070033#include <linux/notifier.h>
34#include <linux/cpu.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070035#include <linux/string.h>
36#include <linux/bitops.h>
Nick Piggin7cf9c2c2006-12-06 20:33:44 -080037#include <linux/rcupdate.h>
Frederic Weisbecker92cf2112015-05-12 16:41:46 +020038#include <linux/preempt.h> /* in_interrupt() */
Linus Torvalds1da177e2005-04-16 15:20:36 -070039
40
Jeff Moyer26fb1582007-10-16 01:24:49 -070041/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070042 * Radix tree node cache.
43 */
Christoph Lametere18b8902006-12-06 20:33:20 -080044static struct kmem_cache *radix_tree_node_cachep;
Linus Torvalds1da177e2005-04-16 15:20:36 -070045
46/*
Nick Piggin55368052012-05-29 15:07:34 -070047 * The radix tree is variable-height, so an insert operation not only has
48 * to build the branch to its corresponding item, it also has to build the
49 * branch to existing items if the size has to be increased (by
50 * radix_tree_extend).
51 *
52 * The worst case is a zero height tree with just a single item at index 0,
53 * and then inserting an item at index ULONG_MAX. This requires 2 new branches
54 * of RADIX_TREE_MAX_PATH size to be created, with only the root node shared.
55 * Hence:
56 */
57#define RADIX_TREE_PRELOAD_SIZE (RADIX_TREE_MAX_PATH * 2 - 1)
58
59/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070060 * Per-cpu pool of preloaded nodes
61 */
62struct radix_tree_preload {
Matthew Wilcox2fcd9002016-05-20 17:03:04 -070063 unsigned nr;
Kirill A. Shutemov9d2a8da2015-06-25 15:02:19 -070064 /* nodes->private_data points to next preallocated node */
65 struct radix_tree_node *nodes;
Linus Torvalds1da177e2005-04-16 15:20:36 -070066};
Harvey Harrison8cef7d52009-01-06 14:40:50 -080067static DEFINE_PER_CPU(struct radix_tree_preload, radix_tree_preloads) = { 0, };
Linus Torvalds1da177e2005-04-16 15:20:36 -070068
Matthew Wilcoxa4db4dc2016-05-20 17:03:24 -070069static inline void *node_to_entry(void *ptr)
Nick Piggin27d20fd2010-11-11 14:05:19 -080070{
Matthew Wilcox30ff46cc2016-05-20 17:03:22 -070071 return (void *)((unsigned long)ptr | RADIX_TREE_INTERNAL_NODE);
Nick Piggin27d20fd2010-11-11 14:05:19 -080072}
73
Matthew Wilcoxa4db4dc2016-05-20 17:03:24 -070074#define RADIX_TREE_RETRY node_to_entry(NULL)
Matthew Wilcoxafe0e392016-05-20 17:02:17 -070075
Matthew Wilcoxdb050f22016-05-20 17:01:57 -070076#ifdef CONFIG_RADIX_TREE_MULTIORDER
77/* Sibling slots point directly to another slot in the same node */
78static inline bool is_sibling_entry(struct radix_tree_node *parent, void *node)
79{
80 void **ptr = node;
81 return (parent->slots <= ptr) &&
82 (ptr < parent->slots + RADIX_TREE_MAP_SIZE);
83}
84#else
85static inline bool is_sibling_entry(struct radix_tree_node *parent, void *node)
86{
87 return false;
88}
89#endif
90
91static inline unsigned long get_slot_offset(struct radix_tree_node *parent,
92 void **slot)
93{
94 return slot - parent->slots;
95}
96
97static unsigned radix_tree_descend(struct radix_tree_node *parent,
98 struct radix_tree_node **nodep, unsigned offset)
99{
100 void **entry = rcu_dereference_raw(parent->slots[offset]);
101
102#ifdef CONFIG_RADIX_TREE_MULTIORDER
103 if (radix_tree_is_indirect_ptr(entry)) {
104 unsigned long siboff = get_slot_offset(parent, entry);
105 if (siboff < RADIX_TREE_MAP_SIZE) {
106 offset = siboff;
107 entry = rcu_dereference_raw(parent->slots[offset]);
108 }
109 }
110#endif
111
112 *nodep = (void *)entry;
113 return offset;
114}
115
Nick Piggin612d6c12006-06-23 02:03:22 -0700116static inline gfp_t root_gfp_mask(struct radix_tree_root *root)
117{
118 return root->gfp_mask & __GFP_BITS_MASK;
119}
120
Nick Piggin643b52b2008-06-12 15:21:52 -0700121static inline void tag_set(struct radix_tree_node *node, unsigned int tag,
122 int offset)
123{
124 __set_bit(offset, node->tags[tag]);
125}
126
127static inline void tag_clear(struct radix_tree_node *node, unsigned int tag,
128 int offset)
129{
130 __clear_bit(offset, node->tags[tag]);
131}
132
133static inline int tag_get(struct radix_tree_node *node, unsigned int tag,
134 int offset)
135{
136 return test_bit(offset, node->tags[tag]);
137}
138
139static inline void root_tag_set(struct radix_tree_root *root, unsigned int tag)
140{
141 root->gfp_mask |= (__force gfp_t)(1 << (tag + __GFP_BITS_SHIFT));
142}
143
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700144static inline void root_tag_clear(struct radix_tree_root *root, unsigned tag)
Nick Piggin643b52b2008-06-12 15:21:52 -0700145{
146 root->gfp_mask &= (__force gfp_t)~(1 << (tag + __GFP_BITS_SHIFT));
147}
148
149static inline void root_tag_clear_all(struct radix_tree_root *root)
150{
151 root->gfp_mask &= __GFP_BITS_MASK;
152}
153
154static inline int root_tag_get(struct radix_tree_root *root, unsigned int tag)
155{
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700156 return (__force int)root->gfp_mask & (1 << (tag + __GFP_BITS_SHIFT));
Nick Piggin643b52b2008-06-12 15:21:52 -0700157}
158
Matthew Wilcox7b60e9a2016-05-20 17:02:23 -0700159static inline unsigned root_tags_get(struct radix_tree_root *root)
160{
161 return (__force unsigned)root->gfp_mask >> __GFP_BITS_SHIFT;
162}
163
Nick Piggin643b52b2008-06-12 15:21:52 -0700164/*
165 * Returns 1 if any slot in the node has this tag set.
166 * Otherwise returns 0.
167 */
168static inline int any_tag_set(struct radix_tree_node *node, unsigned int tag)
169{
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700170 unsigned idx;
Nick Piggin643b52b2008-06-12 15:21:52 -0700171 for (idx = 0; idx < RADIX_TREE_TAG_LONGS; idx++) {
172 if (node->tags[tag][idx])
173 return 1;
174 }
175 return 0;
176}
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700177
178/**
179 * radix_tree_find_next_bit - find the next set bit in a memory region
180 *
181 * @addr: The address to base the search on
182 * @size: The bitmap size in bits
183 * @offset: The bitnumber to start searching at
184 *
185 * Unrollable variant of find_next_bit() for constant size arrays.
186 * Tail bits starting from size to roundup(size, BITS_PER_LONG) must be zero.
187 * Returns next bit offset, or size if nothing found.
188 */
189static __always_inline unsigned long
190radix_tree_find_next_bit(const unsigned long *addr,
191 unsigned long size, unsigned long offset)
192{
193 if (!__builtin_constant_p(size))
194 return find_next_bit(addr, size, offset);
195
196 if (offset < size) {
197 unsigned long tmp;
198
199 addr += offset / BITS_PER_LONG;
200 tmp = *addr >> (offset % BITS_PER_LONG);
201 if (tmp)
202 return __ffs(tmp) + offset;
203 offset = (offset + BITS_PER_LONG) & ~(BITS_PER_LONG - 1);
204 while (offset < size) {
205 tmp = *++addr;
206 if (tmp)
207 return __ffs(tmp) + offset;
208 offset += BITS_PER_LONG;
209 }
210 }
211 return size;
212}
213
Ross Zwisler0796c582016-05-20 17:02:55 -0700214#ifndef __KERNEL__
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700215static void dump_node(struct radix_tree_node *node, unsigned long index)
Matthew Wilcox7cf19af2016-03-17 14:21:57 -0700216{
Ross Zwisler0796c582016-05-20 17:02:55 -0700217 unsigned long i;
Matthew Wilcox7cf19af2016-03-17 14:21:57 -0700218
Matthew Wilcoxc12e51b2016-05-20 17:03:10 -0700219 pr_debug("radix node: %p offset %d tags %lx %lx %lx shift %d count %d parent %p\n",
Matthew Wilcox0c7fa0a2016-05-20 17:03:07 -0700220 node, node->offset,
Ross Zwisler0796c582016-05-20 17:02:55 -0700221 node->tags[0][0], node->tags[1][0], node->tags[2][0],
Matthew Wilcoxc12e51b2016-05-20 17:03:10 -0700222 node->shift, node->count, node->parent);
Matthew Wilcox7cf19af2016-03-17 14:21:57 -0700223
Ross Zwisler0796c582016-05-20 17:02:55 -0700224 for (i = 0; i < RADIX_TREE_MAP_SIZE; i++) {
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700225 unsigned long first = index | (i << node->shift);
226 unsigned long last = first | ((1UL << node->shift) - 1);
Ross Zwisler0796c582016-05-20 17:02:55 -0700227 void *entry = node->slots[i];
228 if (!entry)
229 continue;
230 if (is_sibling_entry(node, entry)) {
231 pr_debug("radix sblng %p offset %ld val %p indices %ld-%ld\n",
232 entry, i,
233 *(void **)indirect_to_ptr(entry),
234 first, last);
235 } else if (!radix_tree_is_indirect_ptr(entry)) {
236 pr_debug("radix entry %p offset %ld indices %ld-%ld\n",
237 entry, i, first, last);
238 } else {
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700239 dump_node(indirect_to_ptr(entry), first);
Ross Zwisler0796c582016-05-20 17:02:55 -0700240 }
241 }
Matthew Wilcox7cf19af2016-03-17 14:21:57 -0700242}
243
244/* For debug */
245static void radix_tree_dump(struct radix_tree_root *root)
246{
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700247 pr_debug("radix root: %p rnode %p tags %x\n",
248 root, root->rnode,
Matthew Wilcox7cf19af2016-03-17 14:21:57 -0700249 root->gfp_mask >> __GFP_BITS_SHIFT);
250 if (!radix_tree_is_indirect_ptr(root->rnode))
251 return;
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700252 dump_node(indirect_to_ptr(root->rnode), 0);
Matthew Wilcox7cf19af2016-03-17 14:21:57 -0700253}
254#endif
255
Linus Torvalds1da177e2005-04-16 15:20:36 -0700256/*
257 * This assumes that the caller has performed appropriate preallocation, and
258 * that the caller has pinned this thread of control to the current CPU.
259 */
260static struct radix_tree_node *
261radix_tree_node_alloc(struct radix_tree_root *root)
262{
Nick Piggine2848a02008-02-04 22:29:10 -0800263 struct radix_tree_node *ret = NULL;
Nick Piggin612d6c12006-06-23 02:03:22 -0700264 gfp_t gfp_mask = root_gfp_mask(root);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700265
Jan Kara5e4c0d972013-09-11 14:26:05 -0700266 /*
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700267 * Preload code isn't irq safe and it doesn't make sense to use
268 * preloading during an interrupt anyway as all the allocations have
269 * to be atomic. So just do normal allocation when in interrupt.
Jan Kara5e4c0d972013-09-11 14:26:05 -0700270 */
Mel Gormand0164ad2015-11-06 16:28:21 -0800271 if (!gfpflags_allow_blocking(gfp_mask) && !in_interrupt()) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700272 struct radix_tree_preload *rtp;
273
Nick Piggine2848a02008-02-04 22:29:10 -0800274 /*
Vladimir Davydov58e698a2016-03-17 14:18:36 -0700275 * Even if the caller has preloaded, try to allocate from the
276 * cache first for the new node to get accounted.
277 */
278 ret = kmem_cache_alloc(radix_tree_node_cachep,
279 gfp_mask | __GFP_ACCOUNT | __GFP_NOWARN);
280 if (ret)
281 goto out;
282
283 /*
Nick Piggine2848a02008-02-04 22:29:10 -0800284 * Provided the caller has preloaded here, we will always
285 * succeed in getting a node here (and never reach
286 * kmem_cache_alloc)
287 */
Christoph Lameter7c8e0182014-06-04 16:07:56 -0700288 rtp = this_cpu_ptr(&radix_tree_preloads);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700289 if (rtp->nr) {
Kirill A. Shutemov9d2a8da2015-06-25 15:02:19 -0700290 ret = rtp->nodes;
291 rtp->nodes = ret->private_data;
292 ret->private_data = NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700293 rtp->nr--;
294 }
Catalin Marinasce80b062014-06-06 14:38:18 -0700295 /*
296 * Update the allocation stack trace as this is more useful
297 * for debugging.
298 */
299 kmemleak_update_trace(ret);
Vladimir Davydov58e698a2016-03-17 14:18:36 -0700300 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700301 }
Vladimir Davydov58e698a2016-03-17 14:18:36 -0700302 ret = kmem_cache_alloc(radix_tree_node_cachep,
303 gfp_mask | __GFP_ACCOUNT);
304out:
Nick Pigginc0bc9872007-10-16 01:24:42 -0700305 BUG_ON(radix_tree_is_indirect_ptr(ret));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700306 return ret;
307}
308
Nick Piggin7cf9c2c2006-12-06 20:33:44 -0800309static void radix_tree_node_rcu_free(struct rcu_head *head)
310{
311 struct radix_tree_node *node =
312 container_of(head, struct radix_tree_node, rcu_head);
Dave Chinnerb6dd0862010-08-23 10:33:19 +1000313 int i;
Nick Piggin643b52b2008-06-12 15:21:52 -0700314
315 /*
316 * must only free zeroed nodes into the slab. radix_tree_shrink
317 * can leave us with a non-NULL entry in the first slot, so clear
318 * that here to make sure.
319 */
Dave Chinnerb6dd0862010-08-23 10:33:19 +1000320 for (i = 0; i < RADIX_TREE_MAX_TAGS; i++)
321 tag_clear(node, i, 0);
322
Nick Piggin643b52b2008-06-12 15:21:52 -0700323 node->slots[0] = NULL;
324 node->count = 0;
325
Nick Piggin7cf9c2c2006-12-06 20:33:44 -0800326 kmem_cache_free(radix_tree_node_cachep, node);
327}
328
Linus Torvalds1da177e2005-04-16 15:20:36 -0700329static inline void
330radix_tree_node_free(struct radix_tree_node *node)
331{
Nick Piggin7cf9c2c2006-12-06 20:33:44 -0800332 call_rcu(&node->rcu_head, radix_tree_node_rcu_free);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700333}
334
335/*
336 * Load up this CPU's radix_tree_node buffer with sufficient objects to
337 * ensure that the addition of a single element in the tree cannot fail. On
338 * success, return zero, with preemption disabled. On error, return -ENOMEM
339 * with preemption not disabled.
David Howellsb34df792009-11-19 18:11:14 +0000340 *
341 * To make use of this facility, the radix tree must be initialised without
Mel Gormand0164ad2015-11-06 16:28:21 -0800342 * __GFP_DIRECT_RECLAIM being passed to INIT_RADIX_TREE().
Linus Torvalds1da177e2005-04-16 15:20:36 -0700343 */
Jan Kara5e4c0d972013-09-11 14:26:05 -0700344static int __radix_tree_preload(gfp_t gfp_mask)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700345{
346 struct radix_tree_preload *rtp;
347 struct radix_tree_node *node;
348 int ret = -ENOMEM;
349
350 preempt_disable();
Christoph Lameter7c8e0182014-06-04 16:07:56 -0700351 rtp = this_cpu_ptr(&radix_tree_preloads);
Kirill A. Shutemov9d2a8da2015-06-25 15:02:19 -0700352 while (rtp->nr < RADIX_TREE_PRELOAD_SIZE) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700353 preempt_enable();
Christoph Lameter488514d2008-04-28 02:12:05 -0700354 node = kmem_cache_alloc(radix_tree_node_cachep, gfp_mask);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700355 if (node == NULL)
356 goto out;
357 preempt_disable();
Christoph Lameter7c8e0182014-06-04 16:07:56 -0700358 rtp = this_cpu_ptr(&radix_tree_preloads);
Kirill A. Shutemov9d2a8da2015-06-25 15:02:19 -0700359 if (rtp->nr < RADIX_TREE_PRELOAD_SIZE) {
360 node->private_data = rtp->nodes;
361 rtp->nodes = node;
362 rtp->nr++;
363 } else {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700364 kmem_cache_free(radix_tree_node_cachep, node);
Kirill A. Shutemov9d2a8da2015-06-25 15:02:19 -0700365 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700366 }
367 ret = 0;
368out:
369 return ret;
370}
Jan Kara5e4c0d972013-09-11 14:26:05 -0700371
372/*
373 * Load up this CPU's radix_tree_node buffer with sufficient objects to
374 * ensure that the addition of a single element in the tree cannot fail. On
375 * success, return zero, with preemption disabled. On error, return -ENOMEM
376 * with preemption not disabled.
377 *
378 * To make use of this facility, the radix tree must be initialised without
Mel Gormand0164ad2015-11-06 16:28:21 -0800379 * __GFP_DIRECT_RECLAIM being passed to INIT_RADIX_TREE().
Jan Kara5e4c0d972013-09-11 14:26:05 -0700380 */
381int radix_tree_preload(gfp_t gfp_mask)
382{
383 /* Warn on non-sensical use... */
Mel Gormand0164ad2015-11-06 16:28:21 -0800384 WARN_ON_ONCE(!gfpflags_allow_blocking(gfp_mask));
Jan Kara5e4c0d972013-09-11 14:26:05 -0700385 return __radix_tree_preload(gfp_mask);
386}
David Chinnerd7f09232007-07-14 16:05:04 +1000387EXPORT_SYMBOL(radix_tree_preload);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700388
Nick Piggin6e954b92006-01-08 01:01:40 -0800389/*
Jan Kara5e4c0d972013-09-11 14:26:05 -0700390 * The same as above function, except we don't guarantee preloading happens.
391 * We do it, if we decide it helps. On success, return zero with preemption
392 * disabled. On error, return -ENOMEM with preemption not disabled.
393 */
394int radix_tree_maybe_preload(gfp_t gfp_mask)
395{
Mel Gormand0164ad2015-11-06 16:28:21 -0800396 if (gfpflags_allow_blocking(gfp_mask))
Jan Kara5e4c0d972013-09-11 14:26:05 -0700397 return __radix_tree_preload(gfp_mask);
398 /* Preloading doesn't help anything with this gfp mask, skip it */
399 preempt_disable();
400 return 0;
401}
402EXPORT_SYMBOL(radix_tree_maybe_preload);
403
404/*
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700405 * The maximum index which can be stored in a radix tree
Linus Torvalds1da177e2005-04-16 15:20:36 -0700406 */
Matthew Wilcoxc12e51b2016-05-20 17:03:10 -0700407static inline unsigned long shift_maxindex(unsigned int shift)
408{
409 return (RADIX_TREE_MAP_SIZE << shift) - 1;
410}
411
Matthew Wilcox1456a432016-05-20 17:02:08 -0700412static inline unsigned long node_maxindex(struct radix_tree_node *node)
413{
Matthew Wilcoxc12e51b2016-05-20 17:03:10 -0700414 return shift_maxindex(node->shift);
Matthew Wilcox1456a432016-05-20 17:02:08 -0700415}
416
417static unsigned radix_tree_load_root(struct radix_tree_root *root,
418 struct radix_tree_node **nodep, unsigned long *maxindex)
419{
420 struct radix_tree_node *node = rcu_dereference_raw(root->rnode);
421
422 *nodep = node;
423
424 if (likely(radix_tree_is_indirect_ptr(node))) {
425 node = indirect_to_ptr(node);
426 *maxindex = node_maxindex(node);
Matthew Wilcoxc12e51b2016-05-20 17:03:10 -0700427 return node->shift + RADIX_TREE_MAP_SHIFT;
Matthew Wilcox1456a432016-05-20 17:02:08 -0700428 }
429
430 *maxindex = 0;
431 return 0;
432}
433
Linus Torvalds1da177e2005-04-16 15:20:36 -0700434/*
435 * Extend a radix tree so it can store key @index.
436 */
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700437static int radix_tree_extend(struct radix_tree_root *root,
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700438 unsigned long index, unsigned int shift)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700439{
Hugh Dickinse2bdb932012-01-12 17:20:41 -0800440 struct radix_tree_node *slot;
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700441 unsigned int maxshift;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700442 int tag;
443
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700444 /* Figure out what the shift should be. */
445 maxshift = shift;
446 while (index > shift_maxindex(maxshift))
447 maxshift += RADIX_TREE_MAP_SHIFT;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700448
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700449 slot = root->rnode;
450 if (!slot)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700451 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700452
Linus Torvalds1da177e2005-04-16 15:20:36 -0700453 do {
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700454 struct radix_tree_node *node = radix_tree_node_alloc(root);
455
456 if (!node)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700457 return -ENOMEM;
458
Linus Torvalds1da177e2005-04-16 15:20:36 -0700459 /* Propagate the aggregated tag info into the new root */
Jonathan Corbetdaff89f2006-03-25 03:08:05 -0800460 for (tag = 0; tag < RADIX_TREE_MAX_TAGS; tag++) {
Nick Piggin612d6c12006-06-23 02:03:22 -0700461 if (root_tag_get(root, tag))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700462 tag_set(node, tag, 0);
463 }
464
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700465 BUG_ON(shift > BITS_PER_LONG);
466 node->shift = shift;
Matthew Wilcox0c7fa0a2016-05-20 17:03:07 -0700467 node->offset = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700468 node->count = 1;
Hugh Dickinse2bdb932012-01-12 17:20:41 -0800469 node->parent = NULL;
Matthew Wilcox49ea6eb2016-05-20 17:02:11 -0700470 if (radix_tree_is_indirect_ptr(slot)) {
Hugh Dickinse2bdb932012-01-12 17:20:41 -0800471 slot = indirect_to_ptr(slot);
472 slot->parent = node;
Matthew Wilcoxa4db4dc2016-05-20 17:03:24 -0700473 slot = node_to_entry(slot);
Hugh Dickinse2bdb932012-01-12 17:20:41 -0800474 }
475 node->slots[0] = slot;
Matthew Wilcoxa4db4dc2016-05-20 17:03:24 -0700476 slot = node_to_entry(node);
477 rcu_assign_pointer(root->rnode, slot);
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700478 shift += RADIX_TREE_MAP_SHIFT;
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700479 } while (shift <= maxshift);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700480out:
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700481 return maxshift + RADIX_TREE_MAP_SHIFT;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700482}
483
484/**
Johannes Weiner139e5612014-04-03 14:47:54 -0700485 * __radix_tree_create - create a slot in a radix tree
Linus Torvalds1da177e2005-04-16 15:20:36 -0700486 * @root: radix tree root
487 * @index: index key
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700488 * @order: index occupies 2^order aligned slots
Johannes Weiner139e5612014-04-03 14:47:54 -0700489 * @nodep: returns node
490 * @slotp: returns slot
Linus Torvalds1da177e2005-04-16 15:20:36 -0700491 *
Johannes Weiner139e5612014-04-03 14:47:54 -0700492 * Create, if necessary, and return the node and slot for an item
493 * at position @index in the radix tree @root.
494 *
495 * Until there is more than one item in the tree, no nodes are
496 * allocated and @root->rnode is used as a direct slot instead of
497 * pointing to a node, in which case *@nodep will be NULL.
498 *
499 * Returns -ENOMEM, or 0 for success.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700500 */
Johannes Weiner139e5612014-04-03 14:47:54 -0700501int __radix_tree_create(struct radix_tree_root *root, unsigned long index,
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700502 unsigned order, struct radix_tree_node **nodep,
503 void ***slotp)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700504{
Christoph Lameter201b6262005-09-06 15:16:46 -0700505 struct radix_tree_node *node = NULL, *slot;
Matthew Wilcox49ea6eb2016-05-20 17:02:11 -0700506 unsigned long maxindex;
Matthew Wilcoxc12e51b2016-05-20 17:03:10 -0700507 unsigned int shift, offset;
Matthew Wilcox49ea6eb2016-05-20 17:02:11 -0700508 unsigned long max = index | ((1UL << order) - 1);
509
510 shift = radix_tree_load_root(root, &slot, &maxindex);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700511
512 /* Make sure the tree is high enough. */
Matthew Wilcox49ea6eb2016-05-20 17:02:11 -0700513 if (max > maxindex) {
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700514 int error = radix_tree_extend(root, max, shift);
Matthew Wilcox49ea6eb2016-05-20 17:02:11 -0700515 if (error < 0)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700516 return error;
Matthew Wilcox49ea6eb2016-05-20 17:02:11 -0700517 shift = error;
518 slot = root->rnode;
Matthew Wilcoxd0891262016-05-20 17:03:19 -0700519 if (order == shift)
Matthew Wilcox49ea6eb2016-05-20 17:02:11 -0700520 shift += RADIX_TREE_MAP_SHIFT;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700521 }
522
Linus Torvalds1da177e2005-04-16 15:20:36 -0700523 offset = 0; /* uninitialised var warning */
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700524 while (shift > order) {
Matthew Wilcoxc12e51b2016-05-20 17:03:10 -0700525 shift -= RADIX_TREE_MAP_SHIFT;
Christoph Lameter201b6262005-09-06 15:16:46 -0700526 if (slot == NULL) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700527 /* Have to add a child node. */
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700528 slot = radix_tree_node_alloc(root);
529 if (!slot)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700530 return -ENOMEM;
Matthew Wilcoxc12e51b2016-05-20 17:03:10 -0700531 slot->shift = shift;
Matthew Wilcox0c7fa0a2016-05-20 17:03:07 -0700532 slot->offset = offset;
Hugh Dickinse2bdb932012-01-12 17:20:41 -0800533 slot->parent = node;
Christoph Lameter201b6262005-09-06 15:16:46 -0700534 if (node) {
Matthew Wilcox339e6352016-03-17 14:21:48 -0700535 rcu_assign_pointer(node->slots[offset],
Matthew Wilcoxa4db4dc2016-05-20 17:03:24 -0700536 node_to_entry(slot));
Linus Torvalds1da177e2005-04-16 15:20:36 -0700537 node->count++;
Christoph Lameter201b6262005-09-06 15:16:46 -0700538 } else
Matthew Wilcox339e6352016-03-17 14:21:48 -0700539 rcu_assign_pointer(root->rnode,
Matthew Wilcoxa4db4dc2016-05-20 17:03:24 -0700540 node_to_entry(slot));
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700541 } else if (!radix_tree_is_indirect_ptr(slot))
542 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700543
544 /* Go a level down */
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700545 node = indirect_to_ptr(slot);
Matthew Wilcox8a14f4d2016-05-20 17:02:44 -0700546 offset = (index >> shift) & RADIX_TREE_MAP_MASK;
547 offset = radix_tree_descend(node, &slot, offset);
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700548 }
549
Matthew Wilcox57578c22016-05-20 17:01:54 -0700550#ifdef CONFIG_RADIX_TREE_MULTIORDER
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700551 /* Insert pointers to the canonical entry */
Matthew Wilcox3b8c00f2016-05-20 17:01:59 -0700552 if (order > shift) {
553 int i, n = 1 << (order - shift);
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700554 offset = offset & ~(n - 1);
Matthew Wilcoxa4db4dc2016-05-20 17:03:24 -0700555 slot = node_to_entry(&node->slots[offset]);
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700556 for (i = 0; i < n; i++) {
557 if (node->slots[offset + i])
558 return -EEXIST;
559 }
560
561 for (i = 1; i < n; i++) {
562 rcu_assign_pointer(node->slots[offset + i], slot);
563 node->count++;
564 }
Nick Piggin612d6c12006-06-23 02:03:22 -0700565 }
Matthew Wilcox57578c22016-05-20 17:01:54 -0700566#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700567
Johannes Weiner139e5612014-04-03 14:47:54 -0700568 if (nodep)
569 *nodep = node;
570 if (slotp)
571 *slotp = node ? node->slots + offset : (void **)&root->rnode;
572 return 0;
573}
574
575/**
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700576 * __radix_tree_insert - insert into a radix tree
Johannes Weiner139e5612014-04-03 14:47:54 -0700577 * @root: radix tree root
578 * @index: index key
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700579 * @order: key covers the 2^order indices around index
Johannes Weiner139e5612014-04-03 14:47:54 -0700580 * @item: item to insert
581 *
582 * Insert an item into the radix tree at position @index.
583 */
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700584int __radix_tree_insert(struct radix_tree_root *root, unsigned long index,
585 unsigned order, void *item)
Johannes Weiner139e5612014-04-03 14:47:54 -0700586{
587 struct radix_tree_node *node;
588 void **slot;
589 int error;
590
591 BUG_ON(radix_tree_is_indirect_ptr(item));
592
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700593 error = __radix_tree_create(root, index, order, &node, &slot);
Johannes Weiner139e5612014-04-03 14:47:54 -0700594 if (error)
595 return error;
596 if (*slot != NULL)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700597 return -EEXIST;
Johannes Weiner139e5612014-04-03 14:47:54 -0700598 rcu_assign_pointer(*slot, item);
Christoph Lameter201b6262005-09-06 15:16:46 -0700599
Nick Piggin612d6c12006-06-23 02:03:22 -0700600 if (node) {
Matthew Wilcox7b60e9a2016-05-20 17:02:23 -0700601 unsigned offset = get_slot_offset(node, slot);
Nick Piggin612d6c12006-06-23 02:03:22 -0700602 node->count++;
Matthew Wilcox7b60e9a2016-05-20 17:02:23 -0700603 BUG_ON(tag_get(node, 0, offset));
604 BUG_ON(tag_get(node, 1, offset));
605 BUG_ON(tag_get(node, 2, offset));
Nick Piggin612d6c12006-06-23 02:03:22 -0700606 } else {
Matthew Wilcox7b60e9a2016-05-20 17:02:23 -0700607 BUG_ON(root_tags_get(root));
Nick Piggin612d6c12006-06-23 02:03:22 -0700608 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700609
Linus Torvalds1da177e2005-04-16 15:20:36 -0700610 return 0;
611}
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700612EXPORT_SYMBOL(__radix_tree_insert);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700613
Johannes Weiner139e5612014-04-03 14:47:54 -0700614/**
615 * __radix_tree_lookup - lookup an item in a radix tree
616 * @root: radix tree root
617 * @index: index key
618 * @nodep: returns node
619 * @slotp: returns slot
620 *
621 * Lookup and return the item at position @index in the radix
622 * tree @root.
623 *
624 * Until there is more than one item in the tree, no nodes are
625 * allocated and @root->rnode is used as a direct slot instead of
626 * pointing to a node, in which case *@nodep will be NULL.
Hans Reisera4331362005-11-07 00:59:29 -0800627 */
Johannes Weiner139e5612014-04-03 14:47:54 -0700628void *__radix_tree_lookup(struct radix_tree_root *root, unsigned long index,
629 struct radix_tree_node **nodep, void ***slotp)
Hans Reisera4331362005-11-07 00:59:29 -0800630{
Johannes Weiner139e5612014-04-03 14:47:54 -0700631 struct radix_tree_node *node, *parent;
Matthew Wilcox85829952016-05-20 17:02:20 -0700632 unsigned long maxindex;
633 unsigned int shift;
Johannes Weiner139e5612014-04-03 14:47:54 -0700634 void **slot;
Nick Piggin7cf9c2c2006-12-06 20:33:44 -0800635
Matthew Wilcox85829952016-05-20 17:02:20 -0700636 restart:
637 parent = NULL;
638 slot = (void **)&root->rnode;
639 shift = radix_tree_load_root(root, &node, &maxindex);
640 if (index > maxindex)
Nick Piggin7cf9c2c2006-12-06 20:33:44 -0800641 return NULL;
642
Matthew Wilcox85829952016-05-20 17:02:20 -0700643 while (radix_tree_is_indirect_ptr(node)) {
644 unsigned offset;
Johannes Weiner139e5612014-04-03 14:47:54 -0700645
Matthew Wilcox85829952016-05-20 17:02:20 -0700646 if (node == RADIX_TREE_RETRY)
647 goto restart;
648 parent = indirect_to_ptr(node);
Nick Piggin7cf9c2c2006-12-06 20:33:44 -0800649 shift -= RADIX_TREE_MAP_SHIFT;
Matthew Wilcox85829952016-05-20 17:02:20 -0700650 offset = (index >> shift) & RADIX_TREE_MAP_MASK;
651 offset = radix_tree_descend(parent, &node, offset);
652 slot = parent->slots + offset;
653 }
Nick Piggin7cf9c2c2006-12-06 20:33:44 -0800654
Johannes Weiner139e5612014-04-03 14:47:54 -0700655 if (nodep)
656 *nodep = parent;
657 if (slotp)
658 *slotp = slot;
659 return node;
Huang Shijieb72b71c2009-06-16 15:33:42 -0700660}
661
662/**
663 * radix_tree_lookup_slot - lookup a slot in a radix tree
664 * @root: radix tree root
665 * @index: index key
666 *
667 * Returns: the slot corresponding to the position @index in the
668 * radix tree @root. This is useful for update-if-exists operations.
669 *
670 * This function can be called under rcu_read_lock iff the slot is not
671 * modified by radix_tree_replace_slot, otherwise it must be called
672 * exclusive from other writers. Any dereference of the slot must be done
673 * using radix_tree_deref_slot.
674 */
675void **radix_tree_lookup_slot(struct radix_tree_root *root, unsigned long index)
676{
Johannes Weiner139e5612014-04-03 14:47:54 -0700677 void **slot;
678
679 if (!__radix_tree_lookup(root, index, NULL, &slot))
680 return NULL;
681 return slot;
Hans Reisera4331362005-11-07 00:59:29 -0800682}
683EXPORT_SYMBOL(radix_tree_lookup_slot);
684
Linus Torvalds1da177e2005-04-16 15:20:36 -0700685/**
686 * radix_tree_lookup - perform lookup operation on a radix tree
687 * @root: radix tree root
688 * @index: index key
689 *
690 * Lookup the item at the position @index in the radix tree @root.
Nick Piggin7cf9c2c2006-12-06 20:33:44 -0800691 *
692 * This function can be called under rcu_read_lock, however the caller
693 * must manage lifetimes of leaf nodes (eg. RCU may also be used to free
694 * them safely). No RCU barriers are required to access or modify the
695 * returned item, however.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700696 */
697void *radix_tree_lookup(struct radix_tree_root *root, unsigned long index)
698{
Johannes Weiner139e5612014-04-03 14:47:54 -0700699 return __radix_tree_lookup(root, index, NULL, NULL);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700700}
701EXPORT_SYMBOL(radix_tree_lookup);
702
703/**
704 * radix_tree_tag_set - set a tag on a radix tree node
705 * @root: radix tree root
706 * @index: index key
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700707 * @tag: tag index
Linus Torvalds1da177e2005-04-16 15:20:36 -0700708 *
Jonathan Corbetdaff89f2006-03-25 03:08:05 -0800709 * Set the search tag (which must be < RADIX_TREE_MAX_TAGS)
710 * corresponding to @index in the radix tree. From
Linus Torvalds1da177e2005-04-16 15:20:36 -0700711 * the root all the way down to the leaf node.
712 *
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700713 * Returns the address of the tagged item. Setting a tag on a not-present
Linus Torvalds1da177e2005-04-16 15:20:36 -0700714 * item is a bug.
715 */
716void *radix_tree_tag_set(struct radix_tree_root *root,
Jonathan Corbetdaff89f2006-03-25 03:08:05 -0800717 unsigned long index, unsigned int tag)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700718{
Ross Zwislerfb969902016-05-20 17:02:32 -0700719 struct radix_tree_node *node, *parent;
720 unsigned long maxindex;
721 unsigned int shift;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700722
Ross Zwislerfb969902016-05-20 17:02:32 -0700723 shift = radix_tree_load_root(root, &node, &maxindex);
724 BUG_ON(index > maxindex);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700725
Ross Zwislerfb969902016-05-20 17:02:32 -0700726 while (radix_tree_is_indirect_ptr(node)) {
727 unsigned offset;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700728
Linus Torvalds1da177e2005-04-16 15:20:36 -0700729 shift -= RADIX_TREE_MAP_SHIFT;
Ross Zwislerfb969902016-05-20 17:02:32 -0700730 offset = (index >> shift) & RADIX_TREE_MAP_MASK;
731
732 parent = indirect_to_ptr(node);
733 offset = radix_tree_descend(parent, &node, offset);
734 BUG_ON(!node);
735
736 if (!tag_get(parent, tag, offset))
737 tag_set(parent, tag, offset);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700738 }
739
Nick Piggin612d6c12006-06-23 02:03:22 -0700740 /* set the root's tag bit */
Ross Zwislerfb969902016-05-20 17:02:32 -0700741 if (!root_tag_get(root, tag))
Nick Piggin612d6c12006-06-23 02:03:22 -0700742 root_tag_set(root, tag);
743
Ross Zwislerfb969902016-05-20 17:02:32 -0700744 return node;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700745}
746EXPORT_SYMBOL(radix_tree_tag_set);
747
748/**
749 * radix_tree_tag_clear - clear a tag on a radix tree node
750 * @root: radix tree root
751 * @index: index key
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700752 * @tag: tag index
Linus Torvalds1da177e2005-04-16 15:20:36 -0700753 *
Jonathan Corbetdaff89f2006-03-25 03:08:05 -0800754 * Clear the search tag (which must be < RADIX_TREE_MAX_TAGS)
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700755 * corresponding to @index in the radix tree. If this causes
756 * the leaf node to have no tags set then clear the tag in the
Linus Torvalds1da177e2005-04-16 15:20:36 -0700757 * next-to-leaf node, etc.
758 *
759 * Returns the address of the tagged item on success, else NULL. ie:
760 * has the same return value and semantics as radix_tree_lookup().
761 */
762void *radix_tree_tag_clear(struct radix_tree_root *root,
Jonathan Corbetdaff89f2006-03-25 03:08:05 -0800763 unsigned long index, unsigned int tag)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700764{
Ross Zwisler00f47b52016-05-20 17:02:35 -0700765 struct radix_tree_node *node, *parent;
766 unsigned long maxindex;
767 unsigned int shift;
Hugh Dickinse2bdb932012-01-12 17:20:41 -0800768 int uninitialized_var(offset);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700769
Ross Zwisler00f47b52016-05-20 17:02:35 -0700770 shift = radix_tree_load_root(root, &node, &maxindex);
771 if (index > maxindex)
772 return NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700773
Ross Zwisler00f47b52016-05-20 17:02:35 -0700774 parent = NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700775
Ross Zwisler00f47b52016-05-20 17:02:35 -0700776 while (radix_tree_is_indirect_ptr(node)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700777 shift -= RADIX_TREE_MAP_SHIFT;
Hugh Dickinse2bdb932012-01-12 17:20:41 -0800778 offset = (index >> shift) & RADIX_TREE_MAP_MASK;
Ross Zwisler00f47b52016-05-20 17:02:35 -0700779
780 parent = indirect_to_ptr(node);
781 offset = radix_tree_descend(parent, &node, offset);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700782 }
783
Ross Zwisler00f47b52016-05-20 17:02:35 -0700784 if (node == NULL)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700785 goto out;
786
Ross Zwisler00f47b52016-05-20 17:02:35 -0700787 index >>= shift;
788
789 while (parent) {
790 if (!tag_get(parent, tag, offset))
Nick Piggind5274262006-01-08 01:01:41 -0800791 goto out;
Ross Zwisler00f47b52016-05-20 17:02:35 -0700792 tag_clear(parent, tag, offset);
793 if (any_tag_set(parent, tag))
Nick Piggin6e954b92006-01-08 01:01:40 -0800794 goto out;
Hugh Dickinse2bdb932012-01-12 17:20:41 -0800795
796 index >>= RADIX_TREE_MAP_SHIFT;
797 offset = index & RADIX_TREE_MAP_MASK;
Ross Zwisler00f47b52016-05-20 17:02:35 -0700798 parent = parent->parent;
Nick Piggin612d6c12006-06-23 02:03:22 -0700799 }
800
801 /* clear the root's tag bit */
802 if (root_tag_get(root, tag))
803 root_tag_clear(root, tag);
804
Linus Torvalds1da177e2005-04-16 15:20:36 -0700805out:
Ross Zwisler00f47b52016-05-20 17:02:35 -0700806 return node;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700807}
808EXPORT_SYMBOL(radix_tree_tag_clear);
809
Linus Torvalds1da177e2005-04-16 15:20:36 -0700810/**
Marcelo Tosatti32605a12005-09-06 15:16:48 -0700811 * radix_tree_tag_get - get a tag on a radix tree node
812 * @root: radix tree root
813 * @index: index key
Matthew Wilcox2fcd9002016-05-20 17:03:04 -0700814 * @tag: tag index (< RADIX_TREE_MAX_TAGS)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700815 *
Marcelo Tosatti32605a12005-09-06 15:16:48 -0700816 * Return values:
Linus Torvalds1da177e2005-04-16 15:20:36 -0700817 *
Nick Piggin612d6c12006-06-23 02:03:22 -0700818 * 0: tag not present or not set
819 * 1: tag set
David Howellsce826532010-04-06 22:36:20 +0100820 *
821 * Note that the return value of this function may not be relied on, even if
822 * the RCU lock is held, unless tag modification and node deletion are excluded
823 * from concurrency.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700824 */
825int radix_tree_tag_get(struct radix_tree_root *root,
Jonathan Corbetdaff89f2006-03-25 03:08:05 -0800826 unsigned long index, unsigned int tag)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700827{
Ross Zwisler4589ba62016-05-20 17:02:38 -0700828 struct radix_tree_node *node, *parent;
829 unsigned long maxindex;
830 unsigned int shift;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700831
Nick Piggin612d6c12006-06-23 02:03:22 -0700832 if (!root_tag_get(root, tag))
833 return 0;
834
Ross Zwisler4589ba62016-05-20 17:02:38 -0700835 shift = radix_tree_load_root(root, &node, &maxindex);
836 if (index > maxindex)
837 return 0;
Nick Piggin7cf9c2c2006-12-06 20:33:44 -0800838 if (node == NULL)
839 return 0;
840
Ross Zwisler4589ba62016-05-20 17:02:38 -0700841 while (radix_tree_is_indirect_ptr(node)) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700842 int offset;
843
Linus Torvalds1da177e2005-04-16 15:20:36 -0700844 shift -= RADIX_TREE_MAP_SHIFT;
Ross Zwisler4589ba62016-05-20 17:02:38 -0700845 offset = (index >> shift) & RADIX_TREE_MAP_MASK;
846
847 parent = indirect_to_ptr(node);
848 offset = radix_tree_descend(parent, &node, offset);
849
850 if (!node)
851 return 0;
852 if (!tag_get(parent, tag, offset))
853 return 0;
854 if (node == RADIX_TREE_RETRY)
855 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700856 }
Ross Zwisler4589ba62016-05-20 17:02:38 -0700857
858 return 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700859}
860EXPORT_SYMBOL(radix_tree_tag_get);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700861
Ross Zwisler21ef5332016-05-20 17:02:26 -0700862static inline void __set_iter_shift(struct radix_tree_iter *iter,
863 unsigned int shift)
864{
865#ifdef CONFIG_RADIX_TREE_MULTIORDER
866 iter->shift = shift;
867#endif
868}
869
Fengguang Wu6df8ba42007-10-16 01:24:33 -0700870/**
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700871 * radix_tree_next_chunk - find next chunk of slots for iteration
872 *
873 * @root: radix tree root
874 * @iter: iterator state
875 * @flags: RADIX_TREE_ITER_* flags and tag index
876 * Returns: pointer to chunk first slot, or NULL if iteration is over
877 */
878void **radix_tree_next_chunk(struct radix_tree_root *root,
879 struct radix_tree_iter *iter, unsigned flags)
880{
881 unsigned shift, tag = flags & RADIX_TREE_ITER_TAG_MASK;
882 struct radix_tree_node *rnode, *node;
Ross Zwisler21ef5332016-05-20 17:02:26 -0700883 unsigned long index, offset, maxindex;
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700884
885 if ((flags & RADIX_TREE_ITER_TAGGED) && !root_tag_get(root, tag))
886 return NULL;
887
888 /*
889 * Catch next_index overflow after ~0UL. iter->index never overflows
890 * during iterating; it can be zero only at the beginning.
891 * And we cannot overflow iter->next_index in a single step,
892 * because RADIX_TREE_MAP_SHIFT < BITS_PER_LONG.
Konstantin Khlebnikovfffaee32012-06-05 21:36:33 +0400893 *
894 * This condition also used by radix_tree_next_slot() to stop
895 * contiguous iterating, and forbid swithing to the next chunk.
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700896 */
897 index = iter->next_index;
898 if (!index && iter->index)
899 return NULL;
900
Ross Zwisler21ef5332016-05-20 17:02:26 -0700901 restart:
902 shift = radix_tree_load_root(root, &rnode, &maxindex);
903 if (index > maxindex)
904 return NULL;
905
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700906 if (radix_tree_is_indirect_ptr(rnode)) {
907 rnode = indirect_to_ptr(rnode);
Ross Zwisler21ef5332016-05-20 17:02:26 -0700908 } else if (rnode) {
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700909 /* Single-slot tree */
Ross Zwisler21ef5332016-05-20 17:02:26 -0700910 iter->index = index;
911 iter->next_index = maxindex + 1;
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700912 iter->tags = 1;
Ross Zwisler21ef5332016-05-20 17:02:26 -0700913 __set_iter_shift(iter, shift);
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700914 return (void **)&root->rnode;
915 } else
916 return NULL;
917
Ross Zwisler21ef5332016-05-20 17:02:26 -0700918 shift -= RADIX_TREE_MAP_SHIFT;
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700919 offset = index >> shift;
920
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700921 node = rnode;
922 while (1) {
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700923 struct radix_tree_node *slot;
Ross Zwisler21ef5332016-05-20 17:02:26 -0700924 unsigned new_off = radix_tree_descend(node, &slot, offset);
925
926 if (new_off < offset) {
927 offset = new_off;
928 index &= ~((RADIX_TREE_MAP_SIZE << shift) - 1);
929 index |= offset << shift;
930 }
931
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700932 if ((flags & RADIX_TREE_ITER_TAGGED) ?
Ross Zwisler21ef5332016-05-20 17:02:26 -0700933 !tag_get(node, tag, offset) : !slot) {
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700934 /* Hole detected */
935 if (flags & RADIX_TREE_ITER_CONTIG)
936 return NULL;
937
938 if (flags & RADIX_TREE_ITER_TAGGED)
939 offset = radix_tree_find_next_bit(
940 node->tags[tag],
941 RADIX_TREE_MAP_SIZE,
942 offset + 1);
943 else
944 while (++offset < RADIX_TREE_MAP_SIZE) {
Ross Zwisler21ef5332016-05-20 17:02:26 -0700945 void *slot = node->slots[offset];
946 if (is_sibling_entry(node, slot))
947 continue;
948 if (slot)
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700949 break;
950 }
951 index &= ~((RADIX_TREE_MAP_SIZE << shift) - 1);
952 index += offset << shift;
953 /* Overflow after ~0UL */
954 if (!index)
955 return NULL;
956 if (offset == RADIX_TREE_MAP_SIZE)
957 goto restart;
Ross Zwisler21ef5332016-05-20 17:02:26 -0700958 slot = rcu_dereference_raw(node->slots[offset]);
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700959 }
960
Ross Zwisler21ef5332016-05-20 17:02:26 -0700961 if ((slot == NULL) || (slot == RADIX_TREE_RETRY))
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700962 goto restart;
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700963 if (!radix_tree_is_indirect_ptr(slot))
964 break;
Ross Zwisler21ef5332016-05-20 17:02:26 -0700965
Matthew Wilcoxe6145232016-03-17 14:21:54 -0700966 node = indirect_to_ptr(slot);
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700967 shift -= RADIX_TREE_MAP_SHIFT;
968 offset = (index >> shift) & RADIX_TREE_MAP_MASK;
969 }
970
971 /* Update the iterator state */
Ross Zwisler21ef5332016-05-20 17:02:26 -0700972 iter->index = index & ~((1 << shift) - 1);
973 iter->next_index = (index | ((RADIX_TREE_MAP_SIZE << shift) - 1)) + 1;
974 __set_iter_shift(iter, shift);
Konstantin Khlebnikov78c1d782012-03-28 14:42:53 -0700975
976 /* Construct iter->tags bit-mask from node->tags[tag] array */
977 if (flags & RADIX_TREE_ITER_TAGGED) {
978 unsigned tag_long, tag_bit;
979
980 tag_long = offset / BITS_PER_LONG;
981 tag_bit = offset % BITS_PER_LONG;
982 iter->tags = node->tags[tag][tag_long] >> tag_bit;
983 /* This never happens if RADIX_TREE_TAG_LONGS == 1 */
984 if (tag_long < RADIX_TREE_TAG_LONGS - 1) {
985 /* Pick tags from next element */
986 if (tag_bit)
987 iter->tags |= node->tags[tag][tag_long + 1] <<
988 (BITS_PER_LONG - tag_bit);
989 /* Clip chunk size, here only BITS_PER_LONG tags */
990 iter->next_index = index + BITS_PER_LONG;
991 }
992 }
993
994 return node->slots + offset;
995}
996EXPORT_SYMBOL(radix_tree_next_chunk);
997
998/**
Jan Karaebf8aa42010-08-09 17:19:11 -0700999 * radix_tree_range_tag_if_tagged - for each item in given range set given
1000 * tag if item has another tag set
1001 * @root: radix tree root
1002 * @first_indexp: pointer to a starting index of a range to scan
1003 * @last_index: last index of a range to scan
1004 * @nr_to_tag: maximum number items to tag
1005 * @iftag: tag index to test
1006 * @settag: tag index to set if tested tag is set
1007 *
1008 * This function scans range of radix tree from first_index to last_index
1009 * (inclusive). For each item in the range if iftag is set, the function sets
1010 * also settag. The function stops either after tagging nr_to_tag items or
1011 * after reaching last_index.
1012 *
Dave Chinner144dcfc2010-08-23 10:33:53 +10001013 * The tags must be set from the leaf level only and propagated back up the
1014 * path to the root. We must do this so that we resolve the full path before
1015 * setting any tags on intermediate nodes. If we set tags as we descend, then
1016 * we can get to the leaf node and find that the index that has the iftag
1017 * set is outside the range we are scanning. This reults in dangling tags and
1018 * can lead to problems with later tag operations (e.g. livelocks on lookups).
1019 *
Matthew Wilcox2fcd9002016-05-20 17:03:04 -07001020 * The function returns the number of leaves where the tag was set and sets
Jan Karaebf8aa42010-08-09 17:19:11 -07001021 * *first_indexp to the first unscanned index.
Jan Karad5ed3a42010-08-19 14:13:33 -07001022 * WARNING! *first_indexp can wrap if last_index is ULONG_MAX. Caller must
1023 * be prepared to handle that.
Jan Karaebf8aa42010-08-09 17:19:11 -07001024 */
1025unsigned long radix_tree_range_tag_if_tagged(struct radix_tree_root *root,
1026 unsigned long *first_indexp, unsigned long last_index,
1027 unsigned long nr_to_tag,
1028 unsigned int iftag, unsigned int settag)
1029{
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001030 struct radix_tree_node *slot, *node = NULL;
1031 unsigned long maxindex;
1032 unsigned int shift = radix_tree_load_root(root, &slot, &maxindex);
Dave Chinner144dcfc2010-08-23 10:33:53 +10001033 unsigned long tagged = 0;
1034 unsigned long index = *first_indexp;
Jan Karaebf8aa42010-08-09 17:19:11 -07001035
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001036 last_index = min(last_index, maxindex);
Jan Karaebf8aa42010-08-09 17:19:11 -07001037 if (index > last_index)
1038 return 0;
1039 if (!nr_to_tag)
1040 return 0;
1041 if (!root_tag_get(root, iftag)) {
1042 *first_indexp = last_index + 1;
1043 return 0;
1044 }
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001045 if (!radix_tree_is_indirect_ptr(slot)) {
Jan Karaebf8aa42010-08-09 17:19:11 -07001046 *first_indexp = last_index + 1;
1047 root_tag_set(root, settag);
1048 return 1;
1049 }
1050
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001051 node = indirect_to_ptr(slot);
1052 shift -= RADIX_TREE_MAP_SHIFT;
Jan Karaebf8aa42010-08-09 17:19:11 -07001053
1054 for (;;) {
Hugh Dickinse2bdb932012-01-12 17:20:41 -08001055 unsigned long upindex;
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001056 unsigned offset;
Jan Karaebf8aa42010-08-09 17:19:11 -07001057
1058 offset = (index >> shift) & RADIX_TREE_MAP_MASK;
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001059 offset = radix_tree_descend(node, &slot, offset);
1060 if (!slot)
Jan Karaebf8aa42010-08-09 17:19:11 -07001061 goto next;
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001062 if (!tag_get(node, iftag, offset))
Jan Karaebf8aa42010-08-09 17:19:11 -07001063 goto next;
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001064 /* Sibling slots never have tags set on them */
1065 if (radix_tree_is_indirect_ptr(slot)) {
1066 node = indirect_to_ptr(slot);
1067 shift -= RADIX_TREE_MAP_SHIFT;
1068 continue;
Jan Karaebf8aa42010-08-09 17:19:11 -07001069 }
Dave Chinner144dcfc2010-08-23 10:33:53 +10001070
1071 /* tag the leaf */
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001072 tagged++;
1073 tag_set(node, settag, offset);
Dave Chinner144dcfc2010-08-23 10:33:53 +10001074
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001075 slot = node->parent;
Dave Chinner144dcfc2010-08-23 10:33:53 +10001076 /* walk back up the path tagging interior nodes */
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001077 upindex = index >> shift;
1078 while (slot) {
Hugh Dickinse2bdb932012-01-12 17:20:41 -08001079 upindex >>= RADIX_TREE_MAP_SHIFT;
1080 offset = upindex & RADIX_TREE_MAP_MASK;
1081
Dave Chinner144dcfc2010-08-23 10:33:53 +10001082 /* stop if we find a node with the tag already set */
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001083 if (tag_get(slot, settag, offset))
Dave Chinner144dcfc2010-08-23 10:33:53 +10001084 break;
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001085 tag_set(slot, settag, offset);
1086 slot = slot->parent;
Dave Chinner144dcfc2010-08-23 10:33:53 +10001087 }
1088
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001089 next:
Jan Karaebf8aa42010-08-09 17:19:11 -07001090 /* Go to next item at level determined by 'shift' */
1091 index = ((index >> shift) + 1) << shift;
Jan Karad5ed3a42010-08-19 14:13:33 -07001092 /* Overflow can happen when last_index is ~0UL... */
1093 if (index > last_index || !index)
Jan Karaebf8aa42010-08-09 17:19:11 -07001094 break;
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001095 offset = (index >> shift) & RADIX_TREE_MAP_MASK;
1096 while (offset == 0) {
Jan Karaebf8aa42010-08-09 17:19:11 -07001097 /*
1098 * We've fully scanned this node. Go up. Because
1099 * last_index is guaranteed to be in the tree, what
1100 * we do below cannot wander astray.
1101 */
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001102 node = node->parent;
Jan Karaebf8aa42010-08-09 17:19:11 -07001103 shift += RADIX_TREE_MAP_SHIFT;
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001104 offset = (index >> shift) & RADIX_TREE_MAP_MASK;
Jan Karaebf8aa42010-08-09 17:19:11 -07001105 }
Matthew Wilcox070c5ac2016-05-20 17:02:52 -07001106 if (is_sibling_entry(node, node->slots[offset]))
1107 goto next;
1108 if (tagged >= nr_to_tag)
1109 break;
Jan Karaebf8aa42010-08-09 17:19:11 -07001110 }
1111 /*
Toshiyuki Okajimaac15ee62011-01-25 15:07:32 -08001112 * We need not to tag the root tag if there is no tag which is set with
1113 * settag within the range from *first_indexp to last_index.
Jan Karaebf8aa42010-08-09 17:19:11 -07001114 */
Toshiyuki Okajimaac15ee62011-01-25 15:07:32 -08001115 if (tagged > 0)
1116 root_tag_set(root, settag);
Jan Karaebf8aa42010-08-09 17:19:11 -07001117 *first_indexp = index;
1118
1119 return tagged;
1120}
1121EXPORT_SYMBOL(radix_tree_range_tag_if_tagged);
1122
Linus Torvalds1da177e2005-04-16 15:20:36 -07001123/**
1124 * radix_tree_gang_lookup - perform multiple lookup on a radix tree
1125 * @root: radix tree root
1126 * @results: where the results of the lookup are placed
1127 * @first_index: start the lookup from this key
1128 * @max_items: place up to this many items at *results
1129 *
1130 * Performs an index-ascending scan of the tree for present items. Places
1131 * them at *@results and returns the number of items which were placed at
1132 * *@results.
1133 *
1134 * The implementation is naive.
Nick Piggin7cf9c2c2006-12-06 20:33:44 -08001135 *
1136 * Like radix_tree_lookup, radix_tree_gang_lookup may be called under
1137 * rcu_read_lock. In this case, rather than the returned results being
Matthew Wilcox2fcd9002016-05-20 17:03:04 -07001138 * an atomic snapshot of the tree at a single point in time, the
1139 * semantics of an RCU protected gang lookup are as though multiple
1140 * radix_tree_lookups have been issued in individual locks, and results
1141 * stored in 'results'.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001142 */
1143unsigned int
1144radix_tree_gang_lookup(struct radix_tree_root *root, void **results,
1145 unsigned long first_index, unsigned int max_items)
1146{
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001147 struct radix_tree_iter iter;
1148 void **slot;
1149 unsigned int ret = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001150
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001151 if (unlikely(!max_items))
Nick Piggin7cf9c2c2006-12-06 20:33:44 -08001152 return 0;
1153
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001154 radix_tree_for_each_slot(slot, root, &iter, first_index) {
Matthew Wilcox46437f92016-02-02 16:57:52 -08001155 results[ret] = rcu_dereference_raw(*slot);
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001156 if (!results[ret])
1157 continue;
Matthew Wilcox46437f92016-02-02 16:57:52 -08001158 if (radix_tree_is_indirect_ptr(results[ret])) {
1159 slot = radix_tree_iter_retry(&iter);
1160 continue;
1161 }
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001162 if (++ret == max_items)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001163 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001164 }
Nick Piggin7cf9c2c2006-12-06 20:33:44 -08001165
Linus Torvalds1da177e2005-04-16 15:20:36 -07001166 return ret;
1167}
1168EXPORT_SYMBOL(radix_tree_gang_lookup);
1169
Nick Piggin47feff22008-07-25 19:45:29 -07001170/**
1171 * radix_tree_gang_lookup_slot - perform multiple slot lookup on radix tree
1172 * @root: radix tree root
1173 * @results: where the results of the lookup are placed
Hugh Dickins63286502011-08-03 16:21:18 -07001174 * @indices: where their indices should be placed (but usually NULL)
Nick Piggin47feff22008-07-25 19:45:29 -07001175 * @first_index: start the lookup from this key
1176 * @max_items: place up to this many items at *results
1177 *
1178 * Performs an index-ascending scan of the tree for present items. Places
1179 * their slots at *@results and returns the number of items which were
1180 * placed at *@results.
1181 *
1182 * The implementation is naive.
1183 *
1184 * Like radix_tree_gang_lookup as far as RCU and locking goes. Slots must
1185 * be dereferenced with radix_tree_deref_slot, and if using only RCU
1186 * protection, radix_tree_deref_slot may fail requiring a retry.
1187 */
1188unsigned int
Hugh Dickins63286502011-08-03 16:21:18 -07001189radix_tree_gang_lookup_slot(struct radix_tree_root *root,
1190 void ***results, unsigned long *indices,
Nick Piggin47feff22008-07-25 19:45:29 -07001191 unsigned long first_index, unsigned int max_items)
1192{
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001193 struct radix_tree_iter iter;
1194 void **slot;
1195 unsigned int ret = 0;
Nick Piggin47feff22008-07-25 19:45:29 -07001196
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001197 if (unlikely(!max_items))
Nick Piggin47feff22008-07-25 19:45:29 -07001198 return 0;
1199
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001200 radix_tree_for_each_slot(slot, root, &iter, first_index) {
1201 results[ret] = slot;
Hugh Dickins63286502011-08-03 16:21:18 -07001202 if (indices)
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001203 indices[ret] = iter.index;
1204 if (++ret == max_items)
Nick Piggin47feff22008-07-25 19:45:29 -07001205 break;
Nick Piggin47feff22008-07-25 19:45:29 -07001206 }
1207
1208 return ret;
1209}
1210EXPORT_SYMBOL(radix_tree_gang_lookup_slot);
1211
Linus Torvalds1da177e2005-04-16 15:20:36 -07001212/**
1213 * radix_tree_gang_lookup_tag - perform multiple lookup on a radix tree
1214 * based on a tag
1215 * @root: radix tree root
1216 * @results: where the results of the lookup are placed
1217 * @first_index: start the lookup from this key
1218 * @max_items: place up to this many items at *results
Jonathan Corbetdaff89f2006-03-25 03:08:05 -08001219 * @tag: the tag index (< RADIX_TREE_MAX_TAGS)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001220 *
1221 * Performs an index-ascending scan of the tree for present items which
1222 * have the tag indexed by @tag set. Places the items at *@results and
1223 * returns the number of items which were placed at *@results.
1224 */
1225unsigned int
1226radix_tree_gang_lookup_tag(struct radix_tree_root *root, void **results,
Jonathan Corbetdaff89f2006-03-25 03:08:05 -08001227 unsigned long first_index, unsigned int max_items,
1228 unsigned int tag)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001229{
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001230 struct radix_tree_iter iter;
1231 void **slot;
1232 unsigned int ret = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001233
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001234 if (unlikely(!max_items))
Nick Piggin612d6c12006-06-23 02:03:22 -07001235 return 0;
1236
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001237 radix_tree_for_each_tagged(slot, root, &iter, first_index, tag) {
Matthew Wilcox46437f92016-02-02 16:57:52 -08001238 results[ret] = rcu_dereference_raw(*slot);
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001239 if (!results[ret])
1240 continue;
Matthew Wilcox46437f92016-02-02 16:57:52 -08001241 if (radix_tree_is_indirect_ptr(results[ret])) {
1242 slot = radix_tree_iter_retry(&iter);
1243 continue;
1244 }
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001245 if (++ret == max_items)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001246 break;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001247 }
Nick Piggin7cf9c2c2006-12-06 20:33:44 -08001248
Linus Torvalds1da177e2005-04-16 15:20:36 -07001249 return ret;
1250}
1251EXPORT_SYMBOL(radix_tree_gang_lookup_tag);
1252
1253/**
Nick Piggin47feff22008-07-25 19:45:29 -07001254 * radix_tree_gang_lookup_tag_slot - perform multiple slot lookup on a
1255 * radix tree based on a tag
1256 * @root: radix tree root
1257 * @results: where the results of the lookup are placed
1258 * @first_index: start the lookup from this key
1259 * @max_items: place up to this many items at *results
1260 * @tag: the tag index (< RADIX_TREE_MAX_TAGS)
1261 *
1262 * Performs an index-ascending scan of the tree for present items which
1263 * have the tag indexed by @tag set. Places the slots at *@results and
1264 * returns the number of slots which were placed at *@results.
1265 */
1266unsigned int
1267radix_tree_gang_lookup_tag_slot(struct radix_tree_root *root, void ***results,
1268 unsigned long first_index, unsigned int max_items,
1269 unsigned int tag)
1270{
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001271 struct radix_tree_iter iter;
1272 void **slot;
1273 unsigned int ret = 0;
Nick Piggin47feff22008-07-25 19:45:29 -07001274
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001275 if (unlikely(!max_items))
Nick Piggin47feff22008-07-25 19:45:29 -07001276 return 0;
1277
Konstantin Khlebnikovcebbd292012-03-28 14:42:53 -07001278 radix_tree_for_each_tagged(slot, root, &iter, first_index, tag) {
1279 results[ret] = slot;
1280 if (++ret == max_items)
Nick Piggin47feff22008-07-25 19:45:29 -07001281 break;
Nick Piggin47feff22008-07-25 19:45:29 -07001282 }
1283
1284 return ret;
1285}
1286EXPORT_SYMBOL(radix_tree_gang_lookup_tag_slot);
1287
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001288#if defined(CONFIG_SHMEM) && defined(CONFIG_SWAP)
1289#include <linux/sched.h> /* for cond_resched() */
1290
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001291struct locate_info {
1292 unsigned long found_index;
1293 bool stop;
1294};
1295
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001296/*
1297 * This linear search is at present only useful to shmem_unuse_inode().
1298 */
1299static unsigned long __locate(struct radix_tree_node *slot, void *item,
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001300 unsigned long index, struct locate_info *info)
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001301{
Matthew Wilcox0c7fa0a2016-05-20 17:03:07 -07001302 unsigned int shift;
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001303 unsigned long i;
1304
Matthew Wilcoxc12e51b2016-05-20 17:03:10 -07001305 shift = slot->shift + RADIX_TREE_MAP_SHIFT;
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001306
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001307 do {
Matthew Wilcoxe6145232016-03-17 14:21:54 -07001308 shift -= RADIX_TREE_MAP_SHIFT;
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001309
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001310 for (i = (index >> shift) & RADIX_TREE_MAP_MASK;
1311 i < RADIX_TREE_MAP_SIZE;
1312 i++, index += (1UL << shift)) {
1313 struct radix_tree_node *node =
1314 rcu_dereference_raw(slot->slots[i]);
1315 if (node == RADIX_TREE_RETRY)
1316 goto out;
1317 if (!radix_tree_is_indirect_ptr(node)) {
1318 if (node == item) {
1319 info->found_index = index;
1320 info->stop = true;
1321 goto out;
1322 }
1323 continue;
1324 }
1325 node = indirect_to_ptr(node);
1326 if (is_sibling_entry(slot, node))
1327 continue;
1328 slot = node;
1329 break;
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001330 }
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001331 if (i == RADIX_TREE_MAP_SIZE)
1332 break;
1333 } while (shift);
1334
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001335out:
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001336 if ((index == 0) && (i == RADIX_TREE_MAP_SIZE))
1337 info->stop = true;
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001338 return index;
1339}
1340
1341/**
1342 * radix_tree_locate_item - search through radix tree for item
1343 * @root: radix tree root
1344 * @item: item to be found
1345 *
1346 * Returns index where item was found, or -1 if not found.
1347 * Caller must hold no lock (since this time-consuming function needs
1348 * to be preemptible), and must check afterwards if item is still there.
1349 */
1350unsigned long radix_tree_locate_item(struct radix_tree_root *root, void *item)
1351{
1352 struct radix_tree_node *node;
1353 unsigned long max_index;
1354 unsigned long cur_index = 0;
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001355 struct locate_info info = {
1356 .found_index = -1,
1357 .stop = false,
1358 };
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001359
1360 do {
1361 rcu_read_lock();
1362 node = rcu_dereference_raw(root->rnode);
1363 if (!radix_tree_is_indirect_ptr(node)) {
1364 rcu_read_unlock();
1365 if (node == item)
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001366 info.found_index = 0;
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001367 break;
1368 }
1369
1370 node = indirect_to_ptr(node);
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001371
1372 max_index = node_maxindex(node);
Hugh Dickins5f30fc92014-03-03 15:38:23 -08001373 if (cur_index > max_index) {
1374 rcu_read_unlock();
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001375 break;
Hugh Dickins5f30fc92014-03-03 15:38:23 -08001376 }
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001377
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001378 cur_index = __locate(node, item, cur_index, &info);
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001379 rcu_read_unlock();
1380 cond_resched();
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001381 } while (!info.stop && cur_index <= max_index);
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001382
Matthew Wilcox0a2efc62016-05-20 17:02:46 -07001383 return info.found_index;
Hugh Dickinse504f3f2011-08-03 16:21:27 -07001384}
1385#else
1386unsigned long radix_tree_locate_item(struct radix_tree_root *root, void *item)
1387{
1388 return -1;
1389}
1390#endif /* CONFIG_SHMEM && CONFIG_SWAP */
Nick Piggin47feff22008-07-25 19:45:29 -07001391
1392/**
Matthew Wilcoxd0891262016-05-20 17:03:19 -07001393 * radix_tree_shrink - shrink radix tree to minimum height
Nick Piggina5f51c92006-01-08 01:01:41 -08001394 * @root radix tree root
1395 */
Matthew Wilcoxfb209012016-05-20 17:03:13 -07001396static inline bool radix_tree_shrink(struct radix_tree_root *root)
Nick Piggina5f51c92006-01-08 01:01:41 -08001397{
Matthew Wilcoxfb209012016-05-20 17:03:13 -07001398 bool shrunk = false;
1399
Matthew Wilcoxd0891262016-05-20 17:03:19 -07001400 for (;;) {
Nick Piggina5f51c92006-01-08 01:01:41 -08001401 struct radix_tree_node *to_free = root->rnode;
Hugh Dickinse2bdb932012-01-12 17:20:41 -08001402 struct radix_tree_node *slot;
Nick Piggina5f51c92006-01-08 01:01:41 -08001403
Matthew Wilcoxd0891262016-05-20 17:03:19 -07001404 if (!radix_tree_is_indirect_ptr(to_free))
1405 break;
Nick Piggin27d20fd2010-11-11 14:05:19 -08001406 to_free = indirect_to_ptr(to_free);
Nick Pigginc0bc9872007-10-16 01:24:42 -07001407
1408 /*
1409 * The candidate node has more than one child, or its child
Matthew Wilcoxd0891262016-05-20 17:03:19 -07001410 * is not at the leftmost slot, or the child is a multiorder
1411 * entry, we cannot shrink.
Nick Pigginc0bc9872007-10-16 01:24:42 -07001412 */
1413 if (to_free->count != 1)
1414 break;
Matthew Wilcox339e6352016-03-17 14:21:48 -07001415 slot = to_free->slots[0];
1416 if (!slot)
Nick Pigginc0bc9872007-10-16 01:24:42 -07001417 break;
Matthew Wilcoxd0891262016-05-20 17:03:19 -07001418 if (!radix_tree_is_indirect_ptr(slot) && to_free->shift)
Matthew Wilcoxafe0e392016-05-20 17:02:17 -07001419 break;
1420
1421 if (radix_tree_is_indirect_ptr(slot)) {
1422 slot = indirect_to_ptr(slot);
1423 slot->parent = NULL;
Matthew Wilcoxa4db4dc2016-05-20 17:03:24 -07001424 slot = node_to_entry(slot);
Matthew Wilcoxafe0e392016-05-20 17:02:17 -07001425 }
Nick Pigginc0bc9872007-10-16 01:24:42 -07001426
Nick Piggin7cf9c2c2006-12-06 20:33:44 -08001427 /*
1428 * We don't need rcu_assign_pointer(), since we are simply
Nick Piggin27d20fd2010-11-11 14:05:19 -08001429 * moving the node from one part of the tree to another: if it
1430 * was safe to dereference the old pointer to it
Nick Piggin7cf9c2c2006-12-06 20:33:44 -08001431 * (to_free->slots[0]), it will be safe to dereference the new
Nick Piggin27d20fd2010-11-11 14:05:19 -08001432 * one (root->rnode) as far as dependent read barriers go.
Nick Piggin7cf9c2c2006-12-06 20:33:44 -08001433 */
Hugh Dickinse2bdb932012-01-12 17:20:41 -08001434 root->rnode = slot;
Nick Piggin27d20fd2010-11-11 14:05:19 -08001435
1436 /*
1437 * We have a dilemma here. The node's slot[0] must not be
1438 * NULLed in case there are concurrent lookups expecting to
1439 * find the item. However if this was a bottom-level node,
1440 * then it may be subject to the slot pointer being visible
1441 * to callers dereferencing it. If item corresponding to
1442 * slot[0] is subsequently deleted, these callers would expect
1443 * their slot to become empty sooner or later.
1444 *
1445 * For example, lockless pagecache will look up a slot, deref
Matthew Wilcox2fcd9002016-05-20 17:03:04 -07001446 * the page pointer, and if the page has 0 refcount it means it
Nick Piggin27d20fd2010-11-11 14:05:19 -08001447 * was concurrently deleted from pagecache so try the deref
1448 * again. Fortunately there is already a requirement for logic
1449 * to retry the entire slot lookup -- the indirect pointer
1450 * problem (replacing direct root node with an indirect pointer
1451 * also results in a stale slot). So tag the slot as indirect
1452 * to force callers to retry.
1453 */
Matthew Wilcoxafe0e392016-05-20 17:02:17 -07001454 if (!radix_tree_is_indirect_ptr(slot))
1455 to_free->slots[0] = RADIX_TREE_RETRY;
Nick Piggin27d20fd2010-11-11 14:05:19 -08001456
Nick Piggina5f51c92006-01-08 01:01:41 -08001457 radix_tree_node_free(to_free);
Matthew Wilcoxfb209012016-05-20 17:03:13 -07001458 shrunk = true;
Nick Piggina5f51c92006-01-08 01:01:41 -08001459 }
Matthew Wilcoxfb209012016-05-20 17:03:13 -07001460
1461 return shrunk;
Nick Piggina5f51c92006-01-08 01:01:41 -08001462}
1463
1464/**
Johannes Weiner139e5612014-04-03 14:47:54 -07001465 * __radix_tree_delete_node - try to free node after clearing a slot
1466 * @root: radix tree root
Johannes Weiner139e5612014-04-03 14:47:54 -07001467 * @node: node containing @index
1468 *
1469 * After clearing the slot at @index in @node from radix tree
1470 * rooted at @root, call this function to attempt freeing the
1471 * node and shrinking the tree.
1472 *
1473 * Returns %true if @node was freed, %false otherwise.
1474 */
Johannes Weiner449dd692014-04-03 14:47:56 -07001475bool __radix_tree_delete_node(struct radix_tree_root *root,
Johannes Weiner139e5612014-04-03 14:47:54 -07001476 struct radix_tree_node *node)
1477{
1478 bool deleted = false;
1479
1480 do {
1481 struct radix_tree_node *parent;
1482
1483 if (node->count) {
Matthew Wilcoxfb209012016-05-20 17:03:13 -07001484 if (node == indirect_to_ptr(root->rnode))
1485 deleted |= radix_tree_shrink(root);
Johannes Weiner139e5612014-04-03 14:47:54 -07001486 return deleted;
1487 }
1488
1489 parent = node->parent;
1490 if (parent) {
Matthew Wilcox0c7fa0a2016-05-20 17:03:07 -07001491 parent->slots[node->offset] = NULL;
Johannes Weiner139e5612014-04-03 14:47:54 -07001492 parent->count--;
1493 } else {
1494 root_tag_clear_all(root);
Johannes Weiner139e5612014-04-03 14:47:54 -07001495 root->rnode = NULL;
1496 }
1497
1498 radix_tree_node_free(node);
1499 deleted = true;
1500
1501 node = parent;
1502 } while (node);
1503
1504 return deleted;
1505}
1506
Matthew Wilcox57578c22016-05-20 17:01:54 -07001507static inline void delete_sibling_entries(struct radix_tree_node *node,
1508 void *ptr, unsigned offset)
1509{
1510#ifdef CONFIG_RADIX_TREE_MULTIORDER
1511 int i;
1512 for (i = 1; offset + i < RADIX_TREE_MAP_SIZE; i++) {
1513 if (node->slots[offset + i] != ptr)
1514 break;
1515 node->slots[offset + i] = NULL;
1516 node->count--;
1517 }
1518#endif
1519}
1520
Johannes Weiner139e5612014-04-03 14:47:54 -07001521/**
Johannes Weiner53c59f22014-04-03 14:47:39 -07001522 * radix_tree_delete_item - delete an item from a radix tree
Linus Torvalds1da177e2005-04-16 15:20:36 -07001523 * @root: radix tree root
1524 * @index: index key
Johannes Weiner53c59f22014-04-03 14:47:39 -07001525 * @item: expected item
Linus Torvalds1da177e2005-04-16 15:20:36 -07001526 *
Johannes Weiner53c59f22014-04-03 14:47:39 -07001527 * Remove @item at @index from the radix tree rooted at @root.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001528 *
Johannes Weiner53c59f22014-04-03 14:47:39 -07001529 * Returns the address of the deleted item, or NULL if it was not present
1530 * or the entry at the given @index was not @item.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001531 */
Johannes Weiner53c59f22014-04-03 14:47:39 -07001532void *radix_tree_delete_item(struct radix_tree_root *root,
1533 unsigned long index, void *item)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001534{
Johannes Weiner139e5612014-04-03 14:47:54 -07001535 struct radix_tree_node *node;
Matthew Wilcox57578c22016-05-20 17:01:54 -07001536 unsigned int offset;
Johannes Weiner139e5612014-04-03 14:47:54 -07001537 void **slot;
1538 void *entry;
Nick Piggind5274262006-01-08 01:01:41 -08001539 int tag;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001540
Johannes Weiner139e5612014-04-03 14:47:54 -07001541 entry = __radix_tree_lookup(root, index, &node, &slot);
1542 if (!entry)
1543 return NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001544
Johannes Weiner139e5612014-04-03 14:47:54 -07001545 if (item && entry != item)
1546 return NULL;
1547
1548 if (!node) {
Nick Piggin612d6c12006-06-23 02:03:22 -07001549 root_tag_clear_all(root);
1550 root->rnode = NULL;
Johannes Weiner139e5612014-04-03 14:47:54 -07001551 return entry;
Nick Piggin612d6c12006-06-23 02:03:22 -07001552 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001553
Matthew Wilcox29e09672016-05-20 17:02:02 -07001554 offset = get_slot_offset(node, slot);
Johannes Weiner53c59f22014-04-03 14:47:39 -07001555
Linus Torvalds1da177e2005-04-16 15:20:36 -07001556 /*
Hugh Dickinse2bdb932012-01-12 17:20:41 -08001557 * Clear all tags associated with the item to be deleted.
1558 * This way of doing it would be inefficient, but seldom is any set.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001559 */
Jonathan Corbetdaff89f2006-03-25 03:08:05 -08001560 for (tag = 0; tag < RADIX_TREE_MAX_TAGS; tag++) {
Hugh Dickinse2bdb932012-01-12 17:20:41 -08001561 if (tag_get(node, tag, offset))
Nick Piggin612d6c12006-06-23 02:03:22 -07001562 radix_tree_tag_clear(root, index, tag);
Nick Piggind5274262006-01-08 01:01:41 -08001563 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001564
Matthew Wilcoxa4db4dc2016-05-20 17:03:24 -07001565 delete_sibling_entries(node, node_to_entry(slot), offset);
Johannes Weiner139e5612014-04-03 14:47:54 -07001566 node->slots[offset] = NULL;
1567 node->count--;
Nick Piggina5f51c92006-01-08 01:01:41 -08001568
Johannes Weiner449dd692014-04-03 14:47:56 -07001569 __radix_tree_delete_node(root, node);
Christoph Lameter201b6262005-09-06 15:16:46 -07001570
Johannes Weiner139e5612014-04-03 14:47:54 -07001571 return entry;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001572}
Johannes Weiner53c59f22014-04-03 14:47:39 -07001573EXPORT_SYMBOL(radix_tree_delete_item);
1574
1575/**
1576 * radix_tree_delete - delete an item from a radix tree
1577 * @root: radix tree root
1578 * @index: index key
1579 *
1580 * Remove the item at @index from the radix tree rooted at @root.
1581 *
1582 * Returns the address of the deleted item, or NULL if it was not present.
1583 */
1584void *radix_tree_delete(struct radix_tree_root *root, unsigned long index)
1585{
1586 return radix_tree_delete_item(root, index, NULL);
1587}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001588EXPORT_SYMBOL(radix_tree_delete);
1589
1590/**
1591 * radix_tree_tagged - test whether any items in the tree are tagged
1592 * @root: radix tree root
1593 * @tag: tag to test
1594 */
Jonathan Corbetdaff89f2006-03-25 03:08:05 -08001595int radix_tree_tagged(struct radix_tree_root *root, unsigned int tag)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001596{
Nick Piggin612d6c12006-06-23 02:03:22 -07001597 return root_tag_get(root, tag);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001598}
1599EXPORT_SYMBOL(radix_tree_tagged);
1600
1601static void
Johannes Weiner449dd692014-04-03 14:47:56 -07001602radix_tree_node_ctor(void *arg)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001603{
Johannes Weiner449dd692014-04-03 14:47:56 -07001604 struct radix_tree_node *node = arg;
1605
1606 memset(node, 0, sizeof(*node));
1607 INIT_LIST_HEAD(&node->private_list);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001608}
1609
Linus Torvalds1da177e2005-04-16 15:20:36 -07001610static int radix_tree_callback(struct notifier_block *nfb,
Matthew Wilcox2fcd9002016-05-20 17:03:04 -07001611 unsigned long action, void *hcpu)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001612{
Matthew Wilcox2fcd9002016-05-20 17:03:04 -07001613 int cpu = (long)hcpu;
1614 struct radix_tree_preload *rtp;
1615 struct radix_tree_node *node;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001616
Matthew Wilcox2fcd9002016-05-20 17:03:04 -07001617 /* Free per-cpu pool of preloaded nodes */
1618 if (action == CPU_DEAD || action == CPU_DEAD_FROZEN) {
1619 rtp = &per_cpu(radix_tree_preloads, cpu);
1620 while (rtp->nr) {
Kirill A. Shutemov9d2a8da2015-06-25 15:02:19 -07001621 node = rtp->nodes;
1622 rtp->nodes = node->private_data;
1623 kmem_cache_free(radix_tree_node_cachep, node);
1624 rtp->nr--;
Matthew Wilcox2fcd9002016-05-20 17:03:04 -07001625 }
1626 }
1627 return NOTIFY_OK;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001628}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001629
1630void __init radix_tree_init(void)
1631{
1632 radix_tree_node_cachep = kmem_cache_create("radix_tree_node",
1633 sizeof(struct radix_tree_node), 0,
Christoph Lameter488514d2008-04-28 02:12:05 -07001634 SLAB_PANIC | SLAB_RECLAIM_ACCOUNT,
1635 radix_tree_node_ctor);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001636 hotcpu_notifier(radix_tree_callback, 0);
1637}