[fio.git] / lib / axmap.c

/*
 * Bitmap of bitmaps, where each layer is number-of-bits-per-word smaller than
 * the previous. Hence an 'axmap', since we axe each previous layer into a
 * much smaller piece. I swear, that is why it's named like that. It has
 * nothing to do with anything remotely narcissistic.
 *
 * A set bit at layer N indicates a full word at layer N-1, and so forth. As
 * the bitmap becomes progressively more full, checking for existence
 * becomes cheaper (since fewer layers are walked, making it a lot more
 * cache friendly) and locating the next free space likewise.
 *
 * Axmaps get pretty close to optimal (1 bit per block) space usage, since
 * layers quickly diminish in size. Doing the size math is straight forward,
 * since we have log64(blocks) layers of maps. For 20000 blocks, overhead
 * is roughly 1.9%, or 1.019 bits per block. The number quickly converges
 * towards 1.0158, or 1.58% of overhead.
 */
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <assert.h>

#include "../arch/arch.h"
#include "axmap.h"
#include "../minmax.h"

#if BITS_PER_LONG == 64
#define UNIT_SHIFT		6
#elif BITS_PER_LONG == 32
#define UNIT_SHIFT		5
#else
#error "Number of arch bits unknown"
#endif

#define BLOCKS_PER_UNIT		(1U << UNIT_SHIFT)
#define BLOCKS_PER_UNIT_MASK	(BLOCKS_PER_UNIT - 1)

static const unsigned long bit_masks[] = {
	0x0000000000000000, 0x0000000000000001, 0x0000000000000003, 0x0000000000000007,
	0x000000000000000f, 0x000000000000001f, 0x000000000000003f, 0x000000000000007f,
	0x00000000000000ff, 0x00000000000001ff, 0x00000000000003ff, 0x00000000000007ff,
	0x0000000000000fff, 0x0000000000001fff, 0x0000000000003fff, 0x0000000000007fff,
	0x000000000000ffff, 0x000000000001ffff, 0x000000000003ffff, 0x000000000007ffff,
	0x00000000000fffff, 0x00000000001fffff, 0x00000000003fffff, 0x00000000007fffff,
	0x0000000000ffffff, 0x0000000001ffffff, 0x0000000003ffffff, 0x0000000007ffffff,
	0x000000000fffffff, 0x000000001fffffff, 0x000000003fffffff, 0x000000007fffffff,
	0x00000000ffffffff,
#if BITS_PER_LONG == 64
	0x00000001ffffffff, 0x00000003ffffffff, 0x00000007ffffffff, 0x0000000fffffffff,
	0x0000001fffffffff, 0x0000003fffffffff, 0x0000007fffffffff, 0x000000ffffffffff,
	0x000001ffffffffff, 0x000003ffffffffff, 0x000007ffffffffff, 0x00000fffffffffff,
	0x00001fffffffffff, 0x00003fffffffffff, 0x00007fffffffffff, 0x0000ffffffffffff,
	0x0001ffffffffffff, 0x0003ffffffffffff, 0x0007ffffffffffff, 0x000fffffffffffff,
	0x001fffffffffffff, 0x003fffffffffffff, 0x007fffffffffffff, 0x00ffffffffffffff,
	0x01ffffffffffffff, 0x03ffffffffffffff, 0x07ffffffffffffff, 0x0fffffffffffffff,
	0x1fffffffffffffff, 0x3fffffffffffffff, 0x7fffffffffffffff, 0xffffffffffffffff
#endif
};

/**
 * struct axmap_level - a bitmap used to implement struct axmap
 * @level: Level index. Each map has at least one level with index zero. The
 *	higher the level index, the fewer bits a struct axmap_level contains.
 * @map_size: Number of elements of the @map array.
 * @map: A bitmap with @map_size elements.
 */
struct axmap_level {
	int level;
	unsigned long map_size;
	unsigned long *map;
};

/**
 * struct axmap - a set that can store numbers 0 .. @nr_bits - 1
 * @nr_level: Number of elements of the @levels array.
 * @levels: struct axmap_level array in which lower levels contain more bits
 *	than higher levels.
 * @nr_bits: One more than the highest value stored in the set.
 */
struct axmap {
	unsigned int nr_levels;
	struct axmap_level *levels;
	uint64_t nr_bits;
};

/* Remove all elements from the @axmap set */
void axmap_reset(struct axmap *axmap)
{
	int i;

	for (i = 0; i < axmap->nr_levels; i++) {
		struct axmap_level *al = &axmap->levels[i];

		memset(al->map, 0, al->map_size * sizeof(unsigned long));
	}
}

void axmap_free(struct axmap *axmap)
{
	unsigned int i;

	if (!axmap)
		return;

	for (i = 0; i < axmap->nr_levels; i++)
		free(axmap->levels[i].map);

	free(axmap->levels);
	free(axmap);
}

/* Allocate memory for a set that can store the numbers 0 .. @nr_bits - 1. */
struct axmap *axmap_new(uint64_t nr_bits)
{
	struct axmap *axmap;
	unsigned int i, levels;

	axmap = malloc(sizeof(*axmap));
	if (!axmap)
		return NULL;

	levels = 1;
	i = (nr_bits + BLOCKS_PER_UNIT - 1) >> UNIT_SHIFT;
	while (i > 1) {
		i = (i + BLOCKS_PER_UNIT - 1) >> UNIT_SHIFT;
		levels++;
	}

	axmap->nr_levels = levels;
	axmap->levels = calloc(axmap->nr_levels, sizeof(struct axmap_level));
	if (!axmap->levels)
		goto free_axmap;
	axmap->nr_bits = nr_bits;

	for (i = 0; i < axmap->nr_levels; i++) {
		struct axmap_level *al = &axmap->levels[i];

		nr_bits = (nr_bits + BLOCKS_PER_UNIT - 1) >> UNIT_SHIFT;

		al->level = i;
		al->map_size = nr_bits;
		al->map = malloc(al->map_size * sizeof(unsigned long));
		if (!al->map)
			goto free_levels;

	}

	axmap_reset(axmap);
	return axmap;

free_levels:
	for (i = 0; i < axmap->nr_levels; i++)
		free(axmap->levels[i].map);

	free(axmap->levels);

free_axmap:
	free(axmap);
	return NULL;
}

/*
 * Call @func for each level, starting at level zero, until a level is found
 * for which @func returns true. Return false if none of the @func calls
 * returns true.
 */
static bool axmap_handler(struct axmap *axmap, uint64_t bit_nr,
			  bool (*func)(struct axmap_level *, uint64_t, unsigned int,
			  void *), void *data)
{
	struct axmap_level *al;
	uint64_t index = bit_nr;
	int i;

	for (i = 0; i < axmap->nr_levels; i++) {
		unsigned long offset = index >> UNIT_SHIFT;
		unsigned int bit = index & BLOCKS_PER_UNIT_MASK;

		al = &axmap->levels[i];

		if (func(al, offset, bit, data))
			return true;

		if (index)
			index >>= UNIT_SHIFT;
	}

	return false;
}

/*
 * Call @func for each level, starting at the highest level, until a level is
 * found for which @func returns true. Return false if none of the @func calls
 * returns true.
 */
static bool axmap_handler_topdown(struct axmap *axmap, uint64_t bit_nr,
	bool (*func)(struct axmap_level *, uint64_t, unsigned int, void *))
{
	int i;

	for (i = axmap->nr_levels - 1; i >= 0; i--) {
		uint64_t index = bit_nr >> (UNIT_SHIFT * i);
		unsigned long offset = index >> UNIT_SHIFT;
		unsigned int bit = index & BLOCKS_PER_UNIT_MASK;

		if (func(&axmap->levels[i], offset, bit, NULL))
			return true;
	}

	return false;
}

struct axmap_set_data {
	unsigned int nr_bits;
	unsigned int set_bits;
};

/*
 * Set at most @__data->nr_bits bits in @al at offset @offset. Do not exceed
 * the boundary of the element at offset @offset. Return the number of bits
 * that have been set in @__data->set_bits if @al->level == 0.
 */
static bool axmap_set_fn(struct axmap_level *al, uint64_t offset,
			 unsigned int bit, void *__data)
{
	struct axmap_set_data *data = __data;
	unsigned long mask, overlap;
	unsigned int nr_bits;

	nr_bits = min(data->nr_bits, BLOCKS_PER_UNIT - bit);

	mask = bit_masks[nr_bits] << bit;

	/*
	 * Mask off any potential overlap, only sets contig regions
	 */
	overlap = al->map[offset] & mask;
	if (overlap == mask) {
		data->set_bits = 0;
		return true;
	}

	if (overlap) {
		nr_bits = ffz(~overlap) - bit;
		if (!nr_bits)
			return true;
		mask = bit_masks[nr_bits] << bit;
	}

	assert(mask);
	assert(!(al->map[offset] & mask));
	al->map[offset] |= mask;

	if (!al->level)
		data->set_bits = nr_bits;

	/* For the next level */
	data->nr_bits = 1;

	return al->map[offset] != -1UL;
}

/*
 * Set up to @data->nr_bits starting from @bit_nr in @axmap. Start at
 * @bit_nr. If that bit has not yet been set then set it and continue until
 * either @data->nr_bits have been set or a 1 bit is found. Store the number
 * of bits that have been set in @data->set_bits. It is guaranteed that all
 * bits that have been requested to set fit in the same unsigned long word of
 * level 0 of @axmap.
 */
static void __axmap_set(struct axmap *axmap, uint64_t bit_nr,
			 struct axmap_set_data *data)
{
	unsigned int nr_bits = data->nr_bits;

	if (bit_nr > axmap->nr_bits)
		return;
	else if (bit_nr + nr_bits > axmap->nr_bits)
		nr_bits = axmap->nr_bits - bit_nr;

	assert(nr_bits <= BLOCKS_PER_UNIT);

	axmap_handler(axmap, bit_nr, axmap_set_fn, data);
}

void axmap_set(struct axmap *axmap, uint64_t bit_nr)
{
	struct axmap_set_data data = { .nr_bits = 1, };

	__axmap_set(axmap, bit_nr, &data);
}

/*
 * Set up to @nr_bits starting from @bit in @axmap. Start at @bit. If that
 * bit has not yet been set then set it and continue until either @nr_bits
 * have been set or a 1 bit is found. Return the number of bits that have been
 * set.
 */
unsigned int axmap_set_nr(struct axmap *axmap, uint64_t bit_nr,
			  unsigned int nr_bits)
{
	unsigned int set_bits = 0;

	do {
		struct axmap_set_data data = { .nr_bits = nr_bits, };
		unsigned int max_bits, this_set;

		max_bits = BLOCKS_PER_UNIT - (bit_nr & BLOCKS_PER_UNIT_MASK);
		if (nr_bits > max_bits)
			data.nr_bits = max_bits;

		this_set = data.nr_bits;
		__axmap_set(axmap, bit_nr, &data);
		set_bits += data.set_bits;
		if (data.set_bits != this_set)
			break;

		nr_bits -= data.set_bits;
		bit_nr += data.set_bits;
	} while (nr_bits);

	return set_bits;
}

static bool axmap_isset_fn(struct axmap_level *al, uint64_t offset,
			   unsigned int bit, void *unused)
{
	return (al->map[offset] & (1ULL << bit)) != 0;
}

bool axmap_isset(struct axmap *axmap, uint64_t bit_nr)
{
	if (bit_nr <= axmap->nr_bits)
		return axmap_handler_topdown(axmap, bit_nr, axmap_isset_fn);

	return false;
}

/*
 * Find the first free bit that is at least as large as bit_nr.  Return
 * -1 if no free bit is found before the end of the map.
 */
static uint64_t axmap_find_first_free(struct axmap *axmap, uint64_t bit_nr)
{
	int i;
	unsigned long temp;
	unsigned int bit;
	uint64_t offset, base_index, index;
	struct axmap_level *al;

	index = 0;
	for (i = axmap->nr_levels - 1; i >= 0; i--) {
		al = &axmap->levels[i];

		/* Shift previously calculated index for next level */
		index <<= UNIT_SHIFT;

		/*
		 * Start from an index that's at least as large as the
		 * originally passed in bit number.
		 */
		base_index = bit_nr >> (UNIT_SHIFT * i);
		if (index < base_index)
			index = base_index;

		/* Get the offset and bit for this level */
		offset = index >> UNIT_SHIFT;
		bit = index & BLOCKS_PER_UNIT_MASK;

		/*
		 * If the previous level had unused bits in its last
		 * word, the offset could be bigger than the map at
		 * this level. That means no free bits exist before the
		 * end of the map, so return -1.
		 */
		if (offset >= al->map_size)
			return -1ULL;

		/* Check the first word starting with the specific bit */
		temp = ~bit_masks[bit] & ~al->map[offset];
		if (temp)
			goto found;

		/*
		 * No free bit in the first word, so iterate
		 * looking for a word with one or more free bits.
		 */
		for (offset++; offset < al->map_size; offset++) {
			temp = ~al->map[offset];
			if (temp)
				goto found;
		}

		/* Did not find a free bit */
		return -1ULL;

found:
		/* Compute the index of the free bit just found */
		index = (offset << UNIT_SHIFT) + ffz(~temp);
	}

	/* If found an unused bit in the last word of level 0, return -1 */
	if (index >= axmap->nr_bits)
		return -1ULL;

	return index;
}

/*
 * 'bit_nr' is already set. Find the next free bit after this one.
 * Return -1 if no free bits found.
 */
uint64_t axmap_next_free(struct axmap *axmap, uint64_t bit_nr)
{
	uint64_t ret;
	uint64_t next_bit = bit_nr + 1;
	unsigned long temp;
	uint64_t offset;
	unsigned int bit;

	if (bit_nr >= axmap->nr_bits)
		return -1ULL;

	/* If at the end of the map, wrap-around */
	if (next_bit == axmap->nr_bits)
		next_bit = 0;

	offset = next_bit >> UNIT_SHIFT;
	bit = next_bit & BLOCKS_PER_UNIT_MASK;

	/*
	 * As an optimization, do a quick check for a free bit
	 * in the current word at level 0. If not found, do
	 * a topdown search.
	 */
	temp = ~bit_masks[bit] & ~axmap->levels[0].map[offset];
	if (temp) {
		ret = (offset << UNIT_SHIFT) + ffz(~temp);

		/* Might have found an unused bit at level 0 */
		if (ret >= axmap->nr_bits)
			ret = -1ULL;
	} else
		ret = axmap_find_first_free(axmap, next_bit);

	/*
	 * If there are no free bits starting at next_bit and going
	 * to the end of the map, wrap around by searching again
	 * starting at bit 0.
	 */
	if (ret == -1ULL && next_bit != 0)
		ret = axmap_find_first_free(axmap, 0);
	return ret;
}
Commit	Line	Data
7ebd796f JA	1	/*
	2	* Bitmap of bitmaps, where each layer is number-of-bits-per-word smaller than
	3	* the previous. Hence an 'axmap', since we axe each previous layer into a
	4	* much smaller piece. I swear, that is why it's named like that. It has
	5	* nothing to do with anything remotely narcissistic.
	6	*
	7	* A set bit at layer N indicates a full word at layer N-1, and so forth. As
de8f6de9	8	* the bitmap becomes progressively more full, checking for existence
7ebd796f JA	9	* becomes cheaper (since fewer layers are walked, making it a lot more
	10	* cache friendly) and locating the next free space likewise.
	11	*
	12	* Axmaps get pretty close to optimal (1 bit per block) space usage, since
	13	* layers quickly diminish in size. Doing the size math is straight forward,
	14	* since we have log64(blocks) layers of maps. For 20000 blocks, overhead
	15	* is roughly 1.9%, or 1.019 bits per block. The number quickly converges
	16	* towards 1.0158, or 1.58% of overhead.
	17	*/
	18	#include <stdio.h>
	19	#include <stdlib.h>
	20	#include <string.h>
	21	#include <assert.h>
	22
	23	#include "../arch/arch.h"
	24	#include "axmap.h"
7ebd796f JA	25	#include "../minmax.h"
	26
	27	#if BITS_PER_LONG == 64
	28	#define UNIT_SHIFT 6
	29	#elif BITS_PER_LONG == 32
	30	#define UNIT_SHIFT 5
	31	#else
	32	#error "Number of arch bits unknown"
	33	#endif
	34
e6f735f0	35	#define BLOCKS_PER_UNIT (1U << UNIT_SHIFT)
7ebd796f JA	36	#define BLOCKS_PER_UNIT_MASK (BLOCKS_PER_UNIT - 1)
7ebd796f JA	37
76dd186e JA	38	static const unsigned long bit_masks[] = {
	39	0x0000000000000000, 0x0000000000000001, 0x0000000000000003, 0x0000000000000007,
	40	0x000000000000000f, 0x000000000000001f, 0x000000000000003f, 0x000000000000007f,
	41	0x00000000000000ff, 0x00000000000001ff, 0x00000000000003ff, 0x00000000000007ff,
	42	0x0000000000000fff, 0x0000000000001fff, 0x0000000000003fff, 0x0000000000007fff,
	43	0x000000000000ffff, 0x000000000001ffff, 0x000000000003ffff, 0x000000000007ffff,
	44	0x00000000000fffff, 0x00000000001fffff, 0x00000000003fffff, 0x00000000007fffff,
	45	0x0000000000ffffff, 0x0000000001ffffff, 0x0000000003ffffff, 0x0000000007ffffff,
	46	0x000000000fffffff, 0x000000001fffffff, 0x000000003fffffff, 0x000000007fffffff,
	47	0x00000000ffffffff,
	48	#if BITS_PER_LONG == 64
	49	0x00000001ffffffff, 0x00000003ffffffff, 0x00000007ffffffff, 0x0000000fffffffff,
	50	0x0000001fffffffff, 0x0000003fffffffff, 0x0000007fffffffff, 0x000000ffffffffff,
	51	0x000001ffffffffff, 0x000003ffffffffff, 0x000007ffffffffff, 0x00000fffffffffff,
	52	0x00001fffffffffff, 0x00003fffffffffff, 0x00007fffffffffff, 0x0000ffffffffffff,
	53	0x0001ffffffffffff, 0x0003ffffffffffff, 0x0007ffffffffffff, 0x000fffffffffffff,
	54	0x001fffffffffffff, 0x003fffffffffffff, 0x007fffffffffffff, 0x00ffffffffffffff,
	55	0x01ffffffffffffff, 0x03ffffffffffffff, 0x07ffffffffffffff, 0x0fffffffffffffff,
	56	0x1fffffffffffffff, 0x3fffffffffffffff, 0x7fffffffffffffff, 0xffffffffffffffff
	57	#endif
	58	};
	59
c7143018 BVA	60	/**
	61	* struct axmap_level - a bitmap used to implement struct axmap
	62	* @level: Level index. Each map has at least one level with index zero. The
	63	* higher the level index, the fewer bits a struct axmap_level contains.
	64	* @map_size: Number of elements of the @map array.
	65	* @map: A bitmap with @map_size elements.
	66	*/
7ebd796f JA	67	struct axmap_level {
	68	int level;
	69	unsigned long map_size;
	70	unsigned long *map;
	71	};
	72
c7143018 BVA	73	/**
	74	* struct axmap - a set that can store numbers 0 .. @nr_bits - 1
	75	* @nr_level: Number of elements of the @levels array.
	76	* @levels: struct axmap_level array in which lower levels contain more bits
	77	* than higher levels.
	78	* @nr_bits: One more than the highest value stored in the set.
	79	*/
7ebd796f JA	80	struct axmap {
	81	unsigned int nr_levels;
	82	struct axmap_level *levels;
47d94b0b	83	uint64_t nr_bits;
7ebd796f JA	84	};
7ebd796f JA	85
c7143018	86	/* Remove all elements from the @axmap set */
7ebd796f JA	87	void axmap_reset(struct axmap *axmap)
	88	{
	89	int i;
	90
	91	for (i = 0; i < axmap->nr_levels; i++) {
	92	struct axmap_level *al = &axmap->levels[i];
	93
	94	memset(al->map, 0, al->map_size * sizeof(unsigned long));
	95	}
	96	}
	97
	98	void axmap_free(struct axmap *axmap)
	99	{
	100	unsigned int i;
	101
	102	if (!axmap)
	103	return;
	104
	105	for (i = 0; i < axmap->nr_levels; i++)
aded30f7	106	free(axmap->levels[i].map);
7ebd796f	107
aded30f7 JA	108	free(axmap->levels);
aded30f7 JA	109	free(axmap);
7ebd796f JA	110	}
7ebd796f JA	111
c7143018	112	/* Allocate memory for a set that can store the numbers 0 .. @nr_bits - 1. */
604d3f5b	113	struct axmap *axmap_new(uint64_t nr_bits)
7ebd796f JA	114	{
	115	struct axmap *axmap;
	116	unsigned int i, levels;
	117
aded30f7	118	axmap = malloc(sizeof(*axmap));
7ebd796f JA	119	if (!axmap)
	120	return NULL;
	121
	122	levels = 1;
	123	i = (nr_bits + BLOCKS_PER_UNIT - 1) >> UNIT_SHIFT;
	124	while (i > 1) {
	125	i = (i + BLOCKS_PER_UNIT - 1) >> UNIT_SHIFT;
	126	levels++;
	127	}
	128
	129	axmap->nr_levels = levels;
2404b2c3	130	axmap->levels = calloc(axmap->nr_levels, sizeof(struct axmap_level));
70c0f356 BVA	131	if (!axmap->levels)
70c0f356 BVA	132	goto free_axmap;
47d94b0b	133	axmap->nr_bits = nr_bits;
7ebd796f JA	134
	135	for (i = 0; i < axmap->nr_levels; i++) {
	136	struct axmap_level *al = &axmap->levels[i];
	137
604d3f5b JA	138	nr_bits = (nr_bits + BLOCKS_PER_UNIT - 1) >> UNIT_SHIFT;
604d3f5b JA	139
7ebd796f	140	al->level = i;
604d3f5b	141	al->map_size = nr_bits;
aded30f7	142	al->map = malloc(al->map_size * sizeof(unsigned long));
7ebd796f	143	if (!al->map)
70c0f356	144	goto free_levels;
7ebd796f	145
7ebd796f JA	146	}
	147
	148	axmap_reset(axmap);
	149	return axmap;
70c0f356 BVA	150
70c0f356 BVA	151	free_levels:
7ebd796f	152	for (i = 0; i < axmap->nr_levels; i++)
70c0f356	153	free(axmap->levels[i].map);
7ebd796f	154
aded30f7	155	free(axmap->levels);
70c0f356 BVA	156
70c0f356 BVA	157	free_axmap:
bb1116fe	158	free(axmap);
7ebd796f JA	159	return NULL;
	160	}
	161
c7143018 BVA	162	/*
	163	* Call @func for each level, starting at level zero, until a level is found
	164	* for which @func returns true. Return false if none of the @func calls
	165	* returns true.
	166	*/
e39c0676	167	static bool axmap_handler(struct axmap *axmap, uint64_t bit_nr,
39c56bc0	168	bool (func)(struct axmap_level , uint64_t, unsigned int,
7ebd796f JA	169	void ), void data)
	170	{
	171	struct axmap_level *al;
edfca254	172	uint64_t index = bit_nr;
7ebd796f JA	173	int i;
	174
	175	for (i = 0; i < axmap->nr_levels; i++) {
7ebd796f JA	176	unsigned long offset = index >> UNIT_SHIFT;
	177	unsigned int bit = index & BLOCKS_PER_UNIT_MASK;
	178
	179	al = &axmap->levels[i];
	180
	181	if (func(al, offset, bit, data))
e39c0676	182	return true;
edfca254 JA	183
	184	if (index)
	185	index >>= UNIT_SHIFT;
7ebd796f JA	186	}
7ebd796f JA	187
e39c0676	188	return false;
7ebd796f JA	189	}
7ebd796f JA	190
c7143018 BVA	191	/*
	192	* Call @func for each level, starting at the highest level, until a level is
	193	* found for which @func returns true. Return false if none of the @func calls
	194	* returns true.
	195	*/
e39c0676	196	static bool axmap_handler_topdown(struct axmap *axmap, uint64_t bit_nr,
39c56bc0	197	bool (func)(struct axmap_level , uint64_t, unsigned int, void *))
7ebd796f	198	{
76dd186e	199	int i;
7ebd796f JA	200
7ebd796f JA	201	for (i = axmap->nr_levels - 1; i >= 0; i--) {
39c56bc0	202	uint64_t index = bit_nr >> (UNIT_SHIFT * i);
7ebd796f JA	203	unsigned long offset = index >> UNIT_SHIFT;
	204	unsigned int bit = index & BLOCKS_PER_UNIT_MASK;
	205
41264298	206	if (func(&axmap->levels[i], offset, bit, NULL))
e39c0676	207	return true;
7ebd796f JA	208	}
7ebd796f JA	209
e39c0676	210	return false;
7ebd796f JA	211	}
7ebd796f JA	212
7ebd796f JA	213	struct axmap_set_data {
	214	unsigned int nr_bits;
	215	unsigned int set_bits;
7ebd796f JA	216	};
7ebd796f JA	217
c7143018 BVA	218	/*
	219	* Set at most @__data->nr_bits bits in @al at offset @offset. Do not exceed
	220	* the boundary of the element at offset @offset. Return the number of bits
	221	* that have been set in @__data->set_bits if @al->level == 0.
	222	*/
39c56bc0	223	static bool axmap_set_fn(struct axmap_level *al, uint64_t offset,
7ebd796f JA	224	unsigned int bit, void *__data)
	225	{
	226	struct axmap_set_data *data = __data;
	227	unsigned long mask, overlap;
	228	unsigned int nr_bits;
	229
	230	nr_bits = min(data->nr_bits, BLOCKS_PER_UNIT - bit);
	231
	232	mask = bit_masks[nr_bits] << bit;
	233
	234	/*
	235	* Mask off any potential overlap, only sets contig regions
	236	*/
	237	overlap = al->map[offset] & mask;
bd71edce	238	if (overlap == mask) {
bd71edce	239	data->set_bits = 0;
e39c0676	240	return true;
bd71edce	241	}
7ebd796f	242
8cd5a2fd	243	if (overlap) {
15a4f496	244	nr_bits = ffz(~overlap) - bit;
49e1ade1 JA	245	if (!nr_bits)
49e1ade1 JA	246	return true;
8cd5a2fd	247	mask = bit_masks[nr_bits] << bit;
7ebd796f JA	248	}
	249
	250	assert(mask);
	251	assert(!(al->map[offset] & mask));
7ebd796f JA	252	al->map[offset] \|= mask;
	253
	254	if (!al->level)
	255	data->set_bits = nr_bits;
	256
c7143018	257	/* For the next level */
7ebd796f	258	data->nr_bits = 1;
c7143018	259
7ebd796f JA	260	return al->map[offset] != -1UL;
	261	}
	262
c7143018 BVA	263	/*
	264	* Set up to @data->nr_bits starting from @bit_nr in @axmap. Start at
	265	* @bit_nr. If that bit has not yet been set then set it and continue until
	266	* either @data->nr_bits have been set or a 1 bit is found. Store the number
	267	* of bits that have been set in @data->set_bits. It is guaranteed that all
	268	* bits that have been requested to set fit in the same unsigned long word of
	269	* level 0 of @axmap.
	270	*/
7ebd796f JA	271	static void __axmap_set(struct axmap *axmap, uint64_t bit_nr,
	272	struct axmap_set_data *data)
	273	{
1cf97788	274	unsigned int nr_bits = data->nr_bits;
7ebd796f	275
47d94b0b JA	276	if (bit_nr > axmap->nr_bits)
	277	return;
	278	else if (bit_nr + nr_bits > axmap->nr_bits)
	279	nr_bits = axmap->nr_bits - bit_nr;
	280
1cf97788	281	assert(nr_bits <= BLOCKS_PER_UNIT);
7ebd796f	282
1cf97788	283	axmap_handler(axmap, bit_nr, axmap_set_fn, data);
7ebd796f JA	284	}
	285
	286	void axmap_set(struct axmap *axmap, uint64_t bit_nr)
	287	{
	288	struct axmap_set_data data = { .nr_bits = 1, };
	289
	290	__axmap_set(axmap, bit_nr, &data);
	291	}
	292
c7143018 BVA	293	/*
	294	* Set up to @nr_bits starting from @bit in @axmap. Start at @bit. If that
	295	* bit has not yet been set then set it and continue until either @nr_bits
	296	* have been set or a 1 bit is found. Return the number of bits that have been
	297	* set.
	298	*/
e39c0676 JA	299	unsigned int axmap_set_nr(struct axmap *axmap, uint64_t bit_nr,
e39c0676 JA	300	unsigned int nr_bits)
7ebd796f	301	{
0bfdf9f1 JA	302	unsigned int set_bits = 0;
	303
	304	do {
09d6bf09	305	struct axmap_set_data data = { .nr_bits = nr_bits, };
0bfdf9f1 JA	306	unsigned int max_bits, this_set;
	307
	308	max_bits = BLOCKS_PER_UNIT - (bit_nr & BLOCKS_PER_UNIT_MASK);
bd71edce	309	if (nr_bits > max_bits)
0bfdf9f1 JA	310	data.nr_bits = max_bits;
	311
	312	this_set = data.nr_bits;
	313	__axmap_set(axmap, bit_nr, &data);
	314	set_bits += data.set_bits;
	315	if (data.set_bits != this_set)
	316	break;
7ebd796f	317
0bfdf9f1 JA	318	nr_bits -= data.set_bits;
	319	bit_nr += data.set_bits;
	320	} while (nr_bits);
	321
	322	return set_bits;
7ebd796f JA	323	}
7ebd796f JA	324
39c56bc0	325	static bool axmap_isset_fn(struct axmap_level *al, uint64_t offset,
e39c0676	326	unsigned int bit, void *unused)
7ebd796f	327	{
0f9f1921	328	return (al->map[offset] & (1ULL << bit)) != 0;
7ebd796f JA	329	}
7ebd796f JA	330
e39c0676	331	bool axmap_isset(struct axmap *axmap, uint64_t bit_nr)
7ebd796f	332	{
ac569176	333	if (bit_nr <= axmap->nr_bits)
c406445a	334	return axmap_handler_topdown(axmap, bit_nr, axmap_isset_fn);
47d94b0b	335
e39c0676	336	return false;
7ebd796f JA	337	}
7ebd796f JA	338
b9304c5b MK	339	/*
	340	* Find the first free bit that is at least as large as bit_nr. Return
	341	* -1 if no free bit is found before the end of the map.
	342	*/
	343	static uint64_t axmap_find_first_free(struct axmap *axmap, uint64_t bit_nr)
7ebd796f	344	{
731ef4c7	345	int i;
b9304c5b MK	346	unsigned long temp;
	347	unsigned int bit;
	348	uint64_t offset, base_index, index;
	349	struct axmap_level *al;
7ebd796f	350
b9304c5b MK	351	index = 0;
	352	for (i = axmap->nr_levels - 1; i >= 0; i--) {
	353	al = &axmap->levels[i];
7ebd796f	354
b9304c5b MK	355	/* Shift previously calculated index for next level */
	356	index <<= UNIT_SHIFT;
	357
	358	/*
	359	* Start from an index that's at least as large as the
	360	* originally passed in bit number.
	361	*/
	362	base_index = bit_nr >> (UNIT_SHIFT * i);
	363	if (index < base_index)
	364	index = base_index;
	365
	366	/* Get the offset and bit for this level */
	367	offset = index >> UNIT_SHIFT;
	368	bit = index & BLOCKS_PER_UNIT_MASK;
	369
	370	/*
	371	* If the previous level had unused bits in its last
	372	* word, the offset could be bigger than the map at
	373	* this level. That means no free bits exist before the
	374	* end of the map, so return -1.
	375	*/
	376	if (offset >= al->map_size)
	377	return -1ULL;
	378
	379	/* Check the first word starting with the specific bit */
	380	temp = ~bit_masks[bit] & ~al->map[offset];
	381	if (temp)
	382	goto found;
	383
	384	/*
	385	* No free bit in the first word, so iterate
	386	* looking for a word with one or more free bits.
	387	*/
	388	for (offset++; offset < al->map_size; offset++) {
	389	temp = ~al->map[offset];
	390	if (temp)
	391	goto found;
7ebd796f	392	}
47d94b0b	393
b9304c5b MK	394	/* Did not find a free bit */
b9304c5b MK	395	return -1ULL;
7ebd796f	396
b9304c5b MK	397	found:
	398	/* Compute the index of the free bit just found */
	399	index = (offset << UNIT_SHIFT) + ffz(~temp);
7ebd796f JA	400	}
7ebd796f JA	401
b9304c5b MK	402	/* If found an unused bit in the last word of level 0, return -1 */
	403	if (index >= axmap->nr_bits)
	404	return -1ULL;
	405
	406	return index;
7ebd796f JA	407	}
	408
	409	/*
	410	* 'bit_nr' is already set. Find the next free bit after this one.
b9304c5b	411	* Return -1 if no free bits found.
7ebd796f JA	412	*/
	413	uint64_t axmap_next_free(struct axmap *axmap, uint64_t bit_nr)
	414	{
53737ae0	415	uint64_t ret;
b9304c5b MK	416	uint64_t next_bit = bit_nr + 1;
	417	unsigned long temp;
	418	uint64_t offset;
	419	unsigned int bit;
7ebd796f	420
b9304c5b MK	421	if (bit_nr >= axmap->nr_bits)
b9304c5b MK	422	return -1ULL;
12bde369	423
b9304c5b MK	424	/* If at the end of the map, wrap-around */
	425	if (next_bit == axmap->nr_bits)
	426	next_bit = 0;
7ebd796f	427
b9304c5b MK	428	offset = next_bit >> UNIT_SHIFT;
b9304c5b MK	429	bit = next_bit & BLOCKS_PER_UNIT_MASK;
7ebd796f	430
53737ae0	431	/*
b9304c5b MK	432	* As an optimization, do a quick check for a free bit
	433	* in the current word at level 0. If not found, do
	434	* a topdown search.
53737ae0	435	*/
b9304c5b MK	436	temp = ~bit_masks[bit] & ~axmap->levels[0].map[offset];
	437	if (temp) {
	438	ret = (offset << UNIT_SHIFT) + ffz(~temp);
53737ae0	439
b9304c5b MK	440	/* Might have found an unused bit at level 0 */
	441	if (ret >= axmap->nr_bits)
	442	ret = -1ULL;
	443	} else
	444	ret = axmap_find_first_free(axmap, next_bit);
	445
	446	/*
	447	* If there are no free bits starting at next_bit and going
	448	* to the end of the map, wrap around by searching again
	449	* starting at bit 0.
	450	*/
	451	if (ret == -1ULL && next_bit != 0)
	452	ret = axmap_find_first_free(axmap, 0);
	453	return ret;
7ebd796f	454	}