[linux-2.6-block.git] / lib / percpu_ida.c

/*
 * Percpu IDA library
 *
 * Copyright (C) 2013 Datera, Inc. Kent Overstreet
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2, or (at
 * your option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 */

#include <linux/mm.h>
#include <linux/bitmap.h>
#include <linux/bitops.h>
#include <linux/bug.h>
#include <linux/err.h>
#include <linux/export.h>
#include <linux/init.h>
#include <linux/kernel.h>
#include <linux/percpu.h>
#include <linux/sched/signal.h>
#include <linux/string.h>
#include <linux/spinlock.h>
#include <linux/percpu_ida.h>

struct percpu_ida_cpu {
	/*
	 * Even though this is percpu, we need a lock for tag stealing by remote
	 * CPUs:
	 */
	spinlock_t			lock;

	/* nr_free/freelist form a stack of free IDs */
	unsigned			nr_free;
	unsigned			freelist[];
};

static inline void move_tags(unsigned *dst, unsigned *dst_nr,
			     unsigned *src, unsigned *src_nr,
			     unsigned nr)
{
	*src_nr -= nr;
	memcpy(dst + *dst_nr, src + *src_nr, sizeof(unsigned) * nr);
	*dst_nr += nr;
}

/*
 * Try to steal tags from a remote cpu's percpu freelist.
 *
 * We first check how many percpu freelists have tags
 *
 * Then we iterate through the cpus until we find some tags - we don't attempt
 * to find the "best" cpu to steal from, to keep cacheline bouncing to a
 * minimum.
 */
static inline void steal_tags(struct percpu_ida *pool,
			      struct percpu_ida_cpu *tags)
{
	unsigned cpus_have_tags, cpu = pool->cpu_last_stolen;
	struct percpu_ida_cpu *remote;

	for (cpus_have_tags = cpumask_weight(&pool->cpus_have_tags);
	     cpus_have_tags; cpus_have_tags--) {
		cpu = cpumask_next(cpu, &pool->cpus_have_tags);

		if (cpu >= nr_cpu_ids) {
			cpu = cpumask_first(&pool->cpus_have_tags);
			if (cpu >= nr_cpu_ids)
				BUG();
		}

		pool->cpu_last_stolen = cpu;
		remote = per_cpu_ptr(pool->tag_cpu, cpu);

		cpumask_clear_cpu(cpu, &pool->cpus_have_tags);

		if (remote == tags)
			continue;

		spin_lock(&remote->lock);

		if (remote->nr_free) {
			memcpy(tags->freelist,
			       remote->freelist,
			       sizeof(unsigned) * remote->nr_free);

			tags->nr_free = remote->nr_free;
			remote->nr_free = 0;
		}

		spin_unlock(&remote->lock);

		if (tags->nr_free)
			break;
	}
}

/*
 * Pop up to IDA_PCPU_BATCH_MOVE IDs off the global freelist, and push them onto
 * our percpu freelist:
 */
static inline void alloc_global_tags(struct percpu_ida *pool,
				     struct percpu_ida_cpu *tags)
{
	move_tags(tags->freelist, &tags->nr_free,
		  pool->freelist, &pool->nr_free,
		  min(pool->nr_free, pool->percpu_batch_size));
}

/**
 * percpu_ida_alloc - allocate a tag
 * @pool: pool to allocate from
 * @state: task state for prepare_to_wait
 *
 * Returns a tag - an integer in the range [0..nr_tags) (passed to
 * tag_pool_init()), or otherwise -ENOSPC on allocation failure.
 *
 * Safe to be called from interrupt context (assuming it isn't passed
 * TASK_UNINTERRUPTIBLE | TASK_INTERRUPTIBLE, of course).
 *
 * @gfp indicates whether or not to wait until a free id is available (it's not
 * used for internal memory allocations); thus if passed __GFP_RECLAIM we may sleep
 * however long it takes until another thread frees an id (same semantics as a
 * mempool).
 *
 * Will not fail if passed TASK_UNINTERRUPTIBLE | TASK_INTERRUPTIBLE.
 */
int percpu_ida_alloc(struct percpu_ida *pool, int state)
{
	DEFINE_WAIT(wait);
	struct percpu_ida_cpu *tags;
	unsigned long flags;
	int tag = -ENOSPC;

	tags = raw_cpu_ptr(pool->tag_cpu);
	spin_lock_irqsave(&tags->lock, flags);

	/* Fastpath */
	if (likely(tags->nr_free >= 0)) {
		tag = tags->freelist[--tags->nr_free];
		spin_unlock_irqrestore(&tags->lock, flags);
		return tag;
	}
	spin_unlock_irqrestore(&tags->lock, flags);

	while (1) {
		spin_lock_irqsave(&pool->lock, flags);
		tags = this_cpu_ptr(pool->tag_cpu);

		/*
		 * prepare_to_wait() must come before steal_tags(), in case
		 * percpu_ida_free() on another cpu flips a bit in
		 * cpus_have_tags
		 *
		 * global lock held and irqs disabled, don't need percpu lock
		 */
		if (state != TASK_RUNNING)
			prepare_to_wait(&pool->wait, &wait, state);

		if (!tags->nr_free)
			alloc_global_tags(pool, tags);
		if (!tags->nr_free)
			steal_tags(pool, tags);

		if (tags->nr_free) {
			tag = tags->freelist[--tags->nr_free];
			if (tags->nr_free)
				cpumask_set_cpu(smp_processor_id(),
						&pool->cpus_have_tags);
		}

		spin_unlock_irqrestore(&pool->lock, flags);

		if (tag >= 0 || state == TASK_RUNNING)
			break;

		if (signal_pending_state(state, current)) {
			tag = -ERESTARTSYS;
			break;
		}

		schedule();
	}
	if (state != TASK_RUNNING)
		finish_wait(&pool->wait, &wait);

	return tag;
}
EXPORT_SYMBOL_GPL(percpu_ida_alloc);

/**
 * percpu_ida_free - free a tag
 * @pool: pool @tag was allocated from
 * @tag: a tag previously allocated with percpu_ida_alloc()
 *
 * Safe to be called from interrupt context.
 */
void percpu_ida_free(struct percpu_ida *pool, unsigned tag)
{
	struct percpu_ida_cpu *tags;
	unsigned long flags;
	unsigned nr_free;

	BUG_ON(tag >= pool->nr_tags);

	tags = raw_cpu_ptr(pool->tag_cpu);

	spin_lock_irqsave(&tags->lock, flags);
	tags->freelist[tags->nr_free++] = tag;

	nr_free = tags->nr_free;

	if (nr_free == 1) {
		cpumask_set_cpu(smp_processor_id(),
				&pool->cpus_have_tags);
		wake_up(&pool->wait);
	}
	spin_unlock_irqrestore(&tags->lock, flags);

	if (nr_free == pool->percpu_max_size) {
		spin_lock_irqsave(&pool->lock, flags);
		spin_lock(&tags->lock);

		if (tags->nr_free == pool->percpu_max_size) {
			move_tags(pool->freelist, &pool->nr_free,
				  tags->freelist, &tags->nr_free,
				  pool->percpu_batch_size);

			wake_up(&pool->wait);
		}
		spin_unlock(&tags->lock);
		spin_unlock_irqrestore(&pool->lock, flags);
	}
}
EXPORT_SYMBOL_GPL(percpu_ida_free);

/**
 * percpu_ida_destroy - release a tag pool's resources
 * @pool: pool to free
 *
 * Frees the resources allocated by percpu_ida_init().
 */
void percpu_ida_destroy(struct percpu_ida *pool)
{
	free_percpu(pool->tag_cpu);
	free_pages((unsigned long) pool->freelist,
		   get_order(pool->nr_tags * sizeof(unsigned)));
}
EXPORT_SYMBOL_GPL(percpu_ida_destroy);

/**
 * percpu_ida_init - initialize a percpu tag pool
 * @pool: pool to initialize
 * @nr_tags: number of tags that will be available for allocation
 *
 * Initializes @pool so that it can be used to allocate tags - integers in the
 * range [0, nr_tags). Typically, they'll be used by driver code to refer to a
 * preallocated array of tag structures.
 *
 * Allocation is percpu, but sharding is limited by nr_tags - for best
 * performance, the workload should not span more cpus than nr_tags / 128.
 */
int __percpu_ida_init(struct percpu_ida *pool, unsigned long nr_tags,
	unsigned long max_size, unsigned long batch_size)
{
	unsigned i, cpu, order;

	memset(pool, 0, sizeof(*pool));

	init_waitqueue_head(&pool->wait);
	spin_lock_init(&pool->lock);
	pool->nr_tags = nr_tags;
	pool->percpu_max_size = max_size;
	pool->percpu_batch_size = batch_size;

	/* Guard against overflow */
	if (nr_tags > (unsigned) INT_MAX + 1) {
		pr_err("percpu_ida_init(): nr_tags too large\n");
		return -EINVAL;
	}

	order = get_order(nr_tags * sizeof(unsigned));
	pool->freelist = (void *) __get_free_pages(GFP_KERNEL, order);
	if (!pool->freelist)
		return -ENOMEM;

	for (i = 0; i < nr_tags; i++)
		pool->freelist[i] = i;

	pool->nr_free = nr_tags;

	pool->tag_cpu = __alloc_percpu(sizeof(struct percpu_ida_cpu) +
				       pool->percpu_max_size * sizeof(unsigned),
				       sizeof(unsigned));
	if (!pool->tag_cpu)
		goto err;

	for_each_possible_cpu(cpu)
		spin_lock_init(&per_cpu_ptr(pool->tag_cpu, cpu)->lock);

	return 0;
err:
	percpu_ida_destroy(pool);
	return -ENOMEM;
}
EXPORT_SYMBOL_GPL(__percpu_ida_init);

/**
 * percpu_ida_for_each_free - iterate free ids of a pool
 * @pool: pool to iterate
 * @fn: interate callback function
 * @data: parameter for @fn
 *
 * Note, this doesn't guarantee to iterate all free ids restrictly. Some free
 * ids might be missed, some might be iterated duplicated, and some might
 * be iterated and not free soon.
 */
int percpu_ida_for_each_free(struct percpu_ida *pool, percpu_ida_cb fn,
	void *data)
{
	unsigned long flags;
	struct percpu_ida_cpu *remote;
	unsigned cpu, i, err = 0;

	for_each_possible_cpu(cpu) {
		remote = per_cpu_ptr(pool->tag_cpu, cpu);
		spin_lock_irqsave(&remote->lock, flags);
		for (i = 0; i < remote->nr_free; i++) {
			err = fn(remote->freelist[i], data);
			if (err)
				break;
		}
		spin_unlock_irqrestore(&remote->lock, flags);
		if (err)
			goto out;
	}

	spin_lock_irqsave(&pool->lock, flags);
	for (i = 0; i < pool->nr_free; i++) {
		err = fn(pool->freelist[i], data);
		if (err)
			break;
	}
	spin_unlock_irqrestore(&pool->lock, flags);
out:
	return err;
}
EXPORT_SYMBOL_GPL(percpu_ida_for_each_free);

/**
 * percpu_ida_free_tags - return free tags number of a specific cpu or global pool
 * @pool: pool related
 * @cpu: specific cpu or global pool if @cpu == nr_cpu_ids
 *
 * Note: this just returns a snapshot of free tags number.
 */
unsigned percpu_ida_free_tags(struct percpu_ida *pool, int cpu)
{
	struct percpu_ida_cpu *remote;
	if (cpu == nr_cpu_ids)
		return pool->nr_free;
	remote = per_cpu_ptr(pool->tag_cpu, cpu);
	return remote->nr_free;
}
EXPORT_SYMBOL_GPL(percpu_ida_free_tags);
Commit	Line	Data
798ab48e KO	1	/*
	2	* Percpu IDA library
	3	*
	4	* Copyright (C) 2013 Datera, Inc. Kent Overstreet
	5	*
	6	* This program is free software; you can redistribute it and/or
	7	* modify it under the terms of the GNU General Public License as
	8	* published by the Free Software Foundation; either version 2, or (at
	9	* your option) any later version.
	10	*
	11	* This program is distributed in the hope that it will be useful, but
	12	* WITHOUT ANY WARRANTY; without even the implied warranty of
	13	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	14	* General Public License for more details.
	15	*/
	16
fd771233	17	#include <linux/mm.h>
798ab48e KO	18	#include <linux/bitmap.h>
	19	#include <linux/bitops.h>
	20	#include <linux/bug.h>
	21	#include <linux/err.h>
	22	#include <linux/export.h>
798ab48e KO	23	#include <linux/init.h>
	24	#include <linux/kernel.h>
	25	#include <linux/percpu.h>
174cd4b1	26	#include <linux/sched/signal.h>
798ab48e KO	27	#include <linux/string.h>
	28	#include <linux/spinlock.h>
	29	#include <linux/percpu_ida.h>
	30
798ab48e KO	31	struct percpu_ida_cpu {
	32	/*
	33	* Even though this is percpu, we need a lock for tag stealing by remote
	34	* CPUs:
	35	*/
	36	spinlock_t lock;
	37
	38	/* nr_free/freelist form a stack of free IDs */
	39	unsigned nr_free;
	40	unsigned freelist[];
	41	};
	42
	43	static inline void move_tags(unsigned dst, unsigned dst_nr,
	44	unsigned src, unsigned src_nr,
	45	unsigned nr)
	46	{
	47	*src_nr -= nr;
	48	memcpy(dst + dst_nr, src + src_nr, sizeof(unsigned) * nr);
	49	*dst_nr += nr;
	50	}
	51
	52	/*
	53	* Try to steal tags from a remote cpu's percpu freelist.
	54	*
d835502f	55	* We first check how many percpu freelists have tags
798ab48e KO	56	*
	57	* Then we iterate through the cpus until we find some tags - we don't attempt
	58	* to find the "best" cpu to steal from, to keep cacheline bouncing to a
	59	* minimum.
	60	*/
	61	static inline void steal_tags(struct percpu_ida *pool,
	62	struct percpu_ida_cpu *tags)
	63	{
	64	unsigned cpus_have_tags, cpu = pool->cpu_last_stolen;
	65	struct percpu_ida_cpu *remote;
	66
	67	for (cpus_have_tags = cpumask_weight(&pool->cpus_have_tags);
d835502f	68	cpus_have_tags; cpus_have_tags--) {
798ab48e KO	69	cpu = cpumask_next(cpu, &pool->cpus_have_tags);
	70
	71	if (cpu >= nr_cpu_ids) {
	72	cpu = cpumask_first(&pool->cpus_have_tags);
	73	if (cpu >= nr_cpu_ids)
	74	BUG();
	75	}
	76
	77	pool->cpu_last_stolen = cpu;
	78	remote = per_cpu_ptr(pool->tag_cpu, cpu);
	79
	80	cpumask_clear_cpu(cpu, &pool->cpus_have_tags);
	81
	82	if (remote == tags)
	83	continue;
	84
	85	spin_lock(&remote->lock);
	86
	87	if (remote->nr_free) {
	88	memcpy(tags->freelist,
	89	remote->freelist,
	90	sizeof(unsigned) * remote->nr_free);
	91
	92	tags->nr_free = remote->nr_free;
	93	remote->nr_free = 0;
	94	}
	95
	96	spin_unlock(&remote->lock);
	97
	98	if (tags->nr_free)
	99	break;
	100	}
	101	}
	102
	103	/*
	104	* Pop up to IDA_PCPU_BATCH_MOVE IDs off the global freelist, and push them onto
	105	* our percpu freelist:
	106	*/
	107	static inline void alloc_global_tags(struct percpu_ida *pool,
	108	struct percpu_ida_cpu *tags)
	109	{
	110	move_tags(tags->freelist, &tags->nr_free,
	111	pool->freelist, &pool->nr_free,
e26b53d0	112	min(pool->nr_free, pool->percpu_batch_size));
798ab48e KO	113	}
798ab48e KO	114
798ab48e KO	115	/**
	116	* percpu_ida_alloc - allocate a tag
	117	* @pool: pool to allocate from
6f6b5d1e	118	* @state: task state for prepare_to_wait
798ab48e KO	119	*
	120	* Returns a tag - an integer in the range [0..nr_tags) (passed to
	121	* tag_pool_init()), or otherwise -ENOSPC on allocation failure.
	122	*
	123	* Safe to be called from interrupt context (assuming it isn't passed
555b270e	124	* TASK_UNINTERRUPTIBLE \| TASK_INTERRUPTIBLE, of course).
798ab48e KO	125	*
798ab48e KO	126	* @gfp indicates whether or not to wait until a free id is available (it's not
71baba4b	127	* used for internal memory allocations); thus if passed __GFP_RECLAIM we may sleep
798ab48e KO	128	* however long it takes until another thread frees an id (same semantics as a
	129	* mempool).
	130	*
555b270e	131	* Will not fail if passed TASK_UNINTERRUPTIBLE \| TASK_INTERRUPTIBLE.
798ab48e	132	*/
6f6b5d1e	133	int percpu_ida_alloc(struct percpu_ida *pool, int state)
798ab48e KO	134	{
	135	DEFINE_WAIT(wait);
	136	struct percpu_ida_cpu *tags;
	137	unsigned long flags;
804209d8	138	int tag = -ENOSPC;
798ab48e	139
804209d8 SAS	140	tags = raw_cpu_ptr(pool->tag_cpu);
804209d8 SAS	141	spin_lock_irqsave(&tags->lock, flags);
798ab48e KO	142
798ab48e KO	143	/* Fastpath */
804209d8 SAS	144	if (likely(tags->nr_free >= 0)) {
	145	tag = tags->freelist[--tags->nr_free];
	146	spin_unlock_irqrestore(&tags->lock, flags);
798ab48e KO	147	return tag;
798ab48e KO	148	}
804209d8	149	spin_unlock_irqrestore(&tags->lock, flags);
798ab48e KO	150
798ab48e KO	151	while (1) {
804209d8 SAS	152	spin_lock_irqsave(&pool->lock, flags);
804209d8 SAS	153	tags = this_cpu_ptr(pool->tag_cpu);
798ab48e KO	154
	155	/*
	156	* prepare_to_wait() must come before steal_tags(), in case
	157	* percpu_ida_free() on another cpu flips a bit in
	158	* cpus_have_tags
	159	*
	160	* global lock held and irqs disabled, don't need percpu lock
	161	*/
6f6b5d1e KO	162	if (state != TASK_RUNNING)
6f6b5d1e KO	163	prepare_to_wait(&pool->wait, &wait, state);
798ab48e KO	164
	165	if (!tags->nr_free)
	166	alloc_global_tags(pool, tags);
	167	if (!tags->nr_free)
	168	steal_tags(pool, tags);
	169
	170	if (tags->nr_free) {
	171	tag = tags->freelist[--tags->nr_free];
	172	if (tags->nr_free)
	173	cpumask_set_cpu(smp_processor_id(),
	174	&pool->cpus_have_tags);
	175	}
	176
804209d8	177	spin_unlock_irqrestore(&pool->lock, flags);
798ab48e	178
6f6b5d1e	179	if (tag >= 0 \|\| state == TASK_RUNNING)
798ab48e KO	180	break;
798ab48e KO	181
555b270e NB	182	if (signal_pending_state(state, current)) {
	183	tag = -ERESTARTSYS;
	184	break;
	185	}
	186
798ab48e	187	schedule();
798ab48e	188	}
6f6b5d1e KO	189	if (state != TASK_RUNNING)
6f6b5d1e KO	190	finish_wait(&pool->wait, &wait);
798ab48e	191
798ab48e KO	192	return tag;
	193	}
	194	EXPORT_SYMBOL_GPL(percpu_ida_alloc);
	195
	196	/**
	197	* percpu_ida_free - free a tag
	198	* @pool: pool @tag was allocated from
	199	* @tag: a tag previously allocated with percpu_ida_alloc()
	200	*
	201	* Safe to be called from interrupt context.
	202	*/
	203	void percpu_ida_free(struct percpu_ida *pool, unsigned tag)
	204	{
	205	struct percpu_ida_cpu *tags;
	206	unsigned long flags;
	207	unsigned nr_free;
	208
	209	BUG_ON(tag >= pool->nr_tags);
	210
804209d8	211	tags = raw_cpu_ptr(pool->tag_cpu);
798ab48e	212
804209d8	213	spin_lock_irqsave(&tags->lock, flags);
798ab48e KO	214	tags->freelist[tags->nr_free++] = tag;
	215
	216	nr_free = tags->nr_free;
798ab48e KO	217
	218	if (nr_free == 1) {
	219	cpumask_set_cpu(smp_processor_id(),
	220	&pool->cpus_have_tags);
	221	wake_up(&pool->wait);
	222	}
804209d8	223	spin_unlock_irqrestore(&tags->lock, flags);
798ab48e	224
e26b53d0	225	if (nr_free == pool->percpu_max_size) {
804209d8 SAS	226	spin_lock_irqsave(&pool->lock, flags);
804209d8 SAS	227	spin_lock(&tags->lock);
798ab48e	228
e26b53d0	229	if (tags->nr_free == pool->percpu_max_size) {
798ab48e KO	230	move_tags(pool->freelist, &pool->nr_free,
798ab48e KO	231	tags->freelist, &tags->nr_free,
e26b53d0	232	pool->percpu_batch_size);
798ab48e KO	233
	234	wake_up(&pool->wait);
	235	}
804209d8 SAS	236	spin_unlock(&tags->lock);
804209d8 SAS	237	spin_unlock_irqrestore(&pool->lock, flags);
798ab48e	238	}
798ab48e KO	239	}
	240	EXPORT_SYMBOL_GPL(percpu_ida_free);
	241
	242	/**
	243	* percpu_ida_destroy - release a tag pool's resources
	244	* @pool: pool to free
	245	*
	246	* Frees the resources allocated by percpu_ida_init().
	247	*/
	248	void percpu_ida_destroy(struct percpu_ida *pool)
	249	{
	250	free_percpu(pool->tag_cpu);
	251	free_pages((unsigned long) pool->freelist,
	252	get_order(pool->nr_tags * sizeof(unsigned)));
	253	}
	254	EXPORT_SYMBOL_GPL(percpu_ida_destroy);
	255
	256	/**
	257	* percpu_ida_init - initialize a percpu tag pool
	258	* @pool: pool to initialize
	259	* @nr_tags: number of tags that will be available for allocation
	260	*
	261	* Initializes @pool so that it can be used to allocate tags - integers in the
	262	* range [0, nr_tags). Typically, they'll be used by driver code to refer to a
	263	* preallocated array of tag structures.
	264	*
	265	* Allocation is percpu, but sharding is limited by nr_tags - for best
	266	* performance, the workload should not span more cpus than nr_tags / 128.
	267	*/
e26b53d0 SL	268	int __percpu_ida_init(struct percpu_ida *pool, unsigned long nr_tags,
e26b53d0 SL	269	unsigned long max_size, unsigned long batch_size)
798ab48e KO	270	{
	271	unsigned i, cpu, order;
	272
	273	memset(pool, 0, sizeof(*pool));
	274
	275	init_waitqueue_head(&pool->wait);
	276	spin_lock_init(&pool->lock);
	277	pool->nr_tags = nr_tags;
e26b53d0 SL	278	pool->percpu_max_size = max_size;
e26b53d0 SL	279	pool->percpu_batch_size = batch_size;
798ab48e KO	280
	281	/* Guard against overflow */
	282	if (nr_tags > (unsigned) INT_MAX + 1) {
	283	pr_err("percpu_ida_init(): nr_tags too large\n");
	284	return -EINVAL;
	285	}
	286
	287	order = get_order(nr_tags * sizeof(unsigned));
	288	pool->freelist = (void *) __get_free_pages(GFP_KERNEL, order);
	289	if (!pool->freelist)
	290	return -ENOMEM;
	291
	292	for (i = 0; i < nr_tags; i++)
	293	pool->freelist[i] = i;
	294
	295	pool->nr_free = nr_tags;
	296
	297	pool->tag_cpu = __alloc_percpu(sizeof(struct percpu_ida_cpu) +
e26b53d0	298	pool->percpu_max_size * sizeof(unsigned),
798ab48e KO	299	sizeof(unsigned));
	300	if (!pool->tag_cpu)
	301	goto err;
	302
	303	for_each_possible_cpu(cpu)
	304	spin_lock_init(&per_cpu_ptr(pool->tag_cpu, cpu)->lock);
	305
	306	return 0;
	307	err:
	308	percpu_ida_destroy(pool);
	309	return -ENOMEM;
	310	}
e26b53d0	311	EXPORT_SYMBOL_GPL(__percpu_ida_init);
7fc2ba17 SL	312
	313	/**
	314	* percpu_ida_for_each_free - iterate free ids of a pool
	315	* @pool: pool to iterate
	316	* @fn: interate callback function
	317	* @data: parameter for @fn
	318	*
	319	* Note, this doesn't guarantee to iterate all free ids restrictly. Some free
	320	* ids might be missed, some might be iterated duplicated, and some might
	321	* be iterated and not free soon.
	322	*/
	323	int percpu_ida_for_each_free(struct percpu_ida *pool, percpu_ida_cb fn,
	324	void *data)
	325	{
	326	unsigned long flags;
	327	struct percpu_ida_cpu *remote;
	328	unsigned cpu, i, err = 0;
	329
7fc2ba17 SL	330	for_each_possible_cpu(cpu) {
7fc2ba17 SL	331	remote = per_cpu_ptr(pool->tag_cpu, cpu);
804209d8	332	spin_lock_irqsave(&remote->lock, flags);
7fc2ba17 SL	333	for (i = 0; i < remote->nr_free; i++) {
	334	err = fn(remote->freelist[i], data);
	335	if (err)
	336	break;
	337	}
804209d8	338	spin_unlock_irqrestore(&remote->lock, flags);
7fc2ba17 SL	339	if (err)
	340	goto out;
	341	}
	342
804209d8	343	spin_lock_irqsave(&pool->lock, flags);
7fc2ba17 SL	344	for (i = 0; i < pool->nr_free; i++) {
	345	err = fn(pool->freelist[i], data);
	346	if (err)
	347	break;
	348	}
804209d8	349	spin_unlock_irqrestore(&pool->lock, flags);
7fc2ba17	350	out:
7fc2ba17 SL	351	return err;
	352	}
	353	EXPORT_SYMBOL_GPL(percpu_ida_for_each_free);
1dddc01a SL	354
	355	/**
	356	* percpu_ida_free_tags - return free tags number of a specific cpu or global pool
	357	* @pool: pool related
	358	* @cpu: specific cpu or global pool if @cpu == nr_cpu_ids
	359	*
	360	* Note: this just returns a snapshot of free tags number.
	361	*/
	362	unsigned percpu_ida_free_tags(struct percpu_ida *pool, int cpu)
	363	{
	364	struct percpu_ida_cpu *remote;
	365	if (cpu == nr_cpu_ids)
	366	return pool->nr_free;
	367	remote = per_cpu_ptr(pool->tag_cpu, cpu);
	368	return remote->nr_free;
	369	}
	370	EXPORT_SYMBOL_GPL(percpu_ida_free_tags);